表示フォームまたは編集フォーム コントロールの 1 つのフィールドの 表示 および 編集 エクスペリエンスを提供します。
Description
フォームの表示 コントロールと 編集フォーム コントロールは、レコード全体を表示および表示するためのコンテナーとして機能します。 各コンテナーには、 個々のフィールド を表示したり、それらのフィールドを更新したりするカード コントロールのセットを保持できます。 各カードには、処理するレコードのフィールドを指定する DataField プロパティがあります。
定義済みのカードは、さまざまなデータ型とユーザー エクスペリエンスに対して定義されます。 たとえば、 テキスト入力 コントロールを使用して数値フィールドを編集するカードがあるとします。これは、キーボードで使用するのに最適です。 別のカードでは、 代わりに Slider コントロールを使用して数値を編集できます。 フォーム コントロールを選択すると、右側のウィンドウでフィールドに基づいてカードを簡単に選択できます。
カード自体にはコントロールが含まれています。 カードのコントロールは、1 つのフィールドを表示および編集するためのエクスペリエンスを構成します。 たとえば、数値カードは、フィールドの表示名を指定する ラベル コントロールと、フィールドの値のエディターを提供する テキスト入力 コントロールで構成される場合があります。 カードには、発生した検証エラーを示す Label コントロールと、フィールドが必要であることを示す共通アスタリスクの ラベル コントロールが含まれている場合もあります。
定義済みのカードのコントロールをカスタマイズするには、サイズ変更、移動、非表示、コントロールの追加、その他の変更を行います。 また、最初からコントロールを追加する完全に空白のカード、"カスタム カード" から始めることもできます。
定義済みのカードは既定で ロック されます。 ロックされたカードでは、カードの特定のプロパティまたはカード内のコントロールのみを変更でき、ロックされたカードを削除することはできません。 カード ロックを表示し、[詳細] ビューの [表示] タブでロックを解除できます。 プロパティがロックされていて変更できない場合は、名前の横にロック アイコンが表示されます。 カードのロック解除は高度なアクティビティであり、カードに対して数式の自動生成が行われなくなり、カードを再ロックできないため、注意して行う必要があります。
フォームのコンテナー内では、 ThisItem レコードを使用でき、レコードのすべてのフィールドが含まれます。 たとえば、カードの Default プロパティは、多くの場合 、ThisItem に設定されます。FieldName。
親参照を使用して、カードのプロパティを参照するコントロールを構成できます。 たとえば、コントロールは Parent.Default を使用して、データ ソースからフィールドの初期状態を読み取る必要があります。 必要な情報に直接アクセスする代わりに Parent を使用することで、カードをより適切にカプセル化し、内部数式を壊さずに別のフィールドに変更できます。
カードをカスタマイズ、ロック解除、作成する方法の例については、「 データ カードについて」 を参照してください。
重要なプロパティ
DataField – このカードが表示および編集するレコード内のフィールドの名前。
- 数式ではなく、二重引用符 (" Name" など) で囲まれた単一の静的文字列として名前を指定します。
- DataField プロパティを空白に設定して、カードのバインドを解除します。 非連結カードの 場合、Valid プロパティと Update プロパティは無視されます。
既定値 – ユーザーによって変更される前のコントロールの初期値。
- カード内の各コントロールについて、このプロパティを Parent.Default に設定して、データ ソースに従ってフィールドの既定値を参照します。 たとえば、スライダーの Default プロパティを Parent.Default に設定して、ユーザーがそのスライダーのジェネリック値で開始されるようにします。
DisplayMode – 値は 、編集、表示、 または 無効にすることができます。 カード内のコントロールでユーザー入力 (編集) を許可するか、データのみを表示 (表示) するか、無効 (無効) にするかを構成します。
- フォームの動作に既定で関連付けられているこのプロパティを構成することで、編集フォームとビュー フォームの両方で 1 つのカードを使用できるようにします。
- 表示モードでは、テキスト入力、ドロップダウン、日付ピッカーなどの子コントロールはテキスト値のみを表示し、対話型の要素や装飾はレンダリングしません。
DisplayName – データ ソース内のフィールドのユーザー フレンドリ名。
- DataSourceInfo 関数は、データ ソースからこのメタデータを提供します。
- カード内のコントロールでは、 Parent.DisplayName を使用してフィールドの名前を参照する必要があります。
エラー – 検証が失敗したときにこのフィールドに表示するわかりやすいエラー メッセージ。
- このプロパティは、 SubmitForm が呼び出されたときに設定されます。
- このメッセージは、データ ソースのメタデータに基づいて検証の問題を説明し、カードの Required プロパティを確認します。
必須 – データ ソースのフィールドを編集するカードに値を含める必要があるかどうか。
- DataSourceInfo 関数は、データ ソースから必要なメタデータを提供します。
- カード内のコントロールでは、 Parent.Required を使用して、そのカードのフィールドが必要かどうかを判断する必要があります。
更新 – フィールドのデータ ソースに書き戻す値。
- このプロパティの数式を使用して、カードの編集コントロールから値を取得し、データ ソースに書き戻します。 たとえば、カードの Update プロパティを Slider.Value に設定して、そのカードのスライダーの値でデータ ソースを更新します。
幅 – コントロールの左端と右端の間の距離。
WidthFit – フォーム コントロールの 編集 など、コンテナー コントロール内の空き領域を埋めるためにコントロールが自動的に水平方向に拡大するかどうかを指定します。 複数のカードにこのプロパティが true に設定されている場合、スペースはそれらの間で分割されます。 詳細については、「 データ フォームのレイアウトについて」を参照してください。
追加のプロパティ
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
塗りつぶし – コントロールの背景色。
Height – コントロールの上端と下端の間の距離。
有効 – カード または 編集フォーム コントロールに有効なエントリが含まれているかどうか、データ ソースに送信する準備ができています。
表示 – コントロールが表示されるか非表示になっているか。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。 複数の列を持つコンテナー内の Card コントロールの場合、このプロパティによってカードが表示される列が決まります。
Y – コントロールの上端と親コンテナーの上端との間の距離 (親コンテナーがない場合は画面)。 複数の行を持つコンテナー内の Card コントロールの場合、このプロパティによってカードが表示される行が決まります。
例示
例については、「 データ カードを理解 する」と 「データ フォームのレイアウトを理解 する」を参照してください。
アクセシビリティ ガイドライン
色のコントラスト
次の間に適切な色のコントラストが必要です。
- 塗りつぶし と子コントロール。 たとえば、カードに ラベル が含まれており、ラベルに透明な塗りつぶしがある場合、カードの 塗りつぶし はラベルの背景色になります。 したがって、カードの 塗りつぶし とラベルの 色の間には十分なコントラストが必要です。
スクリーン リーダーのサポート
- DisplayName が存在する必要があります。