Partilhar via


AccessibleEvents Enumeração

Definição

Especifica os eventos que são relatados por aplicativos acessíveis.

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Herança
AccessibleEvents

Campos

AcceleratorChange 32786

A propriedade KeyboardShortcut de um objeto foi alterada. Os aplicativos de servidor enviam o evento para os objetos acessíveis.

Create 32768

Um objeto foi criado. O sistema operacional envia o evento para os seguintes elementos da interface do usuário: cursor do sistema, controle de cabeçalho, controle de exibição de lista, controle guia, controle de barra de ferramentas, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Servidores devem enviar esse evento para todos os objetos filho de um objeto antes de enviar o evento para o objeto pai. Os servidores devem garantir que todos os objetos filho estejam totalmente criados e prontos para aceitar chamadas de clientes quando o objeto pai envia o evento.

DefaultActionChange 32785

A propriedade DefaultAction de um objeto foi alterada. O sistema envia esse evento para caixas de diálogo. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Portanto, os aplicativos de servidor não precisam enviar esse evento para os objetos filho. Objetos ocultos têm um estado de Invisible e os objetos mostrados não. Eventos do tipo AccessibleEvents.Hide indicam que um estado de Invisible foi definido. Portanto, servidores não precisam enviar o evento AccessibleEvents.StateChange neste caso.

DescriptionChange 32781

A propriedade Description de um objeto foi alterada. Os aplicativos de servidor enviam esse evento para os objetos acessíveis.

Destroy 32769

Um objeto foi destruído. O sistema envia esse evento para os seguintes elementos da interface do usuário: cursor do sistema, controle de cabeçalho, controle de exibição de lista, controle guia, controle de barra de ferramentas, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento pode ou não ser enviado para objetos filho. No entanto, os clientes podem concluir que todos os filhos de um objeto foram destruídos quando o objeto pai envia esse evento.

Focus 32773

Um objeto recebeu o foco do teclado. O sistema envia esse evento para os seguintes elementos da interface do usuário: controle de exibição de lista, barra de menus, menu de atalho, janela de comutador, controle guia, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis.

HelpChange 32784

A propriedade Help de um objeto foi alterada. Os aplicativos de servidor enviam esse evento para os objetos acessíveis.

Hide 32771

Um objeto está oculto. O sistema envia o evento para os seguintes elementos da interface do usuário: cursor do sistema e cursor. Os aplicativos de servidor enviam o evento para os objetos acessíveis. Quando o evento é gerado para um objeto pai, todos os objetos filho já foram ocultados. Portanto, os aplicativos de servidor não precisam enviar o evento para os objetos filho. O sistema não envia o evento consistentemente.

LocationChange 32779

Um objeto mudou de localização, forma ou tamanho. O sistema envia esse evento para os seguintes elementos da interface do usuário: objeto de janela e cursor do sistema. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento é gerado em resposta ao objeto de nível superior dentro da hierarquia de objeto que foi alterada, não para qualquer filho que ele possa conter. Por exemplo, se o usuário redimensiona uma janela, o sistema envia essa notificação para a janela, mas não para a barra de menus, barra de título, barras de rolagem ou outros objetos que também foram alterados. O sistema não envia esse evento para cada janela filho não flutuante quando o pai é movido. No entanto, se um aplicativo explicitamente redimensionar janelas filho como resultado do redimensionamento, o sistema envia vários eventos para os filhos redimensionados. Se a propriedade State do objeto estiver definida como Floating, os servidores deverão enviar um evento de mudança de local sempre que o objeto mudar de local. Se um objeto não tiver esse estado, os servidores deverão gerar esse evento quando o objeto se mover em relação ao seu pai.

NameChange 32780

A propriedade Name de um objeto foi alterada. O sistema envia esse evento para os seguintes elementos da interface do usuário: caixa de seleção, cursor, controle de exibição de lista, botão de ação, botão de opção, controle de barra de status, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis.

ParentChange 32783

Um objeto tem um novo objeto pai. Os aplicativos de servidor enviam esse evento para os objetos acessíveis.

Reorder 32772

Um objeto de contêiner adicionou, removeu ou reordenou seus filhos. O sistema envia esse evento para os seguintes elementos da interface do usuário: controle de cabeçalho, controle de exibição de lista, controle de barra de ferramentas e objeto de janela. Os aplicativos de servidor enviam esse evento, conforme apropriado, para os objetos acessíveis. Esse evento também é enviado por uma janela pai quando a ordem de z para as janelas filho é alterada.

Selection 32774

Um objeto acessível dentro de um objeto de contêiner foi selecionado. Esse evento sinaliza uma única seleção. Um filho foi selecionado em um contêiner que anteriormente não continha nenhum filho selecionado ou a seleção mudou de um filho para outro.

SelectionAdd 32775

Um item em um objeto de contêiner foi adicionado à seleção. O sistema envia esse evento para os seguintes elementos da interface do usuário: caixa de listagem, controle de exibição de lista e controle de exibição de árvore. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento indica que um filho foi adicionado a uma seleção existente.

SelectionRemove 32776

Um item em um objeto de contêiner foi removido da seleção. O sistema envia esse evento para os seguintes elementos da interface do usuário: caixa de listagem, controle de exibição de lista e controle de exibição de árvore. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento indica que um filho foi removido de uma seleção existente.

SelectionWithin 32777

Ocorreram várias alterações de seleção em um objeto de contêiner. O sistema envia esse evento para caixas de listagem. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento pode ser enviado quando os itens selecionados em um controle mudaram consideravelmente. Esse evento informa ao cliente que ocorreram muitas alterações de seleção. Isso é preferível para enviar vários eventos SelectionAdd ou SelectionRemove.

Show 32770

Um objeto oculto está sendo exibido. O sistema envia esse evento para os seguintes elementos da interface do usuário: objeto de janela, cursor e cursor do sistema. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Os clientes podem concluir que, quando esse evento é enviado por um objeto pai, todos os objetos filho já foram exibidos. Portanto, os aplicativos de servidor não precisam enviar esse evento para os objetos filho.

StateChange 32778

O estado de um objeto foi alterado. O sistema envia o evento para os seguintes elementos da interface do usuário: caixa de seleção, caixa de combinação controle de cabeçalho, botão de ação, botão de opção, barra de rolagem, controle de barra de ferramentas, controle de exibição de árvore, controle acima-abaixo e objeto de janela. Os aplicativos de servidor enviam o evento para os objetos acessíveis. Por exemplo, uma alteração de estado pode ocorrer quando um objeto de botão for pressionado ou solto ou quando um objeto estiver sendo habilitado ou desabilitado. O sistema não envia o evento consistentemente.

SystemAlert 2

Um alerta foi gerado. Os aplicativos de servidor enviam esse evento sempre que ocorre uma alteração importante da interface do usuário sobre a qual um usuário pode precisar saber. O sistema não envia o evento consistentemente para objetos de caixa de diálogo.

SystemCaptureEnd 9

Uma janela perdeu a captura do mouse. O sistema envia o evento, os servidores nunca enviam esse evento.

SystemCaptureStart 8

Uma janela está sendo movida ou redimensionada. O sistema envia o evento, os servidores nunca enviam esse evento.

SystemContextHelpEnd 13

Uma janela saiu do modo de ajuda contextual. O sistema não envia o evento consistentemente.

SystemContextHelpStart 12

Uma janela entrou no modo de ajuda contextual. O sistema não envia o evento consistentemente.

SystemDialogEnd 17

Uma caixa de diálogo foi fechada. O sistema não envia o evento para caixas de diálogo padrão. Os servidores enviam esse evento para caixas de diálogo personalizadas. O sistema não envia o evento consistentemente.

SystemDialogStart 16

Uma caixa de diálogo foi exibida. O sistema envia o evento para caixas de diálogo padrão. Os servidores enviam esse evento para caixas de diálogo personalizadas. O sistema não envia o evento consistentemente.

SystemDragDropEnd 15

Um aplicativo está prestes a sair do modo de "arrastar e soltar". Os aplicativos que dão suporte a operações do tipo "arrastar e soltar" devem enviar esse evento, o sistema não.

SystemDragDropStart 14

Um aplicativo está prestes a entrar no modo de "arrastar e soltar". Os aplicativos que dão suporte a operações do tipo "arrastar e soltar" devem enviar esse evento, o sistema não.

SystemForeground 3

A janela de primeiro plano foi alterada. O sistema envia esse evento, mesmo que a janela de primeiro plano seja alterada para outra janela no mesmo thread. Os aplicativos de servidor nunca enviam esse evento.

SystemMenuEnd 5

Um menu da barra de menus foi fechado. O sistema envia esse evento para menus padrão. Os servidores enviam esse evento para menus personalizados.

SystemMenuPopupEnd 7

Um menu de atalho foi fechado. O sistema envia esse evento para menus padrão. Os servidores enviam esse evento para menus personalizados. Quando um menu de atalho é fechado, o cliente recebe essa mensagem quase que imediatamente seguida pelo evento SystemMenuEnd. O sistema não envia o evento consistentemente.

Para uma chamada para TrackPopupMenu(), um cliente verá EVENT_SYSTEM_MENUSTART seguido quase imediatamente pelo EVENT_SYSTEM_MENUPOPUPSTART pop-up que está sendo mostrado.

SystemMenuPopupStart 6

Um menu de atalho foi exibido. O sistema envia esse evento para menus padrão. Os servidores enviam esse evento para menus personalizados. O sistema não envia o evento consistentemente.

Para uma chamada para TrackPopupMenu(), um cliente verá EVENT_SYSTEM_MENUSTART seguido quase imediatamente pelo EVENT_SYSTEM_MENUPOPUPSTART pop-up que está sendo mostrado.

SystemMenuStart 4

Um item de menu na barra de menus foi selecionado. O sistema envia esse evento para menus padrão. Os servidores enviam esse evento para menus personalizados. O sistema pode gerar mais de um evento MenuStart que pode ou não ter um evento MenuEnd correspondente.

SystemMinimizeEnd 23

Um objeto de janela foi minimizado ou maximizado. O sistema envia o evento, os servidores nunca enviam esse evento.

SystemMinimizeStart 22

Um objeto de janela está prestes a ser minimizado ou maximizado. O sistema envia o evento, os servidores nunca enviam esse evento.

SystemMoveSizeEnd 11

A movimentação ou redimensionamento de uma janela é concluído. O sistema envia o evento, os servidores nunca enviam esse evento.

SystemMoveSizeStart 10

Uma janela está sendo movida ou redimensionada. O sistema envia o evento, os servidores nunca enviam esse evento.

SystemScrollingEnd 19

A rolagem terminou em uma barra de rolagem. O sistema envia esse evento para barras de rolagem anexadas a uma janela e para controles da barra de rolagem padrão. Os servidores enviam esse evento para barras de rolagem personalizadas.

SystemScrollingStart 18

A rolagem foi iniciada em uma barra de rolagem. O sistema envia o evento para barras de rolagem anexadas a uma janela e para controles da barra de rolagem padrão. Os servidores enviam esse evento para barras de rolagem personalizadas.

SystemSound 1

Um som foi reproduzido. O sistema envia esse evento quando um sistema de som, como de menus, é executado, mesmo que nenhum som seja audível. Isso pode ser causado pela falta de um arquivo de som ou placa de som. Os servidores enviam este evento se um elemento de interface do usuário personalizado gera um som.

SystemSwitchEnd 21

O usuário soltou o ALT+TAB. O sistema envia o evento SwitchEnd, os servidores nunca enviam esse evento. Se apenas um aplicativo estiver em execução quando o usuário pressionar ALT+TAB, o sistema enviará o evento SwitchEnd sem um evento SwitchStart correspondente.

SystemSwitchStart 20

O usuário pressionou ALT+TAB, o que ativa a janela de comutador. Se apenas um aplicativo estiver em execução quando o usuário pressionar ALT+TAB, o sistema gerará o evento SwitchEnd sem um evento SwitchStart correspondente.

ValueChange 32782

A propriedade Value de um objeto foi alterada. O sistema gera o evento ValueChange para os seguintes elementos de interface do usuário: controle de edição, controle de cabeçalho, controle de tecla de acesso, controle de barra de progresso, barra de rolagem, controle deslizante e controle acima-abaixo. Os aplicativos de servidor enviam esse evento para os objetos acessíveis.

Exemplos

O exemplo de código a seguir demonstra a criação de um controle de gráfico com reconhecimento de acessibilidade, usando o e Control.ControlAccessibleObject as AccessibleObject classes para expor informações acessíveis. O controle plota duas curvas junto com uma legenda. A ChartControlAccessibleObject classe, que deriva de ControlAccessibleObject, é usada no CreateAccessibilityInstance método para fornecer informações acessíveis personalizadas para o controle do gráfico. Como a legenda do gráfico não é um controle baseado em real Control , mas é desenhada pelo controle do gráfico, ela não fornece informações acessíveis internas. Por isso, a ChartControlAccessibleObject classe substitui o GetChild método para retornar o CurveLegendAccessibleObject que representa informações acessíveis para cada parte da legenda. Quando um aplicativo com reconhecimento acessível usa esse controle, o controle pode fornecer as informações acessíveis necessárias.

Este exemplo demonstra o uso da AccessibleEvents enumeração com o AccessibilityNotifyClients método. Confira a visão geral da AccessibleObject classe para o exemplo 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

Comentários

Os aplicativos do sistema operacional e do servidor de acessibilidade geram eventos de acessibilidade em resposta a alterações na interface do usuário.

Essa enumeração é usada por AccessibleObject e Control.

Para obter mais informações, consulte Microsoft Active Accessibility.

Aplica-se a

Confira também