UpdateLayeredWindow函式更新一個分層視窗的位置，大小，形狀，內容和半透明度。
基本介紹
- 外文名：UpdateLayeredWindow
- 名稱：UpdateLayeredWindow
- 定義：Windows API函式
簡介,參數詳情,返回值,
簡介
The UpdateLayeredWindow function updates the position, size, shape, content, and translucency of a layered window.
UpdateLayeredWindow函式更新一個分層視窗的位置，大小，形狀，內容和半透明度。
函式原型
BOOL WINAPI UpdateLayeredWindow( _In_ HWND hwnd, _In_opt_ HDC hdcDst, _In_opt_ POINT *pptDst, _In_opt_ SIZE *psize, _In_opt_ HDC hdcSrc, _In_opt_ POINT *pptSrc, _In_ COLORREF crKey, _In_opt_ BLENDFUNCTION *pblend, _In_ DWORD dwFlags);
參數詳情
| 參數 | 類型 | 說明 |
|---|---|---|
hwnd | 一個分層視窗的句柄。分層視窗在用CreateWindowEx函式創建視窗時應指定WS_EX_LAYERED擴展樣式。 Windows 8： WS_EX_LAYERED擴展樣式支持頂級視窗和子視窗。之前的Windows版本中WS_EX_LAYERED擴展樣式僅支持頂級視窗 | |
hdcDst | 螢幕的設備上下文(DC)句柄。如果指定為NULL，那么將會在調用函式時自己獲得。它用來在視窗內容更新時與調色板顏色匹配。如果hdcDst為NULL，將會使用默認調色板。 如果hdcSrc指定為NULL，那么hdcDst必須指定為NULL。 | |
pptDst | POINT* | 指向分層視窗相對於螢幕的位置的POINT結構的指針。如果保持當前位置不變，pptDst可以指定為NULL。 |
psize | SIZE* | 指向分層視窗的大小的SIZE結構的指針。如果視窗的大小保持不變，psize可以指定為NULL。如果hdcSrc指定為NULL，psize必須指定為NULL。 |
hdcSrc | 分層視窗繪圖表面的設備上下文句柄。這個句柄可以通過調用函式CreateCompatibleDC獲得。如果視窗的形狀和可視範圍保持不變，hdcSrc可以指定為NULL。 | |
pptSrc | POINT* | 指向分層視窗繪圖表面在設備上下文位置的POINT結構的指針。如果hdcSrc指定為NULL，pptSrc就應該指定為NULL。 |
crKey | 指定合成分層視窗時使用的顏色值。要生成一個類型為COLORREF的值，使用RGB宏。 | |
pblend | 指向指定合成分層視窗時使用的透明度結構的指針。 | |
dwFlags | 可以是以下值之一。 如果hdcSrc指定為NULL，dwFlags應該指定為0。 |
| 值 | 意義 |
|---|---|
ULW_ALPHA 0x00000002 | 使用參數pblend作為混合函式,如果顯示模式為256色或低於256色，使用這個值實現的效果和使用ULW_OPAQUE的效果相同。 |
ULW_COLORKEY 0x00000001 | 使用參數crKey值作為透明顏色。 |
ULW_OPAQUE 0x00000004 | 繪製一個不透明的分層視窗。 |
返回值
類型：BOOL
如果函式執行成功，返回非零值。
如果函式執行失敗，返回值為0。調用GetLastError函式獲取更多錯誤信息。
