Collapse All Expand All

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 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.

Platforms

Win32, x64.

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;
}