@ ... SAY

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 ] 

Cláusulas e Parâmetros

<nRow> → Parâ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> → Parâ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 → Clá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

PROMPT ou VAR --> Quando uma delas 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> → Expressão caractere obrigatória, pode ser constante ou variável, indica o conteúdo a ser mostrado no componente. 

PICTURE <cPict> → Clá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> → Cláusula opcional, quando informada permite especificar o nome de uma variável AdvPL que contenha o objeto de interface da janela ou diálogo onde o componente deve ser exibido. Caso seja omitida, o componente será criado na janela ou diálogo ativos no momento. 

FONT <oFont> → Clá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áusulas opcionais, 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] → Clá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> → Clá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.

HTML → Clá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 de Interface 

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