AnnGetMetafile method (Annotation Control)

Builder Syntax	int AnnGetMetafile(HANNOBJECT hObject, unsigned &hFile)
Delphi Syntax	Function AnnGetMetafile(hObject: HANNOBJECT; var hFile: HMETAFILE): L_INT
Overview	Refer to Implementing Annotations.

Remarks

(Document/Medical only) Retrieves the metafile handle associated with an object.

The AnnGetMetafile method is valid only for the following object types:

ANNOBJECT_ENCRYPT

ANNOBJECT_FREEHANDHOTSPOT

ANNOBJECT_HOTSPOT

ANNOBJECT_STAMP

The ANNOBJECT_STAMP objects (which include the Rubber Stamp tools) can display text, a bitmap or a metafile. Only one of these three can be displayed at any time—setting the object to one of these destroys any settings for the other two.

Initially, the ANNOBJECT_STAMP object displays text. The difference between the Stamp and the Rubber Stamp is that initially whereas the Stamp does not display an image, the Rubber Stamp tools are set to display different metafiles (one for each rubber stamp selection).

Initially, the Hotspot, Freehand Hotspot, and Encrypt objects are also set to display predefined metafiles.

Use the AnnGetMetafile method to retrieve a metafile for an object. Use the AnnSetMetafile method to change the metafile for an object. Any new objects will still get the default metafile.

Elements:	AnnSetMetafile method, AnnSetPredefinedMetafile method, AnnGetPredefinedMetafile method, AnnGetEncryptOptions method, AnnSetEncryptOptions method, AnnEncryptApply method, AnnGetSecondaryMetafile method, AnnPredefinedBitmap property, AnnGetPointOptions method, AnnEncryptOptions property, AnnSetBitmap method, AnnSetSecondaryBitmap method, AnnGetSecondaryBitmap method, EncryptBitmap property, AnnPointOptions property, PointUseBitmap property, PointBitmap property
Topics:	Annotations (Document/Medical only): Object Bitmap
	Using Annotation Object Bitmaps
	Obtaining Annotation Object Information