Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

TextSearch (Clase)

Permite a un usuario tener acceso rápidamente a los elementos de un conjunto escribiendo prefijos de cadenas.

Espacio de nombres:  System.Windows.Controls
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public sealed class TextSearch : DependencyObject
Esta clase administrada no se puede declarar en XAML, pero se pueden utilizar propiedades estáticas para asignar valores en XAML.

El tipo TextSearch expone los siguientes miembros.

  NombreDescripción
Propiedad públicaDependencyObjectTypeObtiene el objeto DependencyObjectType que ajusta el tipo CLR de esta instancia.  (Se hereda de DependencyObject).
Propiedad públicaDispatcherObtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
Propiedad públicaIsSealedObtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Se hereda de DependencyObject).
Arriba

  NombreDescripción
Propiedad pública asociadaTextObtiene o establece la cadena que identifica un elemento de una recolección de control.
Propiedad pública asociadaTextPathObtiene o establece el nombre de la propiedad de los elementos que identifica cada elemento de una recolección del control.
Arriba

  NombreDescripción
Método públicoCheckAccess Determina si el subproceso de la llamada tiene acceso a este DispatcherObject. (Se hereda de DispatcherObject).
Método públicoClearValue(DependencyProperty) Borra el valor local de una propiedad. La propiedad que se borrará se especifica mediante un identificador de DependencyProperty. (Se hereda de DependencyObject).
Método públicoClearValue(DependencyPropertyKey) Borra el valor local de una propiedad de sólo lectura. La propiedad que se borrará es especificada por DependencyPropertyKey. (Se hereda de DependencyObject).
Método públicoCoerceValue Fuerza el valor de propiedad de la dependencia especificada. Esto se logra a cualquier función de CoerceValueCallback especificada en los metadatos de propiedad para la propiedad de dependencia tal como existe en el objeto DependencyObject que llama. (Se hereda de DependencyObject).
Método públicoEquals Determina si un DependencyObject proporcionado es equivalente a DependencyObject actual. (Se hereda de DependencyObject).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoGetHashCode Obtiene un código hash para este DependencyObject. (Se hereda de DependencyObject).
Método públicoGetLocalValueEnumeratorCrea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Se hereda de DependencyObject).
Método públicoMiembro estáticoGetTextDevuelve la cadena que identifica el elemento especificado.
Método públicoMiembro estáticoGetTextPathDevuelve el nombre de la propiedad que identifica un elemento de la recolección del elemento especificado.
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetValue Devuelve el valor efectivo actual de propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
Método públicoInvalidatePropertyVuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Se hereda de DependencyObject).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnPropertyChanged Invocado siempre que el valor efectivo de cualquier propiedad de dependencia en este DependencyObject se haya actualizado. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento. (Se hereda de DependencyObject).
Método públicoReadLocalValue Devuelve el valor local de propiedad de dependencia, si existe. (Se hereda de DependencyObject).
Método públicoSetCurrentValueEstablece el valor de una propiedad de dependencia sin cambiar el origen de su valor. (Se hereda de DependencyObject).
Método públicoMiembro estáticoSetText Escribe el valor de la propiedad adjunta Text en el elemento especificado.
Método públicoMiembro estáticoSetTextPath Escribe la propiedad adjunta TextPath en el elemento especificado.
Método públicoSetValue(DependencyProperty, Object)Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Se hereda de DependencyObject).
Método públicoSetValue(DependencyPropertyKey, Object)Establece el valor local de una propiedad de dependencia de sólo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Se hereda de DependencyObject).
Método protegidoShouldSerializePropertyDevuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Se hereda de DependencyObject).
Método públicoToString Devuelve una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoVerifyAccessExige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
Arriba

  NombreDescripción
Campo públicoMiembro estáticoTextPathPropertyIdentifica la propiedad adjunta de TextPath.
Campo públicoMiembro estáticoTextPropertyIdentifica la propiedad adjunta de Text.
Arriba

Esta clase se utiliza para asignar una cadena a los elementos de una recolección de control. Al asignar una cadena a cada elemento de la recolección, se logran dos objetivos. Especifica el texto que se muestra cuando el elemento está seleccionado y permite al usuario seleccionar un elemento escribiendo la cadena asignada.

Por ejemplo, suponga que un ComboBox contiene una recolección de objetos Image, uno de los cuales es una imagen de un perro. Si asigna la cadena "Perro" a ese elemento, el usuario puede seleccionar el perro escribiendo la palabra en el cuadro de texto del cuadro combinado. En cuanto el usuario escriba una parte suficiente de la palabra para distinguirla de otros elementos de la selección, la imagen del perro estará seleccionada. Si IsEditable está establecido en true en ComboBox, aparecerá "Perro" en el cuadro de texto.

Puede especificar el texto que identifica un elemento mediante la propiedad TextSearch.TextPath en un control o estableciendo la propiedad Text en cada elemento de la recolección del control. Estableciendo una de estas propiedades, se asegura de que no aparezca texto inesperado. Si establece la propiedad Text en el elemento de colección de un control, se omitirá la propiedad TextPath. Si establece la propiedad TextPath en un valor que no es el nombre de una propiedad real, se omite TextPath.

En los ejemplos siguientes se crean controles ComboBox que contienen imágenes como elementos en lugar de texto. Funcionalmente, los ejemplos son los mismos. El primer ejemplo establece la propiedad TextPath en ComboBox y el segundo ejemplo establece la propiedad Text en cada elemento de la recolección.


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


.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Mostrar: