#include ltaut.h
L_LTAUT_API L_INT L_AutSetPaintProperty(pAutomation, nGroup, pProperty)
Sets the digital paint automation properties.
Pointer to an automation handle.
Indicates the paint properties to set and the structure pointed to by pProperty. Possible values are:
Value | Meaning |
---|---|
PAINT_GROUP_BRUSH | Set the Paintbrush properties. pProperty points to a PAINTBRUSH structure. |
PAINT_GROUP_SHAPE | Set the Paint shape properties. pProperty points to a PAINTSHAPE structure. |
PAINT_GROUP_REGION | Set the Paint region properties. pProperty points to a PAINTREGION structure. |
PAINT_GROUP_FILL | Set the Paint fill properties. pProperty points to a PAINTFILL structure. |
PAINT_GROUP_TEXT | Set the Paint fill properties. pProperty points to a PAINTTEXT structure. |
Pointer to a PAINTXXX structure to be updated with the specified property values. The type of structure that this parameter points to is indicated by the nGroup parameter.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
Note: This function is only available in the Digital Paint toolkits.
This function will only work if the automation handle was created using the AUTOMATION_MODE_PAINT automation mode. For information on creating an automation handle, refer to L_AutCreate.
Required DLLs and Libraries
This example shows how to change the paint shape properties.
L_INT AutSetPaintPropertyExample(pAUTOMATIONHANDLE pAutomation)
{
L_INT nRet;
nRet = L_AutIsValid ( pAutomation );
if ( SUCCESS == nRet ) /* check the validity of the automation handle */
{
PAINTSHAPE shape ;
/* set the paint shape group properties */
nRet = L_AutGetPaintProperty ( pAutomation, PAINT_GROUP_SHAPE, &shape ) ;
if(nRet != SUCCESS)
return nRet;
/* do some check and change to the required properties */
if (PAINT_SHAPE_BORDER_STYLE_SOLID == shape.nBorderStyle )
{
/* set the desired shape properties using the field masks */
shape.nSize = sizeof ( PAINTSHAPE ) ;
shape.dwMask = PSF_BORDERSTYLE |
PSF_BORDERWIDTH |
PSF_BORDERENDCAP;
shape.nBorderStyle = PAINT_SHAPE_BORDER_STYLE_DOT ;
shape.nBorderWidth = 10 ;
shape.nBorderEndCap = PAINT_SHAPE_BORDER_ENDCAP_ROUND ;
/*set the paint shape group properties */
nRet = L_AutSetPaintProperty ( pAutomation, PAINT_GROUP_SHAPE, &shape ) ;
if(nRet != SUCCESS)
return nRet;
}
return SUCCESS ;
}
else
{
return nRet ;
}
}