typedef struct tagDISPANNOTATIONPROPS
{
L_UINT uStructSize;
COLORREF crAnnotationColor;
L_UINT bSimpleRuler;
L_BOOL bCreateFromCenter;
L_UINT uFlags;
COLORREF crForeColor;
} DISPANNOTATIONPROPS, * pDISPANNOTATIONPROPS;
The DISPANNOTATIONPROPS structure contains options for controlling the appearance and behavior of annotation objects.
Member | Description | |
uStructSize | Size of this structure in bytes, for versioning. Use the sizeof() function to calculate this value. | |
crAnnotationColor | COLORREF value that specified the annotation color. This color will be applied as the default color for the newly created annotation if uFlags was set to DCANNOTATION_APPLYCOLOR_FORNEW. | |
bSimpleRuler | Flags that indicates whether to show the tick marks on the annotation ruler or only show the two tick marks (at the beginning and the end). | |
bCreateFromCenter | Flag that indicates whether to show the annotation ruler with tick marks. Possible values are: | |
Value | Meaning | |
TRUE | The ruler will not have tick marks; it will be like a simple line. This is the default value. | |
FALSE | The ruler will have tick marks and gauges. |
uFlags | Flags the control the behavior of the annotation object. You can combine values together when appropriate by using a bitwise OR ( | ). Possible values are: | |
Flags that determine on which annotation object the new setting will be applied: | ||
Value | Meaning | |
DCANNOTATION_APPLYTO_SELECTED | [0x00000000] Apply on selected object. | |
DCANNOTATION_APPLYTO_ALLOBJECT | [0x00000010] Apply on objects that have the same type. (All rulers or all arrows). | |
DCANNOTATION_APPLYTO_ALL | [0x00000020] Apply on all annotation objects. | |
Flag that sets the options in this structure as the default options for the newly created annotation objects: | ||
Value | Meaning | |
DCANNOTATION_APPLYCOLOR_FORNEW | [0x00000100] The new setting will be the default setting for the annotation object that will be created. | |
crForeColor | Value that indicate the annotation object text color. |
This structure is used by L_DispContainerSetActionProperties and L_DispContainerGetActionProperties functions.
This structure is mainly used to change or retrieve the properties of the annotation objects, and it works only with the following actions:
CONTAINER_ACTION_ANNOTATION_RULER
CONTAINER_ACTION_ANNOTATION_ANGLE
CONTAINER_ACTION_ANNOTATION_TEXT
CONTAINER_ACTION_ANNOTATION_ARROW
CONTAINER_ACTION_ANNOTATION_RECTANGLE
CONTAINER_ACTION_ANNOTATION_ELLIPSE
CONTAINER_ACTION_ANNOTATION_HILITE