LContainer::Update

#include "Ltwrappr.h"

L_INT LContainer::Update (prcPaint)

LPRECT prcPaint;

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

Updates the container client area.

Parameter

Description

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:

LContainer::Reset

Topics:

Displaying Objects

Example

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

L_INT LContainer_UpdateExample( LContainer & lcont)
{
   L_INT nRet;
   nRet = lcont.IsValid ();
   if ( nRet == SUCCESS ) /* check the validity of container handle */
    {
      HWND hWndOwner ;
      RECT rcOwnerClient ;
      /* Get the container owner window */
     nRet = lcont.GetOwner (&hWndOwner ) ;
     if(nRet != SUCCESS)
        return nRet;
      /* Get the owner client rectangle */
      ::GetClientRect ( hWndOwner, &rcOwnerClient ) ; 
      /* Update the container drawing to the screen */
     nRet = lcont.Update (&rcOwnerClient ) ;
     if(nRet != SUCCESS)
        return nRet;
    }
   else
   {
      return nRet ;
   }
   return SUCCESS ;
}