TextSearch Klasse

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ermöglicht es einem Benutzer, schnell auf Elemente in einem Satz zuzugreifen, indem Präfixe von Zeichenfolgen eingegeben werden.

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 die 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. Er gibt den Text an, der beim Auswählen des Elements angezeigt werden soll, und ermöglicht es dem Benutzer, ein Element auszuwählen, indem er die zugewiesene Zeichenfolge eingibt.

Gehen Sie beispielsweise davon aus, dass eine ComboBox Sammlung von Image Objekten enthält, von denen eines ein Bild eines Hundes ist. Wenn Sie die Zeichenfolge "Dog" diesem Element zuweisen, kann der Benutzer den Hund auswählen, indem er das Wort in das Textfeld des Kombinationsfelds eingibt. 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 "ComboBoxHund" festgelegt true ist, wird im Textfeld "Hund" angezeigt.

Sie können den Text angeben, der ein Element identifiziert, indem Sie die TextSearch.TextPath Eigenschaft für ein Steuerelement verwenden oder 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 Sammlungselement 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

Name	Beschreibung
TextPathProperty	Identifies the TextPath attached property.
TextProperty	Identifies the Text attached property.

Eigenschaften

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

Angefügte Eigenschaften

Name	Beschreibung
Text	Dient zum Abrufen oder Festlegen der Zeichenfolge, die ein Element in der Auflistung eines Steuerelements identifiziert.
TextPath	Dient zum Abrufen oder Festlegen des Namens der Elementeigenschaft, die jedes Element in der Auflistung eines Steuerelements identifiziert.

Methoden

Name	Beschreibung
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject)
GetText(DependencyObject)	Gibt die Zeichenfolge zurück, die das angegebene Element identifiziert.
GetTextPath(DependencyObject)	Gibt den Namen der Eigenschaft zurück, die ein Element in der Auflistung des angegebenen Elements identifiziert.
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetText(DependencyObject, String)	Schreibt den Wert der Text angefügten Eigenschaft in das angegebene Element.
SetTextPath(DependencyObject, String)	Schreibt die TextPath angefügte Eigenschaft in das angegebene Element.
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (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 wird. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
VerifyAccess()	Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)

Weitere Informationen

• ComboBox