Usina BRAdvPL Guia
Entrar
← Todos os tópicos
COMANDOEm revisão

@ ... TO

@ nTop, nLeft TO nBottom, nRight [oBox] [CAPTION cCaption] OF oWnd

Desenha um quadro usando coordenadas inicial e final.

@ ... TOAdvPL
01 · VISÃO GERAL

Visão geral

O Guia de referência eAdvpl, §3.14, p. 16, registra a variante histórica apresentada na sintaxe. Os fragmentos pressupõem o ambiente e as definições de comandos correspondentes; não são um aplicativo completo. Nesta construção, TO separa o canto inicial do canto final; os dois últimos números não são largura e altura. O quadro organiza visualmente controles, sem criar uma regra de validação ou uma barreira de acesso. TGroup documenta outro caminho para agrupamento visual com construtor próprio; não presumir que toda macro @ ... TO expanda para essa classe. (Refs. 1–2)

02 · SINTAXE

Sintaxe

@ nTop, nLeft TO nBottom, nRight [oBox] [CAPTION cCaption] OF oWnd

Parâmetros

nTop, nLeft, nBottom, nRight
NuméricoObrigatório

Cantos inicial e final, na unidade do ambiente.

oWnd
ObjetoObrigatório

Janela existente que contém o quadro.

Retorno

Comando de interface/impressão; não usar como expressão com retorno de função.

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento historico; oDlg ja existe.
@ 1, 1 TO 8, 50 CAPTION "Dados de consulta" OF oDlg
// 8 e 50 sao coordenadas finais, nao altura e largura.
Resultado esperado

Propõe um quadro com legenda, sem incluir campos nem lógica de negócio. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Manter os controles dentro dos limites e conferir escala de tela. Não misturar coordenadas em caracteres e pixels sem declaração compatível.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. Guia de referência eAdvpl. §3.14, p. 16. Cópia pública histórica; autoria e compatibilidade atual não confirmadas. Consulta em 2026-10-24.
  2. TOTVS. Classe TGroup. TOTVSTEC/TDN. Consulta em 2026-10-24.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha