ComboBox.IsTextSearchEnabled Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit une valeur qui spécifie si un utilisateur peut accéder à une valeur en tapant.

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

Valeur de propriété

Boolean

bool

true si un utilisateur peut accéder à une valeur en tapant ; sinon, false. La valeur par défaut est true.

Remarques

À compter de Windows 10, version 1607, ComboBox introduit une fonctionnalité de recherche de texte. Par défaut, comboBox passe à une valeur pertinente lorsque l’utilisateur tape. Vous pouvez définir la propriété IsTextSearchEnabled sur false pour désactiver ce comportement. Cela est utile, par exemple, si vous avez étendu ComboBox avec la recherche de texte personnalisée.

Compatibilité des versions

La propriété IsTextSearchEnabled n’est pas disponible avant Windows 10, version 1607. Si le paramètre « version minimale de la plateforme » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour en tenir compte. Pour plus d’informations, consultez Code adaptatif version.

Notes

La fonctionnalité de recherche de texte est disponible lorsque votre application est compilée pour Windows 10 version 1607 et s’exécute sur la version 1607 (ou ultérieure). Il n’est pas disponible lorsque votre application est compilée pour une version précédente ou s’exécute sur une version précédente.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions précédentes de Windows 10, ne définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

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