ComboBox.IsTextSearchEnabled プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーが入力して値にジャンプできるかどうかを指定する値を取得または設定します。
public:
property bool IsTextSearchEnabled { bool get(); void set(bool value); };
bool IsTextSearchEnabled();
void IsTextSearchEnabled(bool value);
public bool IsTextSearchEnabled { get; set; }
var boolean = comboBox.isTextSearchEnabled;
comboBox.isTextSearchEnabled = boolean;
Public Property IsTextSearchEnabled As Boolean
<ComboBox IsTextSearchEnabled="bool"/>
プロパティ値
bool
ユーザー が入力して値にジャンプできる場合は true。それ以外の場合は false。 既定値は trueです。
注釈
Windows 10 バージョン 1607 以降、ComboBox にはテキスト検索機能が導入されています。 既定では、 ComboBox はユーザーが入力すると関連する値にジャンプします。 この動作を無効にするには、IsTextSearchEnabled プロパティを false に設定できます。 これは、カスタム テキスト検索で ComboBox を拡張した場合などに便利です。
バージョン互換性
IsTextSearchEnabled プロパティは、Windows 10 バージョン 1607 より前は使用できません。 Microsoft Visual Studioのアプリの "最小プラットフォーム バージョン" 設定が、このページの後半の「要件」ブロックに示されている「導入されたバージョン」よりも小さい場合は、これを考慮するようにアプリを設計してテストする必要があります。 詳細については、「 バージョン アダプティブ コード」を参照してください。
Note
テキスト検索機能は、アプリが Windows 10 バージョン 1607 用にコンパイルされ、バージョン 1607 (またはそれ以降) で実行されている場合に使用できます。 アプリが以前のバージョン用にコンパイルされている場合、または以前のバージョンで実行されている場合は使用できません。
アプリが以前のバージョンのWindows 10で実行されている場合に例外を回避するには、XAML でこのプロパティを設定したり、ランタイム チェックを実行せずに使用したりしないでください。 この例では、 ApiInformation クラスを使用して、設定する前にこのプロパティの存在を確認する方法を示します。
<ComboBox x:Name="comboBox1" Loaded="ComboBox_Loaded"/>
private void ComboBox_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ComboBox", "IsTextSearchEnabled"))
{
comboBox1.IsTextSearchEnabled = false;
}
}