TextSearch Klasa

Definicja

Umożliwia użytkownikowi szybkie uzyskiwanie dostępu do elementów w zestawie przez wpisanie prefiksów ciągów.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
Dziedziczenie

Przykłady

Poniższe przykłady tworzą ComboBox kontrolki, które zawierają obrazy jako elementy zamiast tekstu.The following examples create ComboBox controls that contain images as items instead of text. Te przykłady są takie same.Functionally, the examples are the same. Pierwszy przykład ustawia TextPath Właściwość dla ComboBox i drugi przykład ustawia Text Właściwość dla każdego elementu w kolekcji.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>

Uwagi

Ta klasa służy do przypisywania ciągu do elementów w kolekcji kontrolki.This class is used to assign a string to items in a control's collection. Przypisanie ciągu do każdego elementu w kolekcji osiąga dwa cele.Assigning a string to each item in the collection accomplishes two objectives. Określa tekst, który ma być wyświetlany, gdy element jest zaznaczony, i umożliwia użytkownikowi wybranie elementu przez wpisanie przypisanego ciągu.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.

Załóżmy na przykład, że element ComboBox zawiera kolekcję Image obiektów, z których jeden jest obrazem Dog.For example, assume that a ComboBox contains a collection of Image objects, one of which is an image of a dog. Jeśli przypiszesz ciąg "Dog" do tego elementu, użytkownik może wybrać pies, wpisując słowo w polu tekstowym pola kombi.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. Gdy tylko użytkownik wpisze wystarczająco dużo wyrazu w celu odróżnienia go od innych elementów w zaznaczeniu, zostanie wybrany obraz tego Dog.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. Jeśli IsEditable jest ustawiona na wartość true , w ComboBox polu tekstowym zostanie wyświetlony tekst "Dog".If IsEditable is set to true on the ComboBox, "Dog" will appear in the text box.

Można określić tekst identyfikujący element przy użyciu TextSearch.TextPath właściwości kontrolki lub przez ustawienie Text właściwości dla każdego elementu w kolekcji kontrolki.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. Ustawienie jednej z tych właściwości gwarantuje, że nieoczekiwany tekst nie zostanie wyświetlony.Setting one of these properties ensures that unexpected text is not displayed. Jeśli ustawisz Text Właściwość dla elementu kolekcji kontrolki, TextPath Właściwość zostanie zignorowana.If you set the Text property on a control's collection item, the TextPath property will be ignored. Jeśli ustawisz TextPath Właściwość na wartość, która nie jest nazwą rzeczywistej właściwości, TextPath jest ignorowana.If you set the TextPath property to a value that is not the name of an actual property, TextPath is ignored.

Użycie tekstu w języku XAMLXAML Text Usage

Nie można zadeklarować tej klasy zarządzanej w XAMLXAML , ale można użyć jej właściwości statycznych do przypisywania wartości w XAMLXAML .You cannot declare this managed class in XAMLXAML, but you can use its static properties to assign values in XAMLXAML.

Pola

TextPathProperty

Identyfikuje TextPath załączoną właściwość.Identifies the TextPath attached property.

TextProperty

Identyfikuje Text załączoną właściwość.Identifies the Text attached property.

Właściwości

DependencyObjectType

Pobiera DependencyObjectType , który zawija CLRCLR Typ tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)

Właściwości dołączone

Text

Pobiera lub ustawia ciąg, który identyfikuje element w kolekcji kontrolki.Gets or sets the string that identifies an item in a control's collection.

TextPath

Pobiera lub ustawia nazwę właściwości Items, która identyfikuje każdy element w kolekcji kontrolki.Gets or sets the name of the items' property that identifies each item in a control's collection.

Metody

CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetText(DependencyObject)

Zwraca ciąg, który identyfikuje określony element.Returns the string to that identifies the specified item.

GetTextPath(DependencyObject)

Zwraca nazwę właściwości, która identyfikuje element w kolekcji określonego elementu.Returns the name of the property that identifies an item in the specified element's collection.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności na tej stronie DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetText(DependencyObject, String)

Zapisuje Text wartość dołączonej właściwości do określonego elementu.Writes the Text attached property value to the specified element.

SetTextPath(DependencyObject, String)

Zapisuje TextPath załączoną właściwość do określonego elementu.Writes the TextPath attached property to the specified element.

SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Dotyczy

Zobacz też