COMMANDUnder review

ADD COLUMN TO BROWSE

ADD COLUMN <oCol> TO BROWSE <oBrw> ARRAY ELEMENT <elm> [HEADER <cHead>] [WIDTH <nWidth>]

Defines a browse column bound to an array element.

ADD COLUMN TO BROWSEAdvPL

01 · OVERVIEW

Overview

Historical eAdvpl reference, §3.17, p. 17. Syntax depends on that environment’s definitions; it does not establish compatibility with every current Protheus include. ARRAY ELEMENT identifies the cell position in a data row. The array, browse and their binding must exist before the column. The example displays a text column without enabling editing. A display mask does not modify stored values. (Guia de referência eAdvpl, s.d., ref. 1)

02 · SYNTAX

Syntax

ADD COLUMN <oCol> TO BROWSE <oBrw> ARRAY ELEMENT <elm> [HEADER <cHead>] [WIDTH <nWidth>]

Parameters

oCol

ObjectRequired

Variable receiving the column.

oBrw

ObjectRequired

Existing bound browse.

elm

NumericRequired

Element position in each row.

cHead

CharacterOptional

Column title.

nWidth

NumericOptional

Width in the variant units.

Return value

No business return value is documented for this interface operation.

03 · PRACTICAL EXAMPLE

Commented example

// Historical fragment: oBrw is already bound to {{"A"},{"B"}}.
Local oCol
ADD COLUMN oCol TO BROWSE oBrw ARRAY ELEMENT 1 ;
    HEADER "Code" WIDTH 12
// No EDITABLE: no write behavior is assumed.

Expected result

Proposes displaying the first element of each row; browse construction is not included. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES

Check every row shape before binding the column. Editing needs validation and persistence beyond presentation.
Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.