AXVISUAL()

Sintaxe

AxVisual( <cAlias>, <nReg>, <nOpc>, <aAcho>, <nColMens>, <cMensagem>, <cFunc>, <aButtons>, <lMaximized>)

Propósito

Permite, por meio de uma interface, que o usuário visualize as informações de um arquivo de dados, conforme a necessidade da aplicação.

Argumentos

< cAlias >

Arquivo de dados cujas informações serão visualizadas. Esse arquivo está cadastrado no Dicionário de Tabelas do Protheus (SX2).

< nReg >

Número do registro (recno) posicionado no alias ativo e que será visualizado.

< nOpc >

Número da linha do array aRotina que define o tipo de edição (Inclusão, Alteração, Exclusão e Visualização). A função AxVisual() será executada quando o usuário selecionar a opção Visualizar.

< aAcho >

Array com o nome dos campos que serão exibidos na interface (tela). Os campos específicos de usuário sempre serão exibidos se não existir no parâmetro um elemento com a expressão “NOUSER”.

<nColMens >

Parâmetro não utilizado.

< cMensagem >

Parâmetro não utilizado.

< cFunc >

Função que carregará as variáveis que serão utilizadas pelo objeto Enchoice. Neste caso, o parâmetro lVirtual é definido internamente pela função AxFunction() e executada como verdadeira (.T.).

< aButtons >

Botões adicionais que serão adicionados na barra de ferramentas padrão (EnchoiceBar). As informações de cada botão devem ser passadas no seguinte formato:

aArray[n][1]  -->  Imagem do botão

aArray[n][2]  -->  Bloco de código contendo a ação que o botão executará

aArray[n][3]  -->  Título do botão

< lMaximized >

Indica se a janela será maximizada ou não.

Deve-se informar verdadeiro (.T.) para se maximizar a janela ou falso (.F.) para não maximizá-la.

Utilização

Esse componente visual é muito utilizado na interface das aplicações para visualizar as informações incluídas anteriormente.

Observação

Essa função pertence ao framework do ERP Protheus.

Exemplos

AxVisual(cAlias,nReg,nOpc)