LChange::ChangeToDDB

#include "ltwrappr.h"

static HBITMAP LChange::ChangeToDDB(hDC, pLBitmap)

HDC hDC;

handle to the device responsible for the conversion

LBitmapBase * pLBitmap;

pointer to the bitmap object

Changes an LBitmapBase object's internal LEAD bitmap handle to a Windows Device Dependent Bitmap (DDB). This function results in only one copy of the bitmap, and it invalidates the LEAD bitmap handle.

Parameter

Description

hDC

Handle to the device responsible for the conversion. The mapping mode of the device context must be MM_TEXT.

pLBitmap

Pointer to the bitmap object referencing the bitmap to change.

Returns

>0

HBITMAP.

0

An error occurred.

Comments

When you no longer need the DDB, you can free it using the Windows DeleteObject() function.

If this function fails, the return value is a NULL HBITMAP.  This can happen if the image is too large for the Windows API functions that LEADTOOLS uses internally.  To get more information about why the Windows API functions may have failed, you can use the Windows API GetLastError. 

/* Change the initial bitmap to a DDB */ 
hDDB = LChange::ChangeToDDB( hDC, &MyBitmap ); 
if(!hDDB) 
{ 
   DWORD dwRet = GetLastError(); 
   /* process the error code here */ 
}

Required DLLs and Libraries

LTDIS

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.

Help Version 20.0.2020.4.5
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help
Introduction
Version History
Getting Started
LEADTOOLS Raster Imaging Features
Redistributables/Files To Be Included With Your Application
Quick Reference
Tutorials
Classes and Member Functions
Summary of Features