TextSearch Klasse

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ermöglicht es einem Benutzer, durch die Eingabe von Präfixen von Zeichenfolgen schnell auf Elemente in einem Satz zuzugreifen.

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

Vererbung

Object

DispatcherObject

DependencyObject

TextSearch

Beispiele

In den folgenden Beispielen werden Steuerelemente erstellt ComboBox , die Bilder als Elemente anstelle von Text enthalten. Funktionell sind die Beispiele identisch. Im ersten Beispiel wird die TextPath Eigenschaft für das ComboBox und das zweite Beispiel die Text Eigenschaft für jedes Element in der Auflistung festgelegt.

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

Hinweise

Diese Klasse wird verwendet, um elementen in der Auflistung eines Steuerelements eine Zeichenfolge zuzuweisen. Durch das Zuweisen einer Zeichenfolge zu jedem Element in der Auflistung werden zwei Ziele erreicht. Es gibt den Text an, der angezeigt werden soll, wenn das Element ausgewählt ist, und es dem Benutzer ermöglicht, ein Element auszuwählen, indem er die zugewiesene Zeichenfolge eingibt.

Gehen Sie z. B. davon aus, dass eine ComboBox Sammlung von Image Objekten enthält, von denen eines ein Bild eines Hundes ist. Wenn Sie der Zeichenfolge "Hund" dieses Elements zuweisen, kann der Benutzer den Hund auswählen, indem Sie das Wort im Textfeld des Kombinationsfelds eingeben. Sobald der Benutzer genügend Wort eingibt, um es von anderen Elementen in der Auswahl zu unterscheiden, wird das Bild des Hundes ausgewählt. Wenn IsEditable auf das ComboBoxFeld "Hund" festgelegt true ist, wird im Textfeld "Hund" angezeigt.

Sie können den Text angeben, der ein Element mithilfe der TextSearch.TextPath Eigenschaft eines Steuerelements identifiziert, oder indem Sie die Text Eigenschaft für jedes Element in der Auflistung des Steuerelements festlegen. Durch festlegen einer dieser Eigenschaften wird sichergestellt, dass unerwarteter Text nicht angezeigt wird. Wenn Sie die Text Eigenschaft für das Auflistungselement eines Steuerelements festlegen, wird die TextPath Eigenschaft ignoriert. Wenn Sie die TextPath Eigenschaft auf einen Wert festlegen, der nicht der Name einer tatsächlichen Eigenschaft ist, TextPath wird ignoriert.

XAML-Textverwendung

Sie können diese verwaltete Klasse in XAML nicht deklarieren, aber Sie können die statischen Eigenschaften verwenden, um Werte in XAML zuzuweisen.

Felder

TextPathProperty	Bezeichnet die angefügte TextPath-Eigenschaft.
TextProperty	Bezeichnet die angefügte Text-Eigenschaft.

Eigenschaften

DependencyObjectType	Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)

Angefügte Eigenschaften

Text	Ruft die Zeichenfolge ab, die ein Element in der Auflistung eines Steuerelements identifiziert, oder legt diese fest.
TextPath	Ruft den Namen der Elementeigenschaft ab, die jedes Element in der Auflistung eines Steuerelements identifiziert, oder legt diesen fest.

Methoden

CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetText(DependencyObject)	Gibt die Zeichenfolge zurück, die das angegebene Element bezeichnet.
GetTextPath(DependencyObject)	Gibt den Namen der Eigenschaft zurück, die ein Element in der Auflistung des angegebenen Elements bezeichnet.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetText(DependencyObject, String)	Schreibt den angefügten Text-Eigenschaftswert in das angegebene Element.
SetTextPath(DependencyObject, String)	Schreibt die angefügte TextPath-Eigenschaft in das angegebene Element.
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)

Siehe auch

• ComboBox