Partager via


CoreTextEditContext Classe

Définition

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

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.

S’applique à

Voir aussi