AccessibleEvents Enumeração

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Especifica eventos que são reportados por aplicações acessíveis.

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

Campos

Name Valor Description
SystemSound 1

Foi ouvido um som. O sistema envia este evento quando um som do sistema, como nos menus, é reproduzido, mesmo que não seja audível nenhum som. Isto pode ser causado pela falta de ficheiro de som ou placa de som. Os servidores enviam este evento se um elemento de interface de utilizador personalizado gerar um som.
SystemAlert 2

Foi gerado um alerta. As aplicações de servidor enviam este evento sempre que ocorre uma alteração importante na interface do utilizador que o utilizador possa precisar de conhecer. O sistema não envia o evento de forma consistente para objetos de caixa de diálogo.
SystemForeground 3

A janela em primeiro plano mudou. O sistema envia este evento mesmo que a janela em primeiro plano seja alterada para outra janela no mesmo thread. As aplicações servidor nunca enviam este evento.
SystemMenuStart 4

Foi selecionado um item do menu na barra de menu. O sistema envia este evento para menus padrão. Os servidores enviam este evento para menus personalizados. O sistema pode gerar mais do que um MenuStart evento que pode ou não ter um evento correspondente MenuEnd .
SystemMenuEnd 5

Um menu do menu estava fechado. O sistema envia este evento para menus padrão. Os servidores enviam este evento para menus personalizados.
SystemMenuPopupStart 6

Foi exibido um menu de atalho. O sistema envia este evento para menus padrão. Os servidores enviam este evento para menus personalizados. O sistema não envia o evento de forma consistente.

Para uma chamada para TrackPopupMenu(), um cliente verá EVENT_SYSTEM_MENUSTART seguido quase imediatamente de EVENT_SYSTEM_MENUPOPUPSTART para o pop-up que está a ser mostrado.
SystemMenuPopupEnd 7

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

Para uma chamada para TrackPopupMenu(), um cliente verá EVENT_SYSTEM_MENUSTART seguido quase imediatamente de EVENT_SYSTEM_MENUPOPUPSTART para o pop-up que está a ser mostrado.
SystemCaptureStart 8

Uma janela está a ser movida ou redimensionada. O sistema envia o evento; Os servidores nunca enviam este evento.
SystemCaptureEnd 9

Uma janela perdeu a captura do rato. O sistema envia o evento; Os servidores nunca enviam este evento.
SystemMoveSizeStart 10

Uma janela está a ser movida ou redimensionada. O sistema envia o evento; Os servidores nunca enviam este evento.
SystemMoveSizeEnd 11

O movimento ou redimensionamento de uma janela está concluído. O sistema envia o evento; Os servidores nunca enviam este evento.
SystemContextHelpStart 12

Uma janela entrou no modo Ajuda sensível ao contexto. O sistema não envia o evento de forma consistente.
SystemContextHelpEnd 13

Uma janela saiu do modo Ajuda sensível ao contexto. O sistema não envia o evento de forma consistente.
SystemDragDropStart 14

Uma aplicação está prestes a entrar em modo de arrastar e largar. Aplicações que suportam operações de arrastar e largar devem enviar este evento; O sistema não.
SystemDragDropEnd 15

Uma aplicação está prestes a sair do modo de arrastar e largar. Aplicações que suportam operações de arrastar e largar devem enviar este evento; O sistema não.
SystemDialogStart 16

Foi exibida uma caixa de diálogo. O sistema envia o evento para as caixas de diálogo padrão. Os servidores enviam este evento para caixas de diálogo personalizadas. O sistema não envia o evento de forma consistente.
SystemDialogEnd 17

Uma caixa de diálogo foi fechada. O sistema não envia o evento para as caixas de diálogo padrão. Os servidores enviam este evento para caixas de diálogo personalizadas. O sistema não envia o evento de forma consistente.
SystemScrollingStart 18

A scroll começou numa barra de scroll. O sistema envia o evento para barras de scroll ligadas a uma janela e para controlos padrão de barra de scroll. Os servidores enviam este evento para barras de scroll personalizadas.
SystemScrollingEnd 19

O scroll terminou numa barra de scroll. O sistema envia este evento para barras de deslocamento ligadas a uma janela e para controlos padrão de barras de deslocamento. Os servidores enviam este evento para barras de scroll personalizadas.
SystemSwitchStart 20

O utilizador pressionava ALT+TAB, que ativa a janela do interruptor. Se apenas uma aplicação estiver a correr quando o utilizador pressiona ALT+TAB, o sistema gera o SwitchEnd evento sem um evento correspondente SwitchStart .
SystemSwitchEnd 21

O utilizador lançou ALT+TAB. O sistema envia o SwitchEnd evento; os servidores nunca enviam este evento. Se apenas uma aplicação estiver a correr quando o utilizador pressiona ALT+TAB, o sistema envia o SwitchEnd evento sem um evento correspondente SwitchStart .
SystemMinimizeStart 22

Um objeto janela está prestes a ser minimizado ou maximizado. O sistema envia o evento; Os servidores nunca enviam este evento.
SystemMinimizeEnd 23

Um objeto janela era minimizado ou maximizado. O sistema envia o evento; Os servidores nunca enviam este evento.
Create 32768

Foi criado um objeto. O sistema operativo envia o evento para os seguintes elementos da interface de utilizador: caret, controlo de cabeçalho, controlo de vista de lista, controlo de tabulação, controlo de barra de ferramentas, controlo de vista em árvore e objeto de janela. As aplicações servidor enviam este evento para os seus objetos acessíveis. Os servidores devem enviar este evento para todos os objetos filhos de um objeto antes de enviar o evento para o objeto pai. Os servidores devem garantir que todos os objetos filhos estão totalmente criados e prontos para aceitar chamadas dos clientes quando o objeto pai envia o evento.
Destroy 32769

Um objeto foi destruído. O sistema envia este evento para os seguintes elementos da interface do utilizador: caret, controlo de cabeçalho, controlo de vista de lista, controlo de tabulação, controlo de barra de ferramentas, controlo de vista em árvore e objeto janela. As aplicações servidor enviam este evento para os seus objetos acessíveis. Este evento pode ou não ser enviado para objetos filhos. No entanto, os clientes podem concluir que todos os filhos de um objeto foram destruídos quando o objeto pai envia este evento.
Show 32770

Está a ser mostrado um objeto escondido. O sistema envia este evento para os seguintes elementos da interface do utilizador: caret, cursor e objeto janela. As aplicações servidor enviam este evento para os seus objetos acessíveis. Os clientes podem concluir que, quando este evento é enviado por um objeto pai, todos os objetos filhos já foram exibidos. Portanto, as aplicações servidor não precisam de enviar este evento para os objetos filhos.
Hide 32771

Um objeto está escondido. O sistema envia o evento para os seguintes elementos da interface de utilizador: caret e cursor. As aplicações servidor enviam o evento para os seus objetos acessíveis. Quando o evento é gerado para um objeto pai, todos os objetos filhos já foram ocultados. Portanto, as aplicações servidor não precisam de enviar o evento para os objetos filhos. O sistema não envia o evento de forma consistente.
Reorder 32772

Um objeto contentor adicionou, removeu ou reordenou os seus filhos. O sistema envia este evento para os seguintes elementos da interface de utilizador: controlo de cabeçalho, controlo da vista de lista, controlo da barra de ferramentas e objeto janela. As aplicações servidor enviam este evento conforme apropriado para os seus objetos acessíveis. Este evento também é enviado por uma janela pai quando a ordem z das janelas filhas muda.
Focus 32773

Um objeto recebeu o foco do teclado. O sistema envia este evento para os seguintes elementos da interface de utilizador: controlo de vista de lista, barra de menus, menu de atalho, janela de comutação, controlo de separador, controlo de vista em árvore e objeto janela. As aplicações servidor enviam este evento para os seus objetos acessíveis.
Selection 32774

Foi selecionado um objeto acessível dentro de um objeto contentor. Este evento sinaliza uma única seleção. Ou uma criança foi selecionada num recipiente que anteriormente não continha nenhuma criança selecionada, ou a seleção mudou de uma criança para outra.
SelectionAdd 32775

Um item dentro de um objeto contentor era adicionado à seleção. O sistema envia este evento para os seguintes elementos da interface de utilizador: caixa de lista, controlo de vista de lista e controlo de vista de árvore. As aplicações servidor enviam este evento para os seus objetos acessíveis. Este evento sinaliza que uma criança foi adicionada a uma seleção existente.
SelectionRemove 32776

Um item dentro de um objeto contentor foi removido da seleção. O sistema envia este evento para os seguintes elementos da interface de utilizador: caixa de lista, controlo de vista de lista e controlo de vista de árvore. As aplicações servidor enviam este evento para os seus objetos acessíveis. Este evento sinaliza que uma criança foi retirada de uma seleção existente.
SelectionWithin 32777

Numerosas alterações na seleção ocorreram dentro de um objeto contentor. O sistema envia este evento para as caixas de lista. As aplicações servidor enviam este evento para os seus objetos acessíveis. Este evento pode ser enviado quando os itens selecionados dentro de um controlo mudaram substancialmente. Este evento informa o cliente de que ocorreram muitas mudanças na seleção. Isto é preferível a enviar vários SelectionAdd eventos SelectionRemove .
StateChange 32778

O estado de um objeto mudou. O sistema envia o evento para os seguintes elementos da interface de utilizador: caixa de seleção, caixa de combo, controlo de cabeçalho, botão de pressão, botão de deslocação, barra de deslocação, controlo da barra de ferramentas, controlo da vista em árvore, controlo para cima e para baixo e objeto janela. As aplicações servidor enviam o evento para os seus objetos acessíveis. Por exemplo, uma alteração de estado pode ocorrer quando um objeto botão foi pressionado ou libertado, ou quando um objeto está a ser ativado ou desativado. O sistema não envia o evento de forma consistente.
LocationChange 32779

Um objeto mudou de localização, forma ou tamanho. O sistema envia este evento para os seguintes elementos da interface de utilizador: caret e objeto janela. As aplicações servidor enviam este evento para os seus objetos acessíveis. Este evento é gerado em resposta ao objeto de topo dentro da hierarquia de objetos que mudou, não para quaisquer filhos que possa conter. Por exemplo, se o utilizador redimensionar uma janela, o sistema envia esta notificação para a janela, mas não para a barra de menus, barra de título, barras de scroll ou outros objetos que também tenham mudado. O sistema não envia este evento para todas as janelas filhas não flutuantes quando o pai move. No entanto, se uma aplicação redimensionar explicitamente as janelas filhas devido ao redimensionamento, o sistema envia múltiplos eventos para os filhos redimensionados. Se a State propriedade de um objeto estiver definida para Floating, os servidores devem enviar um evento de mudança de localização sempre que o objeto muda de localização. Se um objeto não tiver este estado, os servidores devem ativar este evento quando o objeto se move em relação ao seu pai.
NameChange 32780

A propriedade de Name um objeto mudou. O sistema envia este evento para os seguintes elementos da interface do utilizador: caixa de seleção, cursor, controlo de vista de lista, botão de pressão, botão de inserção, controlo de barra de estado, controlo de vista em árvore e objeto janela. As aplicações servidor enviam este evento para os seus objetos acessíveis.
DescriptionChange 32781

A propriedade de Description um objeto mudou. As aplicações servidor enviam este evento para os seus objetos acessíveis.
ValueChange 32782

A propriedade de Value um objeto mudou. O sistema aumenta o ValueChange evento para os seguintes elementos da interface de utilizador: controlo de edição, controlo de cabeçalho, controlo de tecla de atalho, controlo da barra de progresso, barra de scroll, controlo deslizante e controlo para cima e baixo. As aplicações servidor enviam este evento para os seus objetos acessíveis.
ParentChange 32783

Um objeto tem um novo objeto pai. As aplicações servidor enviam este evento para os seus objetos acessíveis.
HelpChange 32784

A propriedade de Help um objeto mudou. As aplicações servidor enviam este evento para os seus objetos acessíveis.
DefaultActionChange 32785

A propriedade de DefaultAction um objeto mudou. O sistema envia este evento para as caixas de diálogo. As aplicações servidor enviam este evento para os seus objetos acessíveis. Portanto, as aplicações servidor não precisam de enviar este evento para os objetos filhos. Os 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, os servidores não precisam de enviar o AccessibleEvents.StateChange evento neste caso.
AcceleratorChange 32786

A propriedade de KeyboardShortcut um objeto mudou. As aplicações servidor enviam o evento para os seus objetos acessíveis.

Exemplos

O exemplo de código seguinte demonstra a criação de um controlo de gráfico consciente da acessibilidade, usando as AccessibleObject classes e Control.ControlAccessibleObject para expor informação acessível. O controlo traça duas curvas juntamente com uma legenda. A ChartControlAccessibleObject classe, que deriva de ControlAccessibleObject, é usada no CreateAccessibilityInstance método para fornecer informação acessível personalizada para o controlo do mapa. Como a legenda do mapa não é um controlo -based real Control , mas sim desenhada pelo controlo do mapa, não tem qualquer informação acessível incorporada. Por causa disso, a ChartControlAccessibleObject classe sobrepõe o GetChild método para devolver o CurveLegendAccessibleObject que representa informação acessível para cada parte da legenda. Quando uma aplicação acessível-consciente utiliza este controlo, este pode fornecer a informação necessária e acessível.

Este exemplo demonstra o uso da AccessibleEvents enumeração com o AccessibilityNotifyClients método. Consulte a AccessibleObject visão geral da classe para o exemplo completo do código.

   // 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

Observações

O sistema operativo e as aplicações do servidor de acessibilidade geram eventos de acessibilidade em resposta a alterações na interface do utilizador.

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

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

Aplica-se a

Ver também