TextSearch Klasse

Definition

Ermöglicht es einem Benutzer, durch die Eingabe von Präfixen von Zeichenfolgen schnell auf Elemente in einem Satz zuzugreifen.Enables a user to quickly access items in a set by typing prefixes of strings.

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

Beispiele

In den folgenden Beispielen ComboBox werden Steuerelemente erstellt, die Bilder als Elemente anstelle von Text enthalten.The following examples create ComboBox controls that contain images as items instead of text. Funktionell sind die Beispiele identisch.Functionally, the examples are the same. Im ersten Beispiel wird die TextPath ComboBox -Eigenschaft auf festgelegt, und im zweiten Text Beispiel wird die-Eigenschaft für jedes Element in der-Auflistung festgelegt.The first example sets the TextPath property on the ComboBox and the second example sets the Text property on each item in the collection.

<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 Steuer Elements eine Zeichenfolge zuzuweisen.This class is used to assign a string to items in a control's collection. Wenn Sie jedem Element in der Auflistung eine Zeichenfolge zuweisen, werden zwei Ziele erreicht.Assigning a string to each item in the collection accomplishes two objectives. Gibt den Text an, der angezeigt werden soll, wenn das Element ausgewählt wird, und ermöglicht es dem Benutzer, ein Element auszuwählen, indem die zugewiesene Zeichenfolge eingegeben wird.It specifies the text to display when the item is selected, and it enables the user to select an item by typing the assigned string.

Angenommen, eine ComboBox enthält eine Auflistung von Image -Objekten, von denen eines ein Bild eines Hundes ist.For example, assume that a ComboBox contains a collection of Image objects, one of which is an image of a dog. Wenn Sie die Zeichenfolge "Dog" diesem Element zuweisen, kann der Benutzer den Hund auswählen, indem er das Wort in das Textfeld des Kombinations Felds eingegeben hat.If you assign the string, "Dog" to that item, the user can select the dog by typing the word in the combo box's text box. Sobald der Benutzer genug des Worts eingibt, um ihn von anderen Elementen in der Auswahl zu unterscheiden, wird das Bild des Hundes ausgewählt.As soon as the user types enough of the word to distinguish it from other items in the selection, the image of the dog will be selected. Wenn IsEditable auftrue festgelegt ist ,wird"Dog"imTextfeldangezeigt.ComboBoxIf IsEditable is set to true on the ComboBox, "Dog" will appear in the text box.

Sie können den Text, der ein Element identifiziert, mithilfe der TextSearch.TextPath -Eigenschaft für ein Steuerelement oder durch Text Festlegen der-Eigenschaft für jedes Element in der-Auflistung des Steuer Elements angeben.You can specify the text that identifies an item by using the TextSearch.TextPath property on a control or by setting the Text property on each item in the control's collection. Wenn Sie eine dieser Eigenschaften festlegen, stellen Sie sicher, dass kein unerwarteter Text angezeigt wird.Setting one of these properties ensures that unexpected text is not displayed. Wenn Sie die Text -Eigenschaft für das Sammel Element eines Steuer Elements festlegen TextPath , wird die-Eigenschaft ignoriert.If you set the Text property on a control's collection item, the TextPath property will be ignored. Wenn Sie die TextPath -Eigenschaft auf einen Wert festlegen, der nicht der Name einer tatsächlichen Eigenschaft ist TextPath , wird ignoriert.If you set the TextPath property to a value that is not the name of an actual property, TextPath is ignored.

Verwendung von XAML-TextXAML Text Usage

Sie können diese verwaltete Klasse nicht in XAMLXAMLdeklarieren, aber Sie können die statischen Eigenschaften verwenden, um XAMLXAMLWerte in zuzuweisen.You cannot declare this managed class in XAMLXAML, but you can use its static properties to assign values in XAMLXAML.

Felder

TextPathProperty

Bezeichnet die angefügte TextPath-Eigenschaft.Identifies the TextPath attached property.

TextProperty

Bezeichnet die angefügte Text-Eigenschaft.Identifies the Text attached property.

Eigenschaften

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)

Angefügte Eigenschaften

Text

Ruft die Zeichenfolge ab, die ein Element in der Auflistung eines Steuerelements identifiziert, oder legt diese fest.Gets or sets the string that identifies an item in a control's collection.

TextPath

Ruft den Namen der Elementeigenschaft ab, die jedes Element in der Auflistung eines Steuerelements identifiziert, oder legt diesen fest.Gets or sets the name of the items' property that identifies each item in a control's collection.

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetText(DependencyObject)

Gibt die Zeichenfolge zurück, die das angegebene Element bezeichnet.Returns the string to that identifies the specified item.

GetTextPath(DependencyObject)

Gibt den Namen der Eigenschaft zurück, die ein Element in der Auflistung des angegebenen Elements bezeichnet.Returns the name of the property that identifies an item in the specified element's collection.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetText(DependencyObject, String)

Schreibt den angefügten Text-Eigenschaftswert in das angegebene Element.Writes the Text attached property value to the specified element.

SetTextPath(DependencyObject, String)

Schreibt die angefügte TextPath-Eigenschaft in das angegebene Element.Writes the TextPath attached property to the specified element.

SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Gilt für:

Siehe auch