MSGET()

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()