Usina BRAdvPL Guide
Sign in
← All topics
COMMANDUnder review

@ ... DBBROWSE

@ nRow, nCol DBBROWSE oBrw ALIAS cAlias SIZE nWidth, nHeight OF oDlg

Documents the historical alias-bound grid.

@ ... DBBROWSEAdvPL
01 · OVERVIEW

Overview

The eAdvpl reference guide, §3.19, p. 18, records the historical variant shown in the syntax. Fragments assume the matching environment and command definitions; they are not a complete application. The manual records ALIAS and SIZE for grid creation. This differs from the MBrowse contract using SX3 and aRotina. TCBrowse is another official grid reference and relates to @ ... BROWSE, but does not establish DBBROWSE as a synonym across includes. Alias opening, column setup and window closing are external prerequisites of the fragment. (Refs. 1–2)

02 · SYNTAX

Syntax

@ nRow, nCol DBBROWSE oBrw ALIAS cAlias SIZE nWidth, nHeight OF oDlg

Parameters

nRow, nCol
NumericRequired

Origin position in the units of the selected variant.

oWnd / oDlg
ObjectRequired

Existing parent window; use the identifier from the actual code.

cAlias
CharacterRequired

Alias already opened by the owner of its lifecycle.

Return value

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

03 · PRACTICAL EXAMPLE

Commented example

// Historical fragment: oDlg and SA1 already exist.
Local oBrw
If Select("SA1") > 0
    @ 2, 2 DBBROWSE oBrw ALIAS "SA1" SIZE 60, 10 OF oDlg
EndIf
// Do not close SA1: the caller owns this alias.
Expected result

Demonstrates alias binding without defining columns or edit operations. It is not a complete maintenance routine. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES
  • Verify the macro and coordinate units in the actual include. Enable editing, deletion or action buttons only after validating contracts, locks and permissions.
  • Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

Related content

REFERENCES
  1. Guia de referência eAdvpl. §3.19, p. 18. Cópia pública histórica; autoria e compatibilidade atual não confirmadas. Accessed on 2026-10-24.
  2. TOTVS. Classe TCBrowse. TOTVSTEC/TDN. Accessed on 2026-10-24.
Status
Under review
Page created on
Last reviewed on
Original language
Portuguese
Reviewed by
Usina.BR
0 approved comment(s)

Comments

There are no approved comments yet.

Sign in with Google or Microsoft to comment.

Powered by Usina Docs · Alpha