ComboBox.IsTextSearchEnabled Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que especifica se um usuário pode saltar para um valor digitando.

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 da propriedade

Boolean

bool

true se um usuário puder ir para um valor digitando; caso contrário, false. O padrão é true.

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

A partir do Windows 10, versão 1607, o ComboBox apresenta um recurso de pesquisa de texto. Por padrão, o ComboBox salta para um valor relevante à medida que o usuário digita. Você pode definir a propriedade IsTextSearchEnabled como false para desabilitar esse comportamento. Isso é útil, por exemplo, se você tiver estendido o ComboBox com a pesquisa de texto personalizada.

Compatibilidade de versões

A propriedade IsTextSearchEnabled não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor que a "versão introduzida" mostrada no bloco Requisitos posteriormente nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Observação

O recurso de pesquisa de texto está disponível quando seu aplicativo é compilado para Windows 10, versão 1607 e em execução na versão 1607 (ou posterior). Ele não está disponível quando seu aplicativo é compilado para uma versão anterior ou está em execução em uma versão anterior.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

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