In This Topic ▼

LContainer::Update

Summary

Updates the container client area.

Syntax

#include "Ltwrappr.h"

L_INT LContainer::Update (prcPaint)

Parameters

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