TextSearch Classe

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Consente a un utente di accedere rapidamente agli elementi in un set 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

Negli esempi seguenti vengono creati ComboBox controlli contenenti immagini come elementi anziché come testo. Funzionalmente, 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 utilizzata 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 contenga ComboBox 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 trueComboBox, "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 ignorata.

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

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

Proprietà

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

Proprietà associate

Nome	Descrizione
Text	Ottiene o imposta la stringa che identifica un elemento nella raccolta di un controllo.
TextPath	Ottiene o imposta il nome della proprietà degli elementi che identifica ogni elemento nella raccolta di un controllo.

Metodi

Nome	Descrizione
CheckAccess()	Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject)
Equals(Object)	Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject)
GetText(DependencyObject)	Restituisce la stringa a che identifica l'elemento specificato.
GetTextPath(DependencyObject)	Restituisce il nome della proprietà che identifica un elemento nella raccolta dell'elemento specificato.
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject oggetto è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata 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 modificarne l'origine del valore. (Ereditato da DependencyObject)
SetText(DependencyObject, String)	Scrive il Text valore della proprietà associata nell'elemento specificato.
SetTextPath(DependencyObject, String)	Scrive la TextPath proprietà associata nell'elemento specificato.
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dall'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 per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
VerifyAccess()	Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)

Vedi anche

• ComboBox