Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CWnd►                                        ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  afx_msg int OnMouseActivate( CWnd*  pFrameWnd, UINT  nHitTest,
                               UINT  message  );
 
  Parameter   Description
 
  <pFrameWnd> Specifies a pointer to the topmost parent window of the
              window being activated. The pointer may be temporary, and
              should not be stored.
 
  <nHitTest>  Specifies the ◄hit-test► area code. A hit test is a test
              that determines the location of the cursor.
 
  <message>   Specifies the message number.
 
  Remarks
 
  Called when the cursor is in an inactive window and the user presses a
  mouse button.
 
  If the child window passes the message to the ◄Default► or
  ◄DefWindowProc► member function, Default or DefWindowProc passes this
  message to the CWnd parent window before any processing occurs. If the
  parent window returns TRUE, processing is halted.
 
  This message-handler member function calls the ◄Default► member
  function. Override this member function in your derived class to handle
  the ◄WM_MOUSEACTIVATE► message.
 
  Return Value
 
  Specifies whether to activate the CWnd and whether to discard the mouse
  event. It must be one of the following values:
 
  Value                 Meaning
 
  MA_ACTIVATE           Activate CWnd.
 
  MA_NOACTIVATE         Do not activate CWnd.
 
  MA_ACTIVATEANDEAT     Activate CWnd and discard the mouse event.
 
  MA_NOACTIVATEANDEAT   Do not activate CWnd and discard the mouse event.
 
  See Also
 
  ◄CWnd::OnNcHitTest►, ◄CWnd::Default►, ◄WM_MOUSEACTIVATE►
 
 
                                     -♦-