L_AnnCopyFromClipboard

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_AnnCopyFromClipboard(hWnd, phContainer)

HWND hWnd;

/* handle to the window for the container */

pHANNOBJECT phContainer;

/* handle to the annotation container object */

Copies an annotation object from the clipboard to a specified annotation container.

The data on the clipboard must be a LEAD annotation in native format.  This function is available in the Document/Medical Toolkits.

Parameter

Description

hWnd

Handle to the window for the container.

phContainer

Handle to the annotation container object.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

(Document/Medical) Before calling this function, you can use the L_AnnClipboardReady function to test the validity of data on the clipboard.

You can use L_AnnCopyToClipboard or L_AnnCutToClipboard to place valid annotation data on the clipboard.

For more information about loading and pasting automated annotations, refer to Loading and Pasting Automated Annotations.

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 95 / 98 / Me, Windows 2000 / XP.

See Also

Functions:

L_AnnCopy, L_AnnCopyToClipboard,

 

L_AnnCutToClipboard, L_AnnClipboardReady

Topics:

Annotation Functions: Creating and Deleting Annotations

 

Implementing Annotations

 

Implementing an Automated Annotation Program

 

Implementing a Non-automated Annotation Program

 

Using Rulers in Annotation Objects

Example

For an example, refer to L_AnnClipboardReady.

For complete sample code, refer to the ANNOTATE example.