Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

MsgStatus / ClearStatus

MsgStatus(cExpressao); ClearStatus()

Mostra e limpa texto de status na API histórica.

MsgStatus / ClearStatusAdvPL
01 · VISÃO GERAL

Visão geral

MsgStatus recebe o texto de status e ClearStatus limpa a indicação. O guia eADVPL descreve apresentação sem esperar uma resposta do usuário. Isso não é confirmação nem prova de execução em background. A referência é histórica: disponibilidade e apresentação dependem do cliente utilizado. O fragmento prepara dois blocos sem exigir uma janela ativa durante a demonstração. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsgStatus(cExpressao); ClearStatus()

Parâmetros

cExpressao
CaractereObrigatório

Texto exibido por MsgStatus.

Retorno

O guia não especifica valor útil de retorno; ClearStatus não recebe parâmetros.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed544()
    // O chamador deve combinar exibicao e limpeza tambem em erros.
    Local bMostrar := {|cTexto| MsgStatus(cTexto)}
    Local bLimpar := {|| ClearStatus()}
    ConOut(ValType(bMostrar)+ValType(bLimpar))
Return Nil
Resultado esperado

Imprime BB. Os blocos não invocados não mudam o status. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Limpar o status ao concluir ou falhar. Em jobs sem interface, registrar progresso em logs apropriados. Não esconder um erro substituindo-o por texto de status.
  • 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 (histórico). §6.3–6.4. Consulta em 2026-10-27.
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