Visualforce 開発者ガイド
jSelectOption クラス
名前空間
System
SelectOption オブジェクトは、エンドユーザに表示されるラベルと、オプションが選択された場合にコントローラに返される値で構成されます。SelectOption は無効な状態で表示することもできます。そのため、ユーザはオプションとして選択することはできませんが、表示することはできます。
インスタンス化
-
1SelectOption option = new SelectOption(value, label, isDisabled);value は、ユ���ザがオプションを選択した場合にコントローラに返される String です。label は、オプション選択肢としてユーザに表示される String です。isDisabled は Boolean で、これを true に設定すると、ユーザはオプションを選択できませんが、表示することができます。
-
1SelectOption option = new SelectOption(value, label);value は、ユーザがオプションを選択した場合にコントローラに返される String です。label は、オプションの選択肢としてユーザに表示される String です。isDisabled の値は指定されないため、ユーザはオプションの表示と選択を行えます。
例
次の例では、SelectOptions オブジェクトのリストを使用して、Visualforce ページの selectCheckboxes コンポーネントに指定可能な値を提供する方法を示します。次のカスタムコントローラでは、getItems メソッドは使用可能な SelectOption オブジェクトのリストを定義して返します。
1swfobject.registerObject("clippy.codeblock-2", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public class sampleCon {
18
19 String[] countries = new String[]{};
20
21 public PageReference test() {
22 return null;
23 }
24
25 public List<SelectOption> getItems() {
26 List<SelectOption> options = new List<SelectOption>();
27 options.add(new SelectOption('US','US'));
28 options.add(new SelectOption('CANADA','Canada'));
29 options.add(new SelectOption('MEXICO','Mexico'));
30 return options;
31 }
32
33 public String[] getCountries() {
34 return countries;
35 }
36
37 public void setCountries(String[] countries) {
38 this.countries = countries;
39 }
40
41} 次のページマークアップで、<apex:selectOptions> タグは上記のコントローラの getItems メソッドを使用して、使用可能な値のリストを取得します。<apex:selectOptions> は、<apex:selectCheckboxes> タグの子であるため、オプションはチェックボックスとして表示されます。
1swfobject.registerObject("clippy.codeblock-3", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17 <apex:page controller="sampleCon">
18 <apex:form>
19 <apex:selectCheckboxes value="{!countries}">
20 <apex:selectOptions value="{!items}"/>
21 </apex:selectCheckboxes><br/>
22 <apex:commandButton value="Test" action="{!test}" rerender="out" status="status"/>
23 </apex:form>
24 <apex:outputPanel id="out">
25 <apex:actionstatus id="status" startText="testing...">
26 <apex:facet name="stop">
27 <apex:outputPanel>
28 <p>You have selected:</p>
29 <apex:dataList value="{!countries}" var="c">{!c}</apex:dataList>
30 </apex:outputPanel>
31 </apex:facet>
32 </apex:actionstatus>
33 </apex:outputPanel>
34</apex:page>