Home

Linha Microsiga Protheus

Árvore de páginas
Ir para o final dos metadados
Ir para o início dos metadados

Função: Enchoice


Versões:Protheus 10
Compatível Países:Todos
Sistemas Operacionais:Todos
Compatível às Bases de Dados:Todos
Nível de Acesso:Nível 1 (Acesso Clientes)
Idiomas:Espanhol , Inglês


Descrição:

Cria um objeto visual para edição de campos baseado no Dicionário de Campos (SX3).

Programa Fonte:
MSMGETPR.PRW
Sintaxe:

Enchoice ( cAlias [ nReg ]nOpc [ aCRA ] [ cLetras ] [ cTexto ] [ aAcho ] [ aPos ] [ aCpos ] [ nModelo ] [ nColMens ] [ cMensagem ] [ cTudoOk ] [ oWnd ] [ lF3 ] [ lMemoria ] [ lColumn ] [ caTela ] [ lNoFolder ] [ lProperty ] [ aField ] [ aFolder ] [ lCreate ] [ lNoMDIStrech ] [ cTela ] )

Retorno:
    ()
Observações

As informações contidas no SX3 definirão se o campo deverá ser exibido, editado e qual tipo de objeto será utilizado (Get, Combo, Memo, CheckBox).

Não é necessário declarar as variáveis aTela e aGets pois a Enchoice faz o controle dos objetos pelas suas propriedades com os mesmos nomes.

A Enchoice utilizará a variável 'private' aRotica caso esta esteja declarada. Senão, utilizará sua propriedade com o mesmo, nome com seguinte formato:

  • 1ª linha: Pesquisar
  • 2ª linha: Visualizar
  • 3ª linha: Incluir
  • 4ª linha: Alterar
  • 5ª linha: Excluir


Através do parâmetro MC_ENCHOLD é possível definir o tipo de visualização da Enchoice no padrão das versões anteriores à P11 (1=Sim, 2=Não).



Parâmetros:



Nome

Tipo

Descrição

Default

Obrigatório

Referência

cAlias

Caracter

Tabela cadastrada no Dicionário de Tabelas (SX2) que será editada




X




nReg

Nulo

Parâmetro não utilizado










nOpc

Numérico

Número da linha do aRotina que definirá o tipo de edição (Inclusão, Alteração, Exclusão, Visualização)




X




aCRA

Nulo

Parâmetro não utilizado










cLetras

Nulo

Parâmetro não utilizado










cTexto

Nulo

Parâmetro não utilizado










aAcho

Vetor

Vetor com nome dos campos que serão exibidos. Os campos de usuário sempre serão exibidos se não existir no parametro um elemento com a expressão "NOUSER"










aPos

Vetor

Vetor com coordenadas para criação da enchoice no formato {, , , }










aCpos

Vetor

Vetor com nome dos campos que poderão ser editados










nModelo

Numérico

Se for diferente de 1 desabilita execução de gatilhos estrangeiros










nColMens

Nulo

Parâmetro não utilizado










cMensagem

Nulo

Parâmetro não utilizado










cTudoOk

Nulo

Parâmetro não utilizado










oWnd

Objeto

Objeto (janela, painel, etc) onde a enchoice será criada










lF3

Lógico

Indica se a enchoice esta sendo criada em uma consulta F3 para utilizar variáveis de memória










lMemoria

Lógico

Indica se a enchoice utilizará variáveis de memória ou os campos da tabela na edição










lColumn

Lógico

Indica se a apresentação dos campos será em forma de coluna










caTela

Caracter

Nome da variável tipo "private" que a enchoice utilizará no lugar da variável aTela










lNoFolder

Lógico

Indica se a enchoice não irá utilizar as Pastas de Cadastro (SXA)










lProperty

Lógico

Indica se a enchoice não utilizará as variáveis tipo "private" aTela e aGets, somente suas propriedades com seus respectivos nomes










aField

Vetor

Vetor com os campos que serão mostrados na Enchoice caso o SX3 não seja utilizado










aFolder

Vetor

Vetor com o nome das pastas caso o SX3 não seja utilizado










lCreate

Lógico

Indica se cria as pastas especificadas no parâmetro aFolder










lNoMDIStrech

Lógico

Define se o objeto não será alinhado conforme o espaço existente na janela

.F.







cTela

Caracter

Campo reservado











  • Sem rótulos