AlphaBlend 函式 (wingdi.h)

發行項
08/27/2023

AlphaBlend函式會顯示具有透明或半透明圖元的點陣圖。

語法

BOOL AlphaBlend(
  [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] BLENDFUNCTION ftn
);

參數

[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] ftn

來源和目的地點陣圖的 Alpha 混合函數、要套用至整個來源點陣圖的全域 Alpha 值，以及來源點陣圖的格式資訊。來源和目的地混合函式目前僅限於AC_SRC_OVER。請參閱 BLENDFUNCTION 和 EMRALPHABLEND 結構。

傳回值

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

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

備註

如果來源矩形和目的地矩形的大小不相同，則會延展來源點陣圖以符合目的地矩形。如果使用 SetStretchBltMode 函式， iStretchMode 值會自動轉換為此函式的 COLORONCOLOR (也就是 BLACKONWHITE、WHITEONBLACK 和 HALFTONE 變更為 COLORONCOLOR) 。

目的地座標是使用目前為目的地裝置內容指定的轉換來轉換。來源座標是使用目前為來源裝置內容指定的轉換來轉換。

如果來源裝置內容識別增強的中繼檔裝置內容，則會發生錯誤 (，且函式會傳回 FALSE) 。

如果目的地和來源點陣圖沒有相同的色彩格式， AlphaBlend 會轉換來源點陣圖以符合目的地點陣圖。

AlphaBlend 不支援鏡像。如果來源或目的地的寬度或高度為負數，此呼叫將會失敗。

轉譯至印表機時，請先呼叫具有 SHADEBLENDCAPS 的 GetDeviceCaps ，以判斷印表機是否支援與 AlphaBlend混合。請注意，對於顯示 DC，支援所有混合作業，而且這些旗標代表作業是否加速。

如果來源和目的地是相同的表面，也就是說，它們都是螢幕或相同的記憶體點陣圖，而且來源和目的地矩形重迭，就會發生錯誤，而且函式會傳回 FALSE。

來源矩形必須完全位於來源介面內，否則會發生錯誤，而且函式會傳回 FALSE。

如果來源或目的地的寬度或高度為負數，AlphaBlend就會失敗。

BLENDFUNCTION的SourceConstantAlpha成員會指定整個來源點陣圖上要使用的 Alpha 透明度值。 SourceConstantAlpha值會與任何每圖元 Alpha 值結合。如果 SourceConstantAlpha 為 0，則會假設影像是透明的。將 SourceConstantAlpha 值設定為 255 (，表示當您只想要使用每圖元 Alpha 值時，影像不透明) 。

規格需求


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