AccessibleEvents Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie des événements qui sont signalés par des applications accessibles.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Héritage
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 |
| 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 |
| 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 Pour un appel à |
| 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 à |
| 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 |
| 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 |
| 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 |
| ValueChange | 32782 | La propriété Value d'un objet a été modifiée. Le système déclenche l'événement |
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.