L_ContainerUpdate

#include "LtCon.h"

L_LTCON_API L_INT L_ContainerUpdate(pContainer, prcPaint)

pCONTAINERHANDLE pContainer;

/* pointer to a container handle */

LPRECT prcPaint;

/* pointer to the RECT structure to be updated */

Updates the container client area.

Parameter

Description

pContainer

Pointer to a container handle.

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

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

See Also

Functions:

L_ContainerReset

Topics:

Displaying Objects

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