TextSearch Classe

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Permet à un utilisateur d'accéder rapidement aux éléments dans un jeu en entrant des préfixes de chaînes.

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

Héritage

Object

DispatcherObject

DependencyObject

TextSearch

Exemples

Les exemples suivants créent ComboBox des contrôles qui contiennent des images en tant qu’éléments au lieu de texte. Fonctionnellement, les exemples sont identiques. Le premier exemple définit la TextPath propriété sur la ComboBox propriété et le deuxième exemple définit la Text propriété sur chaque élément de la collection.

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

Remarques

Cette classe est utilisée pour affecter une chaîne à des éléments dans la collection d’un contrôle. L’attribution d’une chaîne à chaque élément de la collection accomplit deux objectifs. Il spécifie le texte à afficher lorsque l’élément est sélectionné et permet à l’utilisateur de sélectionner un élément en tapant la chaîne affectée.

Par exemple, supposons qu’un ComboBox objet contient une collection d’objets Image , dont l’une est une image d’un chien. Si vous attribuez la chaîne, « Dog » à cet élément, l’utilisateur peut sélectionner le chien en tapant le mot dans la zone de texte de la zone de liste déroulante. Dès que l’utilisateur entre suffisamment de mots pour le distinguer des autres éléments de la sélection, l’image du chien sera sélectionnée. S’il IsEditable est défini true sur le ComboBox, « Dog » s’affiche dans la zone de texte.

Vous pouvez spécifier le texte qui identifie un élément à l’aide de la TextSearch.TextPath propriété sur un contrôle ou en définissant la Text propriété sur chaque élément de la collection du contrôle. La définition de l’une de ces propriétés garantit que le texte inattendu n’est pas affiché. Si vous définissez la propriété sur l’élément Text de collection d’un contrôle, la TextPath propriété est ignorée. Si vous définissez la TextPath propriété sur une valeur qui n’est pas le nom d’une propriété réelle, TextPath est ignorée.

Utilisation du texte XAML

Vous ne pouvez pas déclarer cette classe managée en XAML, mais vous pouvez utiliser ses propriétés statiques pour affecter des valeurs en XAML.

Champs

TextPathProperty	Identifie la propriété jointe TextPath.
TextProperty	Identifie la propriété jointe Text.

Propriétés

DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)

Propriétés attachées

Text	Obtient ou définit la chaîne qui identifie un élément dans la collection d'un contrôle.
TextPath	Obtient ou définit le nom de la propriété des éléments qui identifie chaque élément dans la collection d'un contrôle.

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetText(DependencyObject)	Retourne la chaîne qui identifie l’élément spécifié.
GetTextPath(DependencyObject)	Retourne le nom de la propriété qui identifie un élément dans la collection de l’élément spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetText(DependencyObject, String)	Écrit la valeur de la propriété jointe Text dans l’élément spécifié.
SetTextPath(DependencyObject, String)	Écrit la propriété jointe TextPath dans l’élément spécifié.
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Voir aussi

• ComboBox