TextSearch Класс

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Позволяет пользователю быстро получать доступ к элементам в наборе путем ввода префиксов строк.

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

Наследование

Object

DispatcherObject

DependencyObject

TextSearch

Примеры

В следующих примерах создаются ComboBox элементы управления, содержащие изображения в виде элементов вместо текста. Функциональные примеры одинаковы. Первый пример задает свойство в ComboBox следующем примере, а второй пример задает TextPathText свойство для каждого элемента в коллекции.

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

Комментарии

Этот класс используется для назначения строки элементам в коллекции элемента управления. Назначение строки каждому элементу в коллекции выполняет две цели. Он задает текст, отображаемый при выборе элемента, и позволяет пользователю выбрать элемент, введя назначенную строку.

Например, предположим, что объект ComboBox содержит коллекцию Image объектов, один из которых является изображением собаки. Если назначить строку "Собака" этому элементу, пользователь может выбрать собаку, введя слово в текстовом поле со списком. Как только пользователь достаточно типов слова, чтобы отличить его от других элементов в выборе, будет выбрано изображение собаки. Если IsEditable для параметра "trueComboBoxСобака" будет отображаться текстовое поле.

Можно указать текст, который идентифицирует элемент с помощью TextSearch.TextPath свойства в элементе управления или задав Text свойство для каждого элемента в коллекции элемента управления. Установка одного из этих свойств гарантирует, что непредвиденный текст не отображается. Если задать Text свойство для элемента коллекции элемента элемента управления, TextPath свойство будет игнорироваться. Если для свойства задано TextPath значение, которое не является именем фактического свойства, TextPath игнорируется.

Использование текста XAML

Вы не можете объявить этот управляемый класс в XAML, но можно использовать его статические свойства для назначения значений в XAML.

Поля

Имя	Описание
TextPathProperty	Определяет присоединенное TextPath свойство.
TextProperty	Определяет присоединенное Text свойство.

Свойства

Имя	Описание
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)

Присоединенные свойства

Имя	Описание
Text	Возвращает или задает строку, которая идентифицирует элемент в коллекции элемента управления.
TextPath	Возвращает или задает имя свойства элементов, которое определяет каждый элемент в коллекции элемента управления.

Методы

Имя	Описание
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetText(DependencyObject)	Возвращает строку, в которую идентифицируется указанный элемент.
GetTextPath(DependencyObject)	Возвращает имя свойства, определяющего элемент в коллекции указанного элемента.
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Вызывается при каждом обновлении эффективного значения любого свойства DependencyObject зависимостей. Определенное свойство зависимостей, которое изменилось, сообщается в данных события. (Унаследовано от DependencyObject)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetText(DependencyObject, String)	Записывает значение присоединенного Text свойства в указанный элемент.
SetTextPath(DependencyObject, String)	Записывает присоединенное TextPath свойство в указанный элемент.
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)

См. также раздел

• ComboBox