COMMANDUnder review

ADD FOLDER

ADD FOLDER <oFld> CAPTION <cCaption> [ON ACTIVATE <uAction>] OF <oWnd>

Adds a grouping page to the historical interface.

ADD FOLDERAdvPL

01 · OVERVIEW

Overview

Historical eAdvpl reference, §3.6–3.7, p. 12. Syntax depends on that environment’s definitions; it does not establish compatibility with every current Protheus include. The folder belongs to the OF window and CAPTION identifies it visually. ON ACTIVATE, when used, runs an action upon page activation. This example performs no data loading through events: changing pages must not duplicate writes. Do not assume the macro matches TFolder constructors in other includes. (Guia de referência eAdvpl, s.d., ref. 1)

02 · SYNTAX

Syntax

ADD FOLDER <oFld> CAPTION <cCaption> [ON ACTIVATE <uAction>] OF <oWnd>

Parameters

oFld

ObjectRequired

Created page object.

cCaption

CharacterRequired

Visible caption.

oWnd

ObjectRequired

Existing parent window.

uAction

AnyOptional

Activation action under the historical macro.

Return value

No business return value is documented for this interface operation.

03 · PRACTICAL EXAMPLE

Commented example

// Historical fragment: oDlg already exists.
Local oFld
ADD FOLDER oFld CAPTION "General data" OF oDlg
// Create page controls in their appropriate context.

Expected result

Proposes a captioned page without fields or persistence. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Maintain page state and avoid callbacks referencing destroyed controls.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.