Apex リファレンスガイド
jSelectOption クラス
名前空間
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 オブジェクトのリストを定義して返します。
1public class sampleCon {
2
3 String[] countries = new String[]{};
4
5 public PageReference test() {
6 return null;
7 }
8
9 public List<SelectOption> getItems() {
10 List<SelectOption> options = new List<SelectOption>();
11 options.add(new SelectOption('US','US'));
12 options.add(new SelectOption('CANADA','Canada'));
13 options.add(new SelectOption('MEXICO','Mexico'));
14 return options;
15 }
16
17 public String[] getCountries() {
18 return countries;
19 }
20
21 public void setCountries(String[] countries) {
22 this.countries = countries;
23 }
24
25}次のページマークアップで、<apex:selectOptions> タグは上記のコントローラーの getItems メソッドを使用して、使用可能な値のリストを取得します。<apex:selectOptions> は、<apex:selectCheckboxes> タグの子であるため、オプションはチェックボックスとして表示されます。
1<apex:page controller="sampleCon">
2 <apex:form>
3 <apex:selectCheckboxes value="{!countries}">
4 <apex:selectOptions value="{!items}"/>
5 </apex:selectCheckboxes><br/>
6 <apex:commandButton value="Test" action="{!test}" rerender="out" status="status"/>
7 </apex:form>
8 <apex:outputPanel id="out">
9 <apex:actionstatus id="status" startText="testing...">
10 <apex:facet name="stop">
11 <apex:outputPanel>
12 <p>You have selected:</p>
13 <apex:dataList value="{!countries}" var="c">{!c}</apex:dataList>
14 </apex:outputPanel>
15 </apex:facet>
16 </apex:actionstatus>
17 </apex:outputPanel>
18</apex:page>SelectOption コンストラクター
SelectOption のコンストラクターは次のとおりです。
SelectOption メソッド
SelectOption のメソッドは次のとおりです。すべてインスタンスメソッドです。
getDisabled()
署名
public Boolean getDisabled()
戻り値
型: Boolean
使用方法
isDisabled を true に設定した場合、オプションは表示されますが、選択できません。isDisabled を false に設定した場合、オプションは表示され、選択できます。
getEscapeItem()
署名
public Boolean getEscapeItem()
戻り値
型: Boolean
使用方法
itemEscaped を true に設定した場合、重要な HTML および XML 文字はこのコンポーネントによって生成された HTML 出力でエスケープされます。itemEscaped が false に設定されている場合、項目は書き込まれたとおりに表示されます。
setDisabled(isDisabled)
署名
public Void setDisabled(Boolean isDisabled)
パラメーター
- isDisabled
- 型: Boolean
戻り値
型: Void
使用方法
isDisabled を true に設定した場合、オプションは表示されますが、選択できません。isDisabled を false に設定した場合、オプションは表示され、選択できます。
setEscapeItem(itemsEscaped)
署名
public Void setEscapeItem(Boolean itemsEscaped)
パラメーター
- itemsEscaped
- 型: Boolean
戻り値
型: Void
使用方法
itemEscaped を true に設定した場合、重要な HTML および XML 文字はこのコンポーネントによって生成された HTML 出力でエスケープされます。itemEscaped が false に設定されている場合、項目は書き込まれたとおりに表示されます。
setLabel(label)
署名
public Void setLabel(String label)
パラメーター
- label
- 型: String
戻り値
型: Void
setValue(value)
署名
public Void setValue(String value)
パラメーター
- value
- 型: String
戻り値
型: Void