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 элементы управления, содержащие изображения в виде элементов, а не текста. В функциональном режиме примеры одинаковы. В первом примере свойство задается TextPath Text, ComboBox а во втором — свойство для каждого элемента в коллекции.

<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 задано значение true ComboBox"Собака" в текстовом поле.

Можно указать текст, идентифицирующий элемент, с помощью 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)	Возвращает имя свойства, которое определяет элемент в коллекции указанного элемента.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет действующее значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
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)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
VerifyAccess()	Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)

Применяется к

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

ComboBox