TextSearch Класс

Определение

Позволяет пользователю быстро получать доступ к элементам набора, вводя префиксы строк.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
Наследование

Примеры

В следующих примерах ComboBox создаются элементы управления, содержащие изображения в виде элементов, а не текста.The following examples create ComboBox controls that contain images as items instead of text. Функционально, примеры одинаковы.Functionally, the examples are the same. В первом примере задается TextPath свойство ComboBox в, а во втором примере задается Text свойство для каждого элемента в коллекции.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>

Комментарии

Этот класс используется для присвоения строки элементам в коллекции элемента управления.This class is used to assign a string to items in a control's collection. Назначение строки каждому элементу в коллекции выполняет две задачи.Assigning a string to each item in the collection accomplishes two objectives. Он задает текст, отображаемый при выборе элемента, и позволяет пользователю выбрать элемент, введя назначенную строку.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.

Например, предположим, что ComboBox содержит Image коллекцию объектов, один из которых является изображением Dog.For example, assume that a ComboBox contains a collection of Image objects, one of which is an image of a dog. Если назначить строку "Dog" этому элементу, пользователь может выбрать собака, введя слово в текстовом поле поля со списком.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. Как только пользователь вводит достаточное слово, чтобы отличать его от других элементов в выделенном фрагменте, будет выбрано изображение 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. Если IsEditable для true параметраComboBoxзадано значение, в текстовом поле появится "собака".If IsEditable is set to true on the ComboBox, "Dog" will appear in the text box.

Можно указать текст, определяющий элемент, с помощью TextSearch.TextPath свойства в элементе управления или Text задав свойство для каждого элемента в коллекции элемента управления.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. Установка одного из этих свойств гарантирует, что непредвиденный текст не будет отображаться.Setting one of these properties ensures that unexpected text is not displayed. Если задать Text свойство для элемента коллекции элемента управления, это TextPath свойство будет пропущено.If you set the Text property on a control's collection item, the TextPath property will be ignored. Если задать TextPath для свойства значение, которое не является именем фактического свойства, TextPath то игнорируется.If you set the TextPath property to a value that is not the name of an actual property, TextPath is ignored.

Использование текста XAMLXAML Text Usage

Этот управляемый класс нельзя объявить XAMLXAMLв, но можно использовать его статические свойства для присвоения XAMLXAMLзначений в.You cannot declare this managed class in XAMLXAML, but you can use its static properties to assign values in XAMLXAML.

Поля

TextPathProperty

Идентифицирует присоединенное свойство TextPath.Identifies the TextPath attached property.

TextProperty

Идентифицирует присоединенное свойство Text.Identifies the Text attached property.

Свойства

DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Унаследовано от DependencyObject)
Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject)
IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Унаследовано от DependencyObject)

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

Text

Получает или задает строку, которая определяет элемент в коллекции элемента управления.Gets or sets the string that identifies an item in a control's collection.

TextPath

Получает или задает имя свойства элемента, которое определяет каждый элемент в коллекции элемента управления.Gets or sets the name of the items' property that identifies each item in a control's collection.

Методы

CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Унаследовано от DependencyObject)
Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Унаследовано от DependencyObject)
GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject)
GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Унаследовано от DependencyObject)
GetText(DependencyObject)

Возвращает строку, которая определяет указанный элемент.Returns the string to that identifies the specified item.

GetTextPath(DependencyObject)

Возвращает имя свойства, которое определяет элемент в коллекции указанного элемента.Returns the name of the property that identifies an item in the specified element's collection.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостей.Re-evaluates the effective value for the specified dependency property.

(Унаследовано от DependencyObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Конкретное измененное свойство зависимостей сообщается в данных события.The specific dependency property that changed is reported in the event data.

(Унаследовано от DependencyObject)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Унаследовано от DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Унаследовано от DependencyObject)
SetText(DependencyObject, String)

Записывает значение присоединенного свойства Text в указанный элемент.Writes the Text attached property value to the specified element.

SetTextPath(DependencyObject, String)

Записывает присоединенное свойство TextPath в указанный элемент.Writes the TextPath attached property to the specified element.

SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Унаследовано от DependencyObject)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)

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

Дополнительно