ComboBox.IsTextSearchEnabled 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

取得或設定值，指定使用者是否可以輸入來跳至值。

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"/>

屬性值

Boolean

bool

如果使用者可以輸入來跳至值，則為true;否則為false。 預設值為 True。

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

從 Windows 10 1607 版開始，ComboBox引進文字搜尋功能。 根據預設， ComboBox 會隨著使用者類型跳至相關的值。 您可以將 IsTextSearchEnabled 屬性設定為 false ，以停用此行為。 例如，如果您已使用自訂文字搜尋擴充 ComboBox ，這會很有用。

版本相容性

IsTextSearchEnabled 屬性在 Windows 10 1607 版之前無法使用。 如果您的應用程式在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後需求區塊中顯示的「引進版本」，您必須設計和測試您的應用程式以考慮此專案。 如需詳細資訊，請參閱 版本調適型程式碼。

注意

當您的應用程式針對 Windows 10 1607 版 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;
    }
}