ControlEvent テーブル
ControlEvent テーブルを使用すると、ユーザーが PushButton コントロール、CheckBox コントロール、または SelectionTree コントロール を操作したときに開始 コントロール イベント指定できます。 これらは、ユーザーがコントロール イベントの開始に使用できる唯一のコントロールです。 各コントロールは、複数のコントロール イベントを発行できます。 インストーラーは、[順序付け] 列で指定された順序で各イベントを開始します。 たとえば、プッシュ ボタン コントロールは、イベントを発行して別のダイアログ ボックスへの切り替えを開始し、ダイアログ ボックス シーケンスを終了して、ファイルのインストールを開始できます。
ただし、各コントロールは、NewDialog または 1 つの SpawnDialog イベント を発行できる点に注意してください。 このテーブルで複数の NewDialog コントロール イベントと SpawnDialog コントロール イベントを作成する必要がある場合は、条件フィールドに条件ステートメントを含めて、最大で 1 つのイベントが発行されるようにします。 同じコントロールに対して複数の NewDialog コントロール イベントと SpawnDialog コントロール イベントが選択されている場合、コントロールがアクティブ化されると、Ordering 列の値が最も大きいイベントのみが発行されます。
ControlEvent テーブルには、次の列があります。
コラム | 種類 | 鍵 | 許容 |
---|---|---|---|
] ダイアログ_ | 識別子の | Y | N |
コントロール_ | 識別子の | Y | N |
出来事 | 書式設定された | Y | N |
引数 | 書式設定された | Y | N |
条件 | 条件の | Y | Y |
順序 | 整数 の | N | Y |
列
-
Dialog_
-
Dialog テーブルの最初の列の外部キー。 このフィールドと Control_ フィールドを組み合わせると、一意のコントロールが識別されます。
-
Control_
-
Control テーブルの 2 列目の外部キー。 このフィールドと Dialog_ フィールドを組み合わせると、一意のコントロールが識別されます。
-
イベント
-
ユーザーがDialog_およびControl_で指定されたコントロールと対話するときに発生するイベントの種類を指定する識別子。 使用可能な値の一覧については、「ControlEvent の概要」参照してください。
コントロールでプロパティを設定するには、このフィールドに [Property_Name] を、引数フィールドに新しい値を入力します。 引数フィールドに { } を入力して、null 値を入力します。
-
引数
-
特定のイベントをトリガーするときに修飾子として使用される値。
たとえば、NewDialog ControlEvent または SpawnDialog ControlEvent の引数はダイアログ ボックスの名前であり、インストール アクション の引数はインストール レベルを定義する数値です。
-
条件
-
インストーラーがイベント列のイベントをアクティブ化するかどうかを決定する条件付きステートメント。 条件フィールドの条件ステートメントが True に評価された場合、インストーラーによってイベントがトリガーされます。 したがって、インストーラーによってイベントがトリガーされるように、この列に 1 を配置します。 条件フィールドに False と評価されるステートメントが含まれている場合、インストーラーはイベントをトリガーしません。 インストーラーは、コントロールの他のイベントが True に評価されない限り、条件フィールドに空白のイベントをトリガーしません。 Control_ フィールドに指定されたコントロールの条件フィールドが True に評価されない場合、インストーラーは空の条件フィールドを持つ 1 つのイベントをトリガーし、複数の条件フィールドが空白の場合は、[順序] フィールドの最大値を持つこれらの 1 つのイベントをトリガーします。 条件付きステートメント構文 参照してください。
-
順序付け
-
同じコントロールに関連付けられた複数のイベントを並べ替えるために使用される整数。 これは負以外の数値である必要があります。 このフィールドは空白のままにすることができます。
備考
EventMapping テーブル には、コントロール イベントをサブスクライブするコントロールが一覧表示され、そのイベントが別のコントロールまたはインストーラーによって発行されたときに変更されるコントロール属性が一覧表示されます。
Windows XP 以前のオペレーティング システムでは、ユーザーは チェックボックス コントロール または プッシュ ボタン コントロールを操作することによってのみコントロール イベントを発行できます。 Windows Server 2003 では、ユーザーは、のチェック ボックス コントロールの、SelectionTree コントロール、および プッシュ ボタン コントロールを操作することによってのみ、コントロール イベントを発行できます。 Control_ フィールドに他のコントロールを一覧表示しても効果はありません。
検証