TextSearch Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite a un usuario tener acceso rápidamente a los elementos de un conjunto escribiendo prefijos de cadenas.
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
- Herencia
Ejemplos
En los ejemplos siguientes se crean ComboBox controles que contienen imágenes como elementos en lugar de texto. Funcionalmente, los ejemplos son los mismos. El primer ejemplo establece la TextPath propiedad en ComboBox y el segundo ejemplo establece la Text propiedad en cada elemento de la colecció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>
Comentarios
Esta clase se usa para asignar una cadena a los elementos de la colección de un control. La asignación de una cadena a cada elemento de la colección logra dos objetivos. Especifica el texto que se va a mostrar cuando se selecciona el elemento y permite al usuario seleccionar un elemento escribiendo la cadena asignada.
Por ejemplo, supongamos que contiene ComboBox una colección de Image objetos , una de las cuales es una imagen de un perro. Si asigna la cadena "Dog" 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 lo suficiente de la palabra para distinguirlo de otros elementos de la selección, se seleccionará la imagen del perro. Si IsEditable se establece true
en en ComboBox, "Dog" aparecerá en el cuadro de texto.
Puede especificar el texto que identifica un elemento mediante la TextSearch.TextPath propiedad de un control o estableciendo la Text propiedad en cada elemento de la colección del control. Establecer una de estas propiedades garantiza que no se muestre texto inesperado. Si establece la propiedad en el Text elemento de colección de un control, se omitirá la TextPath propiedad . Si establece la TextPath propiedad en un valor que no es el nombre de una propiedad real, TextPath se omite.
Uso de texto XAML
No puedes declarar esta clase administrada en XAML, pero puedes usar sus propiedades estáticas para asignar valores en XAML.
Campos
TextPathProperty |
Identifica la propiedad adjunta TextPath. |
TextProperty |
Identifica la propiedad adjunta Text. |
Propiedades
DependencyObjectType |
Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject) |
Dispatcher |
Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject) |
IsSealed |
Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject) |
Propiedades adjuntas
Text |
Obtiene o establece la cadena que identifica un elemento de una recolección de control. |
TextPath |
Obtiene o establece el nombre de la propiedad de los elementos que identifica cada elemento de una colección del control. |
Métodos
CheckAccess() |
Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject) |
ClearValue(DependencyProperty) |
Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject) |
ClearValue(DependencyPropertyKey) |
Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject) |
CoerceValue(DependencyProperty) |
Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject) |
Equals(Object) |
Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject) |
GetHashCode() |
Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject) |
GetLocalValueEnumerator() |
Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject) |
GetText(DependencyObject) |
Devuelve la cadena que identifica el elemento especificado. |
GetTextPath(DependencyObject) |
Devuelve el nombre de la propiedad que identifica un elemento de la colección del elemento especificado. |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
GetValue(DependencyProperty) |
Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject) |
InvalidateProperty(DependencyProperty) |
Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento. (Heredado de DependencyObject) |
ReadLocalValue(DependencyProperty) |
Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject) |
SetCurrentValue(DependencyProperty, Object) |
Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject) |
SetText(DependencyObject, String) |
Escribe el valor de propiedad adjunta Text en el elemento especificado. |
SetTextPath(DependencyObject, String) |
Escribe la propiedad adjunta TextPath en el elemento especificado. |
SetValue(DependencyProperty, Object) |
Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject) |
SetValue(DependencyPropertyKey, Object) |
Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject) |
ShouldSerializeProperty(DependencyProperty) |
Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
VerifyAccess() |
Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject) |