この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Force.com Apex コード開発者ガイド

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

SelectOption クラス

SelectOption オブジェクトは Visualforce selectCheckboxes、selectList、または selectRadio コンポーネントに指定可能な値のいずれかを指定します。

名前空間

System

SelectOption オブジェクトは、エンドユーザに表示されるラベルと、オプションが選択された場合にコントローラに返される値で構成されます。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");public 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> タグの子であるため、オプションはチェックボックスとして表示されます。

1swfobject.registerObject("clippy.codeblock-3", "9"); <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(String, String)

指定された値および表示ラベルを使用して、SelectOption クラスの新しいインスタンスを作成します。

署名

public SelectOption(String value, String label)

パラメータ

value
型: String
ユーザがこのオプションを選択した場合に、Visualforce コントローラに返される文字列。
label
型: String
オプション選択肢としてユーザに表示される文字列。

SelectOption(String, String, Boolean)

指定された値、表示ラベル、無効化された設定を使用して、SelectOption クラスの新しいインスタンスを作成します。

署名

public SelectOption(String value, String label, Boolean isDisabled)

パラメータ

value
型: String
ユーザがこのオプションを選択した場合に、Visualforce コントローラに返される文字列。
label
型: String
オプション選択肢としてユーザに表示される文字列。
isDisabled
型: Boolean
true に設定された場合、ユーザはこのオプションを選択できませんが、参照することは可能です。

SelectOption メソッド

SelectOption のメソッドは次のとおりです。すべてインスタンスメソッドです。

getDisabled()

SelectOption オブジェクトの isDisabled 属性の現在の値を返します。

署名

public Boolean getDisabled()

戻り値

型: Boolean

使用方法

isDisabled を true に設定した場合、オプションは表示されますが、選択できません。isDisabled を false に設定した場合、オプションは表示され、選択できます。

getEscapeItem()

SelectOption オブジェクトの itemEscaped 属性の現在の値を返します。

署名

public Boolean getEscapeItem()

戻り値

型: Boolean

使用方法

itemEscaped を true に設定した場合、重要な HTML および XML 文字はこのコンポーネントによって生成された HTML 出力でエスケープされます。itemEscaped が false に設定されている場合、項目は書き込まれたとおりに表示されます。

getLabel()

ユーザに表示されるオプションのラベルを返します。

署名

public String getLabel()

戻り値

型: String

getValue()

ユーザがオプションを選択した場合にコントローラに返されるオプション値を返します。

署名

public String getValue()

戻り値

型: String

setDisabled(Boolean)

SelectOption オブジェクトの isDisabled 属性の値を設定します。

署名

public Void setDisabled(Boolean isDisabled)

パラメータ

isDisabled
型: Boolean

戻り値

型: Void

使用方法

isDisabled を true に設定した場合、オプションは表示されますが、選択できません。isDisabled を false に設定した場合、オプションは表示され、選択できます。

setEscapeItem(Boolean)

SelectOption オブジェクトの itemEscaped 属性の値を設定します。

署名

public Void setEscapeItem(Boolean itemsEscaped)

パラメータ

itemsEscaped
型: Boolean

戻り値

型: Void

使用方法

itemEscaped を true に設定した場合、重要な HTML および XML 文字はこのコンポーネントによって生成された HTML 出力でエスケープされます。itemEscaped が false に設定されている場合、項目は書き込まれたとおりに表示されます。

setLabel(String)

ユーザに表示されるオプションラベルの値を設定します。

署名

public Void setLabel(String label)

パラメータ

label
型: String

戻り値

型: Void

setValue(String)

ユーザがオプションを選択した場合にコントローラに返されるオプション値の値を設定します。

署名

public Void setValue(String value)

パラメータ

value
型: String

戻り値

型: Void