コンポーネントコントロール

コンポーネントは、Panel オブジェクトまたは Work With オブジェクトの GeneXus ツールボックスで利用できます。
コンポーネントは、Web コンポーネントと同様に、いかなる特性も失わずに Panel オブジェクトまたは Work With オブジェクトを含むことができるコントロールです。また、個別に実行することもできます。この機能により、GeneXus アプリケーション開発者に高度な再利用性が提供されます。
Web コンポーネントとの主な違いは、コンポーネントには (Web パネルやトランザクションの) [ Type ] プロパティのような追加プロパティが不要であるということです。

EventDay サンプルの最終結果

シンプルな使用例

EventDay で、セッションの内容の読み取り中にツイートを表示するとします。
そのために、「SessionsWithTweets」というのパネルを作成し、ツールボックスから 2 つのコンポーネントコントロールをドラッグします。

次に、以下のように、両方のコンポーネントコントロールに、セッション用の WorkWith オブジェクトとツイートの Panel オブジェクトを設定します。

最終的なレイアウトは次のようになります。

メソッド

Refresh

コンポーネントに組み込まれたオブジェクトが Refresh イベントを実行するようにします。
戻り値: なし
パラメーター: なし
注: Refresh メソッド/コマンドの違いとそれらの使用方法は、次のとおりです。

オブジェクトとそのコンポーネントすべて (フォーム、グリッドなどを含む) を再表示するには、Refresh コマンドを使用します。
全画面を再表示するには、Refresh Form コマンドを使用します。
オブジェクト内のグリッドを再表示するには、Grid Refresh メソッドを使用します。
コンポーネント (およびそのすべての子孫) に組み込まれたオブジェクトを再表示するには、ここで説明したメソッドを使用します。

複数コンポーネントでのイベントのトリガー順序

複数のコンポーネントを持つパネル内のイベントのトリガー順序は、Work With for Smart Devices の Detail ノードと Section に似ています。パネル P に C₁...C_N コンポーネントがある場合、実行順序は次のようになります。

Client Start (P)
Start (P)
Refresh (P)
Load (P)

     ClientStart (C₁)
     Start (C₁)
     Refresh (C₁)
     Load (C₁)

     <...>

     ClientStart (C_N)
     Start (C_N)
     Refresh (C_N)
     Load (C_N)

アクションバーの動作

複数のコンポーネントを使用する場合、アクションバーの動作は、各コンポーネントのアクションを組み合わせたものになります。

高度な使用例

前の例を続けて使用し、今回はツイートを分単位で読み取るとします。そのためには、Timer 変数 (パネルで非表示にして Chronometer コントロールを設定) と関連付けられ、60 秒以上経過したときに画面を再表示するイベントを記述する必要があります。

Event ClientStart
    // タイマーを初期化
    &Timer = 0
Endevent

Event &Timer.Tick
    // 1 分経過したらコンポーネントを再表示
    If Mod(&Timer,60) = 0
        Component2.Refresh()
    EndIf
EndEvent

最後に、呼び出しをダッシュボードのセッションに置換し、Tweets ノードを削除し、アプリケーションを実行します。

注

コンポーネントコントロールをグリッドコントロールに含めることはできません。
プログラムを使用して実行時にコンポーネントを同期するには、グローバルイベントを使用します。
[ Object ] プロパティは、設計時に使用することも、動的コンポーネントの作成の実行時にプログラムによって使用することもできます。

適用範囲

オブジェクト: Panel、Work With for Smart Devices
ジェネレーター: Apple、Android

使用可能バージョン

このプロパティは、GeneXus 15 以降で利用できます。
動的コンポーネントの作成は、GeneXus 15 Upgrade 12 以降で利用できます。