nRow, nColNuméricoObligatorio
Fila y columna donde se coloca el texto. Con PIXEL, las coordenadas parten de la esquina superior izquierda del componente padre.
COMANDOPublicado
@ ... SAY
@ <nRow>, <nCol> SAY [<oSay> PROMPT | VAR] <cText> [PICTURE <cPict>] [OF <oWnd>] [FONT <oFont>] [COLORS <nClrText>, <nClrBack>] [SIZE <nWidth>, <nHeight>] [HTML] [PIXEL]Crea un componente TSay para mostrar textos, etiquetas y valores con formato en la interfaz.
Descripción general
El comando @ ... SAY muestra una expresión de carácter en un diálogo, panel, folder u otro componente visual. Durante la compilación se traduce al constructor New() de la clase TSay. El texto puede utilizar máscara PICTURE, fuente y colores propios y, al informar HTML, puede interpretar marcas compatibles en lugar de mostrarlas literalmente.
Sintaxis
@ <nRow>, <nCol> SAY [<oSay> PROMPT | VAR] <cText> [PICTURE <cPict>] [OF <oWnd>] [FONT <oFont>] [COLORS <nClrText>, <nClrBack>] [SIZE <nWidth>, <nHeight>] [HTML] [PIXEL]Parámetros
oSay PROMPT / VARObjetoOpcional
Variable que recibe el objeto TSay. Cuando se informa, PROMPT o VAR debe preceder a la expresión mostrada.
cTextCaractereObligatorio
Expresión de carácter constante o variable cuyo contenido se muestra.
PICTURE cPictCaractereOpcional
Máscara utilizada para dar formato al contenido mostrado.
OF oWndObjetoOpcional
Diálogo, panel, folder u otro contenedor propietario del componente. OF es recomendado.
FONT oFontObjetoOpcional
Objeto TFont utilizado para presentar el texto.
COLOR / COLORS nClrText, nClrBackNuméricoOpcional
Color del texto y, opcionalmente, color de fondo.
SIZE nWidth, nHeightNuméricoOpcional
Ancho y alto reservados para el texto.
HTMLCláusulaOpcional
Hace que las marcas HTML compatibles se interpreten en lugar de mostrarse literalmente.
PIXEL / PIXELSCláusulaOpcional
Indica coordenadas en píxeles; se recomienda PIXEL por consistencia.
Etiqueta y valor con formato
#Include "TOTVS.ch"
User Function ExSayValor()
Local oDlg
Local oSayTotal
Local nTotal := 1520.75
Define Dialog oDlg Title "Resumen del pedido" ;
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
ReturnResultado esperado
El primer SAY funciona como etiqueta; el segundo conserva su objeto y muestra el valor con máscara y colores propios.
Texto dentro de un 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
ReturnResultado esperado
OF oPanel convierte SAY en hijo del panel y sus coordenadas pasan a ser relativas a él.
- Incluye TOTVS.ch para que el compilador reconozca el comando.
- Utiliza SAY como etiqueta o para mostrar información que no será editada.
- Utiliza oSay PROMPT cuando necesites modificar propiedades o actualizar el objeto posteriormente.
- Aplica PICTURE cuando la presentación requiera formato, como importes o fechas.
- Dimensiona el componente considerando fuentes, traducciones y textos potencialmente mayores.
- Prefiere OF para identificar explícitamente el contenedor propietario.
- Utiliza HTML solo cuando el formato sea necesario y el entorno sea compatible.
- Cuando se informa un objeto, omitir PROMPT o VAR invalida la declaración.
- Una PICTURE incompatible con el contenido puede mostrarlo incorrectamente.
- Los textos traducidos pueden superar un ancho fijo; reserva espacio o adapta el diseño por idioma.
- El HTML creado con entrada no confiable puede producir formato inesperado; valida y escapa los datos incorporados.
- Sin OF, el componente se asocia a la ventana o diálogo activo.
- Mezclar PIXEL con otra unidad puede causar desalineación.