TextSearch Klasa

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Umożliwia użytkownikowi szybki dostęp do elementów w zestawie, wpisując prefiksy ciągów.

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

Object

DispatcherObject

DependencyObject

TextSearch

Przykłady

W poniższych przykładach są tworzone ComboBox kontrolki zawierające obrazy jako elementy zamiast tekstu. W sposób funkcjonalny przykłady są takie same. Pierwszy przykład ustawia TextPath właściwość na ComboBox obiekcie , a drugi przykład ustawia Text właściwość dla każdego elementu w kolekcji.

<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. Przypisanie ciągu do każdego elementu w kolekcji osiąga dwa cele. Określa tekst wyświetlany po wybraniu elementu i umożliwia użytkownikowi wybranie elementu przez wpisanie przypisanego ciągu.

Załóżmy na przykład, że obiekt ComboBox zawiera kolekcję Image obiektów, z których jeden jest obrazem psa. Jeśli przypiszesz ciąg "Dog" do tego elementu, użytkownik może wybrać psa, wpisując słowo w polu tekstowym pola kombi. Gdy tylko użytkownik wpisze wystarczająco dużo słowa, aby odróżnić go od innych elementów w zaznaczeniu, zostanie wybrany obraz psa. Jeśli IsEditable wartość jest ustawiona true ComboBoxna wartość , w polu tekstowym pojawi się wartość "Pies".

Możesz określić tekst identyfikujący element przy użyciu TextSearch.TextPath właściwości kontrolki lub ustawiając Text właściwość dla każdego elementu w kolekcji kontrolki. Ustawienie jednej z tych właściwości gwarantuje, że nieoczekiwany tekst nie zostanie wyświetlony. Jeśli ustawisz Text właściwość elementu kolekcji kontrolki, TextPath właściwość zostanie zignorowana. Jeśli właściwość zostanie ustawiona TextPath na wartość, która nie jest nazwą właściwości rzeczywistej, TextPath zostanie zignorowana.

Użycie tekstu w języku XAML

Nie można zadeklarować tej klasy zarządzanej w języku XAML, ale możesz użyć jej właściwości statycznych do przypisania wartości w języku XAML.

Pola

TextPathProperty	Identyfikuje dołączoną TextPath właściwość.
TextProperty	Identyfikuje dołączoną Text właściwość.

Właściwości

DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)

Właściwości dołączone

Text	Pobiera lub ustawia ciąg identyfikujący element w kolekcji kontrolki.
TextPath	Pobiera lub ustawia nazwę właściwości elementów, która identyfikuje każdy element w kolekcji kontrolki.

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. 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, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetText(DependencyObject)	Zwraca ciąg identyfikujący określony element.
GetTextPath(DependencyObject)	Zwraca nazwę właściwości, która identyfikuje element w kolekcji określonego elementu.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy zostanie zaktualizowana efektywna wartość dowolnej właściwości DependencyObject zależności. Określona właściwość zależności, która została zmieniona, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject)
SetText(DependencyObject, String)	Zapisuje wartość dołączonej Text właściwości do określonego elementu.
SetTextPath(DependencyObject, String)	Zapisuje dołączoną TextPath właściwość do określonego elementu.
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Zobacz też

• ComboBox