L_AutCreate

#include "ltaut.h"

L_LTAUT_API L_INT L_AutCreate(pAutomation, nMode, dwFlags)

pAUTOMATIONHANDLE pAutomation;

pointer to an automation handle

AUTOMATIONMODE nMode;

automation mode

L_UINT32 dwFlags;

reserved

Creates an automation handle.

Parameter

Description

pAutomation

Pointer to an automation handle.

nMode

An value that represents the automation mode to use when creating the automation handle, enumerated as AUTOMATION_MODE.

dwFlags

Reserved for future use. Use 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

L_AutInit must be called before calling this function.

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

See Also

Functions:

L_AutInit, L_AutFree

Topics:

Initializing, Creating and Freeing Automation Handles

Example

This example shows the minimum requirement to create a Vector Automation.

L_INT AutCreateExample(HWND hWnd, 
pAUTOMATIONHANDLE * ppAutomation, 
pTOOLBARHANDLE * ppToolbar) 
{ 
   L_INT nRet = SUCCESS; 
   if(*ppAutomation == NULL) 
   { 
      nRet = L_AutInit ( ppAutomation ); 
      if (SUCCESS == nRet ) /* initiate the automation */ 
      { 
         /* create the vector automation */ 
         nRet =  L_AutCreate ( *ppAutomation, AUTOMATION_MODE_VECTOR, 0 ); 
         if ( SUCCESS != nRet ) 
         { 
            MessageBox ( hWnd, TEXT("Error creating Vector Automation"), TEXT("Error:"), MB_ICONSTOP ) ; 
            L_AutFree ( ppAutomation ) ; 
            return nRet; 
         } 
      } 
      else 
      { 
         MessageBox ( hWnd, TEXT("Error Initializing Vector Automation"), TEXT("Error:"), MB_ICONSTOP ) ; 
         return nRet; 
      } 
   } 
   /* initiate the toolbar */ 
   if(*ppToolbar == NULL) 
   { 
      nRet = L_TBInit ( ppToolbar ); 
      if ( SUCCESS == nRet ) 
      { 
         POINT pt = { 0, 0 } ; 
         ClientToScreen ( hWnd, &pt ) ; 
         /* create the vector toolbar */ 
         nRet = L_TBCreate ( *ppToolbar, hWnd, TEXT("Vector "), TOOLBAR_VECTOR ) ; 
         if(nRet != SUCCESS) 
            return nRet; 
         /* set the toolbar position */ 
         nRet = L_TBSetPosition ( *ppToolbar, &pt, TOOLBAR_POSITION_TOP | TOOLBAR_POSITION_LEFT ) ; 
         if(nRet != SUCCESS) 
            return nRet; 
         /* set the toolbar visible */ 
         nRet = L_TBSetVisible ( *ppToolbar, TRUE ) ; 
         if(nRet != SUCCESS) 
            return nRet; 
      } 
      else 
      { 
         return nRet ; 
      } 
   } 
   /* set the automation toolbar */ 
   nRet = L_AutSetToolbar ( *ppAutomation, *ppToolbar ) ; 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Container and Automation C API Help