容器
容器(Container)是TouchGFX中的組件，可包含子節點。
要瞭解更多關於容器概念基本性質的資訊，請閱讀小部件和容器頁面。
還可以生成CachableContainer形式的容器。 CacheableContainer可將其內容渲染到動態點陣圖。 相關內容將在通過CacheableContainer提高性能頁面中進行詳細介紹。
在模擬器中運行的容器小部件
小部件組
容器位於TouchGFX Designer中的Containers小部件組中。
TouchGFX Designer中的容器小部件
屬性
TouchGFX Designer中容器的屬性。
| 屬性組 | 屬性說明 |
|---|---|
| Name | 小部件的名稱。 Name是TouchGFX Designer和程式碼中使用的唯一識別碼。 |
| Location | X和Y 指定小部件左上角相對于其父的位置。 W 和 H 指定小部件的寬度和高度。 鎖定指定小部件是否應鎖定為其當前的X、Y、W和H。 如果鎖定小部件，還會禁止通過螢幕與小部件進行交互。 可見指定小部件的可見性。 使小部件不可見還將禁用與小部件之間通過螢幕進行的交互。 |
| Caching | 指定容器是否應生成為CachableContainer形式。 |
| Mixin | 可拖動 指定在運行時小部件是否可拖動。 ClickListener 指定小部件被點擊時是否會呼叫callback函數。 FadeAnimator 指定小部件是否可繪製其 Alpha 值變化的動畫。 MoveAnimator 指定小部件是否可繪製 X 和 Y 值變化的動畫。 |
交互
TouchGFX Designer中的容器支持的操作和觸發條件。
操作
| 小部件特有的操作 | 說明 |
|---|---|
| Resize widget | 調整小部件的寬度和高度。 |
| 標準小部件操作 | 說明 |
|---|---|
| Move widget | 隨時間的推移將小部件移動到新位置。 |
| Hide widget | 隱藏小部件（將可見性設置為false）。 |
| Show widget | 使隱藏的小部件可見（將可見性設置為true）。 |
觸發條件
容器不會產生任何觸發條件。
性能
容器自身對性能沒有任何影響，完全依賴於其子容器。 因此，在大部分平臺上，會將容器視為非常快速的小部件。
在某些情況下，使用CachableContainer在動態點陣圖中快取UI元素可顯著提高整個應用的性能。 更多詳細資訊，請參見通過CacheableContainer提高性能一文。
更多關於繪圖性能的常規資訊，請閱讀常規UI元件性能部分。
範例
生成程式碼
在為View基類生成的程式碼中，可以看到TouchGFX Designer如何設置按鈕。
Screen1ViewBase.cpp
#include <gui_generated/screen1_screen/Screen1ViewBase.hpp>
#include "BitmapDatabase.hpp"
Screen1ViewBase::Screen1ViewBase()
{
container1.setPosition(67, 11, 347, 250);
image1.setXY(109, 61);
image1.setBitmap(touchgfx::Bitmap(BITMAP_BLUE_LOGO_TOUCHGFX_LOGO_ID));
container1.add(image1);
add(container1);
}
Tip
您可以在用戶程式碼中使用Container類中的這些函數和其他可用函數。 如果修改了小部件的外觀，記得呼叫
container1.invalidate() 或container1.invalidateContent() 以強制重繪。 當使用 container1.invalidateContent()，必須呼叫container1.invalidateContent() 更改小工具外觀之前和之後。 注意： container1.invalidateContent()將對容器的所有子級呼叫 invalidateContent() 。