Share via

Gdi::TransparentImage_I

  • Article

This method transfers a bitmap, omitting the portions drawn in a specified color.

static WINGDIAPI BOOL WINAPI TransparentImage_I(
  HDC hdcDest,
  int DstX,
  int DstY,
  int DstCx,
  int DstCy,
  HANDLE hSrc,
  int SrcX,
  int SrcY,
  int SrcCx,
  int SrcCy,
  COLORREF TransparentColor
);

Parameters

  • hdcDest
    [in] Handle to a device context.
  • DstX
    [in] Integer that specifies the x-coordinate, in logical units, of the upper-left corner of the destination rectangle.
  • DstY
    [in] Integer that specifies the y-coordinate, in logical units, of the upper-left corner of the destination rectangle.
  • DstCx
    [in] Integer that specifies the width, in logical units, of the destination rectangle.
  • DstCy
    [in] Integer that specifies the height, in logical units, of the destination rectangle.
  • hSrc
    [in] Handle to a source device context or a source bitmap.
  • SrcX
    [in] Integer that specifies the x-coordinate, in logical units, of the upper-left corner of the source rectangle.
  • SrcY
    [in] Integer that specifies the y-coordinate, in logical units, of the upper-left corner of the source rectangle.
  • SrcCx
    [in] Integer that specifies the width, in logical units, of the source rectangle.
  • SrcCy
    [in] Integer that specifies the height, in logical units, of the source rectangle.
  • TransparentColor
    [in] COLORREF value that indicates the color in the bitmap that will be rendered transparent.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

This method is an internal version of the TransparentImage function.

If the hSrc parameter is a HBITMAP, that bitmap must not be selected into a device context at the time Gdi::TransparentImage_I is called.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gdi.hpp.

See Also

TransparentImage | Gdi::StretchBlt_I | Gdi::MaskBlt_I

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.