| 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: | Português, Inglês, Espanhol |
| Versão | P12 |
Descrição
Classe utilizada para executar a view em uma janela.
A classe se responsabiliza por criar a janela, ativar o View, o desenvolvedor
precisa somente configurar o objeto, passando ou o objeto de View que deseja usar
ou o nome do fonte de onde a View deve ser carregada.
Exemplo
oExecView := FWViewExec():New()
oExecView:setTitle("Musicas")
oExecView:setSource("COMP021_MVC")
oExecView:setOK({|| bOK})
oExecView:setModal(.F.)
oExecView:setOperation(MODEL_OPERATION_VIEW)
oExecView:openView(.F.)
New
Sintaxe
Descrição
Metodo usado para instanciar a classe.
setTitle
Sintaxe
FWVIEWEXEC():setTitle([ cTitle ])-> NIL
Descrição
Define o título da janela onde a view será executada.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| cTitle | Caracteres | Titulo
| "" | | |
setXML
Sintaxe
FWVIEWEXEC():setXML([ cXML ])-> NIL
Descrição
Define o XML que será utilizado no activate da View.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| cXML | Caracteres | XML
| NIL | | |
setSource
Sintaxe
FWVIEWEXEC():setSource([ cSource ])-> NIL
Descrição
Define qual o nome do programa (fonte) de onde a View será carregada.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| cSource | Caracteres | nome do fonte
| "" | | |
setOperat
Sintaxe
FWVIEWEXEC():setOperat([ cID ])-> NIL
Descrição
Define o identificador da operação selecionada no menu.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| cID | Caracteres | Identificador
| "" | | |
setToolBar
Sintaxe
FWVIEWEXEC():setToolBar([ cIDToolBar ])-> NIL
Descrição
Define o relacionamento com os botões da tela (FormBar). Se essa
configuração é ativada, serão recuperadas as informações armazenadas
no profile do usuário para a ToolBar.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| cIDToolBar | Caracteres | ID
| "" | | |
setOperation
Sintaxe
FWVIEWEXEC():setOperation(<nOperation >)-> NIL
Descrição
Define com qual operação a View será executada.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| nOperation | Numérico | Número da operação, podendo ser:
1 - Visualização
3 - Inserção
4 - Atualização
5 - Exclusão
9 - Cópia
| MODEL_OPERATION_VIEW | X | |
setReduction
Sintaxe
FWVIEWEXEC():setReduction(<nPerc >)-> NIL
Descrição
Define se a janela onde a view será exibida deve possuir um percentual
de redução em relação a janela principal.
Caso essa configuração não seja utilizada, a janela irá abrir com o mesmo
tamanho da janela principal, exceto no caso da janela Modal, a Modal
irá abrir respeitando o tamanho máximo que ela pode possuir.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| nPerc | Numérico | Percentual de redução
| 0 | X | |
setSize
Sintaxe
FWVIEWEXEC():setSize([ nWidth ], <nHeight >)-> NIL
Descrição
Define largura e altura da janela.
Quando usado esse método, a janela não será aberta nem com redução
e nem utilizando a janela inteira, ela será exibida com o tamanho
que foi definido pelo método.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| nWidth | Numérico | Largura | 0 | | |
| nHeight | Numérico | Altura
| | X | |
setCloseOnOK
Sintaxe
FWVIEWEXEC():setCloseOnOK([ bCloseOnOK ])-> NIL
Descrição
Metodo que seta um bloco de código para verificar se a janela deve ou não
ser fechada após a execução do botão OK na View. Se o view estiver valido, o
bloco de código é invocado e recebe como parametro o View. O bloco deve
retornar verdadeiro para Fechar a janela ou falso para manter ela aberta.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| bCloseOnOK | Bloco de Código | Bloco de Código
| NIL | | |
setOK
Sintaxe
FWVIEWEXEC():setOK([ bOK ])-> NIL
Descrição
Metodo que seta um bloco de código para ser executado no botão OK da View.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| bOK | Bloco de Código | Bloco de Código
| NIL | | |
setCancel
Sintaxe
FWVIEWEXEC():setCancel([ bCancel ])-> NIL
Descrição
Metodo que seta um bloco de código para ser executado no botão Cancelar da View.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| bCancel | Bloco de Código | Bloco de Código
| NIL | | |
setModal
Sintaxe
FWVIEWEXEC():setModal([ lModal ])-> NIL
Descrição
Metodo que define se a View deve ser aberta na janela modal.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| lModal | Lógico | Se verdadeiro, a janela da view será modal
| .T. | | |
setButtons
Sintaxe
FWVIEWEXEC():setButtons([ aButtons ])-> NIL
Descrição
Método que define quais botões serão mostrados na view.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| aButtons | Array | Array com o seguinte formato:
O array aButtons tem por padrão 14 posições:
1 - Copiar
2 - Recortar
3 - Colar
4 - Calculadora
5 - Spool
6 - Imprimir
7 - Confirmar
8 - Cancelar
9 - WalkTrhough
10 - Ambiente
11 - Mashup
12 - Help
13 - Formulário HTML
14 - ECM
Para cada posição existe um array no seguinte formato:
{.T., NIL}
O valor lógico indica se o botão deve ser habilitado e o Valor NIL é somente para compatilização.
Os únicos itens onde o array é diferente são o Cancelar e o Confirmar, pois eles permitem modificar o título do botão.
{.T., "Confirmar"}
{.T., "Cancelar"}
| NIL | | |
setOwner
Sintaxe
FWVIEWEXEC():setOwner(<oOwner >)-> NIL
Descrição
Metodo uma janela para ser o owner da View.
Nesse caso a classe irá somente ativar a janela, sendo a criação
dela responsabilidade de quem define o owner.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| oOwner | Objeto | Janela do tipo MsDialog ou TDialog
| | X | |
Observações
Se a propriedade lModal estiver ativada, o owner setado será ignorado
e a janela será criada no formato modal.
setModel
Sintaxe
FWVIEWEXEC():setModel(<oModel >)-> NIL
Descrição
Define um model para a view.
Essa configuração deve ser usada quando é desejado que a view já abra com
o model preenchido.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| oModel | Objeto | objeto do tipo MPFormModel ou FWFormModel
| | X | |
openView
Sintaxe
FWVIEWEXEC():openView(<lDeActivateView >)-> NIL
Descrição
Método utilizado para abrir a View na janela.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| lDeActivateView | Lógico | Indica se a View deve ser desativada quando a
janela for encerrada.
| .T. | X | |
deActivate
Sintaxe
FWVIEWEXEC():deActivate()-> NIL
Descrição
Desativa a a view e a janela, destruindo os objetos inclusive.
getButtonPress
Sintaxe
FWVIEWEXEC():getButtonPress()-> nButtonPress
Descrição
Retorna qual botão foi pressionado na view.
Retorno
nButtonPress Retorna 0 se o botao foi o OK ou 1 se foi o Cancelar.
setView
Sintaxe
FWVIEWEXEC():setView(<oView >)-> NIL
Descrição
Define uma view para ser executada.
Se essa configuração for usada, a view não será carregada baseada no programa.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| oView | Objeto | objeto do tipo FwFormView
| | X | |
setBrowse
Sintaxe
FWVIEWEXEC():setBrowse(<oBrowse >, <lCursor >)-> NIL
Descrição
Define um browse para a view e se o cursor será usado ou não.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
|
| oBrowse | Objeto | objeto de browse | | X | |
| lCursor | Lógico | Se verdadeiro usa o cursor na view
| | X | |
