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 番目のエントリーが事前選択されます。