Types d’annotation dynamique
Il existe trois types d’annotation dynamique pris en charge dans Microsoft Active Accessibility : l’annotation directe, l’annotationmappée par des valeurs et l’annotation de serveur. Chaque type offre des avantages spécifiques, il est donc important de comprendre les différences.
Annotation directe
L’annotation directe est la forme la plus simple d’annotation dynamique. Elle s’applique surtout aux éléments accessibles dont la propriété annotée ne dépend pas de l’état du contrôle et ne nécessite pas la prise en charge supplémentaire fournie par l’annotation mappée et l’annotation du serveur. L’annotation directe est utilisée pour remplacer la valeur d’une ou plusieurs propriétés Microsoft Active Accessibility d’un élément accessible et pour remplacer ou ajouter une propriété Microsoft UI Automation au contrôle. Toutes les annotations effectuées dans une propriété Microsoft Active Accessibility sont reflétées dans la traduction UI Automation ainsi que dans le proxy Microsoft Active Accessibility-to-UI Automation. Pour plus d’informations, consultez Annotation directe.
Annotation de mappage de valeurs
En plus d’annoter directement les propriétés IAccessible , il est souvent nécessaire de convertir une valeur spécifique au contrôle en chaîne qui peut être comprise par un utilisateur final. Par exemple, le contrôle de curseur de résolution d’écran sous l’onglet Paramètres de la fenêtre Propriétés d’affichage (à partir de Panneau de configuration). Bien que chaque position du curseur corresponde à une résolution différente (par exemple, 640 x 480, 1024 x 768), le contrôle n’a aucune connaissance de cette relation et ne peut pas transmettre ces informations à Microsoft Active Accessibility.
L’annotation mappée en valeur facilite cette tâche. À l’aide de cette forme d’annotation, vous pouvez spécifier des chaînes pour les valeurs de curseur et spécifier des rôles, des états et des descriptions pour les icônes dans les affichages liste et arborescence. Pour plus d’informations, consultez Annotation de mappage de valeurs.
Annotation du serveur
L’annotation du serveur permet aux développeurs d’inscrire un objet de rappel pour traiter les demandes clientes pour la propriété annotée d’un élément. Cet objet de rappel doit implémenter l’interface IAccPropServer et être inscrit auprès des services d’annotation Microsoft Active Accessibility. Une fois inscrit, il est invité à traiter toutes les demandes du client pour la valeur de propriété de cet élément accessible.
Une fonctionnalité particulièrement utile de l’annotation de serveur est qu’un serveur peut être inscrit une seule fois pour gérer les demandes d’un conteneur et de tous ses enfants. Ainsi, par exemple, un serveur unique peut être configuré une seule fois pour gérer les demandes pour tous les éléments est une zone de liste. Pour plus d’informations, consultez Annotation du serveur.