nRow, nColNuméricoObligatorio
Fila y columna donde se coloca el campo. Con PIXEL, las coordenadas parten de la esquina superior izquierda del componente padre.
COMANDOPublicado
@ ... GET
@ <nRow>, <nCol> GET [<oGet> VAR] <uVar> [OF <oWnd>] [PICTURE <cPict>] [VALID <cbValid>] [WHEN <cbWhen>] [READONLY] [PASSWORD]Crea un campo TGet para editar valores de carácter, numéricos o de fecha en una interfaz AdvPL.
Descripción general
El comando @ ... GET crea un control de entrada vinculado a una variable AdvPL de carácter, numérica o de fecha. Durante la compilación se traduce al constructor New() de la clase TGet. La entrada puede utilizar máscara PICTURE, validación de salida, condición de habilitación y eventos de cambio, además de los modos de solo lectura y contraseña.
Sintaxis
@ <nRow>, <nCol> GET [<oGet> VAR] <uVar> [OF <oWnd>] [PICTURE <cPict>] [VALID <cbValid>] [WHEN <cbWhen>] [READONLY] [PASSWORD]Parámetros
oGet VARObjetoOpcional
Variable que recibe el objeto TGet. Cuando se informa, VAR debe preceder a la variable editada.
uVarCaractere, numérico ou dataObligatorio
Variable de carácter, numérica o de fecha cuyo valor se muestra y edita.
OF oWndObjetoOpcional
Diálogo, panel, folder u otro contenedor propietario del GET. OF es recomendado.
PICTURE cPictCaractereOpcional
Máscara que controla el formato y la edición del valor.
VALID cbValidLógicoOpcional
Validación ejecutada al perder el foco; debe devolver .T. para permitir la salida.
WHEN cbWhenLógicoOpcional
Condición evaluada durante el cambio de foco para determinar si el campo puede recibirlo.
ON CHANGE cbChangeEventoOpcional
Acción ejecutada cuando cambia el contenido editable.
READONLYCláusulaOpcional
Permite foco, selección y copia, pero impide la edición.
PASSWORDCláusulaOpcional
Oculta visualmente los caracteres escritos con asteriscos.
SIZE · FONT · COLOR · PIXELCláusulasOpcional
Personalizan dimensiones, fuente, colores y sistema de coordenadas.
Entrada con máscara y validación
#Include "TOTVS.ch"
User Function ExGetCliente()
Local oDlg
Local oGetCodigo
Local cCodigo := Space(6)
Define Dialog oDlg Title "Identificación del 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 la entrada según la máscara y VALID impide la salida mientras el código esté vacío.
Campos de contraseña y solo lectura
#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 y copiar el usuario sin modificarlo; PASSWORD oculta visualmente la contraseña durante la edición.
- Incluye TOTVS.ch para que el compilador reconozca el comando.
- Inicializa uVar con el tipo correcto antes de crear el componente.
- Utiliza una PICTURE compatible con el tipo y el formato esperado.
- Utiliza VALID para validar la salida, WHEN para controlar la entrada y ON CHANGE para reaccionar durante la edición.
- Utiliza oGet VAR solo cuando necesites propiedades o métodos después de la creación.
- Prefiere PIXEL, aunque GET también acepta PIXELS según la documentación.
- Prefiere OF para identificar explícitamente el contenedor propietario.
- Cuando se informa un objeto, omitir VAR invalida la declaración.
- VALID y WHEN deben devolver valores lógicos.
- Una PICTURE incompatible con el tipo puede restringir o mostrar el valor incorrectamente.
- PASSWORD solo oculta la visualización; no sustituye almacenamiento seguro, cifrado ni controles de acceso.
- ON CHANGE puede ejecutarse muchas veces durante la escritura; mantén la acción ligera.
- Sin OF, el campo se asocia a la ventana o diálogo activo.