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

Dialog.ch

#Include "Dialog.ch"

Declara comandos históricos para criar e ativar diálogos, redefinir controles e configurar recursos e ajuda.

IncludesInterface visualDiálogosReferência histórica
01 · VISÃO GERAL

Visão geral

No pacote histórico analisado, Dialog.ch declara DEFINE DIALOG, ACTIVATE DIALOG, REDEFINE, SET RESOURCES, SET HELPFILE e SET HELP TOPIC. O material complementar associava DEFINE MSDIALOG diretamente a Dialog.ch, mas o inventário fornecido localizou DEFINE MSDIALOG e ACTIVATE MSDIALOG em SigaWin.ch. Essa diferença mostra por que o comando deve ser pesquisado no pacote correspondente ao release, em vez de ser atribuído a uma include por aproximação.

02 · SINTAXE

Sintaxe

#Include "Dialog.ch"

Parâmetros

Dialog.ch
Arquivo .chOpcional

Disponibiliza comandos de diálogo observados no pacote histórico. A dependência efetiva deve ser confirmada no pacote atual.

Retorno

Não há retorno em execução; as diretivas são expandidas durante a compilação.

03 · EXEMPLO PRÁTICO

Diálogo clássico

#Include "Protheus.ch"
#Include "Dialog.ch"

User Function ExDialogo()
    Local oDialogo

    DEFINE DIALOG oDialogo TITLE "Exemplo didático" ;
        FROM 0, 0 TO 150, 300 PIXEL
    ACTIVATE DIALOG oDialogo CENTERED
Return
Resultado esperado

Exemplo didático da sintaxe clássica. Confirme opções, classe resultante e include necessária no release utilizado.

BOAS PRÁTICAS
  • Diferencie DEFINE DIALOG de DEFINE MSDIALOG ao pesquisar a origem da diretiva.
  • O pré-processador/compilador interpreta os comandos; o editor VS Code apenas oferece o ambiente de edição e integração.
  • Confirme a expansão e as opções aceitas na include do release utilizado.
ARMADILHAS COMUNS
  • Não presuma que todo comando visual pertence a Dialog.ch.
  • A implementação interna pode envolver classes, mas a expansão exata deve ser verificada no arquivo atual.
  • Uma include histórica não garante compatibilidade futura automática.

Conteúdos relacionados

REFERÊNCIAS
  1. GOOGLE. Dicionário de Comandos, Constantes Comuns e Exemplos Práticos testados. Material gerado em 8 ago. 2026, fornecido pelo editor do AdvPL Guia; conteúdo tecnicamente revisado e adaptado antes da publicação.
  2. MICROSIGA SOFTWARE S.A. Dialog.ch e SigaWin.ch. Arquivos do pacote histórico include_001.zip, fornecido ao projeto em 8 ago. 2026.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR