BUG: SetWindowPos API Does Not Set Topmost Window in VB

MORE INFORMATION

It is possible to use the SetWindowPos API function to make a Visual Basic Form stay topmost in the z-order (always on top), even when focus is on another window. However, the problems listed above may result.

Steps to Reproduce Behavior

1. Start Visual Basic and create a standard EXE project. Form1 is created by default.
2. From the Project menu, add another Form to the project. It should be called Form2.
3. From the Project menu, add a Basic Module (.BAS) to the project and add the following code:

         ' SetWindowPos Function
         Declare Function SetWindowPos Lib "user32" _
            (ByVal hwnd As Long, ByVal hWndInsertAfter As Long, _
             ByVal x As Long, ByVal y As Long, ByVal cx As Long, _
             ByVal cy As Long, ByVal wFlags As Long) As Long
   
         ' SetWindowPos Flags
         Public Const SWP_NOSIZE = &H1
         Public Const SWP_NOMOVE = &H2
         Public Const HWND_TOPMOST = -1
         Public Const HWND_NOTOPMOST = -2
   
   						

4. Add two CommandButtons to Form2 and add the following code to its Code Window:

         Private Sub Form_Load()
            Command1.Caption = "Make Topmost"
            Command2.Caption = "Unload Form2"
         End Sub
   
         Private Sub Command1_Click()
            Call SetWindowPos(Me.hWnd, HWND_TOPMOST, 0, 0, 0, 0, _
                              SWP_NOSIZE Or SWP_NOMOVE)
         End Sub
   
         Private Sub Command2_Click()
            Call SetWindowPos(Me.hWnd, HWND_NOTOPMOST, 0, 0, 0, 0, _
                              SWP_NOSIZE Or SWP_NOMOVE)
            Unload Me
         End Sub
   
   						

5. Now add a CommandButton to Form1 and add the following code to its Code Window:

         Private Sub Form_Load()
            Command1.Caption = "Show Form2"
            Call SetWindowPos(Me.hWnd, HWND_TOPMOST, 0, 0, 0, 0, _
                              SWP_NOSIZE Or SWP_NOMOVE)
         End Sub
   
         Private Sub Command1_Click()
            Form2.Show vbModeless, Me
         End Sub
   
   						

6. Compile the program and run it as an EXE (outside the Debugger).
   
   RESULTS: Form1 appears as a Topmost window. Pressing the "Show Form2" button makes Form2 visible, but you will notice that Form2 (a child of Form1) is not the topmost window. In fact, you may need to move Form1 to see Form2. This behavior is contrary to the product documentation. Now press the "Make Topmost" button of Form2. This should make Form2 a topmost window. Pressing the "Unload Form2" button will cause Form2 to clear its Topmost flag before closing. This causes Form1's Topmost flag to be cleared as well.
   
   NOTE: Form1 may remain topmost in the z-order until you switch to another window and then switch back. This can give the impression that Form1 is still a topmost window, but the topmost flag has been cleared.