In This Topic ▼

L_DispContainerSetBounds

Summary

Sets the bounding rectangle for the container.

Syntax

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerSetBounds(hCon, lpRect, uFlags)

Parameters

HDISPCONTAINER hCon

Handle to the container.

RECT * 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.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Value	Meaning
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.

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; 
}