トリガーリファレンス¶
ここでは、Kanzi Studio で使用できるトリガーのリファレンスを見つけることができます。トリガーについて詳しくは、トリガーの使用 をご覧ください。
アクティビティトリガー¶
Kanzi Studio でアクティビティノードを使用して、アクティビティのステータスが変化したときに反応するアクティビティトリガーを使用できます。例えば、特定のアクティビティがアクティブになったときに、アプリケーションを特定の状態に設定することができます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Activated |
Activated トリガーは、アクティビティがアクティブ化されたときに発動します。 |
Activating |
Activating トリガーは、アクティビティがアクティベーション状態にあるときに作動します。 |
Deactivated |
Deactivated トリガーは、アクティビティが非アクティブ化されたときに発動します。 |
Deactivating |
Deactivating トリガーは、アクティビティが非アクティブ化状態にあるときに発動します。 |
Status Changed |
Status Changed トリガーは、アクティビティの Activity Status プロパティの値が変化したときに発動します。 |
アクティビティとアクティビティホストの使用方法の詳細については、次を参照してください:
アクティビティホストトリガー¶
Kanzi Studio でアクティビティホストトリガーを使用して、アクティビティのプレハブがノードツリーにアタッチされたときに反応することができます。例えば、特定のアクティビティホストがその特定の子アクティビティのプレハブをノードツリーにアタッチしたときに、アプリケーションを特定の状態にするよう設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Activity Prefab Attached |
Activity Prefab Attached トリガーは、アクティビティホストがアクティビティのプレハブをアタッチしてアクティビティをアクティブ化したときに発動します。 |
Activity Prefab Detached |
Activity Prefab Detached トリガーは、アクティビティホストが非アクティブ化されたアクティビティのプレハブをアタッチしたときに発動します。 |
アクティビティとアクティビティホストの使用方法の詳細については、次を参照してください:
アニメーションのトリガー¶
アニメーショントリガーをアニメーションと共に使用できます。例えば、アニメーションの再生が終了したときに、アプリケーションを Page にナビゲートしたり、ステートに入るように設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Completed |
Completed トリガーは、Animation Player がアニメーションを最後まで再生したときに送信するメッセージをインターセプトします。 |
Started |
Started トリガーは、アニメーションの再生を開始する際に Animation Player が送信するメッセージをインターセプトします。 |
Stopped |
Stopped トリガーは、アニメーションの再生を停止したときに Animation Player が送信するメッセージをインターセプトします。 |
キーフレームアニメーションの作成の詳細については、次を参照してください:
Property Driven Animation Player の使用方法について詳しくは、プロパティ駆動のアニメーションを作成する をご覧ください。
フォーカストリガー¶
フォーカストリガーを使用して、アプリケーション内のUI要素がフォーカスを受け取る方法を処理できます。例えば、ユーザーがオーバーレイを開いたときに、そのオーバーレイがユーザー入力にどのように反応するかを設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
About To Gain Focus |
About To Gain Focus トリガーは、このトリガーを追加したノードがフォーカスを受け取る前に発動されます。 |
About To Lose Focus |
About To Lose Focus トリガーは、このトリガーを追加したノードがフォーカスを失う前に発動されます。 |
Focus Entered Focus Scope |
Focus Entered Focus Scope トリガーは、フォーカススコープ内のノードがフォーカスを受け取ると、そのフォーカススコープノードに設定されます。 |
Focus Gained |
Focus Gained トリガーは、このトリガーを追加したノードがフォーカスを受け取ったときに発動します。 |
Focus Left Focus Scope |
Focus Left Focus Scope トリガーは、フォーカススコープ内のノードがフォーカスを失ったときに、そのフォーカススコープノードに設定されます。 |
Focus Lost |
Focus Lost トリガーは、このトリガーを追加したノードがフォーカスを失ったときに発動します。 |
Input Outside Overlay |
Input Outside Overlay トリガーは、そのオーバーレイの外で入力が発生したときに最前面のオーバーレイフォーカススコープに設定されます。 |
Overlay Brought To Front |
Overlay Brought To Front トリガーは、オーバーレイフォーカススコープが前面に表示され、そのスコープがフォーカスを受け取るときに発動されます。 |
Overlay Gained Focus |
Overlay Gained Focus トリガーは、オーバーレイ内のノードがフォーカスを受け取ると、オーバーレイフォーカススコープノードに設定されます。 |
Overlay Lost Focus |
Overlay Lost Focus トリガーは、オーバーレイ内のノードがフォーカスを失ったときに、オーバーレイフォーカススコープノードに設定されます。 |
Overlay Sent To Back |
Overlay Sent To Back トリガーは、オーバーレイフォーカススコープが背面に送られてそのスコープがフォーカスを持たないようにする場合に発動されます。 |
フォーカストリガーの使用方法について詳しくは、フォーカスの使用 を参照してください。
一般的なトリガー¶
Kanzi Studio の一般的なトリガーを使用して、ノードがノードツリーに接続されたとき、プロパティ値が変更されたとき、または特定の時間間隔で反応するように任意のノードと組み合わせることができます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Data Trigger |
Data Trigger はプロパティとデータソースの値の変化を監視します。Data Trigger を使用して、Apply Property Action を持つターゲットノードのプロパティ値を適用したり、Apply Activation Action を持つ Activity ノードをアクティブにしたりします。データトリガーの詳細については、データトリガー と Apply Activation Action でアクティビティをアクティブ化する を参照してください。 |
On Attached |
Kanzi がノードをノードツリーにアタッチすると、On Attached トリガーが発動します。 |
On Property Change |
On Property Change トリガーは、設定したプロパティの値が変更されたときに発動します。 |
On Timer |
On Timer トリガーは、トリガーで設定した時間間隔の間に発動されます。 |
入力マニピュレータトリガー¶
入力マニピュレータトリガーを使用して、ジェスチャーやタッチイベントなどのユーザー入力を処理できます。入力マニピュレータトリガーを使用して、ユーザー入力をUIコンポーネントやアプリケーション機能にバインドします。
Hit Testable プロパティが有効になっているノードのみが入力を受け取ることができます。ノードにクリックジェスチャーを有効にする を参照してください。
入力マニピュレータトリガーについて詳しくは、ユーザー入力の処理 を参照してください。
Click Manipulator トリガー¶
Click Manipulator トリガーを使用して、クリックジェスチャーに反応します。たとえば、ユーザーがそのノードをクリックしたときにノードの外観を変更することができます。
Click Manipulator トリガーは、Button や Toggle Button ノードのようにデフォルトで入力を処理するノードでは使用できません。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Click |
Click トリガーは、ユーザーがノードを押している間にノード領域内にポインターがある状態でリリースし、Kanzi が他のジェスチャーを認識しない場合に発動されます。 |
Begin |
Begin トリガーは、ユーザーがノードを押したときに発動します。 |
Cancel |
Cancel トリガーがオフになりました。
|
Enter |
Enter トリガーが発動されました。
|
Leave |
Leave トリガーがオフになりました。
|
Click Manipulator の使用方法について詳しくは、Click Manipulator を使用する をご覧ください。
Drag-And-Drop Manipulator トリガー¶
Drag-And-Drop Manipulator トリガーを使用して、ドラッグアンドドロップジェスチャーに反応します。たとえば、ユーザーがそのノードをドラッグアンドドロップしたときにノードの外観を設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Drag and Drop Canceled |
Drag and Drop Canceled トリガーは、ドラッグアンドドロップジェスチャー中にフォーカスがノードから外れると発動します。 |
Drag and Drop Finished |
Drag and Drop Finished トリガーは、ユーザーがドラッグアンドドロップジェスチャーを指を離すかマウスボタンを放すことで終了したときに発動します。 |
Drag and Drop Moved |
Drag and Drop Moved トリガーは、ユーザーがドラッグアンドドロップジェスチャーでノードをドラッグしたときに発動します。 |
Drag and Drop Started |
Drag and Drop Started トリガーは、ユーザーがノードを十分に長く押して、入力マニピュレーターがドラッグアンドドロップジェスチャーを認識したときに発動します。 |
Drag-And-Drop Manipulator の使用方法の詳細については、次を参照してください:
Key Manipulator トリガー¶
Key Manipulator トリガーを使用して、キーボードとのインタラクションを作成できます。たとえば、ユーザーがキーボードの特定のキーを押したときに、アプリケーションを Page ノードに移動させたり、ノードにフォーカスを設定したりすることができます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Key Canceled |
Key Canceled トリガーは、ユーザーがキー押下ジェスチャーをキャンセルしたときに発動します。 |
Key Pressed |
Key Pressed トリガーは、ユーザーがキーボードの特定のキーを押したときに作動します。 |
Key Released |
Key Released トリガーは、ユーザーがキーボードの特定のキーを離したときに発動します。 |
Key Manipulator トリガーの使用方法について詳しくは、Key Manipulator を使用する を参照してください。
Long-Press Manipulator トリガー¶
Long-Press Manipulator トリガーを使用して、長押しジェスチャーに反応します。たとえば、ユーザーがそのノードをクリックしてそのトリガーで設定された時間だけクリックを保持すると、ノードの外観を変更することができます。
Long-Press Manipulator トリガーは、デフォルトで入力を処理するノード、例えば Button や Toggle Button ノードでは使用できません。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Long Press |
Long Press トリガーは、ユーザーがノードエリアで押し下げ、500ミリ秒またはそのノード内の Long-Press Manipulator の Long Press Duration プロパティで設定されたミリ秒数だけノードを押し続けたときに発動されます。 |
Long Press Cancel |
Long Press Cancel トリガーは、ロングプレスジェスチャー中にフォーカスがノードから外れると発動します。 |
Long-Press Manipulator の使用方法の詳細については、参照してください。
Multi-Click Manipulator トリガー¶
Multi-Click Manipulator トリガーを使用して、マルチクリックジェスチャーに反応します。たとえば、ユーザーがノードを連続して複数回クリックしたときに、そのノードの外観を変更することができます。
Multi-Click Manipulator トリガーは、デフォルトで入力を処理するノード、例えば Button や Toggle Button ノードでは使用できません。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Intermediate Click |
Intermediate Click トリガーは、ユーザーが目的のクリック数に達する前にマルチクリックジェスチャー中にノードエリアをクリックしたときに発動されます。 |
Multi-Click |
Multi-Click トリガーは、ユーザーがノードエリアを複数回クリックしたときに発動します。 |
Multi-Click Canceled |
Multi-Click Canceled トリガーは、マルチクリックジェスチャー中にフォーカスがノードから外れると発動します。 |
Multi-Click Manipulator の使用方法の詳細については、次を参照してください:
Pan Manipulator トリガー¶
Pan Manipulator トリガーを使用して、パンジェスチャーに反応します。たとえば、ユーザーがそのノードをパンしたときにノードの外観を設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Pan Canceled |
Pan Canceled トリガーは、パンジェスチャー中にフォーカスがノードから外れると発動します。 |
Pan Entered |
Pan Entered トリガーは、パンジェスチャーがノードに入ると発動します。 |
Pan Finished |
Pan Finished トリガーは、ユーザーがマウスボタンを離してパンジェスチャーを終了したときに発動します。 |
Pan Left |
Pan Left トリガーは、パンジェスチャーがノードを離れるときに発動します。 |
Pan Moved |
Pan Moved トリガーは、ユーザーがパンジェスチャーでノードを移動したときに発動します。 |
Pan Started |
Pan Started トリガーは、ユーザーがノードをクリックしたが、まだそのノードをドラッグしていないときに発動します。 |
Pan Manipulator の使用方法の詳細については、参照してください。
Pinch Manipulator トリガー¶
Pinch Manipulator トリガーを使用して、ピンチジェスチャーに反応します。たとえば、ユーザーがピンチジェスチャーを使用してノードをズームおよび回転させるときに、ノードの外観を設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Pinch Canceled |
Pinch Canceled トリガーは、ピンチジェスチャー中にフォーカスがノードから外れると発動します。 |
Pinch Finished |
Pinch Finished トリガーは、ユーザーが指を離してピンチジェスチャーを終了したときに発動します。 |
Pinch Moved |
Pinch Moved トリガーは、ユーザーがピンチジェスチャーでノードをズームまたは回転させたときに発動します。 |
Pinch Started |
Pinch Started トリガーは、ユーザーが2本の指でノードに触れたときに発動します。 |
Pinch Manipulator の使用方法の詳細については、次を参照してください:
List Box トリガー¶
List Box ノードでリストボックストリガーを使用できます。たとえば、ユーザーが List Box ノード内のアイテムを選択したときに、アプリケーションが Page に移動するように設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
List Box: Item Loaded |
List Box: Item Loaded トリガーは、リストボックス内のアイテムが作成され、ワーキングメモリにロードされたときに発動します。 表示されているアイテムの周囲で、一度にいくつのアイテムをワーキングメモリにロードしたままにするかを設定するには、Keep Alive Item Count プロパティを使用します。 |
List Box: Item Selected |
List Box: Item Selected トリガーは、ユーザーがリストボックス内のアイテムを選択したときに発動します。 |
List Box: Item Unloaded |
List Box: Item Unloaded トリガーは、リストボックス内のアイテムがワーキングメモリからアンロードされたときに発動します。 表示されているアイテムの周囲で、一度にいくつのアイテムをワーキングメモリにロードしたままにするかを設定するには、Keep Alive Item Count プロパティを使用します。 |
List Box: Scroll Finished |
List Box: Scroll Finished トリガーは、リストボックスのスクロールが終了したときに発動されます。 |
List Box: Scroll Started |
List Box: Scroll Started トリガーは、リストボックスのスクロールが開始されると発動します。 |
List Box: Scrolled |
List Box: Scrolled トリガーは、リストボックスがスクロールするたびに設定されます。 |
List Box: Target Changed |
List Box: Target Changed トリガーは、リストボックスのスクロールターゲットが変更されたときに発動します。 例えば、ユーザーがリストボックスアイテムを選択するとスクロールターゲットが変わり、リストボックスがそのアイテムをリストボックスエリアの中央に持ってくるようにスクロールします。 |
List Box: User Scroll Finished |
List Box: User Scroll Finished トリガーは、ユーザーがリストボックスのスクロールを停止したときに発動します。 |
List Box: User Scroll Started |
List Box: User Scroll Started トリガーは、ユーザーがリストボックスのスクロールを開始したときに発動されます。 |
List Box ノードの使用方法の詳細については、次を参照してください:
List Box ノードの使用例については、以下を参照してください。
Page Host トリガー¶
注釈
Page ノードと Page Host ノードは非推奨です。アプリケーションのナビゲーション可能な UI を構築するには、Activity ノードと Activity Host ノードを使用してください。アクティビティ を参照してください。
Page Host トリガーを Page Host ノードと一緒に使用します。例えば、Page Host ノードが Page にナビゲートを開始するときに、アプリケーションがある状態に入るように設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Page Navigation Finished |
Page Navigation Finished トリガーは、Page Host ノードがページへのナビゲーションを完了したときに発動します。 |
Page Navigation Started |
Page Navigation Started トリガーは、Page Host がページのナビゲートを開始するときに発動します。 |
Page ノードと Page Host ノードの使用方法の詳細については、次を参照してください:
Page トリガー¶
注釈
Page ノードと Page Host ノードは非推奨です。アプリケーションのナビゲーション可能な UI を構築するには、Activity ノードと Activity Host ノードを使用してください。アクティビティ を参照してください。
Page トリガーを Page ノードと一緒に使用します。例えば、Page ノードがアクティブ化されたときに、アプリケーションがノードにフォーカスを設定するように設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Page Activated |
Page Activated トリガーは、Page または Page Host ノードがアクティブになると発動します。 |
Page Deactivated |
Page Deactivated トリガーは、Page または Page Host ノードが非アクティブになると発動します。 |
Page ノードと Page Host ノードの使用方法の詳細については、次を参照してください:
プレハブトリガー¶
プレハブトリガーをプレハブと一緒に使用できます。プロジェクト内のプレハブからリソースを非同期でロードするには、Prefab View ノードを使用できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Asynchronous Load Completed |
Asynchronous Load Completed トリガーは、プレハブからのリソースの非同期読み込みが完了したときに発動されます。 |
プレハブを非同期でロードする方法について詳しくは、ノードプレハブの使用 をご覧ください。
プロパティターゲットインターポレータ (Property Target Interpolator) トリガー¶
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Easing Interpolation Completed |
Easing Interpolation Completed トリガーは、Property Target Easing Interpolator が補間するプロパティの値の補間を終了したときに送信するメッセージをインターセプトします。 イージング補間の完了に関する情報を取得する を参照してください。 |
Interpolation Completed |
Interpolation Completed トリガーは、Property Target Interpolator がプロパティの値の補間を完了したときに送信するメッセージをインターセプトします。 補間の完了に関する情報を取得する を参照してください。 |
Property Target Interpolator の使用方法について詳しくは、以下をご覧ください。
Property Target Easing Interpolator の使用方法について詳しくは、イージング関数を使用してプロパティ値を補間する をご覧ください。
レンジトリガー (Range triggers)¶
レンジトリガーは、レンジプロパティを使用するコンポーネントで使用できます。たとえば、ユーザーがスライダーの値を変更したときにアクションを起動するようにアプリケーションを設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Value Change Finished |
Value Change Finished トリガーは、範囲値の変更が完了したときに発動します。 |
Value Change Started |
Value Change Started トリガーは、範囲値が変化し始めると作動します。 |
Value Changed |
Value Changed トリガーは、範囲の値が変わると作動します。 |
Scroll View トリガー¶
Scroll View トリガーを Scroll View ノードと一緒に使用できます。たとえば、ユーザーがスクロールビューをスクロールし始めたり、スクロールを停止したときに、アプリケーションを特定の状態に移行させたり、プロパティの値を変更するように設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Scroll Ended |
Scroll Ended トリガーは、スクロールビューのスクロール位置の変更が完了したときに発動します。 |
Scroll Started |
Scroll Started トリガーは、スクロールビューのスクロール位置が変化し始めるときに発動します。 |
Scroll Zoomed |
Scroll Zoomed トリガーは、スクロールビューのズームレベルが変化したときに発動します。 |
Scrolled |
Scrolled トリガーは、スクロールビューのスクロール位置が変化したときに発動します。 |
Snap Request |
Snap Request トリガーは、スクロールビューがホスティングコンポーネントからスナッピングターゲットを要求したときに発生します。 |
User Scroll Ended |
User Scroll Ended トリガーは、ユーザーがスクロールビューのスクロールを停止したときに発動します。 |
User Scroll Started |
User Scroll Started トリガーは、ユーザーがスクロールビューのスクロールを開始したときに発動します。 |
Scroll View ノードの使用方法の詳細については、参照してください。
Scroll View ノードの使用例については、スクロールビューの例 を参照してください。
ステートマネージャーのトリガー¶
ステートマネージャートリガーをスーテートマネージャーと一緒に使用できます。例えば、ステートマネージャーがある状態に入るときにアプリケーションがアニメーションを再生するように設定できます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Entered State |
Entered State トリガーは、ステートマネージャーがステートに入るときに発動します。 |
Left State |
Left State トリガーは、ステートマネージャーがステートを離れるときに発動します。 |
Transition Finished |
Transition Finished トリガーは、ステートマネージャーがステート遷移を完了したときに発動されます。 |
Transition Started |
Transition Started トリガーは、ステートマネージャーがステート遷移を開始すると作動します。 |
ステートマネージャーの使用方法について詳しくは、ステートマネージャー (State Managers) を使用する場合 を参照してください。
Entered State と Left State トリガーについて詳しく知るには、ノードがステートに入るまたは離れるときに反応する を参照してください。
Text Box トリガー¶
Text Box トリガーを Text Box ノードと一緒に使用できます。例えば、ユーザーがそのノード内のテキストの編集を開始したときに、Text Box ノードの外観を設定することができます。
ネーム (Name) |
ディスクリプション (Description) |
|---|---|
Composition Text Changed |
Composition Text Changed トリガーは、テキスト入力マニピュレーターがユーザーが入力メソッドエディタ (IME) で生成したテキストを更新したときに発動されます。 |
Composition Text Committed |
Composition Text Committed トリガーがオフになりました。
|
Text Composition Canceled |
Text Composition Canceled トリガーがオフになりました。
|
Cursor Moved |
Cursor Moved トリガーは、ユーザーがカーソルを Text Box ノードに移動したときに発動します。 |
Editing Finished |
Editing Finished トリガーは、ユーザーがテキストコンテンツを変更した後に Text Box ノードが編集状態を離れるときに発動されます。 Text Box ノードで Edit Mode プロパティを Triggered に設定すると、Leave Editing State アクションを使用してこのトリガーをオフにすることができます。 |
Editing Started |
Editing Started トリガーは、ユーザーが Text Box ノードでテキストの編集を開始したときに発生します。 Text Box ノードで Edit Mode プロパティを Triggered に設定すると、Enter Editing State アクションを使用してこのトリガーをオフにすることができます。 |
Entered Editing State |
Entered Editing State トリガーは、Text Box ノードが編集状態に入ると発動します。 |
Left Editing State |
Left Editing State トリガーは、Text Box ノードが編集状態を離れるときに発動されます。 |
Input Method Action |
Input Method Action トリガーは、ユーザーが Text Box ノードでテキストを編集中に、画面上のキーボードのアクションボタンをタップしたときに発生します。 |
Input Method Available |
Input Method Available トリガーは、入力方法が Text Box ノードで利用可能になったときに発動します。 たとえば、オンスクリーンキーボードは、スクリーンに表示されたときに使用可能になります。 |
Input Method Unavailable |
Input Method Unavailable トリガーは、Text Box ノードでテキストを構成している入力方法が利用できなくなったときに発動されます。 たとえば、オンスクリーンキーボードは、ユーザーがそれを非表示にしたときに使用不可になります。 |
Selection Changed |
Selection Changed トリガーは、ユーザーが Text Box ノード内のテキスト選択を変更したときに発動します。 |
Selection Cleared |
Selection Cleared トリガーは、ユーザーが Text Box ノード内のテキストの選択を解除したときに発生します。 |
Selection Started |
Selection Started トリガーは、ユーザーが Text Box ノードでテキストの選択を開始したときに発動します。 |
Text Changed |
Text Changed トリガーは、ユーザーが Text Box ノード内のテキストを変更したときに発動します。 |
Text Box ノードの使用方法について詳しくは、Text Box ノードを使用する を参照してください。