Modifier le contrôle (référence de l’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit modifier les objets de contrôle à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets Edit Control dans différentes infrastructures d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence sur l’API pour l’infrastructure d’interface utilisateur que vous utilisez.
Les contrôles Modifier permettent à un utilisateur d’afficher et de modifier du texte. Les contrôles d’édition sont créés avec de nombreux styles différents tels que ES_MULTILINE. Ce style crée un contrôle d’édition multiligne, tel que la zone cliente du Bloc-notes, et ES_READONLY, qui crée un contrôle d’édition en lecture seule.
Microsoft Active Accessibility ne fait pas de distinction entre les contrôles de modification créés avec le nom de classe de fenêtre « EDIT » et les contrôles d’édition enrichi créés avec le nom de la classe de fenêtre « RichEdit » ou « RichEdit20A ».
Méthodes IAccessible
Les contrôles Modifier prennent en charge les méthodes IAccessible suivantes :
Propriétés IAccessibles
Les contrôles Modifier prennent en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChild | |
| get_accChildCount | |
| get_accDescription | |
| get_accFocus | |
| get_accKeyboardShortcut | La propriété KeyboardShortcut est la clé d’accès du contrôle d’édition, qui est un caractère souligné dans le texte de l’étiquette du contrôle de modification. Par exemple, dans une boîte de dialogue Ouvrir de fichier standard, comme dans WordPad, la touche KeyboardShortcut du contrôle d’édition intitulé « Filename: » est « Alt+n ». |
| get_accName | La propriété Name est le texte d’un contrôle de texte statique qui étiquette le contrôle de modification. Par exemple, dans une boîte de dialogue Ouvrir de fichier standard, comme dans WordPad, la propriété Name du contrôle d’édition est « Nom du fichier : ». |
| get_accParent | La propriété Parent est une fenêtre ( ROLE_SYSTEM_WINDOW ) qui entoure le contrôle et a la même propriété Name et le même nom de classe de fenêtre que le contrôle. |
| get_accRole | La propriété Role est ROLE_SYSTEM_TEXT. |
| get_accSelection | |
| get_accState | La propriété State est une combinaison d’une ou plusieurs des valeurs suivantes :STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL |
| get_accValue | La propriété Value est une chaîne unique qui contient le texte dans le contrôle d’édition. Toutefois, si le contrôle est protégé par mot de passe, la propriété Value retourne E_ACCESSDENIED. Pour les contrôles d’édition multiligne, la chaîne contient un retour chariot et un caractère de nouvelle ligne à la fin de chaque ligne. |
Notes
Microsoft Active Accessibility ne prend pas en charge la sélection du texte contenu dans les contrôles d’édition et de modification enrichie, car le texte est exposé sous forme de chaîne dans la propriété Value de l’objet.
Le contrôle d’édition enrichi fourni par Riched20.dll (qui est utilisé dans les éditeurs de texte tels que WordPad dans Windows 98) n’envoie pas de WinEvents lorsque la position de la carete est modifiée lors de la sélection de texte. Lorsque les utilisateurs appuient sur maj et les touches de direction pour sélectionner du texte, l’objet caret ne déclenche pas le EVENT_OBJECT_LOCATIONCHANGE WinEvent. Lorsque la sélection est définie par programmation par le biais de messages d’édition enrichis, l’objet caret n’envoie aucun événement pour indiquer sa nouvelle position.
Toutes les applications qui utilisent Riched20.dll présentent ce problème. Les applications qui utilisent des versions antérieures du contrôle d’édition enrichi envoient correctement des événements en fonction de la sélection.
La valeur State pour les contrôles de modification de mot de passe inclut toujours l’indicateur de bits STATE_SYSTEM_PROTECTED.