LAutomation::Create

#include "ltwrappr.h"

L_INT LAutomation::Create(nMode, dwFlags=0);

AUTOMATIONMODE nMode;	/* automation mode */
L_UINT32 dwFlags;	/* reserved */

Creates an automation handle.

Parameter	Description
nMode	An integer value that represents the automation mode to use when creating the automation handle. Possible values are:
	Value	Meaning
	AUTOMATION_MODE_PAINT	Creates an automation handle for digital paint.
	AUTOMATION_MODE_VECTOR	Creates an automation handle for Vectors.
dwFlags	Reserved for future use. Use 0.

Returns

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

Comments

LAutomation::Initialize must be called before calling this function.

If vector viewing support is unlocked using L_SUPPORT_VECTOR_VIEW, this function will return ERROR_VECTOR_LOCKED, if nMode is set to AUTOMATION_MODE_VECTOR.

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:	LAutomation::Initialize, LAutomation::Free
Topics:	Initializing, Creating and Freeing Automation Handles

Example

This example shows the minimum requirements for creating a Vector Automation.

L_INT LAutomation_CreateExample( HWND hWnd , LAutomation & lauto, pTOOLBARHANDLE g_pToolbar, LToolbar & tlb) 
{
   UNREFERENCED_PARAMETER(g_pToolbar);
   L_INT nRet;
   nRet = lauto.Initialize ();
   if (SUCCESS == nRet ) /* initiate the automation */
   {
      /* create the vector automation */
      nRet = lauto.Create (AUTOMATION_MODE_VECTOR, 0 );
      if ( SUCCESS != nRet ) 
      {
         ::MessageBox ( hWnd, TEXT("Error creating Vector Automation"), TEXT("Error:"), MB_ICONSTOP ) ;
         nRet = lauto.Free() ;
         if(nRet != SUCCESS)
            return nRet;
         return nRet;
      }
   }
   else
   {
      ::MessageBox ( hWnd, TEXT("Error Initializing Vector Automation"), TEXT("Error:"), MB_ICONSTOP ) ;
      return nRet; 
   }
   /* initiate the toolbar */
   nRet = tlb.Initialize ();
   if ( SUCCESS == nRet )
   {
      POINT pt = { 0, 0 } ;
      ::ClientToScreen ( hWnd, &pt ) ;
      /* create the vector toolbar */
      nRet = tlb.Create (hWnd, TEXT("Vector Automation"), TOOLBAR_VECTOR ) ;
      if(nRet != SUCCESS)
         return nRet;
      /* set the toolbar position */
     nRet = tlb.SetPosition (&pt, TOOLBAR_POSITION_TOP | TOOLBAR_POSITION_LEFT ) ;
     if(nRet != SUCCESS)
        return nRet;
      /* set the toolbar visible */
      nRet = tlb.SetVisible (TRUE ) ;
      if(nRet != SUCCESS)
         return nRet;
   }
   else
   {
      return nRet ;
   }
   /* set the automation toolbar */
   nRet = lauto.SetToolbar (&tlb ) ;
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS ;
}