Controle GroupBox

  • Artigo

O controle GroupBox exibe um retângulo, possivelmente com legenda texto, que serve para agrupar outros controles na caixa de diálogo.

Atributos de controle

Você pode usar os atributos a seguir com o controle GroupBox. 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 Event.

Identificador de atributo Bit hexadecimal Descrição
Posição   Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle ao canto esquerdo do controle nas colunas Width, Height, X e Y da tabela Control ou da tabela BBControl. Use Unidades do instalador para definir o comprimento e a distância.
Texto Exibe um legenda no canto superior esquerdo do controle. Para definir a fonte e seu estilo em uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja definida como um estilo de texto válido, essa fonte será usada.
Visível 0x00000000 0x00000001
 Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Attributes da tabela Control ou da tabela BBControl para tornar o controle visível ou oculto após a criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
Sunken 0x00000000 0x00000004
 Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.
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 é alinhado à direita.

 

Comentários

Esse controle pode ser criado a partir da classe BUTTON usando a função CreateWindowEx. Ele tem os estilos BS_GROUPBOX, WS_CHILD e WS_GROUP.

Há sempre uma lacuna entre a parte superior da janela do controle e o quadro visível, mesmo quando não há legenda.