Partilhar via


UI Automation Support for the RadioButton Control Type

Este tópico fornece informações sobre Suporte para o RadioButton Tipo de controle.Em Um tipo de controle é um conjunto de condições que um controle deve atender em Ordem para usar o ControlTypeProperty Propriedade.As condições incluem guia específico linhas para estrutura de árvore, valores de propriedade e Padrões de Controlarar.

Um botão de opção consiste em um botão redondo e texto definido pelo aplicativo (um rótulo), um ícone, ou um bitmap que indica uma opção que o usuário pode fazer ao selecionar o botão.Um aplicativo normalmente usa botões de opção em uma caixa de grupo para permitir que o usuário escolha um conjunto de opções relacionadas, mas mutuamente exclusivas.Por exemplo, o aplicativo pode apresentar um grupo de botões de opção no qual o usuário pode selecionar um formato preferencial para o texto selecionado na área cliente.O usuário pode selecionar um formato alinhado à esquerda, alinhado à direita ou centralizado, selecionando o botão de opção correspondente.Normalmente, o usuário pode selecionar somente uma opção de cada vez a partir de um conjunto de botões de opção.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o tipo de controle RadioButton.O Requisitos Aplicar para todos Lista controles, se , Win32, ou .

Este tópico contém as seguintes seções.

Estrutura de Árvore de Automação de IU Requerida

A tabela a seguir descreve o Modo de controle e o exibição de conteúdo do Árvore que pertence ao botão de opção controla e descreve o que pode estar contido em cada modo de exibição.Para obter mais informações sobre o árvore, consulte Visão geral da árvore de automação de interface do usuário.

Visão de Controle

Visão de Conteúdo

  • RadioButton

  • RadioButton

Não há filhos na visualização de controle ou na visualização de conteúdo.

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para o RadioButton controlam tipo.Para obter mais informações propriedades, consulte UI Automation Properties for Clients.

Propriedade

Value (Valor)

Anotações

AutomationIdProperty()

Veja anotações.

O valor desta propriedade precisa ser único em todos os controles de uma aplicação.

BoundingRectangleProperty

Veja anotações.

O retângulo mais externo que contém o controle inteiro.

IsKeyboardFocusableProperty

Veja anotações.

Se o controle pode receber o foco do teclado, deve suportar essa propriedade.

NameProperty

Veja anotações.

O nome do controle de botão de opção é o texto exibido ao lado do botão que mantém o estado da seleção.

ClickablePointProperty

Veja anotações.

O ponto clicável do controle de botão de opção PRECISA ser um ponto que define a seleção do botão de opção se clicado com um ponteiro do mouse.

LabeledByProperty

Null

Botões de opção são controles auto-rotulantes.

ControlTypeProperty

RadioButton

Esse valor é o mesmo para todos As estruturas.

LocalizedControlTypeProperty

"botão de opção"

String localizada correspondente ao tipo de controle RadioButton.

IsContentElementProperty

True

The radio button control is always included in the content view of the árvore.

IsControlElementProperty

True

The radio button control is always included in the control view of the árvore.

Padrões de Controle de Automação de IU Requeridos

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por todos os controles botão de opção.Para obter mais informações sobre padrões de controle, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.

Padrão de Controle/Propriedade de Padrão de Controle

Suporte/Valor

Anotações

ISelectionItemProvider

Sim

Todos os controles botão de opção devem oferecer suporte ao padrão de seleção de item para que eles próprios possam ser selecionados.

SelectionContainer()

Veja anotações.

O SelectionContainerProperty sempre devem ser concluídas de modo que um Cliente de Automação interface do usuário pode determinar que outros botões de opção em um contexto específico se relacionam entre si.   Para o Win32 Versão do botão de opção, essa propriedade não terão suporte porque ele não é possível obter essas informações a partir dessa estrutura herdada.

IToggleProvider

Nunca

O botão de opção não pode trocar de estado uma vez que este tenha sido definido.Esse padrão nunca deve ser suportado em botão de opção.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles botão de opção.Para obter mais informações sobre eventos, consulte Visão geral sobre eventos de automação de interface do usuário.

Evento

Suporte

Anotações

ElementRemovedFromSelectionEvent

Necessário

Nenhum

ElementSelectedEvent

Necessário

Nenhum

ToggleStateProperty Evento de propriedade alterado.

Nunca

Nenhum

BoundingRectangleProperty Evento de propriedade alterado.

Necessário

Nenhum

IsOffscreenProperty Evento de propriedade alterado.

Necessário

Nenhum

IsEnabledProperty Evento de propriedade alterado.

Necessário

Nenhum

AutomationFocusChangedEvent

Necessário

Nenhum

StructureChangedEvent

Necessário

Nenhum

Consulte também

Conceitos

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

UI Automation Overview

Referência

RadioButton