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 LImageViewerCell::SetActionProperties and LImageViewerCell::GetActionProperties
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