In This Topic ▼

L_ContainerUpdate

Summary

Updates the client area of the container.

Syntax

#include "LtCon.h"

L_LTCON_API L_INT L_ContainerUpdate(pContainer, prcPaint)

Parameters

pCONTAINERHANDLE pContainer

Pointer to a container handle.

LPRECT prcPaint

Pointer to the RECT structure that contains the coordinates of the smallest rectangle that completely encloses the region of the container to update. These coordinates are with respect to the client area of the window that owns the container. The rectangle coordinates are logical coordinates. If this parameter is NULL, this function will update the entire container owner client area.

Returns

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

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

Example

This example will update the container current drawing (if any).

L_INT ContainerUpdateExample(pCONTAINERHANDLE pContainer) 
{ 
   L_INT nRet; 
   nRet = L_ContainerIsValid ( pContainer ); 
   if (SUCCESS == nRet ) /* check the validity of container handle */ 
   { 
      HWND hWndOwner ; 
      RECT rcOwnerClient ; 
 
      /* Get the container owner window */ 
      nRet = L_ContainerGetOwner ( pContainer, &hWndOwner ) ; 
      if(nRet != SUCCESS) 
         return nRet; 
 
      /* Get the owner client rectangle */ 
      GetClientRect ( hWndOwner, &rcOwnerClient ) ;  
 
      /* Update the container drawing to the screen */ 
      nRet = L_ContainerUpdate ( pContainer, &rcOwnerClient ) ; 
   } 
   return nRet; 
}