Display-Selection

NAME、SIZE、および MULTIPLE の属性を持つ OPTION、SELECT などの HTML フォーム要素を生成し、ブラウザウィンドウにドロップダウンメニューやリストボックスのフォームの選択可能なリストを表示します。

FORM 要素は Webject によって自動的に生成されません。リストを正しく表示するには、例に示すように <FORM> および </FORM> タグを含めます。

<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="attribute"/>
  <ie:param name="ATTRIBUTE_VALUE" data="attribute_value"/>
  <ie:param name="GROUP_IN" data="group_name"/>
  <ie:param name="LEADER" data="leader_char"/>
  <ie:param name="LIST_HEADER" data="addl_item"/>
  <ie:param name="LIST_HEADER_VALUE" data="addl_item_value"/>
  <ie:param name="MULTIPLE" data="[TRUE | FALSE]"/>
  <ie:param name="NAME" data="name"/>
  <ie:param name="SELECTED" data="preselected_value"/>
  <ie:param name="SIZE" data="display_height"/>
  <ie:param name="WIDTH" data="element_width"/>
</ie:webject>

必須	選択	オプション
	LIST_HEADER	ATTRIBUTE
	LIST_HEADER_VALUE	ATTRIBUTE_VALUE
	MULTIPLE	GROUP_IN
	SELECTED	LEADER
		NAME
		SIZE
		WIDTH

生成する HTML OPTION 要素の値属性として使用されたり、表示する値として使用されたりする値を持つオブジェクト属性の名前を指定します。このオブジェクト属性の属性名は、生成する HTML SELECT 要素の名前値としても使用されます。

ATTRIBUTE_VALUE を指定すると、HTML SELECT 要素の名前値と HTML OPTION 要素の値属性がこのパラメータによって決まります。一方、HTML OPTION 要素によって表示される値は ATTRIBUTE によって指定される値を保持します。

このパラメータのデフォルトでは、すべての属性を使用して表示します。このパラメータには複数の値を指定できます。このパラメータはオプションです。

生成する HTML OPTION 要素では値属性として使用され、生成する HTML SELECT 要素では名前値として使用される値を持つ Webject 属性の名前を指定します。表示される値は ATTRIBUTE パラメータの値を保持します。

ATTRIBUTE パラメータを指定していない場合、ATTRIBUTE_VALUE パラメータによって、生成する HTML SELECT 要素の名前値と生成する HTML OPTION 要素の値属性が決定されます。一方、表示される値は ATTRIBUTE パラメータのデフォルト値によって異なります。

このパラメータのデフォルトでは、サブミットする値と表示する値の両方に同じ属性が使用されます。このパラメータはオプションです。

入力ソースとして使用するグループの名前を識別します。このグループは VDB グループまたは Context グループです。このパラメータのデフォルトでは、VDB で最後に定義されたグループを使用します。このパラメータはオプションです。

グループの詳細については、Info*Engine データ管理を参照してください。

複数の属性値間に配置する文字列値を指定します。width パラメータを指定しない場合は、LEADER 値が属性値間のセパレータになります。LEADER 値には 1 つまたは複数の文字が含まれます。幅を指定した場合、属性値が幅と等しくなるか、またはそれを超えるまで LEADER 値を使用して属性値を大きくします。このパラメータのデフォルトは "_" です。このパラメータはオプションです。

ドロップダウンリストまたはリストボックスの最上部に表示する選択可能な追加アイテムを指定します。LIST_HEADER パラメータと LIST_HEADER_VALUE パラメータはペアとして処理されます。そのため、LIST_HEADER パラメータを指定する場合は、LIST_HEADER_VALUE パラメータも指定する必要があります。このパラメータには複数の値を指定できます。

LIST_HEADER パラメータのアイテムを選択した場合は、フォームをサブミットしたときに返される LIST_HEADER パラメータのアイテムの値を指定します。このパラメータの値を有効にするには LIST_HEADER パラメータを指定する必要があります。このパラメータには複数の値を指定できます。

フラグとして動作し、選択可能なリストから複数のオブジェクトを選択できるようにします。このパラメータのデフォルトは FALSE です。複数のオブジェクトを選択できるようにするには TRUE を指定します。また、SELECTED パラメータを使用してあらかじめリストの値をすべて選択できるようにするには、このパラメータを TRUE に設定する必要があります。

生成する HTML SELECT 要素の NAME 値を設定します。このパラメータのデフォルトでは、ATTRIBUTE パラメータによって指定された属性名を使用します。または、ATTRIBUTE_VALUE パラメータを指定している場合は、ATTRIBUTE_VALUE パラメータによって指定された属性名を使用します。ATTRIBUTE パラメータまたは ATTRIBUTE_VALUE パラメータのいずれも指定していない場合は、最初の属性の名前を使用します。このパラメータはオプションです。

ドロップダウンメニューまたはリストボックスでデフォルトとして使用する属性値を指定します。値を指定しない、属性値を 1 つ指定する、またはすべての値を指定できます。このパラメータのデフォルトは "" です。リストのすべての値をデフォルトに設定するには、このパラメータの値を "*" に設定します。すべての値をあらかじめ選択するには、MULTIPLE パラメータを有効にしておく必要があります。

生成するリストボックスに一度に表示するオプションの数を設定します。値を指定しない場合は、このパラメータのデフォルトではアイテムを 1 つ表示します。デフォルトを使用する (アイテムを 1 つ指定する) 場合、ドロップダウンメニューが生成されます。アイテムを 2 つ以上指定すると、リストボックスが表示されます。SIZE パラメータで指定したアイテムの数よりも多くのアイテムが返された場合は、すべて表示できるようにスクロールバーが表示されます。このパラメータはオプションです。

ドロップダウンメニューまたはリストボックスの OPTION 要素の幅を設定します。このパラメータのデフォルトは属性のサイズです。複数の属性を指定する場合は、各属性に WIDTH パラメータを指定できます。WIDTH パラメータよりも指定した属性が多い場合は、最初の属性から順にこのパラメータと属性が 1 対 1 の関係で適用され、残りの属性にはデフォルト値が使用されます。このパラメータはオプションです。

以下の Display-Selection Webject の例では、入力グループに複数の要素が含まれており、それぞれに name、address、および email 属性値があると想定されています。

<form>
<select name='NAME'>
<option value='Sam Johnson'>Sam Johnson1234 Main
                             St.sjohnson@somewhere.com</option>
<option value='Harvy Anderson'>Harvy Anderson1234 Amber
                            St.handerson@somewhere.com</option>
<option value='James O'Connor'>James O'Connor775 Main
                                                   St.</option>
<option value='Harvey Hampton'>Harvey Hampton775 Main
                             St.hhampton@somewhere.com</option>
</select>
</form>

<form>
<select name='NAME' size=1>
<option value='Sam Johnson'>Sam Johnson</option>
<option value='Harvy Anderson'>Harvy Anderson</option>
<option value='James O'Connor'>James O'Connor</option>
<option value='Harvey Hampton'>Harvey Hampton</option>
</select>
</form>

以下の例では、指定した ATTRIBUTE_VALUE パラメータが ATTRIBUTE パラメータで指定した属性と異なる場合に生成されるリストを表示します。この場合、リストボックスには NAME 属性が表示されます。一方、フォームをサブミットしたときに返される値は ADDRESS 属性になります。

<form>
<select name='ADDRESS'>
<option value='1234 Main St.'>Sam Johnson</option>
<option value='1234 Amber St.'>Harvy Anderson</option>
<option value='775 Main St.'>James O'Connor</option>
<option value='775 Main St.'>Harvey Hampton</option>
</select>
</form>

<form>
<select name='ADDRESS' size=6>
<option value='1234 Main St.'>Sam Johnson, 1234 Main St.,
                                sjohnson@somewhere.com</option>
<option value='1234 Amber St.'>Harvy Anderson, 1234 Amber St.,
                               handerson@somewhere.com</option>
<option value='775 Main St.'>James O'Connor, 775 Main St.,
                                                      </option>
<option value='775 Main St.'>Harvey Hampton, 775 Main St.,
                                hhampton@somewhere.com</option>
</select>
</form>

<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE_VALUE" data="ADDRESS"/>
  <ie:param name="LEADER" data = "_"/>
  <ie:param name="WIDTH" data="20"/>
  <ie:param name="WIDTH" data="20"/>
  <ie:param name="WIDTH" data="20"/>
  <ie:param name="SIZE" data="6"/>
</ie:webject>
</form>

<form>
<select name='ADDRESS' size=6>
<option value='1234 Main St.'>Sam Johnson_________1234 Main
                      St._______sjohnson@somewhere.com</option>
<option value='1234 Amber St.'>Harvy Anderson______1234 Amber
                      St.______handerson@somewhere.com</option>
<option value='775 Main St.'>James O'Connor______775 Main
                       St.____________________________</option>
<option value='775 Main St.'>Harvey Hampton______775 Main
                     St.________hhampton@somewhere.com</option>
</select>
</form>

<form>
<select name='ADDRESS' size=6>
<option value='*'>All Employees</option>
<option value='1234 Main St.'>Sam Johnson</option>
<option value='1234 Amber St.'>Harvy Anderson</option>
<option value='775 Main St.'>James O'Connor</option>
<option value='775 Main St.'>Harvey Hampton</option>
</select>
</form>

<form>
<select name='ADDRESS' size=6>
<option value='*'>All Employees</option>
<option value='-'>No Employees</option>
<option value='1234 Main St.'>Sam Johnson</option>
<option value='1234 Amber St.'>Harvy Anderson</option>
<option value='775 Main St.'>James O'Connor</option>
<option value='775 Main St.'>Harvey Hampton</option>
</select>
</form>

<form>
<select name='ADDRESS' size=6>
<option value='1234 Main St.'>1234 Main St.</option>
<option selected value='1234 Amber St.'>1234 Amber St.</option>
<option value='775 Main St.'>775 Main St.</option>
<option value='775 Main St.'>775 Main St.</option>
</select>
</form>

<form>
<select name='ADDRESS' size=6 multiple>
<option selected value='1234 Main St.'>1234 Main St.</option>
<option selected value='1234 Amber St.'>1234 Amber St.</option>
<option selected value='775 Main St.'>775 Main St.</option>
<option selected value='775 Main St.'>775 Main St.</option>
</select>
</form>