Instructions d’implémentation iAccessibleEx

Microsoft UI Automation core peut récupérer toutes les propriétés d’accessibilité Active Microsoft pour tout objet accessible exposé par un serveur via l’interface IAccessible. Lors de l’implémentation de IAccessibleEx, vous devez exposer uniquement les aspects de la fonctionnalité d’interface utilisateur qui ne peuvent pas être exposés par le biais de propriétés Microsoft Active Accessibility existantes. Cette rubrique identifie les propriétés et les modèles de contrôle UI Automation qui représentent les fonctionnalités d’interface utilisateur qui n’ont aucun équivalent dans Microsoft Active Accessibility. Il s’agit des propriétés et des modèles de contrôle que vous pouvez exposer dans une implémentation IAccessibleEx.

Cette rubrique contient les sections suivantes :

• propriétés
• modèles de contrôle
• WinEvents pour les événements modifiés de propriété UI Automation
• rubriques connexes

Propriétés

Les propriétés UI Automation suivantes ne chevauchent pas les fonctionnalités d’accessibilité Microsoft Active. Ils peuvent être utilisés dans une implémentation IAccessibleEx :

• AriaProperties
• AriaRole
• AutomationId
• ClassName
• ClickablePoint
• ControllerFor
• Culture
• DescriptionBy
• FlowTo
• FrameworkId
• IsContentElement
• IsControlElement
• IsDataValidForForm
• IsRequiredForForm
• ItemStatus
• ItemType
• LabeledBy
• LocalizedControlType
• Orientation

Bien que les propriétés AcceleratorKey et AccessKey UI Automation se chevauchent avec la propriété accKeyboardShortcut Microsoft Active Accessibility, vous pouvez toujours les utiliser dans une implémentation IAccessibleEx pour les contrôles qui ont à la fois une clé d’accès et un accélérateur. De même, la propriété ControlType UI Automation chevauche la propriété Microsoft Active Accessibility accRole, mais vous pouvez toujours l’utiliser dans une implémentation IAccessibleEx pour définir un rôle plus spécifique pour un contrôle.

Étant donné que les propriétés d’élément UI Automation suivantes sont déjà couvertes par les propriétés Microsoft Active Accessibility, il n’est pas nécessaire de les utiliser dans une implémentation IAccessibleEx.

Pour toute propriété UI Automation non prise en charge, votre implémentation de la méthode IRawElementProviderSimple ::GetPropertyValue doit définir le paramètre pRetVal sur VT_EMPTY et retourner S_OK. Retourner UIA_E_NOTSUPPORTED peut entraîner la suppression du mappage par défaut du proxy MSAA-to-UIA pour la propriété correspondante.

Modèles de contrôle

Les modèles de contrôle UI Automation suivants ne chevauchent pas les fonctionnalités d’accessibilité Active Microsoft. Ils peuvent être utilisés dans une implémentation IAccessibleEx :

• Bassin
• ExpandCollapse
• Grille
• GridItem
• MultipleView
• RangeValue
• Faire défiler
• ScrollItem
• SynchronizedInput
• Table
• TableItem
• Transformer

Pour les modèles de contrôle RangeValue et Transform, certaines méthodes se chevauchent entre le modèle de contrôle UI Automation et les méthodes Microsoft Active Accessibility. Dans ces cas, les deux doivent être implémentés. Par exemple, les méthodes IAccessible ::get_accValue et IAccessible ::p ut_accValue de Microsoft doivent être implémentées, car ui AutomationIRangeValueProvider ::Value et méthodes IRangeValueValueProvider ::SetValue. En interne, une implémentation peut partager du code pour celles-ci. Cette exigence pour implémenter les deux ensembles évite d’avoir une implémentation partielle d’une interface de modèle tout en conservant l’interface IAccessible utilisable par les clients Microsoft Active Accessibility existants.

Les modèles de contrôle UI Automation suivants ne sont pas obligatoires lorsque le contrôle a l’un des rôles décrits ci-dessous ; sinon, elles doivent être explicitement prises en charge si elles sont pertinentes.

Événements modifiés de propriété WinEvents pour UI Automation

Outre les événements définis pour IAccessible, les identificateurs d’événement suivants sont également définis et peuvent être utilisés avec une implémentation IAccessibleEx en tant qu’événements modifiés par propriété pour les propriétés UI Automation correspondantes. Ils utilisent le même mécanisme que les événements définis pour IAccessible . Pour plus d’informations, consultez WinEvents.

Pour les événements ci-dessus qui ont une valeur EVENT_OBJECT_ répertoriée après eux, et implémentation iAccessibleEx doit déclencher cet événement en plus de l’événement modifié répertorié. Cela permet à IAccessibleEx code client existant de continuer à fonctionner, tout en transmettant des informations d’événement plus granulaires aux clients intéressés.

Rubriques connexes

WinEvents

l’interface IAccessibleEx