L_InetSendSetRectCmd

#include "l_bitmap.h"
#include "ltnet.h"

L_LTNET_API L_INT L_InetSendSetRectCmd(hComputer, uCommandID, uWindowID, nType, nLeft, nTop, nWidth, nHeight)

L_COMP hComputer;	/* handle to a remote computer */
L_UINT uCommandID;	/* command id */
LONG_PTR uWindowID;	/* window id */
RECTTYPE nType;	/* rectangle type */
L_INT nLeft;	/* horizontal position */
L_INT nTop;	/* vertical position */
L_INT nWidth;	/* width */
L_INT nHeight;	/* height */

Sends a set rectangle command to a remote computer.

Parameter	Description
hComputer	Handle of the remote computer to which the command will be sent.
uCommandID	Command ID. Each command sent by a member of a connection should have a unique ID. Since a member of a connection may send several commands, this ID allows that member to identify when a specific command request has been completed.
uWindowID	The id of the window to receive the command.
nType	Type of rectangle to set. For possible values, refer to RECTTYPE.
nLeft	X coordinate of the origin of the display rectangle.
nTop	Y coordinate of the origin of the display rectangle.
nWidth	Width of the display rectangle.
nHeight	Height of the display rectangle.

Returns

SUCCESS	This function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The remote computer should respond by calling L_InetSendSetRectRsp in its INETCOMMANDCALLBACK function. This callback function must be set using L_InetSetCommandCallback.

The INETCOMMANDCALLBACK function will receive the uWindowID, nType, nLeft, nTop, nWidth and nHeight information in the pParams parameter. The uWindowID information will be in pParams[0]. The nType information will be in pParams[1], and so forth.

To receive responses to commands, provide an INETRESPONSECALLBACK function. This function must be set using L_InetSetResponseCallback.

This command is only beneficial to windows that have a bitmap associated with them.

Required DLLs and Libraries

LTNET

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:	L_InetSendSetRectRsp, INETRESPONSECALLBACK, INETCOMMANDCALLBACK
Topics:	Sending Commands and Responses
	A Client-Server Diagram: Sending Commands and Responses

Example

 L_INT InetSendSetRectCmdExample(L_COMP hComputer,
                                                L_UINT uWindowID,
                                                LPRECT pRect,
                                                L_UINT *guCommandID)
{
   return L_InetSendSetRectCmd(hComputer,
                               *guCommandID++,
                               uWindowID,
                               RECT_DSTALL,
                               pRect->left,
                               pRect->top,
                               pRect->right - pRect->left,
                               pRect->bottom - pRect->top);
}
//**********  Code on the remote computer ****************/
L_INT SetWindowRect(HWND    hwnd,
                    CMDTYPE cmdType,
                    L_INT   nLeft,
                    L_INT   nTop,
                    L_INT   nWidth,
                    L_INT   nHeight)
{
   UNREFERENCED_PARAMETER(hwnd);
   UNREFERENCED_PARAMETER(cmdType);
   UNREFERENCED_PARAMETER(nLeft);
   UNREFERENCED_PARAMETER(nTop);
   UNREFERENCED_PARAMETER(nWidth);
   UNREFERENCED_PARAMETER(nHeight);
   // Set the window rectangle for painting here...
   return SUCCESS;
}