TextSearch Classe

Definição

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

Propriedades

Propriedades Anexadas

Métodos

Aplica-se a

Confira também

• ComboBox