6 de jul. de 2012


Este artigo descreve algumas técnicas que previnem que um usuário feche (saia) de um Formulário VBA.

Normalmente, um Formulário como mostrado abaixo pode ser fechado ao se clicar no botão X vermelho na lateral superior ou pressionando-se Alt+F4:





Muitas vezes necessitamos executar uma rotina de término de um programa e finalizar um formulário desta forma pode não ser conveniente para o bom funcionamento do mesmo. Abaixo seguem algumas alternativas para contornar esse problema.

Inutilizar Botão de Fechar

Com esta técnica, a interface do formulário permanecerá inalterada, mas não é possível finalizar o programa clicando no X vermelho ou pressionando-se Alt+F4. Obviamente, o desenvolvedor deve criar uma forma de se sair ou mudar para outro formulário, como mostrado abaixo:




Caso o usuário tente clicar no X vermelho ou pressionar Alt+F4, o aviso aparecerá:




O código para esse formulário é:

Private Sub UserForm_QueryClose(Cancel As Integer, CloseMode As Integer)
    If CloseMode = vbFormControlMenu Then
        Cancel = True
        MsgBox "Favor sair do programa clicando no botão 'Sair'" _
          , vbCritical _
          , "Erro"
    End If
End Sub

Private Sub btnSair_Click()
    Unload Me
End Sub


Observe que é utilizado o evento QueryClose do Formulário. Ele é chamado assim que tenta-se clicar no X vermelho ou ao se pressionar Alt+F4. Atribuindo o parâmetro Cancel = True, a operação é anulada. Uma caixa de mensagem é mostrada ao usuário para ele seguir novas instruções de como sair/migrar do Formulário.

Em minha opinião, essa é a melhor forma de previnir que um usuário feche um Formulário.



Remover Botão de Fechar

Está técnica envolve o uso de APIs para remover o botão de fechar do Formulário. No entanto, ainda é possível fechar o Formulário pressionando-se Alt+F4. Se quiser prevenir que o usuário feche dessa forma, sugiro utilizar também o código da seção anterior. Veja que o botão desaparece ao se clicar em Esconder:





Ao se clicar em Mostrar, o botão de fechar aparece novamente.

Como já dito, para usar esta técnica, é necessário o uso de APIs. Logo, o código abaixo são declarações das APIs e deve ficar em um módulo (que não seja do Formulário):


'Estas declarações se referem às APIs do UserForm3
Option Explicit

#If VBA7 Then
    Declare PtrSafe Function FindWindowA Lib "user32" _
      (ByVal lpClassName As String, ByVal lpWindowName As String) As Long
    Declare PtrSafe Function GetWindowLongA Lib "user32" _
      (ByVal hwnd As Long, ByVal nIndex As Long) As Long
    Declare PtrSafe Function SetWindowLongPtr Lib "user32" Alias "SetWindowLongA" _
      (ByVal hwnd As LongPtr, ByVal nIndex As Long, ByVal dwNewLong As LongPtr) As LongPtr
#Else
    Declare Function FindWindowA Lib "USER32" _
      (ByVal lpClassName As String, ByVal lpWindowName As String) As Long
    Declare Function GetWindowLongA Lib "USER32" _
      (ByVal hwnd As Long, ByVal nIndex As Long) As Long
    Declare Function SetWindowLongA Lib "USER32" _
      (ByVal hwnd As Long, ByVal nIndex As Long, ByVal dwNewLong As Long) As Long
#End If

O código do Formulário é mostrado abaixo:

Private Sub btnEsconder_Click()
    Dim hwnd As Long
    hwnd = FindWindowA(vbNullString, Me.Caption)
    SetWindowLongPtr hwnd, -16, GetWindowLongA(hwnd, -16) And &HFFF7FFFF
End Sub

Private Sub btnMostrar_Click()
    Dim hwnd As Long
    hwnd = FindWindowA(vbNullString, Me.Caption)
    SetWindowLongPtr hwnd, -16, GetWindowLongA(hwnd, -16) Or &H80000
End Sub

Private Sub btnSair_Click()
    Unload Me
End Sub

Desativar Botão de Fechar

Esta técnica é idêntica à mostrada acima, exceto que em vez de remover o botão de fechar, o mesmo fica desativado. Vale lembrar que ainda é possível sair do formulário pressionando-se Alt+F4:



 
O código das declarações API, que deve ficar num módulo separado ao do Formulário, é:




'Estas declarações se referem às APIs do UserForm3
Option Explicit

#If VBA7 Then
    Declare PtrSafe Function RemoveMenu Lib "user32" _
      (ByVal hMenu As LongPtr, ByVal nPosition As Long, ByVal wFlags As Long) As Long
    Declare PtrSafe Function GetSystemMenu Lib "user32" _
      (ByVal hwnd As LongPtr, ByVal bRevert As Long) As LongPtr
    Declare PtrSafe Function FindWindow Lib "user32" Alias "FindWindowA" _
      (ByVal lpClassName As String, ByVal lpWindowName As String) As Long
#Else
    Declare Function RemoveMenu Lib "user32" _
      (ByVal hMenu As Long, ByVal nPosition As Long, ByVal wFlags As Long) As Long
    Declare Function GetSystemMenu Lib "user32" _
      (ByVal hwnd As Long, ByVal bRevert As Long) As Long
    Declare Function FindWindow Lib "user32.dll" Alias "FindWindowA" _
      (ByVal lpClassName As String, ByVal lpWindowName As String) As Long
#End If

Public Const MF_BYPOSITION = &H400&

O código do Formulário é:

Private Sub UserForm_Initialize()
    Dim lHwnd As Long
    lHwnd = FindWindow("ThunderDFrame", Me.Caption)
    Do While lHwnd = 0
        lHwnd = FindWindow("ThunderDFrame", Me.Caption)
        DoEvents
    Loop
    RemoveMenu GetSystemMenu(lHwnd, 0), 6, MF_BYPOSITION
End Sub

Private Sub btnSair_Click()
    Unload Me
End Sub




0 comentários:

Postar um comentário