Pular para o conteúdo
Início » Advpl VTGet

Advpl VTGet

    Tipo: TELNET VT100
    Cria um novo objeto VTGET e o coloca em exibição na tela
    Sintaxe
    @ <nLin>, <nCol>
    [VTSAY <exp>
    [PICTURE <cSayPicture>]]
    VTGET <idVar>
    [PICTURE <cGetPicture>]
    [WHEN <lPreCondicao>]
    [VALID <lPosCondicao>]
    [PASSWORD]
    [F3<tabela>]
    Parâmetros
    <nLin> e <nCol> São as coordenadas de linha e coluna para a operação. Se a clausula VTSAY está  presente,
    especificam as coordenadas para o VTSAY, e o VTGET ‚ exibido a direita deste.
    VTSAY exibe o valor de <exp> nas coordenadas especificadas. Caso a PICTURE <cSayPicture> seja especificada.
    VTGET <idVar> define o nome da variável de qualquer tipo de dados a ser editada. Ela pode ser caractere, data ou
    numérica .
    PICTURE <cGetPicture> especifica uma mascara para exibição e as regras para edição do VTGET.
    WHEN <lPreCondicao> especifica uma expressão que deve ser satisfeita antes do cursor entrar na região de edição
    de VTGET. Se <lCondicao> ‚ avaliada como verdadeira (.T.), ‚ permitido ao cursor entrar; de outra forma, o VTGET
    corrente ‚ saltado e o cursor move-se para o próximo VTGET.
    VALID <lPosCondicao> especifica uma expressão que deve ser satisfeita antes que o cursor possa deixar a região
    de edição do VTGET corrente. O VALID<lPosCondicao> ‚ avaliado sempre que o usuário tenta deixar a região de
    edição do VTGET, a menos que a tecla Esc seja pressionada . Se <lPosCondicao> retorna falso (.F.), o controle
    retorna ao VTGET e o usuário não pode deixa -lo até que <lPosCondicao> retorne verdadeiro (.T.) ou o usuário aperte
    Esc. Um VALID <lPosCondicao> pode conter ou ser uma função definida pelo usuário, permitindo-lhe executar
    buscas e outros tipos de operações de validação.
    PASSWORD Monta o VTGET para entrada de dados com * na tela, utilizado para SENHAS
    F3 Associa este VTGET a uma tabela do SXB ou Sx5.
    Descrição
    Quando um comando VTREAD ‚ especificado, um VTGET executa uma edição do conteúdo de <idVar> de qualquer
    tipo de dado. Quando um objeto VTGET ‚ criado, o nome e valor corrente de <idVar> são guardados no objeto VTGET.
    O valor de <idVar> fica armazenado no que‚ chamado de buffer do VTGET. O buffer de VTGET ‚ o que ‚ realmente
    mostrado na tela e editado.
    Exemplo
    #include ‘apvt100.ch’
    nNumber = 0
    @ 0, 0 VTSAY "Digite um numero”;
    VTGET nNumber;
    VALID nNumber > 0