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 (或更高版本) 上运行时，文本搜索功能可用。 当应用针对以前的版本编译或在以前版本上运行时，它不可用。

若要避免在以前版本的 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;
    }
}