Controle RadioButtonGroup
O controle RadioButtonGroup é um grupo de botões de opção. Ele permite que o usuário selecione uma cadeia de caracteres ou um valor inteiro para uma propriedade de uma lista predeterminada de valores. Você pode associar esse controle a uma propriedade inserindo o nome da propriedade na coluna Propriedade da tabela controle . Especifique os valores possíveis para seleção na coluna Valor da tabela RadioButton. Observe que a cadeia de caracteres exibida não é necessariamente a mesma que o valor que o usuário está escolhendo.
Cada controle RadioButtonGroup está associado a uma propriedade. O valor padrão dessa propriedade deve ser inicializado na tabela propriedade . Em cada RadioButtonGroup especificado na tabela RadioButton, pode haver um botão de opção que tenha um valor no campo Valor que corresponda ao valor padrão dessa propriedade. Este é o botão padrão para o controle RadioButtonGroup. O botão Padrão é mostrado inicialmente como selecionado no controle.
Observe que o foco em uma caixa de diálogo não pode ser movido para um controle RadioButtonGroup até que um dos botões do grupo tenha sido selecionado. Para fazer o foco passar para esse grupo de botões, especifique um dos botões como um botão padrão para o grupo.
Os controles RadioButtonGroup definem apenas valores de propriedade e não podem ser usados para enviar um do ControlEvent.
A implementação trata todo o grupo como um controle, portanto, não é possível ocultar ou desabilitar botões individuais dentro do grupo. Da mesma forma, todos os botões precisam ser do mesmo estilo, ou seja, todos eles têm texto ou todos eles têm bitmaps (ou outros recursos semelhantes). A posição dos botões é criada em relação ao grupo. Dessa forma, todo o grupo pode ser movido alterando apenas as coordenadas do grupo sem alterar os botões individuais. Na criação, o controle verifica se os botões individuais não se estendem além dos limites do grupo.
Atributos de controle
Você pode usar os atributos a seguir com esse controle. Para alterar o valor de um atributo usando um evento, assine o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Attribute. Insira o identificador do ControlEvent na coluna Evento.
| Identificador de atributo | Bit hexadecimal | Descrição |
|---|---|---|
| indirectPropertyName | Esse é o nome de uma propriedade indireta associada ao controle. Se o bit de atributo indireto for definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Se o bit de atributo indireto estiver definido, esse nome também será o valor da propriedade listada na coluna Propriedade da tabela controle . | |
| de Posição | Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela controle . Use unidades do instalador para comprimento e distância. |
|
| PropertyName | Esse é o nome da propriedade associada a esse controle. Se o bit de atributo indireto não estiver definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Esse atributo é especificado na coluna Propriedade da tabela controle . | |
| PropertyValue | Valor atual da propriedade exibida ou alterada por esse controle. Se o bit de atributo indireto não estiver definido, esse será o valor de PropertyName. Se o bit de atributo indireto estiver definido, esse será o valor de IndirectPropertyName. Se o atributo for alterado, o controle refletirá o novo valor. | |
| de Texto | Esse atributo de controle pode especificar o texto exibido pelo controle, uma imagem armazenada na tabela Binária ou um conjunto de imagens em tempo de execução. Para especificar o texto, insira a cadeia de caracteres de texto na coluna Texto da tabela controle . Para definir a fonte e o estilo de fonte deste texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada. Para especificar um ícone ou imagem de bitmap armazenado na tabela binária insira a chave primária do registro da imagem da coluna Name da tabela Binária na coluna Texto da tabela Control registro do controle. |
|
| Visíveis | 0x00000000 0x00000001 |
Controle oculto. Controle visível. Inclua esse bit na palavra bit da coluna Atributos na tabela controle para tornar o controle visível ou oculto após sua criação. Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition. |
| habilitado | 0x00000000 0x00000002 |
Controlar em um estado desabilitado. Controlar em um estado habilitado. Inclua esse bit na coluna Atributos do controle para habilitar o controle na criação. Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition. |
| submersa | 0x00000000 0x00000004 |
Exibe o estilo visual padrão. Exibe o controle com uma aparência submersa, 3D. Inclua esses bits na palavra bit na coluna Atributos da tabela controle . |
| Indireto | 0x00000000 0x00000008 |
O controle exibe ou altera o valor da propriedade na coluna Propriedade da tabela controle . O controle exibe ou altera o valor da propriedade que tem o identificador listado na coluna Propriedade da tabela Controle. Determina se a propriedade associada a esse controle é referenciada indiretamente. |
| inteiro | 0x00000000 0x00000010 |
A propriedade associada ao controle é um valor de cadeia de caracteres. A propriedade associada ao controle é um valor inteiro. Inclua esse bit na palavra de bit da coluna Atributos da tabela controle para definir esse atributo na criação do controle. |
| RTLRO | 0x00000000 0x00000020 |
O texto no controle é exibido na ordem de leitura da esquerda para a direita. O texto no controle é exibido na ordem de leitura da direita para a esquerda. |
| RightAligned | 0x00000000 0x00000040 |
O texto no controle é alinhado à esquerda. O texto no controle está alinhado à direita. |
| PushLike | 0x00000000 0x00020000 |
O controle é desenhado com sua aparência habitual. O controle tem o estilo BS_PUSHLIKE e é desenhado para aparecer como um botão de push. Inclua esse bit na palavra de bit da coluna Atributos da tabela controle para definir esse atributo na criação do controle. |
| bitmap | 0x00000000 0x00040000 |
O texto no controle é especificado na coluna Texto da tabela controle . O controle tem o estilo BS_BITMAP, o texto no controle é substituído por uma imagem bitmap. A coluna Texto na tabela controle é usada como uma chave estrangeira para a tabela binária . Inclua esse bit na palavra bit na coluna Atributos da tabela controle . Não defina os bits de estilo Ícone e Bitmap simultaneamente. O botão não pode conter uma imagem bitmap e um texto. Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada. |
| ícone | 0x00000000 0x00080000 |
O texto no controle é especificado na coluna Texto da tabela controle . O controle tem o estilo BS_ICON, o texto no controle é substituído por uma imagem de ícone. A coluna Texto na tabela controle é usada como uma chave estrangeira para a tabela binária . Inclua esse bit na palavra bit na coluna Atributos da tabela controle . Não defina os bits Ícone e Bitmap simultaneamente. O botão não pode conter uma imagem de ícone e um texto. Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada. |
| FixedSize | 0x00000000 0x00100000 |
Estique a imagem do ícone para ajustar o controle. Corte ou centralize a imagem do ícone no controle. Inclua esse bit na palavra de bit da coluna Atributos da tabela controle . |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Carrega a primeira imagem. Carrega a primeira imagem 16x16. Carrega a primeira imagem 32x32. Carrega a primeira imagem 48x48. Um arquivo de ícone pode conter imagens de tamanho diferente do mesmo ícone. Inclua o valor da palavra de bit apropriada na coluna Atributos da tabela controle Se esses bits não estiverem definidos, o instalador ignorará o atributo FixedSize e a imagem será ampliada para se ajustar ao retângulo de controle. Se os bits IconSize e os bits FixedSize forem definidos, uma imagem menor que o controle será centralizada e uma imagem será maior do que o controle que ela será reduzida para ajustar. |
| HasBorder | não definido 0x01000000 |
Sem borda e sem texto. Exibe borda e texto. Inclua 16777216 na palavra bit na coluna Atributos da controle de para exibir uma borda e um texto. |
Observações
Devido à maneira como o Windows desenha o quadro, há uma lacuna entre a parte superior da janela do controle e o quadro visível, mesmo quando não há legenda.
Esse controle pode ser criado a partir da classe BUTTON usando a função CreateWindowEx. Se o HasBorder bit estiver definido, ele terá o estilo BS_GROUPBOX, caso contrário, ele terá o estilo BS_OWNERDRAW.
O controle RadioButtonGroup não deve sobrepor outros controles e outros controles não devem sobrepor um RadioButtonGroup. Sobrepor esse controle e outro pode fazer com que os controles funcionem ou exibam incorretamente. Para fornecer programas de leitor de tela com texto descritivo extra sobre um controle RadioButtonGroup, siga o exemplo fornecido em Adicionar Texto Extra aos Botões de Opção.