Sintaxe
@ nLinha, nColuna MSGET VARIAVEL SIZE nLargura,nAltura UNIDADE OF oObjetoRef F3 cF3 VALID validação WHEN condição PICTURE cPicture
Propósito
Permite que o usuário digite informações na tela, conforme a necessidade da aplicação.
Argumentos
< nLinha >
Linha na qual o objeto MSGET aparecerá na janela em que ele será definido.
< nColuna >
Coluna na qual o objeto MSGET aparecerá na janela em que ele será definido.
<VARIAVEL >
Variável que será vinculada ao objeto MSGET, definindo as suas características e armazenando o que conteúdo informado pelo usuário.
< nLargura >
Define a largura do objeto MSGET para a exibição do texto.
< nAltura >
Define a altura do objeto MSGET para a exibição do texto.
< UNIDADE >
Unidade de medida das dimensões da janela. O mais comum é pixels.
< oObjetoRef >
Nome do objeto dialog no qual o MSGET será definido.
< cF3 >
Define a consulta padrão que será vinculada ao campo.
< Validação >
Função de validação do conteúdo informado pelo usuário.
< Condição >
Condição para a edição do campo. Pode ser diretamente um valor lógico (.T. ou .F.), uma variável lógica ou a chamada de uma função que retorne um valor lógico.
Caso o valor lógico seja verdadeiro (.T.), o usuário conseguirá editar o conteúdo do campo, informando-o ou alterando-o. Caso o valor lógico seja falso (.F.), o usuário não conseguirá editar o conteúdo do campo.
< cPicture >
Define a máscara (Picture) de digitação do campo. Essa opção é útil quando é importante formatar a edição da informação. Por exemplo, o CPF e o CNPJ.
Utilização
Esse componente visual é muito utilizado na interface das aplicações para capturar informações digitadas pelo usuário.
Exemplos
@ 010,050 MSGET cCNPJ SIZE 55,11 OF oDlg PIXEL PICTURE “@R 99.999.999/9999-99”;
VALID !Vazio()