共用方式為

BufferedPaintSetAlpha 函式 (uxtheme.h)

  • 發行項

將 Alpha 設定為指定矩形中的指定值。 Alpha 控制將緩衝區混合至目的地目標裝置內容時所套用的透明度量， (DC) 。

語法

HRESULT BufferedPaintSetAlpha(
       HPAINTBUFFER hBufferedPaint,
  [in] const RECT   *prc,
       BYTE         alpha
);

參數

hBufferedPaint

類型： HPAINTBUFFER

緩衝繪製內容的句柄，透過 BeginBufferedPaint 取得。

[in] prc

類型： const RECT*

RECT 結構的指標，指定要在其中設定 Alpha 的矩形。 將此參數設定為 NULL ，以指定整個緩衝區。

alpha

類型： BYTE

要設定的Alpha值。 Alpha 值的範圍可以從零 (完全透明) 到 255 (完全不透明) 。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此函式會設定目標矩形中每個圖元的Alpha值。 傳遞 Alpha 值為 255 會讓圖元完全不透明。 uxtheme.h 中定義的 BufferedPaintMakeOpaque 宏會將 Alpha 值設定為 255。 它通常用來呼叫 GDI 以繪製到記憶體緩衝區，然後讓它不透明，以便將其繪製在玻璃上。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 uxtheme.h
Dll UxTheme.dll