References ▼
#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 ;}}