Partager via


AccessibleEvents Énumération

Définition

Spécifie des événements qui sont signalés par des applications accessibles.

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Héritage
AccessibleEvents

Champs

AcceleratorChange 32786

La propriété KeyboardShortcut d'un objet a été modifiée. Les applications serveur envoient cet événement pour leurs objets accessibles.

Create 32768

Un objet a été créé. Le système d'exploitation envoie cet événement pour les éléments d'interface utilisateur suivants : signe insertion, contrôle d'en-tête, contrôle list view, contrôle onglet, contrôle de barre d'outils, contrôle tree view et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Les serveurs doivent envoyer cet événement pour tous les objets enfants d'un objet avant d'envoyer l'événement pour l'objet parent. Les serveurs doivent s'assurer que les objets enfants sont tous créés et prêts à accepter des appels des clients quand l'objet parent envoie l'événement.

DefaultActionChange 32785

La propriété DefaultAction d'un objet a été modifiée. Le système envoie cet événement pour des boîtes de dialogue. Les applications serveur envoient cet événement pour leurs objets accessibles. Par conséquent, il n'est pas nécessaire que les applications serveur envoient cet événement pour les objets enfants. Les objets masqués ont un état Invisible, et pas les objets affichés. Les événements de type AccessibleEvents.Hide indiquent qu'un état Invisible a été défini. Par conséquent, il n'est pas nécessaire que les applications serveur envoient l'événement AccessibleEvents.StateChange dans ce cas.

DescriptionChange 32781

La propriété Description d'un objet a été modifiée. Les applications serveur envoient cet événement pour leurs objets accessibles.

Destroy 32769

Un objet a été détruit. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : signe insertion, contrôle d'en-tête, contrôle list view, contrôle onglet, contrôle de barre d'outils, contrôle tree view et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement peut être envoyé ou non aux objets enfants. Cependant, les clients peuvent conclure que tous les enfants d'un objet ont été détruits quand l'objet parent envoie cet événement.

Focus 32773

Un objet a reçu le focus clavier. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : contrôle list view, barre de menus, menu contextuel, fenêtre de basculement, contrôle onglet, contrôle tree view et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles.

HelpChange 32784

La propriété Help d'un objet a été modifiée. Les applications serveur envoient cet événement pour leurs objets accessibles.

Hide 32771

Un objet est masqué. Le système envoie l'événement pour les éléments d'interface utilisateur suivants : signe insertion et curseur. Les applications serveur envoient cet événement pour leurs objets accessibles. Lorsque l'événement est généré pour un objet parent, tous les objets enfants sont déjà masqués. Par conséquent, il n'est pas nécessaire que les applications serveur envoient l'événement pour les objets enfants. Le système n'envoie pas l'événement de manière cohérente.

LocationChange 32779

Un objet a changé d'emplacement, de forme ou de taille. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : signe insertion et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement est généré en réponse à la modification de l'objet de niveau supérieur dans la hiérarchie d'objets, pas pour les enfants qu'il peut contenir. Par exemple, si l'utilisateur redimensionne une fenêtre, le système envoie cette notification pour la fenêtre, mais pas pour la barre de menus, la barre de titre, les barres de défilement ou d'autres objets qui ont également été modifiés. Le système n'envoie pas cet événement pour chaque fenêtre enfant non flottante quand le parent est déplacé. Cependant, si une application redimensionne explicitement des fenêtres enfants après avoir été redimensionnée, le système envoie plusieurs événements pour les enfants redimensionnés. Si la propriété State d'un objet a la valeur Floating, les serveurs doivent envoyer un événement de changement d'emplacement chaque fois que l'objet change d'emplacement. Si un objet n'a pas cet état, les serveurs doivent déclencher cet événement quand l'objet est déplacé par rapport à son parent.

NameChange 32780

La propriété Name d'un objet a été modifiée. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : case à cocher, curseur, contrôle list view, bouton de commande, case d'option, contrôle de barre d'état, contrôle tree view et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles.

ParentChange 32783

Un objet a un nouvel objet parent. Les applications serveur envoient cet événement pour leurs objets accessibles.

Reorder 32772

Un objet conteneur a ajouté, supprimé ou modifié l'ordre de ses enfants. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : contrôle header, contrôle list view, contrôle toolbar et objet window. Les applications serveur envoient cet événement suivant les besoins pour leurs objets accessibles. Cet événement est également envoyé par une fenêtre parente quand l'ordre de plan pour les fenêtres enfants est modifié.

Selection 32774

Un objet accessible dans un objet conteneur a été sélectionné. Cet événement signale une sélection unique. Soit un enfant a été sélectionné dans un conteneur qui ne contenait pas d'enfants sélectionnés précédemment, soit la sélection est passée d'un enfant à un autre.

SelectionAdd 32775

Un élément dans un objet conteneur a été ajouté à la sélection. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : zone de liste, contrôle list view et contrôle tree view. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement signale qu'un enfant a été ajouté à une sélection existante.

SelectionRemove 32776

Un élément dans un objet conteneur a été enlevé de la sélection. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : zone de liste, contrôle list view et contrôle tree view. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement signale qu'un enfant a été enlevé d'une sélection existante.

SelectionWithin 32777

Plusieurs modifications de sélection se sont produites dans un objet conteneur. Le système envoie cet événement pour des zones de liste. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement peut être envoyé quand les éléments sélectionnés dans un contrôle ont subi des modifications importantes. Cet événement informe le client que de nombreuses modifications de sélection se sont produites. Cela est préférable à l'envoi de plusieurs événements SelectionAdd ou SelectionRemove.

Show 32770

Un objet masqué est affiché. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : signe insertion, curseur et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Les clients peuvent conclure que, lorsque cet événement est envoyé par un objet parent, tous les objets enfants ont déjà été affichés. Par conséquent, il n'est pas nécessaire que les applications serveur envoient cet événement pour les objets enfants.

StateChange 32778

L'état d'un objet a changé. Le système envoie l'événement pour les éléments d'interface utilisateur suivants : case à cocher, zone de liste déroulante, contrôle header, bouton de commande, case d'option, barre de défilement, contrôle toolbar, contrôle tree view, contrôle up-down et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Par exemple, un changement d'état peut se produire lorsqu'un objet bouton a été enfoncé ou relâché, ou lorsqu'un objet est activé ou désactivé. Le système n'envoie pas l'événement de manière cohérente.

SystemAlert 2

Une alerte a été générée. Les applications serveur envoient cet événement chaque fois qu'un changement important de l'interface utilisateur s'est produit et qu'il peut être utile d'en informer l'utilisateur. Le système n'envoie pas cet événement de manière cohérente pour les boîtes de dialogue.

SystemCaptureEnd 9

Une fenêtre a perdu la capture de la souris. Le système envoie cet événement, les serveurs ne l'envoient jamais.

SystemCaptureStart 8

Une fenêtre est déplacée ou redimensionnée. Le système envoie cet événement, les serveurs ne l'envoient jamais.

SystemContextHelpEnd 13

Une fenêtre a quitté le mode d'aide contextuelle. Le système n'envoie pas l'événement de manière cohérente.

SystemContextHelpStart 12

Une fenêtre est passée en mode d'aide contextuelle. Le système n'envoie pas l'événement de manière cohérente.

SystemDialogEnd 17

Une boîte de dialogue a été fermée. Le système n'envoie pas cet événement pour des boîtes de dialogue standard. Les serveurs envoient cet événement pour des boîtes de dialogue personnalisées. Le système n'envoie pas l'événement de manière cohérente.

SystemDialogStart 16

Une boîte de dialogue a été affichée. Le système envoie cet événement pour des boîtes de dialogue standard. Les serveurs envoient cet événement pour des boîtes de dialogue personnalisées. Le système n'envoie pas l'événement de manière cohérente.

SystemDragDropEnd 15

Une application va quitter le mode glisser-déplacer. Les applications qui prennent en charge les opérations glisser-déplacer doivent envoyer cet événement, pas le système.

SystemDragDropStart 14

Une application va passer en mode glisser-déplacer. Les applications qui prennent en charge les opérations glisser-déplacer doivent envoyer cet événement, pas le système.

SystemForeground 3

La fenêtre de premier plan a changé. Le système envoie cet événement même si la fenêtre de premier plan a été remplacée par une autre fenêtre dans le même thread. Les applications serveur n'envoient jamais cet événement.

SystemMenuEnd 5

Un menu de la barre de menus a été fermé. Le système envoie cet événement pour des menus standard. Les serveurs envoient cet événement pour des menus personnalisés.

SystemMenuPopupEnd 7

Un menu contextuel a été fermé. Le système envoie cet événement pour des menus standard. Les serveurs envoient cet événement pour des menus personnalisés. Lorsqu'un menu contextuel est fermé, le client reçoit ce message suivi presque immédiatement par l'événement SystemMenuEnd. Le système n'envoie pas l'événement de manière cohérente.

Pour un appel à TrackPopupMenu(), un client s’affiche EVENT_SYSTEM_MENUSTART presque immédiatement EVENT_SYSTEM_MENUPOPUPSTART pour la fenêtre contextuelle affichée.

SystemMenuPopupStart 6

Un menu contextuel a été affiché. Le système envoie cet événement pour des menus standard. Les serveurs envoient cet événement pour des menus personnalisés. Le système n'envoie pas l'événement de manière cohérente.

Pour un appel à TrackPopupMenu(), un client s’affiche EVENT_SYSTEM_MENUSTART presque immédiatement EVENT_SYSTEM_MENUPOPUPSTART pour la fenêtre contextuelle affichée.

SystemMenuStart 4

Un élément de menu sur la barre de menus a été sélectionné. Le système envoie cet événement pour des menus standard. Les serveurs envoient cet événement pour des menus personnalisés. Le système peut déclencher plusieurs événements MenuStart qui peuvent correspondre à un événement MenuEnd ou non.

SystemMinimizeEnd 23

Un objet window a été réduit ou agrandi. Le système envoie cet événement, les serveurs ne l'envoient jamais.

SystemMinimizeStart 22

Un objet window va être réduit ou agrandi. Le système envoie cet événement, les serveurs ne l'envoient jamais.

SystemMoveSizeEnd 11

Le mouvement de redimensionnement d'une fenêtre est terminé. Le système envoie cet événement, les serveurs ne l'envoient jamais.

SystemMoveSizeStart 10

Une fenêtre est déplacée ou redimensionnée. Le système envoie cet événement, les serveurs ne l'envoient jamais.

SystemScrollingEnd 19

Le défilement est terminé sur une barre de défilement. Le système envoie cet événement pour les barres de défilement attachées à une fenêtre et pour les contrôles de barre de défilement standard. Les serveurs envoient cet événement pour des barres de défilement personnalisées.

SystemScrollingStart 18

Le défilement a commencé sur une barre de défilement. Le système envoie cet événement pour les barres de défilement attachées à une fenêtre et pour les contrôles de barre de défilement standard. Les serveurs envoient cet événement pour des barres de défilement personnalisées.

SystemSound 1

Un son a été lu. Le système envoie cet événement quand un son système, pour des menus, par exemple, est lu, même si aucun son n'est audible. Cela peut être provoqué par l'absence de fichier audio ou de carte audio. Les serveurs envoient cet événement si un élément d'interface utilisateur personnalisé génère un son.

SystemSwitchEnd 21

L'utilisateur a relâché ALT+TAB. Le système envoie l'événement SwitchEnd, les serveurs ne l'envoient jamais. Si une seule application est exécutée quand l'utilisateur appuie sur ALT+TAB, le système envoie l'événement SwitchEnd sans événement SwitchStart correspondant.

SystemSwitchStart 20

L'utilisateur a appuyé sur ALT+TAB, ce qui active la fenêtre switch. Si une seule application est exécutée quand l'utilisateur appuie sur ALT+TAB, le système déclenche l'événement SwitchEnd sans événement SwitchStart correspondant.

ValueChange 32782

La propriété Value d'un objet a été modifiée. Le système déclenche l'événement ValueChange pour les éléments d'interface utilisateur suivants : contrôle d'édition, contrôle d'en-tête, contrôle de touche d'accès rapide, contrôle de barre de progression, barre de défilement, contrôle Slider et contrôle up-down. Les applications serveur envoient cet événement pour leurs objets accessibles.

Exemples

L’exemple de code suivant illustre la création d’un contrôle de graphique prenant en compte l’accessibilité, en utilisant les classes et Control.ControlAccessibleObject les AccessibleObject classes pour exposer des informations accessibles. Le contrôle trace deux courbes avec une légende. La ChartControlAccessibleObject classe, qui dérive de ControlAccessibleObject, est utilisée dans la CreateAccessibilityInstance méthode pour fournir des informations accessibles personnalisées pour le contrôle de graphique. Étant donné que la légende du graphique n’est pas un contrôle réel Control , mais qu’elle est dessinée par le contrôle de graphique, elle ne contient aucune information accessible intégrée. En raison de cela, la ChartControlAccessibleObject classe remplace la GetChild méthode pour renvoyer les CurveLegendAccessibleObject informations accessibles pour chaque partie de la légende. Lorsqu’une application prenant en charge l’accès utilise ce contrôle, le contrôle peut fournir les informations accessibles nécessaires.

Cet exemple montre comment utiliser l’énumération AccessibleEvents avec la AccessibilityNotifyClients méthode. Consultez la vue d’ensemble de la classe pour l’exemple AccessibleObject de code complet.

   // Gets or sets the location for the curve legend.
   Point get()
   {
      return location;
   }

   void set( Point value )
   {
      location = value;
      chart->Invalidate();
      
      // Notifies the chart of the location change. This is used for
      // the accessibility information. AccessibleEvents::LocationChange
      // tells the chart the reason for the notification.
      chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
   }

}

property String^ Name 
{

   // Gets or sets the Name for the curve legend.
   String^ get()
   {
      return name;
   }

   void set( String^ value )
   {
      if ( name != value )
      {
         name = value;
         chart->Invalidate();
         
         // Notifies the chart of the name change. This is used for
         // the accessibility information. AccessibleEvents::NameChange
         // tells the chart the reason for the notification.
         chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

}

property bool Selected 
{

   // Gets or sets the Selected state for the curve legend.
   bool get()
   {
      return selected;
   }

   void set( bool value )
   {
      if ( selected != value )
      {
         selected = value;
         chart->Invalidate();
         
         // Notifies the chart of the selection value change. This is used for
         // the accessibility information. The AccessibleEvents value depends upon
         // if the selection is true (AccessibleEvents::SelectionAdd) or
         // false (AccessibleEvents::SelectionRemove).
         chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }
    // Gets or sets the location for the curve legend.
    public Point Location
    {   
        get {
            return location;
        }
        set {
            location = value;
            chart.Invalidate();

            // Notifies the chart of the location change. This is used for
            // the accessibility information. AccessibleEvents.LocationChange
            // tells the chart the reason for the notification.

            chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }            

    // Gets or sets the Name for the curve legend.
    public string Name
    {   
        get {
            return name;
        }
        set {
            if (name != value) 
            {
                name = value;
                chart.Invalidate();

                // Notifies the chart of the name change. This is used for
                // the accessibility information. AccessibleEvents.NameChange
                // tells the chart the reason for the notification.

                chart.AccessibilityNotifyClients(AccessibleEvents.NameChange, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

    // Gets or sets the Selected state for the curve legend.
    public bool Selected
    {   
        get {
            return selected;
        }
        set {
            if (selected != value) 
            {
                selected = value;
                chart.Invalidate();

                // Notifies the chart of the selection value change. This is used for
                // the accessibility information. The AccessibleEvents value depends upon
                // if the selection is true (AccessibleEvents.SelectionAdd) or 
                // false (AccessibleEvents.SelectionRemove).
                chart.AccessibilityNotifyClients(
                    selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }
' Gets or sets the location for the curve legend.            
Public Property Location() As Point
    Get
        Return m_location
    End Get
    Set
        m_location = value
        chart.Invalidate()

        ' Notifies the chart of the location change. This is used for
        ' the accessibility information. AccessibleEvents.LocationChange
        ' tells the chart the reason for the notification.
        chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
                CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
    End Set
End Property

' Gets or sets the Name for the curve legend.            
Public Property Name() As String
    Get
        Return m_name
    End Get
    Set
        If m_name <> value Then
            m_name = value
            chart.Invalidate()

            ' Notifies the chart of the name change. This is used for
            ' the accessibility information. AccessibleEvents.NameChange
            ' tells the chart the reason for the notification. 
            chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
                    CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
        End If
    End Set
End Property

' Gets or sets the Selected state for the curve legend.            
Public Property Selected() As Boolean
    Get
        Return m_selected
    End Get
    Set
        If m_selected <> value Then
            m_selected = value
            chart.Invalidate()

            ' Notifies the chart of the selection value change. This is used for
            ' the accessibility information. The AccessibleEvents value varies
            ' on whether the selection is true (AccessibleEvents.SelectionAdd) or 
            ' false (AccessibleEvents.SelectionRemove). 
            If m_selected Then
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            Else
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            End If
        End If
    End Set
End Property

Remarques

Le système d’exploitation et les applications serveur d’accessibilité génèrent des événements d’accessibilité en réponse aux modifications apportées à l’interface utilisateur.

Cette énumération est utilisée par AccessibleObject et Control.

Pour plus d’informations, consultez Microsoft Active Accessibility.

S’applique à

Voir aussi