メイン･コンテンツまでスキップ

Container（コンテナ）

ContainerはTouchGFXのコンポーネントで、子のノードを含んでいます。

Containerの概念の基本的な性質の詳細については、「ウィジェットとコンテナ」のページを参照してください。

ContainerはCachableContainerとして生成することもできます。 CacheableContainerは、コンテンツをダイナミック･ビットマップに描画できます。 詳細については、「キャッシュ可能コンテナによるパフォーマンス向上」ページを参照してください。

シミュレータで実行されるContainerウィジェット

ウィジェット･グループ​

Containerは、TouchGFX DesignerのContainersウィジェット･グループ内にあります。

TouchGFX DesignerのContainerウィジェット

プロパティ​

TouchGFX DesignerのContainerのプロパティは以下のとおりです。

プロパティ･グループプロパティの説明
Nameウィジェットの名前。 Nameは、TouchGFX Designerおよびコードで使用される一意の識別子です。
LocationXおよびYは、親を基準としてウィジェットの左上隅の位置を指定します。

WおよびHは、ウィジェットの幅と高さを指定します。

Lockは、ウィジェットを現在のX、Y、W、Hでロックするかどうかを指定します。
ウィジェットをロックすると、スクリーンを通したウィジェットとのインタラクションも無効になります。

Visibleは、ウィジェットの可視性を指定します。 ウィジェットを非表示にすると、画面を介したウィジェットとの相互作用も無効になります。
CachingCachableは、ContainerをCachableContainerとして生成するかどうかを指定します。
MixinsDraggableは、実行時にウィジェットをドラッグ可能にするかどうかを指定します。

ClickListenerは、ウィジェットがクリックされたときにコールバックを発行するかどうかを指定します。

FadeAnimatorは、ウィジェットがAlpha値への変更をアニメーション化できるかどうかを指定します。

MoveAnimatorは、ウィジェットがXおよびY値への変更をアニメーション化できるかどうかを指定します。

インタラクション​

TouchGFX DesignerでContainerによってサポートされるアクションとトリガは以下のとおりです。

アクション​

ウィジェット固有のアクション説明
Resize widgetウィジェットの幅と高さを変更します。
標準のウィジェット･アクション説明
Move widget時間の経過に伴ってウィジェットを新しい位置に移動します。
Hide widgetウィジェットを非表示にします（可視性をfalseに設定します）。
Show widget非表示のウィジェットを表示します（可視性をtrueに設定します）。

トリガ​

Containerはトリガを発行しません。

パフォーマンス​

Containerそのものがパフォーマンスに影響することはなく、その子に完全に依存します。 このため、Containerはほとんどのプラットフォーム上で非常に高速のウィジェットであると見なされます。

場合によっては、CachableContainerを使用してUI要素をダイナミック･ビットマップにキャッシュすることで、アプリケーション全体のパフォーマンスを大幅に向上させることができます。 詳細については、「キャッシュ可能コンテナによるパフォーマンス向上」の記事を参照してください。

描画のパフォーマンスの詳細については、「一般的なUIコンポーネントのパフォーマンス」セクションを参照してください。

例​

生成済みコード​

View基底クラスの生成済みコードを見ると、TouchGFX DesignerによるContainerの設定方法がわかります。

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() を呼び出します。

API参照​

Further reading
  • ContainerクラスのAPI参照
  • CachableContainerクラスのAPI参照