CoreTextEditContext Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 CoreTextEditContextPublic NotInheritable Class CoreTextEditContext- Héritage
- 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. |