L_DispContainerSetBounds

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerSetBounds(hCon, lpRect, uFlags)

HDISPCONTAINER hCon;	/* handle to the container */
RECT * lpRect;	/* pointer to a structure */
L_UINT uFlags;	/* reserved for future use */

Sets the bounding rectangle for the container.

Parameter	Description
hCon	Handle to the container.
lpRect	Pointer to a RECT structure that contains the bounding rectangle to set for the container. This bounding rectangle is relative to the upper left corner of the parent windows client area.
uFlags	Reserved for future use. Pass 0.

Returns

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

Comments

The coordinates of lpRect are relative to the parent window coordinates. If the container window has no parent, the coordinates will be relative to the screen coordinates.

Call L_DispContainerGetBounds to get the current bounding rectangle for the container.

Required DLLs and Libraries

LTIVW

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_DispContainerCreate, L_DispContainerGetBounds, L_DispContainerSetProperties, L_DispContainerGetProperties, L_DispContainerGetWindowHandle, L_DispContainerDestroy
Topics:	Using the Image Viewer
	Image Viewer Functions: Using the Image Viewer

Example

When the user resizes the container parent window, the container window will be resized to fit the new size of the parent client area.

 L_INT DispContainerSetBoundsExample(HDISPCONTAINER hCon,
                                                    HWND           hWndParent,
                                                    L_UINT         uState,
                                                    L_INT          nCx,
                                                    L_INT          nCy)
{
   L_INT nRet;
   UNREFERENCED_PARAMETER(nCx);
   UNREFERENCED_PARAMETER(nCy);
   UNREFERENCED_PARAMETER(uState);

   RECT rcRect; 
   GetClientRect(hWndParent, &rcRect); 
   nRet = L_DispContainerSetBounds(hCon, &rcRect, 0); 
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}