In This Topic ▼

LBitmapWindow::CopyFromClipboard

Summary

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

Syntax

#include "ltwrappr.h"

virtual L_INT LBitmapWindow::CopyFromClipboard(hWnd)

Parameters

HWND hWnd

Handle to the active window.

Returns

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

Example

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