Questa documentazione è stata archiviata e non viene gestita.

Classe TextSearch

Aggiornamento: novembre 2007

Consente a un utente di accedere rapidamente a elementi in un insieme digitando prefissi di stringhe.

Spazio dei nomi:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS per XAML: http://schemas.microsoft.com/winfx/xaml/presentation

public sealed class TextSearch : DependencyObject
public final class TextSearch extends DependencyObject
public final class TextSearch extends DependencyObject
Non è possibile dichiarare questa classe gestita nella sintassi XAML, ma è possibile utilizzare le relative proprietà statiche per assegnare valori in XAML.

Questa classe è utilizzata per assegnare una stringa agli elementi in un insieme del controllo. L'assegnazione di una stringa a ogni elemento nell'insieme raggiunge due obiettivi. Specifica il testo da visualizzare quando l'elemento viene selezionato e consente all'utente di selezionare un elemento digitando la stringa assegnata.

Ad esempio, si supponga che un ComboBox contenga un insieme di oggetti Image uno dei quali è l'immagine di un cane. Se si assegna la stringa, "Cane" a quell’elemento, l'utente può selezionare il cane digitando la parola nella casella di testo della casella combinata. Appena l'utente digita una parte della parola sufficiente a distinguerla dagli altri elementi della selezione, viene selezionata l'immagine del cane. Se IsEditable è impostato su true in ComboBox, la parola "Cane" verrà visualizzata nella casella di testo.

È possibile specificare il testo che identifica un elemento utilizzando la proprietà TextSearch.TextPath su un controllo o impostando la proprietà Text su ogni elemento nell'insieme del controllo. L'impostazione di una di queste proprietà garantisce che non venga visualizzato testo non previsto. Se si imposta la proprietà Text su un elemento di insieme di un controllo, la proprietà TextPath verrà ignorata. Se si imposta la proprietà TextPath su un valore che non è il nome di una proprietà effettiva, TextPath viene ignorato.

Gli esempi seguenti creano controlli ComboBox che contengono immagini anziché testo come elementi. Funzionalmente, gli esempi sono gli stessi. Il primo esempio illustra come impostare la proprietà TextPath su ComboBox mentre il secondo esempio illustra come impostare la proprietà Text su ogni elemento nell'insieme.

<ComboBox IsEditable="true" TextSearch.TextPath="Name">
      <Image Name="Cat" Source="data\cat.png"/>
      <Image Name="Dog" Source="data\dog.png"/>
      <Image Name="Fish" Source="data\fish.png"/>
</ComboBox>


<ComboBox IsEditable="true">
      <Image TextSearch.Text="Cat" Source="data\cat.png"/>
      <Image TextSearch.Text="Dog" Source="data\dog.png"/>
      <Image TextSearch.Text="Fish" Source="data\fish.png"/>
</ComboBox>


Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0
Mostra: