TOTVSTEC

Árvore de páginas

Sintaxe Mínima

@ <nTop>,<nLeft> GROUP <oGroup> TO <nBottom>,<nRight>

Sintaxe Completa

@ <nTop>, <nLeft> GROUP <oGroup> TO <nBottom>,<nRight>
   [ LABEL | PROMPT <cLabel> ] 
   [ OF <oWnd> ]
   [ COLOR <nClrText> [,<nClrBack> ] ]
   [ PIXEL ]

Include

#include "totvs.ch"

Parâmetros

CláusulaTipoObrigatóriaDescrição
<nTop>NSParâmetro obrigatório, indica a linha da coordenada inicial de tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
<nLeft>NSParâmetro obrigatório, indica a coluna da coordenada inicial de tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
GROUP <oGroup>CSCláusula obrigatória, indica o uso do componente de agrupamento tGroup(). Deve ser sucedido da variável AdvPL a receber o objeto do componente.
TO <nBottom>,<nRight>NSParâmetros obrigatórios, indicam as coordenadas finais de tela (linha e coluna, respectivamente) que deve ser ocupada pelo componente.
LABEL | PROMPT <cLabel>CNParâmetro opcional, pode ser uma constante string ou variável do tipo caractere a ser exibida como título do agrupamento na interface.
OF <oWnd>ONCláusula opcional, quando informada permite especificar o nome de uma variável AdvPL que contenha o objeto ou componente pai de interface (janela ou diálogo, painel, folder) onde o componente deve ser exibido. Caso seja omitida, o componente será criado na janela ou diálogo ativos no momento.
COLOR | COLORS <nClrText> [ ,<nClrBack]NNCláusulas opcionais, que quando especificadas, permitem alterar a cor do texto da mensagem a ser exibida pelo componente, e opcionalmente também permite alterar a cor de fundo do texto da exibição.
PIXEL 
NCláusula opcional, quando uma delas for especificada, indica que o sistema de coordenadas usado nos parâmetros <nRow> e <nCol> são em pixels (ou pontos) a partir da coordenada superior esquerda (0,0) do componente visual pai em uso no qual o objeto será posicionado. 
  • O componente TGroup() não cria um objeto de container para outros objetos, como o tPanel(). O objetivo deste componente é apenas desenhar na interface um retângulo para agrupar outros componentes de forma visual.

Classe usada pelo comando

O comando @ .. GROUP é traduzido em tempo de compilação para utilizar a classe de interface visual do AdvPL TGROUP() e seu método construtor NEW().

Referências

Construtor TGroup:New

Exemplo


Exemplo do comando @ ... GROUP
#include 'totvs.ch'

User Function TGroup()
Local oDlg, oGet
Local cPassW := space(20)
Local oGrp

DEFINE DIALOG oDlg TITLE "Exemplo tGroup" FROM 180,180 TO 550,700 PIXEL

// Cria o grupo
@ 10,10 GROUP oGrp TO 60,200 LABEL "Grupo de Teste" PIXEL

// Cria o Objeto tGet usando o comando @ .. GET 
@ 20,15 GET oGet VAR cPassW SIZE 150,20 OF oDlg PIXEL VALID !empty(cPassW) PASSWORD

ACTIVATE DIALOG oDlg CENTERED

Return

Resultado


  • Sem rótulos