ComboBox.IsTextSearchEnabled Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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;
}
}