ANNROTATEOPTIONS

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

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

Member

Description

uStructSize

Size of this structure. Use sizeof(ANNROTATEOPTIONS).

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] bShowRotateHandles field is valid.

 

ANNROTATE_RESET_ROTATE_HANDLES

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

 

ANNROTATE_ALL

[3] Logical “or” of above flags – all fields are valid.

 

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 L_AnnSetRotateOptions and L_AnnGetRotateOptions to get or set the rotate options on any annotation object, including the automation object.

When calling L_AnnGetRotateOptions, the uFlags field identifies which fields to retrieve. When calling L_AnnSetRotateOptions, 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.

Example

For an example, refer to L_AnnGetRotateOptions.