AccessibleEvents Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica eventos notificados por aplicaciones accesibles.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Herencia
Campos
| AcceleratorChange | 32786 | La propiedad KeyboardShortcut de un objeto ha cambiado. Las aplicaciones de servidor envían el evento para sus objetos accesibles. |
| Create | 32768 | Se ha creado un objeto. El sistema operativo envía el evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación, control de encabezado, control de vista de lista, control de fichas, control de la barra de herramientas, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Los servidores deben enviar este evento para todos los objetos secundarios de un objeto antes de enviar el evento para el objeto primario Los servidores deben garantizar que todos los objetos secundarios están completamente creados y listos para aceptar llamadas de clientes cuando el objeto primario envía el evento. |
| DefaultActionChange | 32785 | La propiedad DefaultAction de un objeto ha cambiado. El sistema envía este evento para cuadros de diálogo. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Por tanto, las aplicaciones de servidor no necesitan enviar este evento para los objetos secundarios. Los objetos ocultos tienen el estado Invisible mientras que los objetos mostrados no lo tienen. Los eventos de tipo |
| DescriptionChange | 32781 | La propiedad Description de un objeto ha cambiado. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
| Destroy | 32769 | Se ha destruido un objeto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación, control de encabezado, control de vista de lista, control de fichas, control de la barra de herramientas, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento se puede enviar o no para objetos secundarios. Sin embargo, los clientes pueden concluir que se han destruido todos los secundarios de un objeto cuando el objeto primario envía este evento. |
| Focus | 32773 | Un objeto ha recibido el foco de teclado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: control de vista de lista, barra de menús, menú contextual, ventana de cambio, control de fichas, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
| HelpChange | 32784 | La propiedad Help de un objeto ha cambiado. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
| Hide | 32771 | Un objeto está oculto. El sistema envía el evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación y cursor. Las aplicaciones de servidor envían el evento para sus objetos accesibles. Cuando se genera el evento para un objeto primario, ya se han ocultado todos los objetos secundarios. Por tanto, las aplicaciones de servidor no necesitan enviar el evento para los objetos secundarios. El sistema no envía este evento de forma coherente. |
| LocationChange | 32779 | Se ha modificado la ubicación, la forma o el tamaño de un objeto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento se genera en respuesta al objeto de nivel superior dentro de la jerarquía de objetos que ha cambiado y no para los secundarios que pueda incluir. Por ejemplo, si el usuario cambia el tamaño de una ventana, el sistema envía esta notificación para la ventana, pero no para la barra de menús, la barra de título, las barras de desplazamiento u otros objetos que también hayan cambiado. El sistema no envía este evento para todas las ventanas secundarias no flotantes cuando se mueve el primario. Sin embargo, si una aplicación cambia de forma explícita el tamaño de las ventanas secundarias como resultado de un cambio de tamaño, el sistema envía varios eventos para los secundarios cuyo tamaño ha cambiado. Si la propiedad State de un objeto se establece en Floating, los servidores deben enviar un evento de cambio de ubicación siempre que cambie la ubicación del objeto. Si un objeto no tiene este estado, los servidores deben provocar este evento cuando el objeto se mueva en relación con su primario. |
| NameChange | 32780 | La propiedad Name de un objeto ha cambiado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: casilla, cursor, control de vista de lista, botón de comando, botón de radio, control de barra de estado, control de vista de árbol y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
| ParentChange | 32783 | Un objeto tiene un nuevo objeto primario. Las aplicaciones de servidor envían este evento para sus objetos accesibles. |
| Reorder | 32772 | Un objeto contenedor ha agregado, quitado o reordenado sus secundarios. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: control de encabezado, control de vista de lista, control de la barra de herramientas y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles, según corresponda. Una ventana primaria también envía este evento cuando cambia el orden Z de las ventanas secundarias. |
| Selection | 32774 | Se ha seleccionado un objeto accesible de un objeto contenedor. Este evento señala una única selección. Se ha seleccionado un secundario de un contenedor que anteriormente no incluía secundarios seleccionados, o bien la selección ha cambiado de un secundario a otro. |
| SelectionAdd | 32775 | Se ha agregado un elemento de un objeto contenedor a la selección. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: cuadro de lista, control de vista de lista y control de vista de árbol. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento señala que se ha agregado un secundario a una selección existente. |
| SelectionRemove | 32776 | Se ha quitado un elemento de un objeto contenedor de la selección. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: cuadro de lista, control de vista de lista y control de vista de árbol. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento señala que se ha quitado un secundario de una selección existente. |
| SelectionWithin | 32777 | Se han producido numerosos cambios de selección en un objeto contenedor. El sistema envía este evento para cuadros de lista. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Este evento se puede enviar cuando los elementos seleccionados de un control han cambiado considerablemente. Este evento informa al cliente de que se han producido varios cambios de selección. Es preferible esto que enviar varios eventos |
| Show | 32770 | Se está mostrando un objeto oculto. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: símbolo de intercalación, cursor y objeto de ventana. Las aplicaciones de servidor envían este evento para sus objetos accesibles. Cuando un objeto primario envía este evento, los clientes pueden concluir que ya se han mostrado todos los objetos secundarios. Por tanto, las aplicaciones de servidor no necesitan enviar este evento para los objetos secundarios. |
| StateChange | 32778 | El estado de un objeto ha cambiado. El sistema envía este evento para los siguientes elementos de la interfaz de usuario: casilla, cuadro combinado, control de encabezado, botón de comando, botón de radio, barra de desplazamiento, control de la barra de herramientas, control de vista de árbol, control de flechas y objeto de ventana. Las aplicaciones de servidor envían el evento para sus objetos accesibles. Por ejemplo, se puede producir un cambio de estado al presionar o soltar un objeto de botón, o al habilitar o deshabilitar un objeto. El sistema no envía este evento de forma coherente. |
| SystemAlert | 2 | Se ha generado un aviso. Las aplicaciones de servidor envían este evento siempre que se produce un cambio importante en la interfaz de usuario que es posible que un usuario necesite conocer. El sistema no envía el evento de forma coherente para objetos de cuadro de diálogo. |
| SystemCaptureEnd | 9 | Una ventana ha perdido la captura del mouse. El sistema envía el evento; los servidores nunca envían este evento. |
| SystemCaptureStart | 8 | Se ha movido o se ha cambiado el tamaño de una ventana. El sistema envía el evento; los servidores nunca envían este evento. |
| SystemContextHelpEnd | 13 | Una ventana ha salido del modo de ayuda contextual. El sistema no envía este evento de forma coherente. |
| SystemContextHelpStart | 12 | Una ventana ha entrado en el modo de ayuda contextual. El sistema no envía este evento de forma coherente. |
| SystemDialogEnd | 17 | Se ha cerrado un cuadro de diálogo. El sistema no envía el evento para cuadros de diálogo estándar. Los servidores envían este evento para cuadros de diálogo personalizados. El sistema no envía este evento de forma coherente. |
| SystemDialogStart | 16 | Se ha mostrado un cuadro de diálogo. El sistema envía el evento para cuadros de diálogo estándar. Los servidores envían este evento para cuadros de diálogo personalizados. El sistema no envía este evento de forma coherente. |
| SystemDragDropEnd | 15 | Una aplicación va a salir del modo de arrastrar y colocar. Las aplicaciones que admiten operaciones de arrastrar y colocar deben enviar este evento; el sistema no lo hace. |
| SystemDragDropStart | 14 | Una aplicación va a entrar en el modo de arrastrar y colocar. Las aplicaciones que admiten operaciones de arrastrar y colocar deben enviar este evento; el sistema no lo hace. |
| SystemForeground | 3 | Ha cambiado la ventana de primer plano. El sistema envía este evento incluso si se cambia la ventana de primer plano por otra del mismo subproceso. Las aplicaciones de servidor nunca envían este evento. |
| SystemMenuEnd | 5 | Se ha cerrado un menú de la barra de menús. El sistema envía este evento para menús estándar. Los servidores envían este evento para menús personalizados. |
| SystemMenuPopupEnd | 7 | Se ha cerrado un menú contextual. El sistema envía este evento para menús estándar. Los servidores envían este evento para menús personalizados. Cuando se cierra un menú contextual, el cliente recibe este mensaje seguido casi inmediatamente del evento Para una llamada a |
| SystemMenuPopupStart | 6 | Se ha mostrado un menú contextual. El sistema envía este evento para menús estándar. Los servidores envían este evento para menús personalizados. El sistema no envía este evento de forma coherente. Para una llamada a |
| SystemMenuStart | 4 | Se ha seleccionado un elemento de menú de la barra de menús. El sistema envía este evento para menús estándar. Los servidores envían este evento para menús personalizados. El sistema puede provocar más de un evento |
| SystemMinimizeEnd | 23 | Se ha minimizado o maximizado un objeto de ventana. El sistema envía el evento; los servidores nunca envían este evento. |
| SystemMinimizeStart | 22 | Se va a minimizar o maximizar un objeto de ventana. El sistema envía el evento; los servidores nunca envían este evento. |
| SystemMoveSizeEnd | 11 | Ha finalizado el movimiento o cambio de tamaño de una ventana. El sistema envía el evento; los servidores nunca envían este evento. |
| SystemMoveSizeStart | 10 | Se ha movido o se ha cambiado el tamaño de una ventana. El sistema envía el evento; los servidores nunca envían este evento. |
| SystemScrollingEnd | 19 | Ha finalizado el desplazamiento en una barra de desplazamiento. El sistema envía este evento para barras de desplazamiento asociadas a una ventana y para controles de barra de desplazamiento estándar. Los servidores envían este evento para barras de desplazamiento personalizadas. |
| SystemScrollingStart | 18 | Se ha iniciado el desplazamiento en una barra de desplazamiento. El sistema envía el evento para barras de desplazamiento asociadas a una ventana y para controles de barra de desplazamiento estándar. Los servidores envían este evento para barras de desplazamiento personalizadas. |
| SystemSound | 1 | Se ha reproducido un sonido. El sistema envía este evento cuando se reproduce un sonido del sistema, por ejemplo, para menús, incluso si el sonido no es audible. Esto puede deberse a la falta de un archivo de sonido o a la falta de tarjeta de sonido. Los servidores envían este evento cuando un elemento personalizado de la interfaz de usuario genera un sonido. |
| SystemSwitchEnd | 21 | El usuario ha soltado ALT+TAB. El sistema envía el evento |
| SystemSwitchStart | 20 | El usuario ha presionado ALT+TAB, lo que activa la ventana de cambio. Si sólo se está ejecutando una aplicación cuando el usuario presiona ALT+TAB, el sistema provoca el evento |
| ValueChange | 32782 | La propiedad Value de un objeto ha cambiado. El sistema provoca el evento |
Ejemplos
En el ejemplo de código siguiente se muestra la creación de un control de gráfico compatible con accesibilidad, mediante las AccessibleObject clases y Control.ControlAccessibleObject para exponer información accesible. El control traza dos curvas junto con una leyenda. La ChartControlAccessibleObject clase , que deriva de ControlAccessibleObject, se usa en el CreateAccessibilityInstance método para proporcionar información accesible personalizada para el control de gráfico. Dado que la leyenda del gráfico no es un control basado en real Control , sino que, en su lugar, se dibuja mediante el control de gráfico, no se obtiene ninguna información accesible integrada. Por este motivo, la ChartControlAccessibleObject clase invalida el GetChild método para devolver que CurveLegendAccessibleObject representa información accesible para cada parte de la leyenda. Cuando una aplicación con reconocimiento accesible usa este control, el control puede proporcionar la información accesible necesaria.
En este ejemplo se muestra el uso de la AccessibleEvents enumeración con el AccessibilityNotifyClients método . Consulte la información general de la AccessibleObject clase para obtener el ejemplo de código completo.
// 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
Comentarios
Las aplicaciones del servidor de accesibilidad y del sistema operativo generan eventos de accesibilidad en respuesta a los cambios en la interfaz de usuario.
Esta enumeración la usan AccessibleObject y Control.
Para obtener más información, consulte Microsoft Accesibilidad activa.
