L_AnnCopyFromClipboard

#include "l_bitmap.h"

L_LTANN_API L_INT 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 and 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 and 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 2000 / XP/Vista.

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.