Creates an automation handle.
#include "ltwrappr.h"
L_INT LAutomation::Create(nMode, dwFlags=0);
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. |
Reserved for future use. Use 0.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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.
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 ;
}