In This Topic ▼

LAutomation::RemoveContainer

Summary

Removes the specified container from the automation list of containers.

Syntax

#include "ltwrappr.h"

L_INT LAutomation::RemoveContainer (pLContainer);

Parameters

LContainer * pLContainer

Pointer to an LContainer object that references the container to remove.

Returns

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

Comments

Removing the container from the automation list of containers will remove the automation functionality from that container and the window that owns it.

When working with vector automation, the user must free any vector handles associated with the automation container.

Required DLLs and Libraries

LTAUT
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 shows how to remove some container from the automation.

L_INT LAutomation_RemoveContainerExample(LAutomation &Automation, LContainer &Container) 
{ 
   L_INT nRet; 
 
   nRet = Automation.IsValid (); 
 
   if ( SUCCESS == nRet ) /* check the validity of the automation handle */ 
 
   { 
 
      nRet = Container.IsValid (); 
      if ( SUCCESS == nRet ) /* check the validity of the container handle */ 
 
      { 
 
         /* Remove the container from the automation */ 
 
         nRet = Automation.RemoveContainer (&Container ) ; 
         if(nRet != SUCCESS) 
            return nRet; 
 
         /* Free the container handle */ 
 
         nRet = Container.Free () ; 
         if(nRet != SUCCESS) 
            return nRet; 
 
      } 
 
      else 
 
      { 
 
         return nRet ; 
 
      } 
 
   } 
 
   else 
 
   { 
 
      return nRet ; 
 
   } 
 
   return SUCCESS ; 
 
}