Partilhar via

Tabela RadioButton

  • Artigo

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 de todos os grupos.

Ela tem as colunas a seguir.

Coluna Tipo Chave Nullable
Propriedade Identificador S N
Order Inteiro S N
Valor Formatted N N
X Inteiro N N
S Inteiro N N
Largura Inteiro N N
Altura Inteiro N N
Texto Formatted N S
Ajuda Texto N S

 

Colunas

Property

Uma propriedade nomeada a ser vinculada a este botão de opção. Todos os botões vinculados à mesma propriedade passam a fazer parte do mesmo grupo.

Order

Um inteiro positivo usado para determinar a ordenação dos itens dentro de uma lista. Os inteiros não precisam ser consecutivos.

Value

A cadeia de caracteres de valor associada a esse botão. A seleção do 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. Precisa 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. Precisa ser um número não negativo.

Width

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

Height

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

Text

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 se ajustar ao controle, ele será truncado. Se o botão exibir um ícone ou um bitmap, essa coluna conterá o nome da imagem, que é uma chave na tabela Binary. Não há como mostrar uma imagem e um texto em um botão.

Help

As cadeias de caracteres de Help 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 um texto ToolTip. Esse texto é mostrado pelos leitores de tela para controles que contêm uma imagem. A segunda parte é usada para a ajuda contextual, embora a ajuda contextual ainda não tenha sido implementada. O caractere separador é obrigató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 do instalador, não nas unidades da caixa de diálogo. Uma unidade do instalador é igual a um décimo segundo da altura do tamanho da fonte MS Sans Serif de 10 pontos. As coordenadas dos controles são relativas ao cartaz.

As coordenadas dos botões são fornecidas 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 entre si.

O conteúdo dos campos Value e Text é formatado pela função MsiFormatRecord quando o controle é criado, ou seja, eles podem conter qualquer expressão que a função MsiFormatRecord possa interpretar. A formatação só ocorre quando o controle é criado e não é atualizada 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 dessa propriedade precisa ser inicializado na tabela Property. Em 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 dessa propriedade. Esse é o botão padrão do controle RadioButtonGroup. O botão padrão é inicialmente mostrado como selecionado no controle.

Observe que o usuário só poderá alterar o foco em uma caixa de diálogo pressionando a tecla Tab de um controle RadioButtonGroup quando um dos botões do grupo for selecionado. Para fazer com que o foco vá para esse 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