Share via

TransparentBlt

  • Article

This function performs a bit-block transfer of the color data corresponding to a rectangle of pixels from the specified source device context into a destination device context.

BOOL TransparentBlt(
  HDC hdcDest,
  int nXOriginDest,
  int nYOriginDest,
  int nWidthDest,
  int hHeightDest,
  HDC hdcSrc,
  int nXOriginSrc,
  int nYOriginSrc,
  int nWidthSrc,
  int nHeightSrc,
  UINT crTransparent
);

Parameters

  • hdcDest
    [in] Handle to the destination device context.
  • nXOriginDest
    [in] Specifies the x-coordinate, in logical units, of the upper-left corner of the destination rectangle.
  • nYOriginDest
    [in] Specifies the y-coordinate, in logical units, of the upper-left corner of the destination rectangle.
  • nWidthDest
    [in] Specifies the width, in logical units, of the destination rectangle.
  • hHeightDest
    [in] Handle to the height, in logical units, of the destination rectangle.
  • hdcSrc
    [in] Handle to the source device context or a source bitmap handle.
  • nXOriginSrc
    [in] Specifies the x-coordinate, in logical units, of the source rectangle.
  • nYOriginSrc
    [in] Specifies the y-coordinate, in logical units, of the source rectangle.
  • nWidthSrc
    [in] Specifies the width, in logical units, of the source rectangle.
  • nHeightSrc
    [in] Specifies the height, in logical units, of the source rectangle.
  • crTransparent
    [in] Indicates that the RGB color in the source bitmap to treat as transparent.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

To get extended error information, call GetLastError.

Remarks

The TransparentBlt function is a wrapper for the TransparentImage function.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

TransparentImage | SetDIBitsToDevice | StretchDIBits | Creating Bitmaps | GDI Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.