INCLUDEUnder review

Dialog.ch

#Include "Dialog.ch"

Declares historical commands for dialogs, control redefinition, resources and help.

IncludesVisual interfaceDialogsHistorical reference

01 · OVERVIEW

Overview

In the analyzed historical package, Dialog.ch declares DEFINE DIALOG, ACTIVATE DIALOG, REDEFINE, SET RESOURCES, SET HELPFILE and SET HELP TOPIC. The supplemental material associated DEFINE MSDIALOG with Dialog.ch, but the supplied inventory places DEFINE MSDIALOG and ACTIVATE MSDIALOG in SigaWin.ch. This illustrates why directives must be checked in the package matching the target release.

02 · SYNTAX

Syntax

#Include "Dialog.ch"

Parameters

Dialog.ch

.ch fileOptional

Provides dialog commands observed in the historical package; confirm the actual dependency in the current package.

Return value

There is no runtime return value; directives are expanded during compilation.

03 · PRACTICAL EXAMPLE

Classic dialog

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

User Function ExDialog()
    Local oDialog
    DEFINE DIALOG oDialog TITLE "Teaching example" ;
        FROM 0, 0 TO 150, 300 PIXEL
    ACTIVATE DIALOG oDialog CENTERED
Return

Expected result

Classic teaching syntax; confirm clauses and dependencies for the target release.

BEST PRACTICES

Distinguish DEFINE DIALOG from DEFINE MSDIALOG.
The preprocessor/compiler interprets directives; VS Code is the editing and integration environment.
Confirm expansions and accepted clauses for the target release.

COMMON PITFALLS

Not every visual command belongs to Dialog.ch.
Check the current file before describing the internal expansion.
A historical include does not guarantee future compatibility.