L_ContainerCreate

#include "LtCon.h"

L_LTCON_API L_INT L_ContainerCreate (pContainer, hwndOwner)

pCONTAINERHANDLE pContainer;	/* pointer to a container handle */
L_HWND hwndOwner;	/* window handle */

Creates a container and attaches it to a user defined window.

Parameter	Description
pContainer	Pointer to a container handle.
hwndOwner	Handle of the window that owns the container.

Returns

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

Comments

The container owner window should have CS_DBLCLKS in its class style. Otherwise some container functions will not work.

L_ContainerInit must be called before calling this function.

Required DLLs and Libraries

LTCON

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_ContainerIsValid, L_ContainerInit, L_ContainerSetMetrics, L_ContainerFree.
Topics:	Creating a Container

Example

This example shows the minimum requirements to start using some container.

 L_INT ContainerCreateExample(HWND hWnd, pCONTAINERHANDLE * ppLeadContainer)
{
   L_INT nRet;
   CONTAINERMETRICS Metrics ;

   /* Initialize the container handle */
   nRet = L_ContainerInit( ppLeadContainer ) ;
   if(nRet != SUCCESS)
      return nRet;

   /* Create the container and attach it to its owner window */
   nRet = L_ContainerCreate( *ppLeadContainer, hWnd ) ;
   if(nRet != SUCCESS)
      return nRet;
   nRet = L_ContainerIsValid( *ppLeadContainer );
   if ( SUCCESS == nRet) /* the validity of the container handle */
   {
      /* Set the container object type to rectangle */
      nRet = L_ContainerSetObjectType( *ppLeadContainer, CONTAINER_OBJECT_TYPE_RECT ) ;
      if(nRet != SUCCESS)
         return nRet;

      /* Initiate the container metrics */
      Metrics.nSize  = sizeof ( CONTAINERMETRICS ) ;
      Metrics.dwMask = CMF_LIMITS ; 

      /* Set the container limits to some value, all container inputs (after scaling) will be restricted to this range */
      SetRect ( &Metrics.rcLimits, 0, 0, 500, 500 ) ;

      /* Set the container metrics */
     nRet = L_ContainerSetMetrics( *ppLeadContainer, &Metrics ) ;
   }
   return nRet;
}