ComboBox.IsTextSearchEnabled Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore che specifica se un utente può passare a un valore 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"/>

Valore della proprietà

Boolean

bool

true se un utente può passare a un valore digitando; in caso contrario, false. Il valore predefinito è True.

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

A partire da Windows 10 versione 1607, ComboBox introduce una funzionalità di ricerca di testo. Per impostazione predefinita, ComboBox passa a un valore rilevante come tipi di utente. È possibile impostare la proprietà IsTextSearchEnabled su false per disabilitare questo comportamento. Ciò è utile, ad esempio, se si dispone di ComboBox esteso con ricerca di testo personalizzata.

Compatibilità tra versioni

La proprietà IsTextSearchEnabled non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Nota

La funzionalità di ricerca del testo è disponibile quando l'app viene compilata per Windows 10 versione 1607 e in esecuzione nella versione 1607 (o successiva). Non è disponibile quando l'app viene compilata per una versione precedente o è in esecuzione in una versione precedente.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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