L_AutSetActiveContainer

Summary

Sets the active automation container.

Syntax

#include "ltaut.h"

L_LTAUT_API L_INT L_AutSetActiveContainer(pAutomation, pContainer)

Parameters

pAUTOMATIONHANDLE pAutomation

Pointer to an automation handle.

pCONTAINERHANDLE pContainer

Pointer to the container handle that references the container to be activated.

Returns

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

Comments

The container being set must exist in the automation container list. To add a container to the automation container list, call L_AutAddContainer.

Required DLLs and Libraries

See Also

Functions

Topics

Example

This example shows how to set the automation active container.

L_INT AutSetActiveContainerExample(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 */ 
      { 
         pCONTAINERHANDLE pActiveContainer ; 
 
         /* get the current active container */ 
         nRet = L_AutGetActiveContainer ( pAutomation, &pActiveContainer ) ; 
         if(nRet != SUCCESS) 
            return nRet; 
 
         if ( pContainer != pActiveContainer ) /* if the new container is not currently active */ 
         { 
            /* set the new active container */ 
            nRet = L_AutSetActiveContainer ( pAutomation, pContainer ) ; 
            if(nRet != SUCCESS) 
               return nRet; 
         } 
         return SUCCESS ; 
      } 
      else 
      { 
         return nRet ; 
      } 
   } 
   else 
   { 
      return nRet ; 
   } 
} 

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

LEADTOOLS Container and Automation C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.