SetStrokeTableAttributes 

2.0     

Sets attributes of a stroke s class within an HPENDATA object. (The class is an entry in a table stored in the PENDATAHEADER1AOCX0 structure. Modifying the table entry affects all the strokes described by the entry.)

int SetStrokeTableAttributes( HPENDATA hpndt, UINT iTblEntry, LPARAM lParam, UINT uOption )

Parameters

hpndt

Handle to the HPENDATA object.

iTblEntry

Zero-based table index to the class entry in the pen data header.

lParam

A pointer to a structure (cast to the LPARAM type), or a byte, word, or doubleword value, depending on uOption. This parameter cannot be NULL.

uOption

Specifies the attributes to set. This parameter can be one of the following:

SSA_PENTIPTABLE

Set the pen-tip characteristics (color, width, nib) of the class of strokes specified by iTblEntry. lParam is a pointer to a PENTIP1AOCX_ structure. All the strokes sharing this entry in the stroke class table receive the new pen-tip attribute.

SSA_USERTABLE

Set the user value, if any, of the class of strokes specified by iTblEntry. lParam is a byte, word, or doubleword value, and the pen data must have been created with the corresponding size allocated for user values. All the strokes sharing this stroke class table entry receive the new user value.

Return Value

Returns PDR_OK if successful; otherwise, returns one of the following negative values:

Constant

Description

PDR_COMPRESSED

Pen data is compressed.

PDR_ERROR

Parameter or other unspecified error.

PDR_MEMERR

Memory error.

PDR_PNDTERR

Invalid pen data.

PDR_SCTERR

Stroke class table may be full, or related error.

PDR_VERSIONERR

Could not convert old pen data.

 

See Also

CreatePenDataEx, GetStrokeAttributes, GetStrokeTableAttributes, SetStrokeAttributes, PENTIP