ComboBox.IsTextSearchEnabled Propriété

Définition

Espace de noms:

Windows.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.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

À compter de Windows 10, version 1607, ComboBox introduit une fonctionnalité de recherche de texte. Par défaut, comboBox passe à une valeur pertinente à mesure que 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 une 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 de plateforme minimale » 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 tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Notes

La fonctionnalité de recherche de texte est disponible lorsque votre application est compilée pour Windows 10, version 1607 et exécutée 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 qu’elle s’exécute sur une version précédente.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions antérieures 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;
    }
}