ホーム › UI.WindowsAndMessaging › UpdateLayeredWindow

UpdateLayeredWindow

関数

レイヤードウィンドウの位置や形状や不透明度を更新する。

DLLUSER32.dll呼出規約winapiSetLastErrorあり対応OSWindows 2000 以降

シグネチャ

// USER32.dll
#include <windows.h>

BOOL UpdateLayeredWindow(
    HWND hWnd,
    HDC hdcDst,   // optional
    POINT* pptDst,   // optional
    SIZE* psize,   // optional
    HDC hdcSrc,   // optional
    POINT* pptSrc,   // optional
    COLORREF crKey,
    BLENDFUNCTION* pblend,   // optional
    UPDATE_LAYERED_WINDOW_FLAGS dwFlags
);

パラメーター

名前	型	方向
hWnd	HWND	in
hdcDst	HDC	inoptional
pptDst	POINT*	inoptional
psize	SIZE*	inoptional
hdcSrc	HDC	inoptional
pptSrc	POINT*	inoptional
crKey	COLORREF	in
pblend	BLENDFUNCTION*	inoptional
dwFlags	UPDATE_LAYERED_WINDOW_FLAGS	in

戻り値の型: BOOL

各言語での呼び出し定義

// USER32.dll
#include <windows.h>

BOOL UpdateLayeredWindow(
    HWND hWnd,
    HDC hdcDst,   // optional
    POINT* pptDst,   // optional
    SIZE* psize,   // optional
    HDC hdcSrc,   // optional
    POINT* pptSrc,   // optional
    COLORREF crKey,
    BLENDFUNCTION* pblend,   // optional
    UPDATE_LAYERED_WINDOW_FLAGS dwFlags
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("USER32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool UpdateLayeredWindow(
    IntPtr hWnd,   // HWND
    IntPtr hdcDst,   // HDC optional
    IntPtr pptDst,   // POINT* optional
    IntPtr psize,   // SIZE* optional
    IntPtr hdcSrc,   // HDC optional
    IntPtr pptSrc,   // POINT* optional
    uint crKey,   // COLORREF
    IntPtr pblend,   // BLENDFUNCTION* optional
    uint dwFlags   // UPDATE_LAYERED_WINDOW_FLAGS
);

<DllImport("USER32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function UpdateLayeredWindow(
    hWnd As IntPtr,   ' HWND
    hdcDst As IntPtr,   ' HDC optional
    pptDst As IntPtr,   ' POINT* optional
    psize As IntPtr,   ' SIZE* optional
    hdcSrc As IntPtr,   ' HDC optional
    pptSrc As IntPtr,   ' POINT* optional
    crKey As UInteger,   ' COLORREF
    pblend As IntPtr,   ' BLENDFUNCTION* optional
    dwFlags As UInteger   ' UPDATE_LAYERED_WINDOW_FLAGS
) As Boolean
End Function

' hWnd : HWND
' hdcDst : HDC optional
' pptDst : POINT* optional
' psize : SIZE* optional
' hdcSrc : HDC optional
' pptSrc : POINT* optional
' crKey : COLORREF
' pblend : BLENDFUNCTION* optional
' dwFlags : UPDATE_LAYERED_WINDOW_FLAGS
Declare PtrSafe Function UpdateLayeredWindow Lib "user32" ( _
    ByVal hWnd As LongPtr, _
    ByVal hdcDst As LongPtr, _
    ByVal pptDst As LongPtr, _
    ByVal psize As LongPtr, _
    ByVal hdcSrc As LongPtr, _
    ByVal pptSrc As LongPtr, _
    ByVal crKey As Long, _
    ByVal pblend As LongPtr, _
    ByVal dwFlags As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

UpdateLayeredWindow = ctypes.windll.user32.UpdateLayeredWindow
UpdateLayeredWindow.restype = wintypes.BOOL
UpdateLayeredWindow.argtypes = [
    wintypes.HANDLE,  # hWnd : HWND
    wintypes.HANDLE,  # hdcDst : HDC optional
    ctypes.c_void_p,  # pptDst : POINT* optional
    ctypes.c_void_p,  # psize : SIZE* optional
    wintypes.HANDLE,  # hdcSrc : HDC optional
    ctypes.c_void_p,  # pptSrc : POINT* optional
    wintypes.DWORD,  # crKey : COLORREF
    ctypes.c_void_p,  # pblend : BLENDFUNCTION* optional
    wintypes.DWORD,  # dwFlags : UPDATE_LAYERED_WINDOW_FLAGS
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('USER32.dll')
UpdateLayeredWindow = Fiddle::Function.new(
  lib['UpdateLayeredWindow'],
  [
    Fiddle::TYPE_VOIDP,  # hWnd : HWND
    Fiddle::TYPE_VOIDP,  # hdcDst : HDC optional
    Fiddle::TYPE_VOIDP,  # pptDst : POINT* optional
    Fiddle::TYPE_VOIDP,  # psize : SIZE* optional
    Fiddle::TYPE_VOIDP,  # hdcSrc : HDC optional
    Fiddle::TYPE_VOIDP,  # pptSrc : POINT* optional
    -Fiddle::TYPE_INT,  # crKey : COLORREF
    Fiddle::TYPE_VOIDP,  # pblend : BLENDFUNCTION* optional
    -Fiddle::TYPE_INT,  # dwFlags : UPDATE_LAYERED_WINDOW_FLAGS
  ],
  Fiddle::TYPE_INT)

#[link(name = "user32")]
extern "system" {
    fn UpdateLayeredWindow(
        hWnd: *mut core::ffi::c_void,  // HWND
        hdcDst: *mut core::ffi::c_void,  // HDC optional
        pptDst: *mut POINT,  // POINT* optional
        psize: *mut SIZE,  // SIZE* optional
        hdcSrc: *mut core::ffi::c_void,  // HDC optional
        pptSrc: *mut POINT,  // POINT* optional
        crKey: u32,  // COLORREF
        pblend: *mut BLENDFUNCTION,  // BLENDFUNCTION* optional
        dwFlags: u32  // UPDATE_LAYERED_WINDOW_FLAGS
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("USER32.dll", SetLastError = true)]
public static extern bool UpdateLayeredWindow(IntPtr hWnd, IntPtr hdcDst, IntPtr pptDst, IntPtr psize, IntPtr hdcSrc, IntPtr pptSrc, uint crKey, IntPtr pblend, uint dwFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'USER32_UpdateLayeredWindow' -Namespace Win32 -PassThru
# $api::UpdateLayeredWindow(hWnd, hdcDst, pptDst, psize, hdcSrc, pptSrc, crKey, pblend, dwFlags)

#uselib "USER32.dll"
#func global UpdateLayeredWindow "UpdateLayeredWindow" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; UpdateLayeredWindow hWnd, hdcDst, varptr(pptDst), varptr(psize), hdcSrc, varptr(pptSrc), crKey, varptr(pblend), dwFlags   ; 戻り値は stat
; hWnd : HWND -> "sptr"
; hdcDst : HDC optional -> "sptr"
; pptDst : POINT* optional -> "sptr"
; psize : SIZE* optional -> "sptr"
; hdcSrc : HDC optional -> "sptr"
; pptSrc : POINT* optional -> "sptr"
; crKey : COLORREF -> "sptr"
; pblend : BLENDFUNCTION* optional -> "sptr"
; dwFlags : UPDATE_LAYERED_WINDOW_FLAGS -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "USER32.dll"
#cfunc global UpdateLayeredWindow "UpdateLayeredWindow" sptr, sptr, var, var, sptr, var, int, var, int
; res = UpdateLayeredWindow(hWnd, hdcDst, pptDst, psize, hdcSrc, pptSrc, crKey, pblend, dwFlags)
; hWnd : HWND -> "sptr"
; hdcDst : HDC optional -> "sptr"
; pptDst : POINT* optional -> "var"
; psize : SIZE* optional -> "var"
; hdcSrc : HDC optional -> "sptr"
; pptSrc : POINT* optional -> "var"
; crKey : COLORREF -> "int"
; pblend : BLENDFUNCTION* optional -> "var"
; dwFlags : UPDATE_LAYERED_WINDOW_FLAGS -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "USER32.dll"
#cfunc global UpdateLayeredWindow "UpdateLayeredWindow" sptr, sptr, sptr, sptr, sptr, sptr, int, sptr, int
; res = UpdateLayeredWindow(hWnd, hdcDst, varptr(pptDst), varptr(psize), hdcSrc, varptr(pptSrc), crKey, varptr(pblend), dwFlags)
; hWnd : HWND -> "sptr"
; hdcDst : HDC optional -> "sptr"
; pptDst : POINT* optional -> "sptr"
; psize : SIZE* optional -> "sptr"
; hdcSrc : HDC optional -> "sptr"
; pptSrc : POINT* optional -> "sptr"
; crKey : COLORREF -> "int"
; pblend : BLENDFUNCTION* optional -> "sptr"
; dwFlags : UPDATE_LAYERED_WINDOW_FLAGS -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; BOOL UpdateLayeredWindow(HWND hWnd, HDC hdcDst, POINT* pptDst, SIZE* psize, HDC hdcSrc, POINT* pptSrc, COLORREF crKey, BLENDFUNCTION* pblend, UPDATE_LAYERED_WINDOW_FLAGS dwFlags)
#uselib "USER32.dll"
#cfunc global UpdateLayeredWindow "UpdateLayeredWindow" intptr, intptr, var, var, intptr, var, int, var, int
; res = UpdateLayeredWindow(hWnd, hdcDst, pptDst, psize, hdcSrc, pptSrc, crKey, pblend, dwFlags)
; hWnd : HWND -> "intptr"
; hdcDst : HDC optional -> "intptr"
; pptDst : POINT* optional -> "var"
; psize : SIZE* optional -> "var"
; hdcSrc : HDC optional -> "intptr"
; pptSrc : POINT* optional -> "var"
; crKey : COLORREF -> "int"
; pblend : BLENDFUNCTION* optional -> "var"
; dwFlags : UPDATE_LAYERED_WINDOW_FLAGS -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL UpdateLayeredWindow(HWND hWnd, HDC hdcDst, POINT* pptDst, SIZE* psize, HDC hdcSrc, POINT* pptSrc, COLORREF crKey, BLENDFUNCTION* pblend, UPDATE_LAYERED_WINDOW_FLAGS dwFlags)
#uselib "USER32.dll"
#cfunc global UpdateLayeredWindow "UpdateLayeredWindow" intptr, intptr, intptr, intptr, intptr, intptr, int, intptr, int
; res = UpdateLayeredWindow(hWnd, hdcDst, varptr(pptDst), varptr(psize), hdcSrc, varptr(pptSrc), crKey, varptr(pblend), dwFlags)
; hWnd : HWND -> "intptr"
; hdcDst : HDC optional -> "intptr"
; pptDst : POINT* optional -> "intptr"
; psize : SIZE* optional -> "intptr"
; hdcSrc : HDC optional -> "intptr"
; pptSrc : POINT* optional -> "intptr"
; crKey : COLORREF -> "int"
; pblend : BLENDFUNCTION* optional -> "intptr"
; dwFlags : UPDATE_LAYERED_WINDOW_FLAGS -> "int"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	user32 = windows.NewLazySystemDLL("USER32.dll")
	procUpdateLayeredWindow = user32.NewProc("UpdateLayeredWindow")
)

// hWnd (HWND), hdcDst (HDC optional), pptDst (POINT* optional), psize (SIZE* optional), hdcSrc (HDC optional), pptSrc (POINT* optional), crKey (COLORREF), pblend (BLENDFUNCTION* optional), dwFlags (UPDATE_LAYERED_WINDOW_FLAGS)
r1, _, err := procUpdateLayeredWindow.Call(
	uintptr(hWnd),
	uintptr(hdcDst),
	uintptr(pptDst),
	uintptr(psize),
	uintptr(hdcSrc),
	uintptr(pptSrc),
	uintptr(crKey),
	uintptr(pblend),
	uintptr(dwFlags),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL

function UpdateLayeredWindow(
  hWnd: THandle;   // HWND
  hdcDst: THandle;   // HDC optional
  pptDst: Pointer;   // POINT* optional
  psize: Pointer;   // SIZE* optional
  hdcSrc: THandle;   // HDC optional
  pptSrc: Pointer;   // POINT* optional
  crKey: DWORD;   // COLORREF
  pblend: Pointer;   // BLENDFUNCTION* optional
  dwFlags: DWORD   // UPDATE_LAYERED_WINDOW_FLAGS
): BOOL; stdcall;
  external 'USER32.dll' name 'UpdateLayeredWindow';

result := DllCall("USER32\UpdateLayeredWindow"
    , "Ptr", hWnd   ; HWND
    , "Ptr", hdcDst   ; HDC optional
    , "Ptr", pptDst   ; POINT* optional
    , "Ptr", psize   ; SIZE* optional
    , "Ptr", hdcSrc   ; HDC optional
    , "Ptr", pptSrc   ; POINT* optional
    , "UInt", crKey   ; COLORREF
    , "Ptr", pblend   ; BLENDFUNCTION* optional
    , "UInt", dwFlags   ; UPDATE_LAYERED_WINDOW_FLAGS
    , "Int")   ; return: BOOL

●UpdateLayeredWindow(hWnd, hdcDst, pptDst, psize, hdcSrc, pptSrc, crKey, pblend, dwFlags) = DLL("USER32.dll", "bool UpdateLayeredWindow(void*, void*, void*, void*, void*, void*, dword, void*, dword)")
# 呼び出し: UpdateLayeredWindow(hWnd, hdcDst, pptDst, psize, hdcSrc, pptSrc, crKey, pblend, dwFlags)
# hWnd : HWND -> "void*"
# hdcDst : HDC optional -> "void*"
# pptDst : POINT* optional -> "void*"
# psize : SIZE* optional -> "void*"
# hdcSrc : HDC optional -> "void*"
# pptSrc : POINT* optional -> "void*"
# crKey : COLORREF -> "dword"
# pblend : BLENDFUNCTION* optional -> "void*"
# dwFlags : UPDATE_LAYERED_WINDOW_FLAGS -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。