AccessibleEvents Enumeración

Definición

Especifica eventos notificados por aplicaciones accesibles.

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Herencia
AccessibleEvents

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 AccessibleEvents.Hide indican que se ha establecido un estado Invisible. Por tanto, los servidores no necesitan enviar el evento AccessibleEvents.StateChange en este caso.

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 SelectionAdd o SelectionRemove.

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 SystemMenuEnd. El sistema no envía este evento de forma coherente.

Para una llamada a TrackPopupMenu(), un cliente verá EVENT_SYSTEM_MENUSTART seguido casi inmediatamente para EVENT_SYSTEM_MENUPOPUPSTART que se muestre el elemento emergente.

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 TrackPopupMenu(), un cliente verá EVENT_SYSTEM_MENUSTART seguido casi inmediatamente para EVENT_SYSTEM_MENUPOPUPSTART que se muestre el elemento emergente.

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 MenuStart que puede tener o no un evento MenuEnd correspondiente.

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 SwitchEnd; los servidores nunca envían este evento. Si sólo se está ejecutando una aplicación cuando el usuario presiona ALT+TAB, el sistema envía el evento SwitchEnd sin un evento SwitchStart correspondiente.

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 SwitchEnd sin un evento SwitchStart correspondiente.

ValueChange 32782

La propiedad Value de un objeto ha cambiado. El sistema provoca el evento ValueChange para los siguientes elementos de la interfaz de usuario: control de edición, control de encabezado, control de teclas de acceso rápido, control de barra indicadora de progreso, barra de desplazamiento, control deslizante y control de flechas. Las aplicaciones de servidor envían este evento para sus objetos accesibles.

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.

Se aplica a

Consulte también