L_AutRemoveContainer

#include "ltaut.h"

L_LTAUT_API L_INT L_AutRemoveContainer(pAutomation, pContainer)

Removes the specified container from the automation list of containers.

Parameters

pAUTOMATIONHANDLE pAutomation

Pointer to an automation handle.

pCONTAINERHANDLE pContainer

Pointer to a container handle.

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

See Also

Functions

Topics

Example

This example shows how to remove some container from the automation.

L_INT AutRemoveContainerExample(pAUTOMATIONHANDLE  pAutomation, 
                                                pCONTAINERHANDLE   pContainer) 
{ 
   L_INT nRet; 
 
   nRet = L_AutIsValid ( pAutomation ) ; 
   if ( SUCCESS == nRet) /* check the validity of the automation handle */ 
   { 
      nRet = L_ContainerIsValid ( pContainer ) ; 
      if ( SUCCESS == nRet) /* check the validity of the container handle */ 
      { 
         /* Remove the container from the automation */ 
         nRet = L_AutRemoveContainer ( pAutomation, pContainer ) ; 
         if(nRet != SUCCESS) 
            return nRet; 
 
         /* Free the container handle */ 
         L_ContainerFree ( pContainer ) ; 
 
         return SUCCESS ; 
      } 
      else 
      { 
         return nRet ; 
      } 
   } 
   else 
   { 
      return nRet ; 
   } 
} 

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Container and Automation C API Help