selectedIndexItem

selectedIndexItem プロパティーは、配列を含む VGUIRecord フィールドに適用されます。 このプロパティーの値は、選択された索引項目 という名前です。これは、 もう 1 つの VGUIRecord フィールドであり、その値は以下の 2 つのランタイム処理の外観を示します。
  • Web ページが表示されるときに、コントロール (チェック・ボックスなど) が事前選択されているかどうか
  • ユーザーがコントロールを選択したかどうか

プロパティーが参照するフィールドは、NUM 型でなければならず、 小数点以下の桁を持つことはできませんが、配列型とすることはできます。

以下の場合を考えてください。
  • VGUI レコード・フィールドが配列であり、配列ではないフィールド (選択された索引項目) を参照する selectedIndexItem プロパティーを持つ
  • uiType プロパティーが input または inputOutput

このケースでは、生成される Web ページは、ユーザーが値を 1 つだけ選択できるラジオ・ボタンを含みます。 選択された索引項目は、番号でラジオ・ボタンを識別し、番号 1 は最初のラジオ・ボタンを意味します。

同じケースにおいて選択された索引項目が配列の場合、生成される Web ページは一連のチェック・ボックスを含み、以下の事柄が該当します。
  • データが表示用に準備される際に、配列には、事前選択のとおりに設定されるエントリーの索引が含まれます。
  • データが戻されるとき、配列にはユーザーが選択したエントリーの索引が含まれます。 例えば、ユーザーが、索引 1、3、および 5 で表示エントリーを選択した場合、配列の最初の要素は 1 を、2 番目の要素は 3 を、3 番目は 5 を含み、残りは 0 を含みます。
uiType プロパティーが output の場合、生成される HTML は異なります。
  • 選択された索引項目が配列ではない場合、生成される Web ページは、太字体で表示されるラベルと、ユーザーが値を 1 つ選択できる HTML <SELECT> 構造 (ドロップダウン・リストとして表示されます) から成る一組の構造を含みます。 例えば、選択された索引項目が 2 という値を持つ場合、2 番目のエントリーが事前選択されます。
  • 選択された索引項目が配列の場合、生成される Web ページは同様のペア構造を含みますが、ユーザーは複数の値を選択できます。 選択された索引項目の最初の要素の値が 1 で、要素 2 の値が 3 の場合、ブラウザーはドロップダウン・リストを表示し、最初と 3 番目のエントリーが事前選択されます。