Sets the DigitalPaint automation properties. This function is only available in the Digital Paint toolkits.
#include "Ltwrappr.h"
L_INT LAutomation::SetPaintProperty(nGroup, pProperty)
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. |
This function will only work when the automation mode is AUTOMATION_MODE_PAINT.
This example shows how to change the paint shape properties.
L_INT LAutomation_SetPaintPropertyExample( LAutomation &Automation )
{
L_INT nRet;
nRet = Automation.IsValid ();
if ( SUCCESS == nRet ) /* check the validity of the automation handle */
{
PAINTSHAPE shape ;
/* set the paint shape group properties */
nRet = Automation.GetPaintProperty (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 = Automation.SetPaintProperty (PAINT_GROUP_SHAPE, &shape ) ;
if(nRet != SUCCESS)
return nRet;
}
}
else
{
return nRet ;
}
return SUCCESS ;
}