nRow, nColNuméricoRequired
Row and column where the text is placed. With PIXEL, coordinates start at the upper-left corner of the parent.
COMMANDPublished
@ ... SAY
@ <nRow>, <nCol> SAY [<oSay> PROMPT | VAR] <cText> [PICTURE <cPict>] [OF <oWnd>] [FONT <oFont>] [COLORS <nClrText>, <nClrBack>] [SIZE <nWidth>, <nHeight>] [HTML] [PIXEL]Creates a TSay component for displaying text, labels and formatted values in the interface.
Overview
The @ ... SAY command displays a character expression in a dialog, panel, folder or other visual component. During compilation it is translated into the TSay class New() constructor. Text may use a PICTURE mask, custom font and colors and, when HTML is supplied, supported markup may be interpreted instead of displayed literally.
Syntax
@ <nRow>, <nCol> SAY [<oSay> PROMPT | VAR] <cText> [PICTURE <cPict>] [OF <oWnd>] [FONT <oFont>] [COLORS <nClrText>, <nClrBack>] [SIZE <nWidth>, <nHeight>] [HTML] [PIXEL]Parameters
oSay PROMPT / VARObjetoOptional
Variable receiving the TSay object. When supplied, PROMPT or VAR must precede the displayed expression.
cTextCaractereRequired
Constant or variable character expression whose content is displayed.
PICTURE cPictCaractereOptional
Mask used to format the displayed content.
OF oWndObjetoOptional
Dialog, panel, folder or other container that owns the component. OF is recommended.
FONT oFontObjetoOptional
TFont object used to display the text.
COLOR / COLORS nClrText, nClrBackNuméricoOptional
Text color and, optionally, background color.
SIZE nWidth, nHeightNuméricoOptional
Width and height reserved for the text.
HTMLCláusulaOptional
Causes supported HTML markup to be interpreted instead of shown literally.
PIXEL / PIXELSCláusulaOptional
Indicates pixel coordinates; prefer PIXEL for consistency.
Label and formatted value
#Include "TOTVS.ch"
User Function ExSayValue()
Local oDlg
Local oSayTotal
Local nTotal := 1520.75
Define Dialog oDlg Title "Order summary" ;
From 100, 100 To 240, 520 Pixel
@ 20, 20 Say "Total:" Size 45, 12 Of oDlg Pixel
@ 20, 70 Say oSayTotal Prompt nTotal ;
Picture "@E 999,999.99" Size 100, 12 ;
Colors CLR_BLUE, CLR_WHITE Of oDlg Pixel
Activate Dialog oDlg Centered
ReturnExpected result
The first SAY is a label; the second retains its object and displays a masked value with custom colors.
Text inside a panel
#Include "TOTVS.ch"
User Function ExSayPanel()
Local oDlg
Local oPanel
Local oFonte
Define Dialog oDlg Title "Situação" ;
From 0, 0 To 200, 460 Pixel
oFonte := TFont():New("Arial",, -16, .T.)
@ 10, 15 MsPanel oPanel Prompt "Processamento" ;
Size 190, 55 Of oDlg Raised
@ 18, 15 Say "Processamento concluído" ;
Size 150, 14 Font oFonte ;
Colors CLR_GREEN, CLR_WHITE Of oPanel Pixel
Activate Dialog oDlg Centered
ReturnExpected result
OF oPanel makes SAY a child of the panel and its coordinates become relative to it.
- Include TOTVS.ch to make the command available to the compiler.
- Use SAY as a field label or to display non-editable information.
- Use oSay PROMPT when properties or the object must be updated later.
- Apply PICTURE for formatted display such as currency or dates.
- Size the component for fonts, translations and potentially longer text.
- Prefer OF to explicitly identify the owner container.
- Use HTML only when formatting is necessary and the environment is compatible.
- When an object is supplied, omitting PROMPT or VAR makes the declaration invalid.
- A PICTURE incompatible with the content may display it incorrectly.
- Translated text may exceed a fixed width; reserve space or adapt layout by language.
- HTML built from untrusted input may produce unexpected formatting; validate and escape embedded data.
- Without OF, the component is bound to the active window or dialog.
- Mixing PIXEL with another unit may cause misalignment.