CoreTextEditContext Classe

Définition

Espace de noms:

Windows.UI.Text.Core

Objet principal utilisé par les contrôles d’entrée de texte pour communiquer avec le serveur d’entrée de texte.

public ref class CoreTextEditContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext

Public NotInheritable Class CoreTextEditContext

Héritage

Object Platform::Object IInspectable CoreTextEditContext

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Pour obtenir un objet de ce type, appelez CoreTextServicesManager.CreateEditContext.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1511	10586	NotifyFocusLeaveCompleted

Propriétés

InputPaneDisplayPolicy	Obtient ou définit une valeur qui indique si le volet d’entrée doit être affiché automatiquement lorsque le focus entre dans votre contrôle d’entrée de texte. La valeur par défaut est Automatique, ce qui indique que le volet d’entrée s’affiche automatiquement. La valeur Manual indique que votre application sera chargée d’afficher et de masquer le volet d’entrée à l’aide de InputPane.TryShow et TryHide.
InputScope	Obtient ou définit une valeur qui indique l’étendue d’entrée du contrôle d’entrée de texte.
IsReadOnly	Obtient ou définit une valeur qui indique si le contrôle d’édition est modifiable.
Name	Obtient ou définit un nom descriptif pour le contrôle d’entrée de texte. Une infrastructure d’application utilise généralement des propriétés telles que « name » ou « id » pour identifier un contrôle. Il est donc recommandé de définir cette propriété en conséquence sur le serveur d’entrée de texte afin que les processeurs d’entrée puissent mieux préserver le contexte d’entrée et fournir de meilleures suggestions.

Méthodes

NotifyFocusEnter()	Avertit le serveur d’entrée de texte que le focus a entré le contrôle d’entrée de texte.
NotifyFocusLeave()	Avertit le serveur d’entrée de texte que le focus a quitté le contrôle d’entrée de texte.
NotifyLayoutChanged()	Avertit le serveur d’entrée de texte que la disposition du texte à l’intérieur du contrôle d’entrée de texte a changé.
NotifySelectionChanged(CoreTextRange)	Avertit le serveur d’entrée de texte de toute modification que le contrôle d’entrée de texte doit apporter à la plage de sélection. Cela est important pour que l’état interne du contrôle et l’état interne du serveur restent synchronisés.
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	Avertit le serveur d’entrée de texte de toute modification que le contrôle d’entrée de texte doit apporter au texte. Cela est important pour que l’état interne du contrôle et l’état interne du serveur restent synchronisés. Étant donné qu’une modification du texte est également susceptible d’affecter la plage de sélection, la méthode prend la plage de sélection en tant que paramètre.

Événements

CompositionCompleted	Se produit lorsque la composition est terminée.
CompositionStarted	Se produit lorsque la composition a commencé.
FocusRemoved	Se produit lorsque le focus a été supprimé de force d’un contrôle d’entrée de texte. L’application doit gérer cet événement pour supprimer le focus pour le contrôle d’entrée de texte en conséquence.
FormatUpdating	Se produit lorsque le serveur d’entrée de texte doit appliquer un autre format à une plage de texte particulière. Cela se produit généralement pendant la composition.
LayoutRequested	Se produit lorsque le serveur d’entrée de texte doit obtenir le cadre englobant d’une plage de texte et du contrôle d’entrée de texte lui-même. L’application doit gérer cet événement et retourner les informations géométriques demandées.
NotifyFocusLeaveCompleted	Se produit une fois que le focus a quitté le contrôle d’entrée de texte.
SelectionRequested	Se produit lorsque le serveur d’entrée de texte doit obtenir la plage de texte représentant le texte actuellement sélectionné dans le contrôle d’entrée de texte. L’application doit gérer cet événement et retourner la plage demandée.
SelectionUpdating	Se produit lorsque le serveur d’entrée de texte doit modifier la plage de texte actuellement sélectionnée dans le contrôle d’entrée de texte. Cet événement peut être le résultat d’un processeur d’entrée qui a besoin de sélectionner du texte ou de déplacer le caret. Le contrôle d’entrée de texte doit définir sa plage de sélection en conséquence.
TextRequested	Se produit lorsque le serveur d’entrée de texte doit obtenir une plage de texte à partir du contrôle d’entrée de texte. L’application doit gérer cet événement et retourner la plage demandée.
TextUpdating	Se produit lorsque le serveur d’entrée de texte doit modifier du texte à l’intérieur du contrôle d’entrée de texte. Cet événement peut être le résultat d’un événement clé( par exemple, l’insertion d’un caractère unique) ou le résultat d’un traitement effectué par un processeur d’entrée, tel que la correction automatique et la prédiction. Lors de la gestion de l’événement, le contrôle d’entrée de texte doit remplacer une plage par le nouveau texte fourni par le serveur, et également déplacer la carete vers la fin du nouveau texte.

Voir aussi

• Exemple de contrôle d’édition personnalisé