LContainer::Update

Summary

Updates the container client area.

Syntax

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

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