Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Nota
Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.
Este tópico fornece informações sobre o suporte à automação da interface do usuário para o tipo de controle Spinner. Na automação da interface do usuário, um tipo de controle é um conjunto de condições que um controle deve atender para usar a ControlTypeProperty propriedade. As condições incluem diretrizes específicas para a estrutura da árvore de Automação da Interface do Usuário, valores de propriedade da Automação da Interface do Usuário e padrões de controle.
Os controles rotadores são usados para selecionar a partir de um domínio de itens ou um intervalo de números.
As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle Spinner. Os requisitos de automação da interface do usuário se aplicam a todos os controles rotadores, seja Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Estrutura de árvore de automação da interface do usuário necessária
A tabela a seguir mostra a visualização de controlo e a visualização de conteúdo da árvore de Automação da Interface de Utilizador que dizem respeito aos controlos spinner quando suportam os padrões de controlo Range Value, Value e Selection e indica o que cada visualização pode conter. Para obter mais informações sobre a árvore de automação da interface do usuário, consulte Visão geral da árvore de automação da interface do usuário.
Valor do intervalo ou Padrão de controle do valor
| Vista de Controlo | Visualização de conteúdo |
|---|---|
| Indicador de Carregamento - Editar (0 ou 1) - Botão (2) |
Indicador de Carregamento |
Padrão de controle de seleção
| Vista de Controlo | Visualização de conteúdo |
|---|---|
| Indicador de Carregamento - Editar (0 ou 1) - Botão (2) - Item de lista (0 ou mais) |
Indicador de Carregamento - ListItem (0 ou mais) |
Para garantir que os dois botões na subárvore de exibição de controle possam ser distinguidos por ferramentas de teste automatizadas, atribua o SmallIncrement ou SmallDecrementAutomationId conforme apropriado. Para algumas implementações, o controle Edit associado pode ser um par do controle Spinner.
Propriedades de automação da interface do usuário necessárias
A tabela a seguir lista as propriedades de Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para controles rotadores. Para obter mais informações sobre as propriedades de automação da interface do usuário, consulte Propriedades de automação da interface do usuário para clientes.
| Propriedade de automação da interface do usuário | Valor | Notas |
|---|---|---|
| AutomationIdProperty | Ver notas. | O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo. |
| BoundingRectangleProperty | Ver notas. | O retângulo mais externo que contém todo o controle. |
| ClickablePointProperty | Ver notas. | O ponto clicável do controlo giratório dá foco à área de edição do controlo. |
| IsKeyboardFocusableProperty | Ver notas. | Se o controle pode receber foco do teclado, ele deve suportar essa propriedade. |
| NameProperty | Ver notas. | O controlo giratório normalmente obtém o seu nome de um rótulo de texto estático. |
| LabeledByProperty | Ver notas. | Os controles Spinner têm um rótulo de texto estático. |
| ControlTypeProperty | Indicador de Carregamento | Esse valor é o mesmo para todas as estruturas de interface do usuário. |
| LocalizedControlTypeProperty | "Spinner" | Cadeia de caracteres localizada correspondente ao tipo de controle Spinner. |
| IsContentElementProperty | Verdade | O controle do rotador deve estar sempre contente. |
| IsControlElementProperty | Verdade | O controlo Spinner deve ser sempre um controlo. |
Padrões e propriedades de controle de automação da interface do usuário necessários
A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados pelos controles rotadores. Para obter mais informações sobre padrões de controle, consulte Visão geral de padrões de controle de automação da interface do usuário.
| Propriedade de Padrão de Controlo/Padrão | Suporte/Valor | Notas |
|---|---|---|
| ISelectionProvider | Depende | Os controles rotadores que têm uma lista de itens a serem selecionados devem oferecer suporte a esse padrão. |
| CanSelectMultiple | Falso | Os controles rotadores são sempre contêineres de seleção única. |
| IRangeValueProvider | Depende | Os controles rotadores que abrangem um intervalo numérico podem oferecer suporte a esse padrão. |
| IValueProvider | Depende | Os controles rotadores que abrangem um conjunto discreto de opções ou números podem oferecer suporte a esse padrão. |
Eventos de automação da interface do usuário necessários
A tabela a seguir lista os eventos de Automação da Interface do Usuário necessários para serem suportados por todos os controles giradores. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário.
| Evento de automação da interface do usuário | Suporte | Notas |
|---|---|---|
| InvalidatedEvent | Depende | Nenhuma |
| BoundingRectangleProperty evento de alteração de propriedade. | Necessário | Nenhuma |
| IsOffscreenProperty evento de alteração de propriedade. | Necessário | Nenhuma |
| IsEnabledProperty evento de alteração de propriedade. | Necessário | Nenhuma |
| ValueProperty evento de alteração de propriedade. | Depende | Nenhuma |
| ValueProperty evento de alteração de propriedade. | Depende | Nenhuma |
| AutomationFocusChangedEvent | Necessário | Nenhuma |
| StructureChangedEvent | Necessário | Nenhuma |