Audio Clip Annotation Object

(Document and Medical Imaging toolkits)

The audio clip annotation object (ANNOBJECT_AUDIO) is a rectangle containing a scaled image that can be activated to play a WAV file. With the automated functions, in design mode, the user clicks and drags to specify the rectangle in the current window. A dialog box then lets the user specify the WAV file. In run mode, clicking on the icon plays the WAV file.

For information on flipping, reversing or rotating annotation objects, refer to Flipping, Reversing and Rotating Annotation Objects.

When you save this type of annotation, the WAV file is not saved. Only its path, specified in the text property, is saved.

With low-level functions, you must specify the defining rectangle. Other applicable properties have the following defaults, which you can change:

Active state

Defaults to disabled. It can be changed using L_AnnSetActiveState.

Visible

Defaults to FALSE. It can be changed using L_AnnSetVisible.

Selected

Defaults to FALSE. It can be changed using L_AnnSetSelected.

Text

Defaults to an empty string. It can be changed to the path of the WAV file using L_AnnSetText.

Tag (identifier)

Defaults to 0. It can be changed using L_AnnSetTag.

Window handle

Defaults to NULL or the handle inherited from the container. It can be changed for all objects using L_AnnSetWnd.

User mode

Defaults to design mode or the mode inherited from the container. It can be changed for all objects using L_AnnSetUserMode.

Fixed State

Defaults to not fixed. It can be changed using L_AnnSetFixed.

Name

Defaults to empty string. It can be changed using L_AnnSetNameOptions.

Related topics:

Implementing Annotations.

Types of Annotations.

Low-Level Coordinate System for Annotations.

Annotation Objects - Automated Features