nRow, nColNuméricoObrigatório
Linha e coluna em que a área de texto será posicionada. Com PIXEL, as coordenadas partem do canto superior esquerdo do componente pai.
COMANDOPublicado
@ ... GET MULTILINE
@ <nRow>, <nCol> GET [<oMultiGet> VAR] <uVar> MULTILINE [OF <oWnd>] [SIZE <nWidth>, <nHeight>] [WHEN <cbWhen>] [VALID <cbValid>] [READONLY] [NOBORDER] [NO VSCROLL]Cria um campo TMultiGet para edição ou apresentação de textos com várias linhas.
Visão geral
O comando @ ... GET MULTILINE cria uma área de texto ligada a uma variável caractere. Durante a compilação, ele é convertido no construtor New() da classe TMultiGet. Por padrão, o componente permite rolagem vertical quando o conteúdo ultrapassa sua altura; também pode ser configurado como somente leitura, sem borda ou sem rolagem vertical.
Sintaxe
@ <nRow>, <nCol> GET [<oMultiGet> VAR] <uVar> MULTILINE [OF <oWnd>] [SIZE <nWidth>, <nHeight>] [WHEN <cbWhen>] [VALID <cbValid>] [READONLY] [NOBORDER] [NO VSCROLL]Parâmetros
oMultiGet VARObjetoOpcional
Variável que receberá o objeto TMultiGet. Quando o objeto é informado, VAR deve anteceder a variável editada.
uVarCaractereObrigatório
Variável caractere cujo texto será apresentado e editado.
MULTILINECláusulaObrigatório
Seleciona o controle multilinha. TEXT e MEMO também são aceitos, mas MULTILINE é a forma recomendada.
OF oWndObjetoOpcional
Diálogo, painel, folder ou outro contêiner proprietário. OF é a forma recomendada.
SIZE nWidth, nHeightNuméricoOpcional
Largura e altura da área de texto.
WHEN cbWhenLógicoOpcional
Condição que determina se o componente pode receber foco.
VALID cbValidLógicoOpcional
Validação executada na perda do foco; deve retornar .T. para permitir a saída.
READONLYCláusulaOpcional
Permite seleção e cópia, mas impede alterações no texto.
NOBORDER / NO BORDERCláusulaOpcional
Cria o componente sem a borda visual padrão.
NO VSCROLLCláusulaOpcional
Desabilita a rolagem vertical, mesmo quando existem mais linhas do que a área pode mostrar.
COLOR · SIZE · FONT · PIXELCláusulasOpcional
Personalizam cores, dimensões, fonte e sistema de coordenadas.
Edição de observações em várias linhas
#Include "TOTVS.ch"
User Function ExGetMultiline()
Local oDlg
Local oObservacao
Local cObservacao := ""
Define Dialog oDlg Title "Observações do pedido" ;
From 100, 100 To 380, 620 Pixel
@ 15, 20 Get oObservacao Var cObservacao ;
Multiline Size 250, 90 Of oDlg Pixel ;
Valid Len(AllTrim(cObservacao)) <= 500
Activate Dialog oDlg Centered
ReturnResultado esperado
O usuário pode inserir quebras de linha. VALID limita o conteúdo a 500 caracteres antes de permitir a saída.
Texto informativo somente para leitura
#Include "TOTVS.ch"
User Function ExTextoLeitura()
Local oDlg
Local cTexto := "Orientações:" + CRLF + ;
"1. Confira os dados." + CRLF + ;
"2. Confirme o processamento."
Define Dialog oDlg Title "Orientações" ;
From 0, 0 To 260, 520 Pixel
@ 15, 20 Get cTexto Multiline ReadOnly ;
Size 220, 75 Of oDlg Pixel NOBORDER
Activate Dialog oDlg Centered
ReturnResultado esperado
READONLY preserva seleção e cópia; NOBORDER deixa a apresentação mais discreta.
- Inclua TOTVS.ch para disponibilizar o comando ao compilador.
- A variável editada deve ser caractere; use GET comum para valores numéricos ou datas.
- Prefira a palavra MULTILINE às alternativas TEXT e MEMO para padronização.
- A barra de rolagem vertical aparece automaticamente quando necessária.
- Use READONLY para apresentar textos longos que podem ser selecionados e copiados.
- Prefira OF para explicitar o contêiner proprietário.
- A documentação oficial alerta que o suporte a COLOR/COLORS foi acrescentado posteriormente; confirme a versão do AppServer e SmartClient em ambientes antigos.
- Sem MULTILINE, TEXT ou MEMO, o pré-compilador pode gerar um TGet de linha única.
- Quando o objeto é informado, esquecer VAR torna a declaração inválida.
- NO VSCROLL pode ocultar parte do conteúdo quando ele ultrapassa a altura disponível.
- VALID e WHEN precisam retornar valores lógicos.
- Sem OF, o componente será associado à janela ou ao diálogo ativo.
- Textos muito grandes podem exigir limites, persistência e tratamento específicos da aplicação.