MSGET()

Sintaxis

@ nLinha, nColuna MSGET VARIAVEL SIZE nLargura,nAltura UNIDADE OF oObjetoRef F3 cF3 VALID validación WHEN condición PICTURE cPicture

Propósito

Permite que el usuario escriba la información en la pantalla, de acuerdo con la necesidad de la aplicación.

Argumentos

< nLinha >

Línea en la cual el objeto MSGET aparecerá en la ventana en la que se definirá.

< nColuna >

Columna en la cual el objeto MSGET aparecerá en la ventana en la que se definirá.

<VARIABLE >

Variable que se vinculará al objeto MSGET, definiendo sus características y almacenando el contenido informado por el usuario.

< nLargura >

Define el ancho del objeto MSGET para la  exhibición del texto.

< nAltura >

Define la altura del objeto MSGET para la exhibición del texto.

< UNIDAD >

Unidad de medida de las dimensiones de la ventana. Lo más común es pixels.

< oObjetoRef >

Nombre del objeto dialog en el cual se definirá el MSGET.

< cF3 >

Define la consulta estándar que se vinculará al campo.

< Validación >

Función de validación del contenido informado por el usuario.

< Condición >

Condición para la edición del campo. Puede ser directamente un valor lógico (.T. o .F.), una variable lógica o la llamada de una función que devuelva un valor lógico.

Si el valor lógico es verdadero (.T.), el usuario conseguirá editar el contenido del campo, informándolo o modificándolo. En caso de que el valor lógico sea falso (.F.), el usuario no conseguirá editar el contenido del campo.

< cPicture >

Define la máscara (Picture) de digitación del campo. Esta opción es útil cuando es importante formatear la edición de la información. Por ejemplo, el Registro de contribuyente persona física (RCPF) y el Registro de contribuyente persona jurídica (RCPJ).

Utilización

Este componente visual es bastante utilizado en la interfaz de las aplicaciones para capturar información digitada por el usuario.

Ejemplos

@ 010,050 MSGET cCNPJ SIZE 55,11 OF oDlg PIXEL PICTURE “@R 99.999.999/9999-99”;

VALID !Vazio()