コンポーネントの動作式 (実験段階)
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
重要
これは実験段階の機能です。 詳細については、実験的機能とプレビュー機能 を参照してください。
イベントがコンポーネント インスタンスの変更をトリガーしたときに実行される、動作の数式 を 1 つ以上指定します。
たとえば、コンポーネントの OnReset プロパティを、初期化を行い入力をクリアする 1 つ以上の数式に設定します。 Reset 関数がコンポーネント インスタンスで実行するときに、値をリセットします。
注意
カスタム動作プロパティを作成する機能は現在実験段階です。 ただし、運用環境のすべてのコンポーネントで使用可能な既定の OnReset プロパティを使用できます。
OnReset
コンポーネント マスターを選択して、プロパティのドロップダウン リスト (数式バーの左側) の OnReset を選択し、1 つ以上の数式を入力します。
OnReset をテストするには、コンポーネントをリセットするためのコントロールを構成します。 たとえば、この式のボタンの OnSelect プロパティ: リセット (ComponentName)。
例 - タイマーをリセットする
この時間ピッカー コンポーネントでは、時間 _selectedHour および _selectedMinute を表示するために 2 つの変数が使用されます。 ピッカーがリセットされると、これらの変数は既定値は、たとえば 12: 12 にリセットされます。コンポーネントの OnReset プロパティの数式は次のとおりです: Set(_selectedHour,12); Set(_selectedMinute,12)
リセットをトリガーするには、画面に移動してコンポーネントのインスタンスを挿入します。 ボタンを追加し、OnReset をトリガーするのに リセット (TimerComponent_instance) を呼び出すため、ボタンの OnSelect を構成します。
カスタム プロパティを使用して OnReset を更新する
コンポーネントの外部からコンポーネント インスタンスをリセットする以外に、内部から OnReset をトリガーする別のメソッドがあります。 "値が変化するときに OnReset を発生させる"は、カスタム入力プロパティを作成するときのオプションです。 コンポーネントの OnReset をトリガーするのに、このプロパティの値を変更できます。 このメソッドは、既定値を簡単に設定およびリセットするように設計されています。
例
上記の例は、受注番号の確認および番号の更新を示します。 数値の上下コンポーネントは、受注数を増減するために使用されます。 左側のギャラリーを選択すると、選択したツールの受注番号を表示するため、数値の上下コンポーネントの既定の数がリセットされます。 値が変化するときに OnReset を発生させるは、入力が変更するときに既定値をリセットできるようにしました。
これを行うには、既定のプロパティの 値が変化するときに OnReset を発生させるを確認します。 コンポーネントの OnReset は Set(_numericValue,'Numeric up down'.DefaultValue) に設定します。 _numericValue は、現在の受注値の値を格納する変数です。 テキスト入力コントロールの既定を、If(IsBlank(_numericValue), 'Numeric up down'.DefaultValue, _numericValue) に設定します。
参照
- キャンバス コンポーネント
- コンポーネント ライブラリ
- コンポーネント ライブラリ アプリケーション ライフサイクル管理 (ALM)
- コンポーネントの動作の数式
- Power Apps component framework
- モデル駆動型アプリのカスタム ページにキャンバス コンポーネントを追加する
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。