cWsForm
Pacote
A classe cWsForm está definida no pacote cWsForm.pkg.
Hierarquia
A classe cWsForm é uma subclasse da classe dbForm do DataFlex e herda todas as propriedades, eventos e métodos existentes nesta classe.
Para que serve
A classe cWsForm é uma subclasse da classe Form e foi especializada com alguns recursos adicionais:
- A cor do objeto muda dinamicamente quando recebe o foco.
- Novas propriedades adicionadas permitem melhor controle do Label.
- O botão de prompt apresenta a imagem de uma lupa no lugar dos costumeiros “…”.
- Através da propriedade pbRestoreLastValueOnActivate, foi adicioanda a capacidade de lembrar seu valor, mesmo quando o usuário fecha o sistema e abre novamente.
Eventos
Imprimir
Tipo
Procedure
Para que serve
Este evento é disparado sempre que o usuário pressiona o botão “Imprimir” da barra de ferramentas que é exibida no topo da dbView. Programe dentro dele o que você deseja fazer nesta situação.
Observações
- O botão “Imprimir” da barra de ferramentas não fica habilitado, por padrão. Para habilitá-lo, utilize a propriedade pbVisiblePrint.
- Consulte a tela LogDD.vw para ver um exemplo de utilização deste evento.
OnPreEnteringView
Tipo
Procedure
Para que serve
Este evento foi criado especialmente quando há necessidade de criar/desligar relacionamentos específicos para uma View. Neste evento ligamos ou desligamos o relacionamento e no evento OnPreExitingView fazemos o oposto. A grande maioria dos desenvolvedores utiliza os métodos Entering_Scope e Exiting_Scope para fazer isso, só que eles não são seguros, pois se o usuário abrir uma outra View que depende do relacionamento que foi alterado na view que está aberta, a Exiting_Scope só será executada depois que a outra view foi carregada, causando comportamentos imprevistos na outra View. Exemplo:
Procedure OnPreEnteringView
// Nesta View a tabela Direito será relacionada com UsuarioF
Set_Relate Direito.Id_Usuario to Usuariof.Id_Usuario
End_Procedure // OnPreEnteringView
Procedure OnPreExitingView
// Restaurando o relacionamento original usado nas demais Views do sistema
Set_Relate Direito.Id_Usuario to Usuario.Id_Usuario
End_Procedure // OnPreExitingView
OnPreExitingView
Tipo
Procedure
Para que serve
Este evento foi criado especialmente quando há necessidade de criar/desligar relacionamentos específicos para uma View. Neste evento ligamos ou desligamos o relacionamento e no evento OnPreExitingView fazemos o oposto. A grande maioria dos desenvolvedores utiliza os métodos Entering_Scope e Exiting_Scope para fazer isso, só que eles não são seguros, pois se o usuário abrir uma outra View que depende do relacionamento que foi alterado na view que está aberta, a Exiting_Scope só será executada depois que a outra view foi carregada, causando comportamentos imprevistos na outra View. Exemplo:
Procedure OnPreEnteringView
// Nesta View a tabela Direito será relacionada com UsuarioF
Set_Relate Direito.Id_Usuario to Usuariof.Id_Usuario
End_Procedure // OnPreEnteringView
Procedure OnPreExitingView
// Restaurando o relacionamento original usado nas demais Views do sistema
Set_Relate Direito.Id_Usuario to Usuario.Id_Usuario
End_Procedure // OnPreExitingView
Propriedades
pbHighLightFocus
Tipo
Boolean
Valor padrão
True
Para que serve
Se esta propriedade for True a cor do objeto e do texto do objeto irá mudar de cor quando ele receber o foco. As cores que serão aplicadas ao objeto estão definidas na tela de preferências visuais do usuário.
pbLabelTransparentState
Tipo
Boolean
Valor padrão
True
Para que serve
Se esta propriedade for True, o Label do objeto será transparente. Caso contrário não será. Esta propriedade tem para o Label deste objeto o mesmo efeito que a propriedade Transparent_State tem nos objetos TextBox.
pbRestoreLastValueOnActivate
Tipo
Boolean
Valor padrão
False
Para que serve
Se esta propriedade for True, o valor do objeto será salvo no registro do Windows. Quando o usuário abrir novamente este objeto em uma próxima instância da aplicação, o último valor utilizado será restaurado.
O valor fica salvo em uma chave do registro abaixo de HKEY_CURRENT_USER, desta forma, é específico para cada usuário que utiliza o sistema e em cada máquina que utilizar.
Observação
Esta propriedade está disponível a partir da versão 18.2.12 do MenuFlex.