Usina BRAdvPL Guide
Sign in
← All topics
FUNCTIONUnder review

X3Picture

X3Picture(cField) -> cPicture

Gets an SX3 field’s display picture.

X3PictureAdvPL
01 · OVERVIEW

Overview

Unlike parameterless X3Titulo/X3Descric, X3Picture receives the technical field name. A picture controls presentation, not physical length or content validation. The community sample uses D2_QUANT; this uninvoked block preserves that lookup without assuming universal decimals/picture. (Sources: refs. 1–2.)

02 · SYNTAX

Syntax

X3Picture(cField) -> cPicture

Parameters

cField
CharacterRequired

Technical field name.

Return value

Character in the historical reference.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed723()
    // Depends on environment dictionary; block not invoked.
    Local bPicture := {|| X3Picture("D2_QUANT")}
    ConOut(ValType(bPicture))
Return Nil
Expected result

Creates block B without querying the field. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES
  • Verify field existence and picture behavior in the intended output.
  • Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

Related content

REFERENCES
  1. Waterloo Ferreira da Silva. AdvPL — O Manual, p. 386. Referência histórica. Accessed on 2026-10-28.
  2. Universo do Desenvolvedor. eurairapelli/universo_do_desenvolvedor_site. ADVPL/Funcoes/Arquivos SXs/X3Picture.PRW. Arquivo completo analisado; adaptação. Accessed on 2026-10-28.
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