ComboBox.IsEditable プロパティ

定義

ComboBox のテキスト ボックス内のテキストの編集を有効または無効にする値を取得または設定します。Gets or sets a value that enables or disables editing of the text in text box of the ComboBox.

public:
 property bool IsEditable { bool get(); void set(bool value); };
public bool IsEditable { get; set; }
member this.IsEditable : bool with get, set
Public Property IsEditable As Boolean

プロパティ値

ComboBox が編集可能な場合は true。それ以外の場合は falsetrue if the ComboBox can be edited; otherwise false. 既定値は、false です。The default is false.

次の例でComboBoxは、テキストではなく項目として画像を含むコントロールを作成します。The following examples create ComboBox controls that contain images as items instead of text. プロパティがにtrue設定されているTextBox場合、では、イメージのToStringメソッドによって返される値が表示されます。 IsEditableIf the IsEditable property is set to true, the TextBox displays the value returned by the image's ToString method. 予期しないTextBoxテキストでを回避するにTextSearch.TextTextSearch.TextPath 、プロパティとプロパティを使用して、表示するテキストを割り当てます。To avoid a TextBox with unexpected text, use the TextSearch.Text and TextSearch.TextPath properties to assign text to be displayed.

<ComboBox IsEditable="true" TextSearch.TextPath="Name">
  <Image Name="Cat" Source="data\cat.png"/>
  <Image Name="Dog" Source="data\dog.png"/>
  <Image Name="Fish" Source="data\fish.png"/>
</ComboBox>
<ComboBox IsEditable="true">
  <Image TextSearch.Text="Cat" Source="data\cat.png"/>
  <Image TextSearch.Text="Dog" Source="data\dog.png"/>
  <Image TextSearch.Text="Fish" Source="data\fish.png"/>
</ComboBox>

もう1つの解決策DisplayMemberPathは、プロパティを使用することです。Another solution is to use the DisplayMemberPath property. ComboBoxドロップダウンコントロールでは、イメージは表示されませんが、割り当てたテキストが表示されます。The drop-down control of the ComboBox will not display the images but will display the text you assigned.

次の例は、DisplayMemberPath を使用する方法を示しています。The following example shows how to use DisplayMemberPath.


<ComboBox IsEditable="true" DisplayMemberPath="Name">
  <Image Name="CAT" Source="data\cat.png"/>
  <Image Name="DOG" Source="data\dog.png"/>
  <Image Name="FISH" Source="data\fish.png"/>
</ComboBox>

注釈

プロパティIsEditableIsReadOnlyプロパティは、ユーザー ComboBoxが次のいずれかの操作を実行したときのの動作を指定します。The IsEditable and IsReadOnly properties specify how the ComboBox behaves when the user does one of the following:

  • 内の項目を選択する文字列を入力ComboBoxします。Enters a string to select an item in the ComboBox.

  • 内の項目に対応していない文字列を入力ComboBoxします。Enters a string that does not correspond to an item in the ComboBox.

  • テキストボックス内の文字列の一部を選択します。Selects part of the string that is in the text box.

  • 値をテキストボックスにコピーまたは貼り付けます。Copies or pastes a value into the text box.

次の表では、およびIsEditable IsReadOnlyの値に応じて、ユーザーが実行できる操作と実行できない操作について説明します。The following table describes the actions the user can and cannot take, depending on the values of IsEditable and IsReadOnly.

IsReadOnlytrue ですIsReadOnly is true IsReadOnlyfalse ですIsReadOnly is false
IsEditabletrue ですIsEditable is true -文字列を入力して、 ComboBox内の項目を選択することはできません。- Cannot select an item in the ComboBox by entering a string.
-内ComboBoxの項目に対応していない文字列を入力することはできません。- Cannot enter a string that does not correspond to an item in the ComboBox.
- ComboBoxテキストボックス内の文字列の一部を選択できます。- Can select part of the string in the ComboBox text box.
- ComboBoxテキストボックス内の文字列をコピーできますが、 ComboBoxテキストボックスに文字列を貼り付けることはできません。- Can copy the string in the ComboBox text box, but cannot paste a string into the ComboBox text box.
-文字列を入力して、 ComboBox内の項目を選択できます。- Can select an item in the ComboBox by entering a string.
-内ComboBoxの項目に対応しない文字列を入力できます。- Can enter a string that does not correspond to an item in the ComboBox.
- ComboBoxテキストボックス内の文字列の一部を選択できます。- Can select part of the string in the ComboBox text box.
- ComboBoxテキストボックス内の文字列をコピーまたは貼り付けることができます。- Can copy or paste the string in the ComboBox text box.
IsEditablefalse ですIsEditable is false -文字列を入力して、 ComboBox内の項目を選択できます。- Can select an item in the ComboBox by entering a string.
-内ComboBoxの項目に対応していない文字列を入力することはできません。- Cannot enter a string that does not correspond to an item in the ComboBox.
-内の文字列の一部を選択するComboBoxことはできません。- Cannot select part of the string in the ComboBox.
-内ComboBoxの文字列をコピーまたは貼り付けできません。- Cannot copy or paste the string in the ComboBox.
-文字列を入力して、 ComboBox内の項目を選択できます。- Can select an item in the ComboBox by entering a string.
-内ComboBoxの項目に対応していない文字列を入力することはできません。- Cannot enter a string that does not correspond to an item in the ComboBox.
-内の文字列の一部を選択するComboBoxことはできません。- Cannot select part of the string in the ComboBox.
-内ComboBoxの文字列をコピーまたは貼り付けできません。- Cannot copy or paste the string in the ComboBox.

IsEditableIsEditable true等しい場合TextBox 、はをComboBox使用ContentPresenterして現在選択されている項目を表示します。がに等しい場合は、代わりにがこの目的で使用されます。 falseWhen IsEditable is equal to false, the ComboBox uses a ContentPresenter to display the currently selected item; when IsEditable is equal to true, a TextBox is used for this purpose instead. ではTextBoxプレーンテキストのみが表示され、にComboBoxItemは画像などのプレーンテキスト以外のテキストコンテンツが含まれる場合があることに注意してください。Note that a TextBox only displays plain text, and that a ComboBoxItem may include non-plain text content, such as images.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field IsEditableProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象