IE_SETFORMAT
Sets the
format of a stroke or a set of strokes in an ink edit control.
Parameters
wParam
Not used;
must be 0.
lParam
Address of a STRKFMT structure.
Return Value
Returns
IER_OK if successful; otherwise, returns one of the following:
|
Constant |
Description |
|
IER_ERROR |
Unknown
error. |
|
IER_PARAMERR |
wParam or lParam is invalid. Also returned when
there is an invalid stroke index and the IESF_STROKE option is specified in
the iesf member of the STRKFMT structure. |
|
IER_MEMERR |
A memory
error occurred. |
|
IER_SECURITY |
The control
has security protection disallowing the operation. |
|
IER_SELECTION |
No valid
selection with the IESF_SELECTION option in the iesf member of the STRKFMT structure. |
Comments
The stroke or
strokes indicated by the STRKFMT structure are modified as indicated and repainted
(unless drawing has been turned off using the IEDO_NONE bit in IE_SETDRAWOPTS).
The iesf
member of the STRKFMT structure contains the IESF_TIPCOLOR or
IESF_TIPWIDTH bit flags to selectively adjust the color or width attributes of
the ink. This allows setting only the color, for example, while leaving the
width unchanged. If the value in iesf has either IESF_TIPCOLOR or
IESF_TIPWIDTH set, the ink in the control adopts the new color or width given
in the rgb or bwidth members of the PENTIP structure identified in the
tip member of STRKFMT.
The caller
must initialize the cbSize member of the STRKFMT structure to sizeof( STRKFMT ) before
sending this message.
See Also