Partilhar via


Tabela RadioButton

Os botões de opção não são tratados como controles individuais, mas fazem parte de um grupo de botões de opção que funciona como um controle RadioButtonGroup. A tabela RadioButton lista os botões para todos os grupos.

A tabela RadioButton tem as seguintes colunas.

Coluna Tipo Chave Nulo
Propriedade Identificador Y N
Encomenda inteiro Y N
Valor Formatado N N
X inteiro N N
Y inteiro N N
Largura inteiro N N
Altura inteiro N N
Texto Formatado N Y
Ajuda de texto N Y

 

Colunas

Propriedade

Uma propriedade nomeada a ser vinculada a esse botão de opção. Todos os botões vinculados à mesma propriedade tornam-se parte do mesmo grupo.

Encomenda

Um inteiro positivo usado para determinar a ordem dos itens dentro de uma lista. Os números inteiros não têm de ser consecutivos.

Valor

A cadeia de caracteres de valor associada a esse botão. Selecionar o botão define a propriedade associada a esse valor.

X

A coordenada horizontal dentro do grupo do canto superior esquerdo do retângulo delimitador do botão de opção. Este deve ser um número não negativo.

Y

A coordenada vertical dentro do grupo do canto superior esquerdo do retângulo delimitador do botão de opção. Este deve ser um número não negativo.

Largura

A largura do botão. Este deve ser um número não negativo.

Altura

A altura do botão. Este deve ser um número não negativo.

Texto

O título localizável e visível a ser atribuído ao botão de opção. Se o texto for muito longo para caber no controle, ele será truncado. Se o botão exibir um ícone ou um bitmap, essa coluna conterá o nome da imagem, que é uma chave para a tabela Binary. Não é possível mostrar uma imagem e um texto num botão.

Ajuda

As cadeias de caracteres da Ajuda usadas com o botão. O texto é opcional e localizável. A cadeia de caracteres é dividida em duas partes separadas por um caractere (|). A primeira parte da cadeia de caracteres é usada como texto de dica de ferramenta. Este texto é mostrado por leitores de tela para controles que contêm uma imagem. A segunda parte é usada para Ajuda sensível ao contexto, embora a ajuda sensível ao contexto ainda não tenha sido implementada. O caractere separador é necessário mesmo que apenas um dos dois tipos de texto esteja presente.

Comentários

Os valores inteiros para x, y, largura e altura estão nas unidades de instalação , não em unidades de diálogo. Uma unidade de instalação é igual a um duodécimo da altura do tamanho da fonte MS Sans Serif de 10 pontos. As coordenadas para os controles são relativas ao outdoor.

As coordenadas dos botões são dadas em relação ao grupo. Se as coordenadas do grupo forem alteradas, os botões dentro do grupo permanecerão na mesma posição relativa uns aos outros.

O conteúdo dos campos Valor e Texto são formatados pela funçãoMsiFormatRecord quando o controle é criado, portanto, eles podem conter qualquer expressão que a função MsiFormatRecord possa interpretar. A formatação ocorre somente quando o controle é criado e não é atualizado se uma propriedade envolvida na expressão é modificada durante a vida útil do controle.

Cada controle RadioButtonGroup está associado a uma propriedade. O valor padrão para essa propriedade deve ser inicializado na tabela Property. Dentro de cada RadioButtonGroup especificado na tabela RadioButton, pode haver um botão de opção que tenha um valor no campo Value que corresponda ao valor padrão para essa propriedade. Este é o botão padrão para o controle RadioButtonGroup. O botão padrão é inicialmente mostrado como selecionado no controle.

Observe que o usuário não pode alterar o foco em uma caixa de diálogo pressionando a tecla TAB para um controle RadioButtonGroup até que um dos botões no grupo tenha sido selecionado. Para fazer com que o foco se mova para este grupo de botões pressionando a tecla TAB, especifique um dos botões como um botão padrão para o grupo.

Validação

ICE03
ICE06
ICE17
ICE34
ICE46