TextSearch Classe

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

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

public ref class TextSearch sealed : System::Windows::DependencyObject

public sealed class TextSearch : System.Windows.DependencyObject

type TextSearch = class
    inherit DependencyObject

Public NotInheritable Class TextSearch
Inherits DependencyObject

Ereditarietà

Object

DispatcherObject

DependencyObject

TextSearch

Esempio

Gli esempi seguenti creano ComboBox controlli che contengono immagini come elementi anziché testo. A livello funzionale, gli esempi sono gli stessi. Il primo esempio imposta la TextPath proprietà su ComboBox e il secondo esempio imposta la Text proprietà su ogni elemento dell'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>

Commenti

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

Si supponga, ad esempio, che un ComboBox oggetto contenga una raccolta di Image oggetti, uno dei quali è un'immagine di un cane. Se si assegna la stringa "Dog" a tale elemento, l'utente può selezionare il cane digitando la parola nella casella di testo della casella di testo della casella combinata. Non appena l'utente digita abbastanza della parola per distinguerlo da altri elementi nella selezione, verrà selezionata l'immagine del cane. Se IsEditable è impostato su true su ComboBox, "Dog" verrà visualizzato nella casella di testo.

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

Utilizzo del testo XAML

Non puoi dichiarare questa classe gestita in XAML, ma puoi usare le relative proprietà statiche per assegnare valori in XAML.

Campi

TextPathProperty	Identifica la proprietà associata TextPath.
TextProperty	Identifica la proprietà associata Text.

Proprietà

DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)

Proprietà associate

Text	Ottiene o imposta la stringa che identifica un elemento in un insieme del controllo.
TextPath	Ottiene o imposta il nome della proprietà degli elementi che identifica ogni elemento in una raccolta del controllo.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetText(DependencyObject)	Restituisce la stringa che identifica l'elemento specificato.
GetTextPath(DependencyObject)	Restituisce il nome della proprietà che identifica un elemento nella raccolta dell'elemento specificato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetText(DependencyObject, String)	Scrive il valore della proprietà associata Text nell'elemento specificato.
SetTextPath(DependencyObject, String)	Scrive la proprietà associata TextPath nell'elemento specificato.
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)

Vedi anche

• ComboBox