.xaml ファイルの構成

Data Standard の .xaml ファイルは、Data Standard ダイアログを作成する基本コンポーネントで構成されます。基本コンポーネントには、グリッド(Grid)、コンボボックス(ComboBox)、ラベル(Label)、テキストボックス(TextBox)、ボタン(Button)などがあります。オートデスクでは、これらのコンポーネントを理解してから、独自の Data Standard ダイアログをカスタマイズまたは作成することをお勧めします。

注: これらのコンポーネントの多くは、このトピックで説明する内容よりも複雑なパラメータがあります。このトピックでは、これらのコンポーネントの基本的な動作を中心に説明します。

グリッド(Grid)

グリッド(Grid)は、行と列の表構造のすべてをコントロールするレイアウトパネルです。セルは、行と列の組み合わせで一意になります。すべてのセルには、ラベルやテキストボックスなどのコントロールを複数含めることができます。

これがグリッドの基本構造です。グリッドには、Grid.RowDefinition 部で定義する複数の行が必要ですHeight の値を 30 に指定した場合、高さの値が固定され、指定後は変更できません。値を "auto" に指定した場合、行の高さが動的になり、コントロールに応じて、厚くなったり薄くなります。同じ値が列の幅に適用されます。

コントロール

行と列を定義したら、ラベルやテキストボックスなどのコントロールを追加できます。コントロールは、Grid.Column と Grid.Row の 2 つのプロパティでアタッチする必要があります。これらのプロパティは、グリッド内のコントロールの位置を定義します。最初の行には 0、2 番目の行には 1 というように順次指定します。

次の要素はすべてコントロールです。

ラベル(Label)
ラベル(Label)は、編集不可の単純なフィールド名です。ラベルには、何のラベルかを示すテキストを指定します。このテキストを基に、ユーザは対応するテキストボックスやコンボボックスにどのようなタイプの値を挿入する必要があるかを把握できます。たとえば、Comments というラベルを空のテキストボックスの横に配置したとします。この場合、ユーザはテキストボックスにコメントを入力することを把握できます。

Label には Content プロパティがあります。このプロパティは、ラベルに表示するテキストです。
```
<Label Grid.Row ="0" Grid.Colum="0" Content="sample" />
```
テキストボックス(TextBox)
テキストボックス(TextBox)は編集可能なフィールドです。ユーザはテキストボックスに何らかの値を入力できます。Data Standard は入力値を読み取り、他の処理に使用することができます。
テキストボックスでは次のプロパティが必要です。
- Text: テキストボックスにサンプルとして表示する初期テキストです。content="Enter Comments Here" と記述した場合、テキストボックスには最初に "Enter Comments Here" が表示され、空になりません。
- Name: 要素を識別する名前を取得または設定します。この名前は参照として機能し、イベントハンドラコードなどのコードビハインドは要素を参照できるようになります。
```
<TextBox Grid.Row="0" Grid.Column="0" Text="{Binding Prop[State].Value}" Name="testtextfield" />
```
コンボボックス(ComboBox)
コンボボックス(ComboBox)は、編集不可のフィールドですが、ユーザは既存のオプションの一覧から値を直接選択することができます。設定すると、この値を抽出して後で処理することができます。
コンボボックスでは次のプロパティが必要です。
- Itemsource: ユーザが選択できる値の一覧をコントロールで取得する場所を宣言します。
- Text: コンボボックスにサンプルとして表示する初期テキストです。content="United States" と記述した場合、コンボボックスの既定のオプションが "United States" になり、コンボボックスに表示されます。
- Name: 要素を識別する名前を取得または設定します。この名前は参照として機能し、イベントハンドラコードなどのコードビハインドは要素を参照できるようになります。
```
<ComboBox Name="MaterialCombo" Text="{Binding Prop[Cost].Value}" Grid.Column="3" Grid.Row="6" ItemsSource="{Binding Prop[Cost].ListValues}"/>
```
ボタン(Button)
ボタン(Button)は、ユーザが検索や保存などのイベントを簡単にトリガできるユーザインタフェース要素です。

ボタンでは Command プロパティが必要です。このプロパティは、ボタンがトリガされたときにどのアクションが実行されるかを識別します。

バインド

これらのコンポーネントのいずれかを使用して、Vault のファイルプロパティを変更するには、"{Binding Prop[cost].Value}" を理解する必要があります。バインドを行うことで、Vault のファイルプロパティに含める値をマッピングできます。たとえば、テキストボックスのテキストを Vault の Cost プロパティにバインドした場合、このテキストボックスに何かの値が入力されるたびに、Vault で Cost プロパティが自動的に更新されます。バインドは、プロパティの変更を自動化する優れた方法です。このため、エンドユーザが行う作業も少なくなります。

Prop [ ]

Prop[ ]は、バインドに不可欠な関数です。この関数を使用すると、Vault 内のファイルのプロパティにアクセスできます。たとえば、テキストボックスを Engineer プロパティにマッピングする場合は、<TextBox text="{Binding Prop[Engineer].Value}"/> と記述します。テキストボックスが作成されると、Prop[ ]はこのプロパティの値を返します。テキストボックスが更新されるたびに、マッピングされているファイルプロパティに新しい値が記述されたことが Prop[ ]関数に通知されます。