ComboBox.IsTextSearchEnabled Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft einen Wert ab, der angibt, ob ein Benutzer durch Eingabe zu einem Wert springen kann, oder legt diesen fest.

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

Eigenschaftswert

Boolean

bool

true , wenn ein Benutzer durch Eingabe zu einem Wert springen kann; andernfalls false. Der Standardwert ist true.

Hinweise

Ab Windows 10 Version 1607 führt ComboBox eine Textsuche-Funktion ein. Standardmäßig springt das ComboBox-Element zu einem relevanten Wert, wenn der Benutzer eingibt. Sie können die IsTextSearchEnabled-Eigenschaft auf false festlegen, um dieses Verhalten zu deaktivieren. Dies ist beispielsweise nützlich, wenn Sie ComboBox mit benutzerdefinierter Textsuche erweitert haben.

Versionskompatibilität

Die IsTextSearchEnabled-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.

Hinweis

Die Textsuche ist verfügbar, wenn Ihre App für Windows 10, Version 1607, kompiliert wird und unter Version 1607 (oder höher) ausgeführt wird. Sie ist nicht verfügbar, wenn Ihre App für eine frühere Version kompiliert wird oder in einer früheren Version ausgeführt wird.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie festlegen.

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