L_AnnSetUserMode

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnSetUserMode(hObject, uMode)

HANNOBJECT hObject;

/* handle to the root container */

L_UINT uMode;

/* constant that specifies the user mode */

Sets the user mode for all objects. Design mode is for creating objects; run mode is for viewing them.

This function is available in the Document and Medical Imaging toolkits.

Parameter

Description

hObject

Handle to the root container.

uMode

The constant that specifies the user mode. Possible values are:

 

Value

Meaning

 

ANNUSER_DESIGN

[0] Design mode. Used for creating objects.

 

ANNUSER_RUN

[1] Run mode. Used for viewing or activating objects.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

You set this property on the root container, and all objects in the container inherit the property.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista.

See Also

Functions:

L_AnnGetUserMode

Topics:

Annotation Functions: Global Properties

 

Implementing Annotations

 

Implementing an Automated Annotation Program

 

Implementing a Non-automated Annotation Program

 

Altering Annotation Object Settings

Example

For an example, refer to Implementing an Automated Annotation Program. For complete sample code, refer to the ANNOTATE example. example.