Classe: FWViewExec


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ãoP12


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
FWVIEWEXEC():New()-> NIL

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


NomeTipoDescriçãoDefaultObrigatórioReferência
cTitleCaracteresTitulo""


 
setXML


Sintaxe
FWVIEWEXEC():setXML([ cXML ])-> NIL

Descrição
Define o XML que será utilizado no activate da View.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
cXMLCaracteresXMLNIL


 
setSource


Sintaxe
FWVIEWEXEC():setSource([ cSource ])-> NIL

Descrição
Define qual o nome do programa (fonte) de onde a View será carregada.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
cSourceCaracteresnome do fonte""


 
setOperat


Sintaxe
FWVIEWEXEC():setOperat([ cID ])-> NIL

Descrição
Define o identificador da operação selecionada no menu.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
cIDCaracteresIdentificador""


 
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


NomeTipoDescriçãoDefaultObrigatórioReferência
cIDToolBarCaracteresID""


 
setOperation


Sintaxe
FWVIEWEXEC():setOperation(<nOperation >)-> NIL

Descrição
Define com qual operação a View será executada.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
nOperationNuméricoNúmero da operação, podendo ser:
1 - Visualização
3 - Inserção
4 - Atualização
5 - Exclusão
9 - Cópia
MODEL_OPERATION_VIEWX


 
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


NomeTipoDescriçãoDefaultObrigatórioReferência
nPercNuméricoPercentual de redução0X


 
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


NomeTipoDescriçãoDefaultObrigatórioReferência
nWidthNuméricoLargura0

nHeightNuméricoAltura
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


NomeTipoDescriçãoDefaultObrigatórioReferência
bCloseOnOKBloco de CódigoBloco de CódigoNIL


 
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


NomeTipoDescriçãoDefaultObrigatórioReferência
bOKBloco de CódigoBloco de CódigoNIL


 
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


NomeTipoDescriçãoDefaultObrigatórioReferência
bCancelBloco de CódigoBloco de CódigoNIL


 
setModal


Sintaxe
FWVIEWEXEC():setModal([ lModal ])-> NIL

Descrição
Metodo que define se a View deve ser aberta na janela modal.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
lModalLógicoSe 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


NomeTipoDescriçãoDefaultObrigatórioReferência
aButtonsArrayArray 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


NomeTipoDescriçãoDefaultObrigatórioReferência
oOwnerObjetoJanela 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.

Importante!
Esse método foi descontinuado
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


NomeTipoDescriçãoDefaultObrigatórioReferência
oModelObjetoobjeto 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


NomeTipoDescriçãoDefaultObrigatórioReferência
lDeActivateViewLógicoIndica 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


NomeTipoDescriçãoDefaultObrigatórioReferência
oViewObjetoobjeto 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


NomeTipoDescriçãoDefaultObrigatórioReferência
oBrowseObjetoobjeto de browse
X
lCursorLógicoSe verdadeiro usa o cursor na view
X



 
  • Sem rótulos