nRow, nColNuméricoObrigatório
Linha e coluna em que o campo será posicionado. Com PIXEL, as coordenadas partem do canto superior esquerdo do componente pai.
COMANDOPublicado
@ ... GET
@ <nRow>, <nCol> GET [<oGet> VAR] <uVar> [OF <oWnd>] [PICTURE <cPict>] [VALID <cbValid>] [WHEN <cbWhen>] [READONLY] [PASSWORD]Cria um campo TGet para editar valores caractere, numéricos ou de data em uma interface AdvPL.
Visão geral
O comando @ ... GET cria um controle de entrada ligado a uma variável AdvPL dos tipos caractere, numérico ou data. Durante a compilação, ele é convertido no construtor New() da classe TGet. A entrada pode receber máscara PICTURE, validação na saída, condição de habilitação e eventos de alteração, além dos modos somente leitura e senha.
Sintaxe
@ <nRow>, <nCol> GET [<oGet> VAR] <uVar> [OF <oWnd>] [PICTURE <cPict>] [VALID <cbValid>] [WHEN <cbWhen>] [READONLY] [PASSWORD]Parâmetros
oGet VARObjetoOpcional
Variável que receberá o objeto TGet. Quando o objeto é informado, VAR deve anteceder a variável editada.
uVarCaractere, numérico ou dataObrigatório
Variável cujo conteúdo será apresentado e editado pelo campo.
OF oWndObjetoOpcional
Diálogo, painel, folder ou outro contêiner proprietário do GET. OF é a forma recomendada.
PICTURE cPictCaractereOpcional
Máscara que controla a formatação e a edição do valor.
VALID cbValidLógicoOpcional
Validação executada na perda do foco; deve retornar .T. para permitir a saída.
WHEN cbWhenLógicoOpcional
Condição executada durante a troca de foco para determinar se o campo pode receber foco.
ON CHANGE cbChangeEventoOpcional
Ação executada quando o conteúdo editável é alterado.
READONLYCláusulaOpcional
Permite foco, seleção e cópia, mas impede a edição do conteúdo.
PASSWORDCláusulaOpcional
Oculta visualmente os caracteres digitados com asteriscos.
SIZE · FONT · COLOR · PIXELCláusulasOpcional
Personalizam dimensões, fonte, cores e sistema de coordenadas.
Entrada com máscara e validação
#Include "TOTVS.ch"
User Function ExGetCliente()
Local oDlg
Local oGetCodigo
Local cCodigo := Space(6)
Define Dialog oDlg Title "Identificação do cliente" ;
From 100, 100 To 260, 520 Pixel
@ 18, 20 Say "Código:" Of oDlg Pixel
@ 16, 65 Get oGetCodigo Var cCodigo ;
Picture "@!" Size 90, 12 Of oDlg Pixel ;
Valid !Empty(AllTrim(cCodigo))
Activate Dialog oDlg Centered
ReturnResultado esperado
PICTURE transforma a entrada conforme a máscara e VALID impede a saída enquanto o código estiver vazio.
Campo de senha e campo somente leitura
#Include "TOTVS.ch"
User Function ExGetAcesso()
Local oDlg
Local cUsuario := "OPERADOR"
Local cSenha := Space(20)
Define Dialog oDlg Title "Acesso" ;
From 0, 0 To 220, 480 Pixel
@ 15, 20 Say "Usuário:" Of oDlg Pixel
@ 13, 70 Get cUsuario Size 100, 12 ;
Of oDlg Pixel ReadOnly
@ 45, 20 Say "Senha:" Of oDlg Pixel
@ 43, 70 Get cSenha Size 100, 12 ;
Of oDlg Pixel Password ;
Valid !Empty(AllTrim(cSenha))
Activate Dialog oDlg Centered
ReturnResultado esperado
READONLY permite consultar e copiar o usuário sem alterá-lo; PASSWORD mascara visualmente a senha durante a edição.
- Inclua TOTVS.ch para disponibilizar o comando ao compilador.
- Inicialize uVar com o tipo correto antes de criar o componente.
- Use PICTURE compatível com o tipo e o formato esperado para o dado.
- Use VALID para validar a saída, WHEN para controlar a entrada e ON CHANGE para reagir durante a edição.
- Use oGet VAR apenas quando precisar acessar propriedades ou métodos do objeto depois da criação.
- Prefira PIXEL, embora a documentação registre que GET também aceita PIXELS.
- Prefira OF para explicitar o contêiner proprietário.
- Quando o objeto é informado, esquecer VAR torna a declaração inválida.
- VALID e WHEN precisam retornar valores lógicos.
- Uma PICTURE incompatível com o tipo da variável pode restringir ou apresentar o valor incorretamente.
- PASSWORD apenas mascara a exibição; não substitui armazenamento seguro, criptografia nem controles de acesso.
- ON CHANGE pode ser chamado muitas vezes durante a digitação; mantenha a ação leve.
- Sem OF, o campo será associado à janela ou ao diálogo ativo.