GdiTransparentBlt 函式 (wingdi.h)

發行項
08/27/2023

GdiTransparentBlt函式會執行與指定來源裝置內容圖元矩形相對應的色彩資料位區塊傳輸至目的地裝置內容。

注意此函式與 TransparentBlt相同。

語法

BOOL GdiTransparentBlt(
  [in] HDC  hdcDest,
  [in] int  xoriginDest,
  [in] int  yoriginDest,
  [in] int  wDest,
  [in] int  hDest,
  [in] HDC  hdcSrc,
  [in] int  xoriginSrc,
  [in] int  yoriginSrc,
  [in] int  wSrc,
  [in] int  hSrc,
  [in] UINT crTransparent
);

參數

[in] hdcDest

目的地裝置內容的控制碼。

[in] xoriginDest

目的地矩形左上角的 X 座標，以邏輯單位表示。

[in] yoriginDest

目的地矩形左上角的 Y 座標，以邏輯單位表示。

[in] wDest

目的地矩形的寬度，以邏輯單位表示。

[in] hDest

目的地矩形的高度，以邏輯單位表示。

[in] hdcSrc

來源裝置內容的控制碼。

[in] xoriginSrc

來源矩形的 X 座標，以邏輯單位表示。

[in] yoriginSrc

來源矩形的 Y 座標，以邏輯單位表示。

[in] wSrc

來源矩形的寬度，以邏輯單位表示。

[in] hSrc

來源矩形的高度，以邏輯單位表示。

[in] crTransparent

來源點陣圖中要視為透明的 RGB 色彩。

傳回值

如果函式成功，則傳回值為 TRUE。

如果函式失敗，傳回值為 FALSE。

備註

GdiTransparentBlt函式可與相容的點陣圖搭配運作， (DDB) 。

GdiTransparentBlt函式支援來源點陣圖的所有格式。不過，針對 32 個 bpp 點陣圖，它只會複製 Alpha 值。使用 AlphaBlend 來指定 32 位圖元點陣圖與透明度。

如果來源和目的地矩形的大小不相同，則會延展來源點陣圖以符合目的矩形。使用 SetStretchBltMode 函式時，BLACKONWHITE 和 WHITEONBLACK 的 iStretchMode 模式會轉換成 GdiTransparentBlt 函式的 COLORONCOLOR。

目的地裝置內容會指定目的地座標的轉換類型。來源裝置內容會指定來源座標的轉換類型。

如果來源或目的地的寬度或高度為負數，GdiTransparentBlt不會鏡像點陣圖。

在多個監視器系統中使用時， hdcSrc 和 hdcDest 都必須參考相同的裝置，否則函式將會失敗。若要在不同裝置的 DC 之間傳輸資料，請呼叫 GetDIBits，將記憶體點陣圖轉換成 DIB。若要向第二個裝置顯示 DIB，請呼叫 SetDIBits 或 StretchDIBits。

規格需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll