ComboBox.SelectedText ComboBox.SelectedText ComboBox.SelectedText ComboBox.SelectedText Property

定義

ComboBox のうち編集できる部分の中で選択されているテキストを取得または設定します。Gets or sets the text that is selected in the editable portion of a ComboBox.

public:
 property System::String ^ SelectedText { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string SelectedText { get; set; }
member this.SelectedText : string with get, set
Public Property SelectedText As String

プロパティ値

コンボ ボックスで現在選択されているテキストを表す文字列。A string that represents the currently selected text in the combo box. DropDownStyleDropDownList に設定されている場合、戻り値は空の文字列 ("") です。If DropDownStyle is set to DropDownList, the return value is an empty string ("").

注釈

コントロールで現在選択SelectedTextされているテキストを取得または変更するには、プロパティを使用します。 ComboBoxYou can use the SelectedText property to retrieve or change the currently selected text in a ComboBox control. ただし、ユーザーの操作によって選択が自動的に変更される可能性があることに注意してください。However, you should be aware that the selection can change automatically because of user interaction. たとえば、ボタンClickのイベントハンドラーでSelectedText値を取得した場合、値は空の文字列になります。For example, if you retrieve the SelectedText value in a button Click event handler, the value will be an empty string. これは、入力フォーカスがコンボボックスからボタンに移動したときに、選択が自動的にクリアされるためです。This is because the selection is automatically cleared when the input focus moves from the combo box to the button.

コンボボックスがフォーカスを失うと、選択ポイントはテキストの先頭に移動し、選択したテキストは選択解除されます。When the combo box loses focus, the selection point moves to the beginning of the text and any selected text becomes unselected. この場合、 SelectedTextプロパティを取得すると空の文字列が取得されSelectedText 、プロパティを設定すると、指定した値がテキストの先頭に追加されます。In this case, getting the SelectedText property retrieves an empty string, and setting the SelectedText property adds the specified value to the beginning of the text.

コンボボックスがフォーカスを取得すると、コントロールのフルテキストが自動的に選択されます。When the combo box gains focus, the full text in the control is automatically selected. コントロールのFocusメソッドを呼び出して入力フォーカスを設定すると、コントロールにフォーカスがあるかどうかに関係なく、フルテキストが選択されます。If you call the control's Focus method to set the input focus, the full text is selected regardless of whether the control already had focus.

ユーザーがドロップダウンリストから項目を選択するか、上方向キーと下方向キーを使用すると、新しい項目のテキストが自動的に選択されます。When the user selects an item from the drop-down list or by using the UP ARROW and DOWN ARROW keys, the text for the new item is automatically selected. ただし、イベントハンドラー SelectedText SelectedIndexChangedまたはSelectedValueChangedイベントハンドラーで値を取得しようとすると、プロパティは空の文字列を返します。However, if you try to get the SelectedText value in a SelectedIndexChanged or SelectedValueChanged event handler, the property returns an empty string. これは、これらのイベントの時点で、前SelectedTextの値がクリアされ、新しい値がまだ設定されていないためです。This is because, at the time of these events, the previous SelectedText value has been cleared and the new value has not yet been set. イベントハンドラー SelectedIndexChangedまたはイベントハンドラーで現在SelectedValueChangedの値を取得するには、代わりにプロパティを使用します。SelectedItemTo retrieve the current value in a SelectedIndexChanged or SelectedValueChanged event handler, use the SelectedItem property instead.

適用対象