GetLayeredWindowAttributes 函式 (winuser.h)

發行項
03/04/2024

擷取分層視窗的不透明和透明色鍵。

語法

BOOL GetLayeredWindowAttributes(
  [in]            HWND     hwnd,
  [out, optional] COLORREF *pcrKey,
  [out, optional] BYTE     *pbAlpha,
  [out, optional] DWORD    *pdwFlags
);

參數

[in] hwnd

類型： HWND

分層視窗的句柄。使用 CreateWindowEx 函式建立視窗時指定WS_EX_LAYERED，或在建立窗口之後使用 SetWindowLong 設定WS_EX_LAYERED，即可建立分層視窗。

[out, optional] pcrKey

類型： COLORREF*

COLORREF 值的指標，可接收組成分層視窗時要使用的透明度色彩索引鍵。此色彩中視窗所繪製的所有像素都會是透明的。如果不需要自變數，這可以是 NULL 。

[out, optional] pbAlpha

類型： BYTE*

用來描述分層視窗不透明度的 Alpha 值。類似於 BLENDFUNCTION 結構的 SourceConstantAlpha 成員。當 pbAlpha 所參考的變數為 0 時，視窗會完全透明。當 pbAlpha 所參考的變數為 255 時，視窗不透明。如果不需要自變數，這可以是 NULL 。

[out, optional] pdwFlags

類型： DWORD*

分層旗標。如果不需要值，這個參數可以是 NULL 。分層旗標可以是下列一或多個值。

值	意義
LWA_ALPHA 0x00000002	使用 pbAlpha 來判斷分層視窗的不透明度。
LWA_COLORKEY 0x00000001	使用 pcrKey 做為透明度色彩。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

只有在應用程式先前在視窗上呼叫 SetLayeredWindowAttributes 時，才能呼叫 GetLayeredWindowAttributes。如果使用 UpdateLayeredWindow 設定分層視窗，函式將會失敗。

如需詳細資訊，請參閱使用分層式 Windows。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-window-l1-1-1 (於 Windows 8.1)