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

@ ... METER

@ nRow, nCol METER oMtr [FROM nFrom TO nTo] [SIZE nWidth, nHeight] OF oWnd

Representa visualmente o avanço de um processamento.

@ ... METERAdvPL
01 · VISÃO GERAL

Visão geral

O Guia de referência eAdvpl, §3.23–3.24, p. 20, 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. A variante histórica apresenta limites FROM/TO e atualização por SetMeter. A classe TMeter documenta total e métodos Set/SetTotal: são contratos distintos que não devem ser fundidos numa sintaxe inventada. Progresso visual deve corresponder ao trabalho concluído, não apenas ao número de tentativas. O fragmento usa dez etapas sem gravação e não trata cancelamento ou erros de uma tarefa real. (Refs. 1–2)

02 · SINTAXE

Sintaxe

@ nRow, nCol METER oMtr [FROM nFrom TO nTo] [SIZE nWidth, nHeight] OF oWnd

Parâmetros

nRow, nCol
NuméricoObrigatório

Posição de origem na unidade da variante utilizada.

oWnd / oDlg
ObjetoObrigatório

Janela pai existente; o nome deve corresponder ao código real.

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.
Local oMtr
Local nEtapa
@ 2, 2 METER oMtr FROM 0 TO 10 SIZE 30, 1 OF oDlg
For nEtapa := 1 To 10
    // Uma etapa didatica; substituir por trabalho efetivamente concluido.
    SetMeter(oMtr, nEtapa)
Next
Resultado esperado

Propõe avanço de 0 a 10. O laço rápido pode mostrar apenas o estado final; não comprova responsividade. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Prever total zero e falhas parciais. Não inserir Sleep apenas para simular trabalho; separar atualização visual de confirmação transacional.
  • 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.23–3.24, p. 20. Cópia pública histórica; autoria e compatibilidade atual não confirmadas. Consulta em 2026-10-24.
  2. TOTVS. Classe TMeter. 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