COMMANDUnder review

@ ... TO

@ nTop, nLeft TO nBottom, nRight [oBox] [CAPTION cCaption] OF oWnd

Draws a frame using start and end coordinates.

@ ... TOAdvPL

01 · OVERVIEW

Overview

The eAdvpl reference guide, §3.14, p. 16, records the historical variant shown in the syntax. Fragments assume the matching environment and command definitions; they are not a complete application. Here TO separates the initial and final corners; the last two numbers are not width and height. The frame visually groups controls without creating validation or an access boundary. TGroup documents another visual-grouping approach with its own constructor; do not assume every @ ... TO macro expands into that class. (Refs. 1–2)

02 · SYNTAX

Syntax

@ nTop, nLeft TO nBottom, nRight [oBox] [CAPTION cCaption] OF oWnd

Parameters

nTop, nLeft, nBottom, nRight

NumericRequired

Start and end corners in environment units.

oWnd

ObjectRequired

Existing window containing the frame.

Return value

Interface/printing command; do not use as a function-return expression.

03 · PRACTICAL EXAMPLE

Commented example

// Historical fragment; oDlg already exists.
@ 1, 1 TO 8, 50 CAPTION "Inquiry data" OF oDlg
// 8 and 50 are final coordinates, not height and width.

Expected result

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

BEST PRACTICES

Keep controls within bounds and check display scaling. Do not mix character and pixel coordinates without compatible declarations.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.