| 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 |
Cria um objeto visual para edição de campos baseado no Dicionário de Campos (SX3).
MSMGETPR.PRW
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 ] )
- ()
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).
| 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 |