TextSearch Classe

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Permite que um usuário a acesse rapidamente itens em um conjunto digitando prefixos de cadeias de caracteres.

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

Herança

Object

DispatcherObject

DependencyObject

TextSearch

Exemplos

Os exemplos a seguir criam ComboBox controles que contêm imagens como itens em vez de texto. Funcionalmente, os exemplos são os mesmos. O primeiro exemplo define a TextPath propriedade no e o ComboBox segundo exemplo define a Text propriedade em cada item da coleção.

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

Comentários

Essa classe é usada para atribuir uma cadeia de caracteres a itens na coleção de um controle. Atribuir uma cadeia de caracteres a cada item na coleção atinge dois objetivos. Ele especifica o texto a ser exibido quando o item é selecionado e permite que o usuário selecione um item digitando a cadeia de caracteres atribuída.

Por exemplo, suponha que um ComboBox contém uma coleção de Image objetos, um dos quais é uma imagem de um cão. Se você atribuir a cadeia de caracteres, "Cão" a esse item, o usuário poderá selecionar o cão digitando a palavra na caixa de texto da caixa de combinação. Assim que o usuário digitar o suficiente da palavra para distingui-la de outros itens na seleção, a imagem do cão será selecionada. Se IsEditable estiver definido como true , ComboBox"Dog" aparecerá na caixa de texto.

Você pode especificar o texto que identifica um item usando a TextSearch.TextPath propriedade em um controle ou definindo a Text propriedade em cada item na coleção do controle. Definir uma dessas propriedades garante que o texto inesperado não seja exibido. Se você definir a Text propriedade no item de coleção de um controle, a TextPath propriedade será ignorada. Se você definir a TextPath propriedade como um valor que não é o nome de uma propriedade real, TextPath será ignorado.

Uso de texto XAML

Você não pode declarar essa classe gerenciada em XAML, mas pode usar suas propriedades estáticas para atribuir valores em XAML.

Campos

TextPathProperty	Identifica a propriedade TextPath anexada.
TextProperty	Identifica a propriedade Text anexada.

Propriedades

DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
IsSealed	Obtém um valor que indica se essa instância está validada no momento (somente leitura). (Herdado de DependencyObject)

Propriedades Anexadas

Text	Obtém ou define a cadeia de caracteres que identifica um item na coleção de um controle.
TextPath	Obtém ou define o nome da propriedade do item que identifica cada item na coleção de um controle.

Métodos

CheckAccess()	Determina se o thread de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Converte o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (Herdado de DependencyObject)
GetHashCode()	Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject. (Herdado de DependencyObject)
GetText(DependencyObject)	Retorna a cadeia de caracteres que identifica o item especificado.
GetTextPath(DependencyObject)	Retorna o nome da propriedade que identifica um item na coleção do elemento especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo para a propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject)
SetText(DependencyObject, String)	Grava o valor da propriedade anexada Text no elemento especificado.
SetTextPath(DependencyObject, String)	Grava a propriedade anexada TextPath no elemento especificado.
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)

Confira também

• ComboBox