Barre de défilement (référence d’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets de barre de défilement à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets de barre de défilement dans différents frameworks d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence sur les API pour l’infrastructure d’interface utilisateur que vous utilisez.
Les barres de défilement permettent à l’utilisateur de choisir la direction et la distance pour faire défiler les informations d’une fenêtre ou d’une zone de liste associée. Le nom de la classe de fenêtre d’une barre de défilement est « SCROLLBAR ».
Le contenu des propriétés IAccessible varie selon que la barre de défilement est verticale ou horizontale et sur laquelle des parties suivantes de la barre de défilement est interrogée par le client :
- La barre de défilement elle-même
- Flèche supérieure ou flèche droite
- Bouton flèche vers le bas ou la flèche gauche
- Zone de défilement (pouce)
- La région de la page vers le haut ou de la page de droite
- Zone de la page vers le bas ou de la page de gauche
IAccessible, méthodes
Une barre de défilement prend en charge les méthodes IAccessible suivantes :
accDoDefaultAction : l’objet de barre de défilement lui-même et le curseur de défilement ne prennent pas en charge la méthode accDoDefaultAction .
Pour les autres parties de la barre de défilement sur une barre de défilement verticale, accDoDefaultAction appelle PostMessage avec le message WM_VSCROLL avec wParam défini sur les valeurs suivantes.
Bouton/Région Vaule Flèche supérieure SB_LINEUP Flèche vers le bas SB_LINEDOWN Zone de mise en page vers le haut SB_PAGEUP Zone de page vers le bas SB_PAGEDOWN Pour les autres parties de la barre de défilement d’une barre de défilement horizontale, accDoDefaultAction appelle PostMessage avec le message WM_HSCROLL avec wParam défini sur les valeurs suivantes.
Bouton/Région Valeur Flèche gauche SB_LINELEFT Bouton flèche droite SB_LINERIGHT Zone de gauche de la page SB_PAGELEFT Région de droite de la page SB_PAGERIGHT
Propriétés IAccessible
Une barre de défilement prend en charge les propriétés IAccessible suivantes :
get_accChildCount : la propriété ChildCount de l’objet barre de défilement est cinq. Pour les autres parties de la barre de défilement, la propriété ChildCount est égale à zéro.
get_accDefaultAction : l’objet de barre de défilement lui-même et le curseur de défilement ne prennent pas en charge la propriété DefaultAction . La propriété DefaultAction pour les boutons de direction et les zones ombrées de chaque côté du curseur de défilement est « Appuyez ».
get_accDescription : la propriété Description dépend de la partie de la barre de défilement interrogée.
Les parties d’une barre de défilement verticale ont les descriptions suivantes.
Élément Description Barre de défilement elle-même « Utilisé pour modifier la zone d’affichage verticale » Flèche supérieure « Déplace la position verticale vers le haut d’une ligne » Flèche vers le bas « Déplace la position verticale vers le bas d’une ligne » Faire défiler le pouce « Indique la position verticale actuelle et peut être déplacé pour la modifier directement » Zone de mise en page vers le haut « Déplace la position verticale vers le haut de quelques lignes » Zone de page vers le bas « Indique la position verticale actuelle et peut être déplacé pour la modifier directement » Les parties d’une barre de défilement horizontale ont les descriptions suivantes.
Élément Description Barre de défilement elle-même « Utilisé pour modifier la zone d’affichage horizontale » Flèche gauche « Déplace la position horizontale vers la gauche d’une colonne » Bouton flèche droite 'Déplace la position horizontale vers la droite d’une colonne » Faire défiler le pouce « Indique la position horizontale actuelle et peut être déplacé pour la modifier directement » Zone de gauche de la page « Déplace la position horizontale vers la gauche de deux colonnes » Région de droite de la page « Indique la position verticale actuelle et peut être déplacé pour la modifier directement » get_accName : la propriété Name dépend de la partie de la barre de défilement interrogée.
Les parties d’une barre de défilement verticale portent les noms suivants.
Élément Nom Fenêtre de barre de défilement « Vertical » Flèche supérieure « Line up » Flèche vers le bas « Ligne vers le bas » Faire défiler le pouce « Position » Zone de mise en page vers le haut « Page vers le haut » Zone de page vers le bas « Page vers le bas » Les parties d’une barre de défilement horizontale portent les noms suivants.
Élément Nom Fenêtre de barre de défilement « Horizontal » Flèche gauche « Colonne de gauche » Bouton flèche droite « Colonne à droite » Faire défiler le pouce « Position » Région de droite de la page « Page à droite » Zone de gauche de la page « Page à gauche » get_accParent : la propriété Parent des boutons de direction, du défilement du pouce et de la zone ombrée de chaque côté du pouce est la fenêtre de la barre de défilement. La propriété Parent de la fenêtre de barre de défilement 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.
get_accRole : la propriété Role dépend de la partie de la barre de défilement interrogée. Les parties d’une barre de défilement ont les rôles suivants.
Élément Rôle Barre de défilement elle-même ROLE_SYSTEM_SCROLLBAR Flèches haut, bas, gauche et droite ROLE_SYSTEM_PUSHBUTTON Faire défiler le pouce ROLE_SYSTEM_INDICATOR Régions de la page haut, de la page vers le bas, de la page de gauche et de la page de droite ROLE_SYSTEM_PUSHBUTTON get_accState : la propriété State de chaque composant de barre de défilement comprend une combinaison des valeurs suivantes.
État Valeur STATE_SYSTEM_INVISIBLE Pour la barre de défilement elle-même, cela indique que la barre de défilement verticale ou horizontale spécifiée n’existe pas. Pour les régions de page haut ou de page vers le bas, cela indique que le pouce est positionné de telle sorte que la région n’existe pas. STATE_SYSTEM_OFFSCREEN Pour la barre de défilement elle-même, cela indique que la fenêtre est dimensionnée de telle sorte que la barre de défilement verticale ou horizontale spécifiée ne soit pas affichée actuellement. STATE_SYSTEM_PRESSED Appuyez sur le bouton flèche ou la zone de page. STATE_SYSTEM_UNAVAILABLE Le composant est désactivé. get_accValue : la propriété Value de la fenêtre de barre de défilement indique la position de la barre de défilement et est une chaîne qui contient un entier compris entre « 0 » et « 100 ».
Rubriques connexes