Page tree
Skip to end of metadata
Go to start of metadata

Sintaxe Mínima

@ <nRow>,<nCol> SAY <cText>

Sintaxe Completa

@ <nRow>, <nCol> SAY [ <oSay> PROMPT | VAR ] <cText> 
[ PICTURE <cPict> ]
[ OF | WINDOW | DIALOG <oWnd> ]
[ FONT <oFont> ]
[ PIXEL, PIXELS ]
[ COLOR | COLORS <nClrText> [,<nClrBack> ] ]
[ SIZE <nWidth>, <nHeight> ]
[ HTML ]

Include

#include "totvs.ch"

Parâmetros

CláusulaTipoObrigatóriaDescrição
<nRow>NSParâmetro obrigatório, indica a linha da tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
<nCol>NSParâmetro obrigatório, indica a coluna da tela (em pixels ou coordenadas) onde o componente será exibido. Deve ser usada uma expressão numérica, constante ou variável.
SAY 
SCláusula obrigatória, pode ser seguida diretamente da expressão caractere – constante ou variável – que deve ser exibida na tela, ou da cláusula opcional PROMPT ou VAR
<oSay> PROMPT | VAR
NQuando a cláusula PROMPT ou VAR for informada, permite e obriga a especificar um nome de variável AdvPL imediatamente antes da cláusula, no qual o objeto do componente tSAY() será armazenado, seguido da expressão ou variável caractere que será mostrada pelo componente.
<cText> CSExpressão caractere obrigatória, pode ser constante ou variável, indica o conteúdo a ser mostrado no componente. 
PICTURE <cPict>CNCláusula opcional, quando especificada exige que seja informada uma expressão caractere, constante ou variável, que contenha uma máscara de exibição para o conteúdo a ser exibido. Para mais informações sobre como criar uma picture ou máscara de exibição, consulte a documentação sobre pictures de formatação na TDN.
OF | WINDOW | DIALOG <oWnd>ONCláusula opcional, quando informada permite especificar o nome de uma variável AdvPL que contenha o objeto ou componente pai de interface (janela ou diálogo, painel, folder) onde o componente deve ser exibido. Caso seja omitida, o componente será criado na janela ou diálogo ativos no momento. Embora todas as cláusulas sejam suportadas (OF, DIALOG ou WINDOW), por questões de padronização de código, recomendamos o uso da cláusula OF – pois um componente de interface não necessariamente têm seu componente pai definido como uma caixa de diálogo, qualquer outro componente de agrupamento ou container pode ser utilizado – como um tPanel, tFolder, etc.
FONT <oFont>ONCláusula opcional, permite informar um objeto AdvPL do tipo TFont(), para que seja possível mostrar o texto no componente usando uma fonte diferente da fonte default do ambiente. 
PIXEL | PIXELS 

Cláusula opcional, quando uma delas for especificada, indica que o sistema de coordenadas usado nos parâmetros <nRow> e <nCol> são em pixels (ou pontos) a partir da coordenada superior esquerda (0,0) do componente visual pai em uso no qual o objeto será posicionado. 
COLOR | COLORS <nClrText> [ ,<nClrBack]NNCláusulas opcionais, que quando especificadas, permitem alterar a cor do texto da mensagem a ser exibida pelo componente, e opcionalmente também permite alterar a cor de fundo do texto da exibição.
SIZE <nWidth>,<nHeight>NNCláusula opcional, quando utilizada deve ser seguida dos parâmetros numéricos <nWidth> e <nHeight>, que respectivamente indicam o comprimento e a altura do componente na interface.
HTMLLNCláusula opcional, quando usada informa ao componente que o texto a ser exibido deve ser tratado como um conteúdo HTML, que pode conter tags HTML de formatação que devem ser interpretadas, e não mostradas efetivamente como conteúdo do texto

Classe usada pelo comando

O comando @ .. SAY é traduzido em tempo de compilação para utilizar a classe de interface visual do AdvPL TSAY() e seu método construtor NEW().

Referências

Classe TSay - Construtores

Exemplo


Exemplo do comando @ ... SAY
#include 'totvs.ch'

User Function TSay()
Local oDlg, oFont, oSay

DEFINE DIALOG oDlg TITLE "Exemplo TSay" FROM 180,180 TO 550,700 PIXEL

// Cria Fonte para visualização
oFont := TFont():New('Courier new',,-18,.T.)

// Cria o Objeto tSay usando o comando @ .. SAY 
@ 10,10 SAY oSay PROMPT 'Texto para exibição I' SIZE 200,20 COLORS CLR_RED,CLR_WHITE FONT oFont OF oDlg PIXEL 

ACTIVATE DIALOG oDlg CENTERED

Return


Resultado


  • No labels