AccessibleEvents Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica os eventos que são relatados por aplicativos acessíveis.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Herança
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 |
| 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 |
| 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 Para uma chamada para |
| 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 |
| 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 |
| 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 |
| 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 |
| ValueChange | 32782 | A propriedade Value de um objeto foi alterada. O sistema gera o evento |
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.