プロパティのいずれかを設定して、コントロールの見た目と動作を構成します。 コントロールの種類ごとに、さまざまなプロパティのセットがあります。 一部のプロパティ (高さ や 幅 など) はほぼすべての種類のコントロールで共通ですが、他のプロパティ (OnSelect など) は、コントロールの 1 つの種類に固有のものです。
コントロール
ボタン – クリック時に Power Fx を実行するボタン要素。
ボタン セット – ボタン要素のセットのコンテナー。
チェック ボックス – ユーザーが選択または選択解除の 2 つのオプションから選択できるようにするチェック ボックス。
列 - 他の要素のコンテナーとして機能する個々の列。
列セット - 列のコレクションで、各列はコンテナーです。
コンテナー - 他の要素のコレクション。
日付の選択 – ユーザーが日付を選択するためのフィールド。
ドロップ ダウン – ユーザーが展開可能な項目の一覧から 1 つの項目を選択できるメニュー。
ファクト セット – ファクトのコンテナー要素。
画像 – 画像の外観を制御するプロパティを持つ画像。
画像セット – フォト ギャラリーとして機能する画像のコンテナー。
メディア – URI と MimeType で指定されたビデオまたは画像。
番号入力 – ユーザーが数値を入力するためのフィールド。
テーブル – 行と列に最適にレイアウトされた表形式のデータまたは構造化情報を表示します。
テキスト入力 – ユーザーがテキストを入力するためのフィールド。
テキスト ラベル – テキストの外観を制御するプロパティを持つテキストのブロック。
時間選択 – ユーザーが時間を選択するためのフィールド。
すべてのプロパティ
A
Alt テキスト – 画像、オーディオまたはビデオを説明する代替テキスト。
関連付けられた入力 - どの入力をアクションに関連付けるかを制御します。
B
背景色 – 透明な画像に背景を適用します。 このプロパティは画像スタイルを考慮します。
背景画像 – 背景画像を指定します。 許容できるフォーマットは PNG、JPEG および GIF です。
ブリード – コントロールが親のパディングを通してブリードされるかどうかを決定します。
C
選択肢 - ユーザーが選択できる項目の一覧。
色 – テキストの色を制御します。
コンテンツの配置 – コンテンツを列内で垂直方向に配置する方法を定義します。
D
規定値 – プロパティの初期値。
区切り線 – true の場合、コントロールの上部に区切り線を描画します。
E
エラー メッセージ – 入力した内容が無効な場合に表示するエラー メッセージ。
F
ファクト - ファクト セットに表示するファクト。
フォントの種類 – レンダリングに使用するフォントの種類
H
高さ – プロパティの高さを指定します。
水平方向の配置 – 水平方向の配置をコントロールします。
I
IconUrl - タイトルの横のボタンに表示されるオプションのアイコン。 バージョン 1.2 以降のデータ URI をサポートします。
画像サイズ – 各画像の目安の大きさを制御します。 物理的な寸法はホストごとに異なります。 画像セットでは自動とストレッチはサポートされていません。 これらの値が設定されている場合、サイズはデフォルトで中になります。
InlineAction – 入力に対するインライン アクション。 通常、入力の右に表示されます。 アクションにアイコンを提供することをお勧めします (アクションのタイトルの代わりに表示されます)。
最初は表示可能 – 'false' の場合、この項目はビジュアル ツリーから削除されます。
L
ラベル – 入力のラベル。
M
最大長 – 収集する文字の最大長のヒント (クライアントによっては無視される場合もあります)。
最大行数 – 表示する最大行数を指定します。
最大値 – 最大値のヒント (クライアントによっては無視される場合もあります)。
最小の高さ – 列セットの最小高さをピクセル単位で指定します ("80 px" など)。
最小値 – 最小値のヒント (ライアントによっては無視される場合もあります)。
モード – カード要素間の階層を確立するために、モードをプライマリまたはセカンダリとして定義できます。
複数行 – true の場合、複数行を入力できます。
複数の選択肢 – 複数項目の選択を許可します。
O
OnSelect - ユーザーがボタンをタップまたはクリックしたときに実行するアクション。
P
プレースホルダー – 希望する入力内容の説明。 選択されていない場合に表示されます。
ポスター – 再生前に表示する画像の URL。 バージョン 1.2 以降のデータ URI をサポートします
右から左に表示 – 有効にすると、コンテナ内のコンテンツが右から左に表示されます。 無効にすると、このコンテナ内のコンテンツは左から右に表示されます。 設定を解除すると、レイアウト方向は親コンテナまたは親列から継承されます。 すべての先祖で設定されていない場合、デフォルトのプラットフォーム動作が適用されます。
R
正規表現 – このテキスト入力の必須形式を示す正規表現。
すべてに対して繰り返す – すべてに対して繰り返すは、データ ソース に基づいてコントロールを複数回表示するために使用されます。 すべてに対して繰り返すプロパティがコレクションまたはデータ ソースに設定されている場合、関連するプロパティは ThisItem
を使用してコレクションまたはデータ ソース内の特定の項目を参照できます。
Dataverse Accounts テーブルとテキスト ラベルの Repeat for each プロパティを使用することで、作成者は、アカウントテーブル中のすべてのアカウントのアカウント名を表示するカードを作成できます。
- Dataverse 接続を使用してアカウント テーブルを追加する
- テキスト ラベル コントロールを追加します。
- テキスト ラベルすべてに対して繰り返すプロパティを
Accounts
に設定します。 - テキスト ラベルのテキスト プロパティを
ThisItem.'Account Name'
に設定します。 - カードを再生すると、アカウント テーブルの長さ分のテキスト ラベルのリストが表示され、それぞれにアカウント名が表示されます。
必須フィールド – この入力が必須かどうか。
S
画面 - ユーザーが「画面の表示」のボタンをタップまたはクリックしたときに現在のカードの下に表示される画面。
グリッド ラインの表示 – グリッド ラインを表示すべきかどうかを指定します。
表示条件 – 条件付きレイアウト式。
サイズ – 画像またはテキストのサイズを制御します。
ソース - 再生するメディア コンテンツ。 既定で指定された最初のものを再生します。
間隔 – このコントロールと直前のコントロールの間に確保する間隔を制御します。
スタイル - コントロールのスタイルを決定します。
目立たせない – true の場合、テキストの表示が少しトーンダウンして目立たなくなります。
T
ターゲット要素 - ユーザーが「可視性の切り替え」タイプのボタンをタップまたはクリックしたときにその可視性を変更する要素。
テキスト – 表示するテキスト。 マークダウンのサブセットがサポートされています (https://aka.ms/ACTextFeatures)。
タイトル - このボタンのラベル。
Tooltip - エンド ユーザーがアクションの上にマウスを置いたときに表示され、ナレーション ソフトウェアを使用するときに読み上げられるテキストを定義します。
タイプ – 選択時にボタンが実行するアクション - 画面の表示、Power Fx の実行、URL を開く、可視性の切り替えのいずれかです。
U
URL – 画像への URL、またはボタンが選択されたときに開く URL。 バージョン 1.2 以降のデータ URI をサポートします。
V
値 – 選択されるべき初期項目 (または一連の項目)。 複数選択の場合は、カンマ区切り文字列値を指定します。
W
太さ – テキストの太さを制御します。
幅 – プロパティの幅を指定します。
折り返し – true の場合、テキストを折り返すことができます。 それ以外の場合、テキストは切り取られます。