Share via


Gdi::TransparentImage_I (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

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 Value

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

Header gdi.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Gdi
TransparentImage
Gdi::StretchBlt_I
Gdi::MaskBlt_I