Fourniture de la propriété Name

Les développeurs de serveurs doivent veiller à créer des contrôles prédéfinis et courants pour s’assurer que Microsoft Active Accessibility peut exposer la propriété Name du contrôle. Selon le type de contrôle, le texte de la propriété Name provient de l’un des éléments suivants :

• Texte de la fenêtre du contrôle (ou légende)
• Texte statique qui étiquette le contrôle

Pour rechercher le texte de la fenêtre du contrôle, Microsoft Active Accessibility envoie le message WM_GETTEXT au contrôle. Ce texte correspond au paramètre de texte dans l’instruction de définition de ressource du contrôle. Pour certains contrôles, tels que les boutons, il s’agit du même texte que celui affiché avec le contrôle. Pour les autres contrôles, tels que les barres d’outils, ce texte n’est pas affiché. Par conséquent, les développeurs de serveurs doivent fournir du texte explicite dans l’instruction de définition de ressource du contrôle pour aider les utilisateurs des utilitaires clients à identifier le contrôle.

Pour rechercher l’étiquette du contrôle, Microsoft Active Accessibility recherche un contrôle de texte statique en appelant GetWindow avec l’indicateur GW_HWNDPREV. La recherche est arrêtée si un contrôle de texte statique est trouvé ou si un contrôle est rencontré dont les styles de fenêtre sont WS_GROUP | WS_TABSTOP. Cet ordre de recherche correspond à l’ordre de tabulation inverse d’une boîte de dialogue. Les développeurs de serveurs doivent respecter l’ordre de tabulation lors de la création de contrôles afin qu’un contrôle de texte statique précède immédiatement le contrôle qu’il étiquette.

Pour plus d’informations sur les techniques utilisées par Microsoft Active Accessibility pour exposer la propriété Name, consultez Référence des éléments d’interface utilisateur.