Set Mouse Intercept Condition

3270	5250	VT
Yes	Yes	Yes

This function specifies the mouse input to be intercepted. The client sends the following command to set the mouse event to be intercepted.

PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aMOUSE) );

where:

hData	Identifies a handle to a Windows global memory object that specifies the condition of intercepting the mouse input, CF_TEXT or CF_DSPTEXT.
aMOUSE	Identifies Mouse atom as the item.

If the format is CF_TEXT, the client program sends the condition in the following structure:

typedef struct tagSETMOUSE_CF_TEXT
{
 unsigned      unused:12,           //
 unsigned      fRelease:1,          //
 unsigned      fReserved:3;         //
 int           cfFormat;            // Always CF_TEXT
 unsigned char Condition[1]         //
} SETMOUSE_CF_TEXT, FAR *lpSETMOUSE_CF_TEXT;

The following table shows the parameters' values:

Parameter Name	Meaning	Value
Condition	Condition of intercepting the mouse input	A string terminated with \0, consists of the constants defined as follows in any order: L Enable intercepting the left button l Disable intercepting the left button R Enable intercepting the right button r Disable intercepting the right button M Enable intercepting the middle button m Disable intercepting the middle button S Enable intercepting a single click s Disable intercepting a single click D Enable intercepting a double click d Disable intercepting a double click T Retrieve the pointed string t Do not retrieve the pointed string

If the format is CF_DSPTEXT, the client program sends the condition in the following structure:

typedef struct tagSETMOUSE_CF_DSPTEXT
{
 unsigned      unused:12,           //
 unsigned      fRelease:1,          //
 unsigned      fReserved:3;         //
 int           cfFormat;            // Always CF_DSPTEXT
 BOOL          bLeftButton;         //
 BOOL          bRightButton;        //
 BOOL          bMiddleButton;       //
 BOOL          bSingleClick;        //
 BOOL          bDoubleClick;        //
 BOOL          bRetrieveString;     //
} SETMOUSE_CF_DSPTEXT, FAR *lpSETMOUSE_CF_DSPTEXT;

The following table shows the values in the parameters:

Parameter Name	Meaning	Value
bLeftButton	Enable or disable interception of the left mouse button	True Enable intercepting the left button False Disable intercepting the left button
bRightButton	Enable or disable interception of the right mouse button	True Enable intercepting the right button False Disable intercepting the right button
bMiddleButton	Enable or disable interception of the middle mouse button	True Enable intercepting the middle button False Disable intercepting the middle button
bSingleClick	Enable or disable interception of the single click	True Enable intercepting the single click False Disable intercepting the single click
bDoubleClick	Enable or disable interception of the double click	True Enable intercepting the double click False Disable intercepting the double click
bRetrieveString	Retrieve or do not retrieve the pointed string	True Retrieve the pointed string False Do not retrieve the pointed string