Audio Clip Annotation Object

Note:

This topic is for Document/Medical only.

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.

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

You cannot flip, reverse, or rotate an audio clip. If you flip, reverse, or rotate a container that includes an audio clip, the object will move to the new position, but will retain its orientation.

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

Name

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

Visible

Defaults to FALSE. It can be changed using the AnnSetVisible method.

Selected

Defaults to FALSE. It can be changed using the AnnSetSelected method.

Text

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

Tag (identifier)

Defaults to 0. It can be changed using the AnnSetTag method.

Window handle

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

User mode

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

Fixed State

Defaults to not fixed. It can be changed using the AnnFixed property

Related topics:

image\sqrblit.gif Implementing Annotations.

image\sqrblit.gif Types of Annotations.

image\sqrblit.gif Low-Level Coordinate System for Annotations.