LBitmapWindow::CopyFromClipboard

#include "ltwrappr.h"

virtual L_INT LBitmapWindow::CopyFromClipboard(hWnd)

HWND hWnd;

/* handle to the active window. */

Copies image data from the clipboard to a specified bitmap. The image on the clipboard must be a DIB, DDB, or a WMF.

Parameter

Description

hWnd

Handle to the active window.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

If the bitmap window object already has an allocated bitmap, then the bitmap that is pasted from the clipboard will be pasted as a floater for the displayed bitmap. If the bitmap window does not have an allocated bitmap, then the bitmap that is pasted from the clipboard will become the main displayed image.

The class objects bitmap is referenced by the pointer to the bitmap handle. The bitmap will contain the same width, height, and bits per pixel as the image contained in the clipboard. The color order field in the bitmap handle will be set to ORDER_BGR. If the copied image is not in BGR order, it is up to you to change its color order using LBitmapBase::ColorRes.

Required DLLs and Libraries

LTDIS
LTDLG
LTEFX
LTFIL
LTIMG
LTISI
LTSCR
LTTWN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

Class Members

Topics:

Using DIBs, DDBs, and the Clipboard

Example

L_INT LBitmapWindow__CopyFromClipboardExample(LBitmapWindow& MyBitmap,HWND hWnd)
{
   L_INT nRet = FAILURE ;
   if(MyBitmap.IsClipboardReady())
      nRet = MyBitmap.CopyFromClipboard(hWnd);
   return nRet;
}