TextSearch Classe

Definição

Espaço de Nomes:
System.Windows.Controls
Assemblagem:
PresentationFramework.dll

Permite ao utilizador aceder rapidamente a itens de um conjunto digitando prefixos de cadeias.

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 seguintes criam ComboBox controlos que contêm imagens como itens em vez de texto. Funcionalmente, os exemplos são os mesmos. O primeiro exemplo define a TextPath propriedade em e ComboBox o 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>

Observações

Esta classe é usada para atribuir uma cadeia de caracteres a itens na coleção de um controlo. Atribuir uma sequência a cada item da coleção cumpre dois objetivos. Especifica o texto a mostrar quando o item é selecionado e permite ao utilizador selecionar um item ao escrever a cadeia atribuída.

Por exemplo, suponha que a ComboBox contém uma coleção de Image objetos, um dos quais é a imagem de um cão. Se atribuir a cadeia "Cão" a esse item, o utilizador pode selecionar o cão digitando a palavra na caixa de texto da caixa de combo. Assim que o utilizador digitar o suficiente da palavra para a distinguir de outros itens na seleção, a imagem do cão será selecionada. Se IsEditable estiver definido para true no ComboBox, "Cão" aparecerá na caixa de texto.

Pode especificar o texto que identifica um item usando a TextSearch.TextPath propriedade num controlo ou definindo a Text propriedade em cada item da coleção do controlo. Definir uma destas propriedades garante que texto inesperado não é exibido. Se definir a Text propriedade no item de cobrança de um controlo, a TextPath propriedade será ignorada. Se definir a TextPath propriedade para um valor que não é o nome de uma propriedade real, TextPath é ignorado.

Utilização de Texto XAML

Não podes declarar esta classe gerida em XAML, mas podes usar as suas propriedades estáticas para atribuir valores em XAML.

Campos

Name Description
TextPathProperty

Identifica a TextPath propriedade anexada.
TextProperty

Identifica a Text propriedade anexada.

Propriedades

Name Description
DependencyObjectType

Obtém o DependencyObjectType que envolve o tipo CLR desta instância.

(Herdado de DependencyObject)
Dispatcher

Percebe o Dispatcher que isto DispatcherObject está associado.

(Herdado de DispatcherObject)
IsSealed

Recebe um valor que indica se esta instância está atualmente selada (apenas leitura).

(Herdado de DependencyObject)

Propriedades Anexadas

Name Description
Text

Obtém ou define a cadeia que identifica um item na coleção de um controlo.
TextPath

Obtém ou define o nome da propriedade dos itens que identifica cada item na coleção de um controlo.

Métodos

Name Description
CheckAccess()

Determina se o thread que chama 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 DependencyProperty identificador.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey.

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject.

(Herdado de DependencyObject)
Equals(Object)

Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject.

(Herdado de DependencyObject)
GetHashCode()

Obtém um código de hash para isto DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject.

(Herdado de DependencyObject)
GetText(DependencyObject)

Devolve a string para que identifica o item especificado.
GetTextPath(DependencyObject)

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

Devolve o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo da propriedade de dependência especificada.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada nos dados do evento.

(Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)

Devolve o valor local de uma propriedade de dependência, se esta existir.

(Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor.

(Herdado de DependencyObject)
SetText(DependencyObject, String)

Escreve o Text valor da propriedade associada ao elemento especificado.
SetTextPath(DependencyObject, String)

Escreve a TextPath propriedade associada ao elemento especificado.
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência.

(Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência.

(Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.

(Herdado de DependencyObject)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
VerifyAccess()

Faz cumprir que o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)

Aplica-se a

Ver também