Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 descreve o modo de exibição de controle e o modo de exibição de conteúdo da árvore de Automação da Interface do Usuário que pertencem aos controles spinner quando eles oferecem suporte aos padrões de controle Range Value, Value e Selection e descreve o que pode ser contido em cada exibição. 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 |
|---|---|
| Ícone de Progresso - Editar (0 ou 1) - Botão (2) |
Ícone de Progresso |
Padrão de controle de seleção
| Vista de Controlo | Visualização de conteúdo |
|---|---|
| Ícone de Progresso - Editar (0 ou 1) - Botão (2) - Item de lista (0 ou mais) |
Ícone de Progresso - 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 controle girador dá foco à parte de edição do controle. |
| IsKeyboardFocusableProperty | Ver notas. | Se o controle pode receber foco do teclado, ele deve suportar essa propriedade. |
| NameProperty | Ver notas. | O controle spinner normalmente obtém 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 | Ícone de Progresso | 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 controle Spinner deve ser sempre um controle. |
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 Control Pattern/Pattern | 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 |