ComboBox.IsTextSearchEnabled 属性

定义

获取或设置一个值,该值指定用户是否可以通过键入跳转到值。

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 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;
    }
}

适用于