ANNROTATEOPTIONS (Document/Medical only)

typedef struct tagANNROTATEOPTIONS
{
   L_UINT uStructSize; 
   L_UINT uFlags; 
   L_BOOL bShowRotateHandles; 
   L_INT32 nReserved; 
} ANNROTATEOPTIONS, L_FAR *pANNROTATEOPTIONS;

The ANNROTATEOPTIONS structure contains information about the rotation options for a specific annotation object.

Member

Description

uStructSize

Size of the ANNROTATEOPTIONS structure. This should be sizeof(ANNROTATEOPTIONS). You must fill this member.

uFlags

Flag that identifies which fields are valid, or to execute an operation that does not depend on a field. Possible values are one or more of the following constants you can combine values together when appropriate by using a bitwise OR ( | ). Possible values are:

 

Value

Meaning

 

ANNROTATE_SHOW_ROTATE_HANDLES

[1] The bShowRotateHandles field is valid.

 

ANNROTATE_RESET_ROTATE_HANDLES

[2] Reset the rotate handles to the original orientation.

bShowRotateHandles

Flag that indicates whether to show or hide the annotation rotate handles. Possible values are:

 

Value

Meaning

 

TRUE

Show the annotation object rotate handles.

 

FALSE

Hide the annotation object rotate handles.

nReserved

Reserved for future use. Use zero.

Comments

The ANNROTATEOPTIONS structure is used with the functions LAnnotation::SetRotateOptions and LAnnotation::GetRotateOptions to get or set the rotate options on any annotation object, including the automation object.

When calling LAnnotation::GetRotateOptions, the uFlags field identifies which fields to retrieve. When calling LAnnotation::SetRotateOptions, the uFlags field identifies which fields to set, or in the case of the flag ANNROTATE_RESET_ROTATE_HANDLES, causes the annotation object to reset the rotate handles to the original orientation.

When you create an object in the automation mode, the value for bShowRotateHandles is taken from the automation object.

The default value for bShowRotateHandles is FALSE, which means that the objects will not show rotate handles when selected.

This structure is used with two of the new functions being introduced as part of Version 14.5.