ComboBox.IsTextSearchEnabled Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor que especifica si un usuario puede saltar a un valor escribiendo.

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

Valor de propiedad

Boolean

bool

true si un usuario puede saltar a un valor escribiendo; de lo contrario, false. El valor predeterminado es true.

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

A partir de Windows 10, versión 1607, ComboBox presenta una característica de búsqueda de texto. De forma predeterminada, comboBox salta a un valor relevante a medida que el usuario escribe. Puede establecer la propiedad IsTextSearchEnabled en false para deshabilitar este comportamiento. Esto resulta útil, por ejemplo, si ha extendido ComboBox con la búsqueda de texto personalizada.

Compatibilidad de versiones

La propiedad IsTextSearchEnabled no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Nota:

La característica de búsqueda de texto está disponible cuando la aplicación se compila para Windows 10, versión 1607 y se ejecuta en la versión 1607 (o posterior). No está disponible cuando la aplicación se compila para una versión anterior o se ejecuta en una versión anterior.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

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