Win32 API 日本語リファレンス
ホームSystem.Ole › OLEUICHANGEICONW

OLEUICHANGEICONW

構造体
サイズx64: 616 バイト / x86: 580 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
cbStructDWORD4+0+0この構造体のサイズをバイト単位で表す。
dwFlagsCHANGE_ICON_FLAGS4+4+4ダイアログの動作を制御するフラグ(CHANGE_ICON_FLAGS)である。
hWndOwnerHWND8/4+8+8ダイアログの親ウィンドウのハンドルである。
lpszCaptionLPWSTR8/4+16+12ダイアログのタイトルバー文字列(ワイド)である。NULL可。
lpfnHookLPFNOLEUIHOOK8/4+24+16ダイアログをカスタマイズするフックプロシージャである。NULL可。
lCustDataLPARAM8/4+32+20フックプロシージャへ渡すアプリ定義データである。
hInstanceHINSTANCE8/4+40+24カスタムテンプレートを含むモジュールのインスタンスハンドルである。
lpszTemplateLPWSTR8/4+48+28カスタムダイアログテンプレートのリソース名(ワイド)である。NULL可。
hResourceHRSRC8/4+56+32カスタムテンプレートのリソースハンドルである。NULL可。
hMetaPictHGLOBAL8/4+64+36選択されたアイコンを表すメタファイルピクチャのハンドル(入出力)である。
clsidGUID16+72+40アイコン候補を取得する対象オブジェクトのCLSIDである。
szIconExeWCHAR520+88+56アイコンを抽出するEXE/DLLのパス(ワイド文字バッファ)である。
cchIconExeINT4+608+576szIconExeバッファの文字数容量を表す。

各言語での定義

#include <windows.h>

// OLEUICHANGEICONW  (x64 616 / x86 580 バイト)
typedef struct OLEUICHANGEICONW {
    DWORD cbStruct;
    CHANGE_ICON_FLAGS dwFlags;
    HWND hWndOwner;
    LPWSTR lpszCaption;
    LPFNOLEUIHOOK lpfnHook;
    LPARAM lCustData;
    HINSTANCE hInstance;
    LPWSTR lpszTemplate;
    HRSRC hResource;
    HGLOBAL hMetaPict;
    GUID clsid;
    WCHAR szIconExe[260];
    INT cchIconExe;
} OLEUICHANGEICONW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OLEUICHANGEICONW
{
    public uint cbStruct;
    public uint dwFlags;
    public IntPtr hWndOwner;
    public IntPtr lpszCaption;
    public IntPtr lpfnHook;
    public IntPtr lCustData;
    public IntPtr hInstance;
    public IntPtr lpszTemplate;
    public IntPtr hResource;
    public IntPtr hMetaPict;
    public Guid clsid;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string szIconExe;
    public int cchIconExe;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OLEUICHANGEICONW
    Public cbStruct As UInteger
    Public dwFlags As UInteger
    Public hWndOwner As IntPtr
    Public lpszCaption As IntPtr
    Public lpfnHook As IntPtr
    Public lCustData As IntPtr
    Public hInstance As IntPtr
    Public lpszTemplate As IntPtr
    Public hResource As IntPtr
    Public hMetaPict As IntPtr
    Public clsid As Guid
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public szIconExe As String
    Public cchIconExe As Integer
End Structure
import ctypes
from ctypes import wintypes

class OLEUICHANGEICONW(ctypes.Structure):
    _fields_ = [
        ("cbStruct", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("hWndOwner", ctypes.c_void_p),
        ("lpszCaption", ctypes.c_void_p),
        ("lpfnHook", ctypes.c_void_p),
        ("lCustData", ctypes.c_ssize_t),
        ("hInstance", ctypes.c_void_p),
        ("lpszTemplate", ctypes.c_void_p),
        ("hResource", ctypes.c_void_p),
        ("hMetaPict", ctypes.c_void_p),
        ("clsid", GUID),
        ("szIconExe", ctypes.c_wchar * 260),
        ("cchIconExe", ctypes.c_int),
    ]
#[repr(C)]
pub struct OLEUICHANGEICONW {
    pub cbStruct: u32,
    pub dwFlags: u32,
    pub hWndOwner: *mut core::ffi::c_void,
    pub lpszCaption: *mut core::ffi::c_void,
    pub lpfnHook: *mut core::ffi::c_void,
    pub lCustData: isize,
    pub hInstance: *mut core::ffi::c_void,
    pub lpszTemplate: *mut core::ffi::c_void,
    pub hResource: *mut core::ffi::c_void,
    pub hMetaPict: *mut core::ffi::c_void,
    pub clsid: GUID,
    pub szIconExe: [u16; 260],
    pub cchIconExe: i32,
}
import "golang.org/x/sys/windows"

type OLEUICHANGEICONW struct {
	cbStruct uint32
	dwFlags uint32
	hWndOwner uintptr
	lpszCaption uintptr
	lpfnHook uintptr
	lCustData uintptr
	hInstance uintptr
	lpszTemplate uintptr
	hResource uintptr
	hMetaPict uintptr
	clsid windows.GUID
	szIconExe [260]uint16
	cchIconExe int32
}
type
  OLEUICHANGEICONW = record
    cbStruct: DWORD;
    dwFlags: DWORD;
    hWndOwner: Pointer;
    lpszCaption: Pointer;
    lpfnHook: Pointer;
    lCustData: NativeInt;
    hInstance: Pointer;
    lpszTemplate: Pointer;
    hResource: Pointer;
    hMetaPict: Pointer;
    clsid: TGUID;
    szIconExe: array[0..259] of WideChar;
    cchIconExe: Integer;
  end;
const OLEUICHANGEICONW = extern struct {
    cbStruct: u32,
    dwFlags: u32,
    hWndOwner: ?*anyopaque,
    lpszCaption: ?*anyopaque,
    lpfnHook: ?*anyopaque,
    lCustData: isize,
    hInstance: ?*anyopaque,
    lpszTemplate: ?*anyopaque,
    hResource: ?*anyopaque,
    hMetaPict: ?*anyopaque,
    clsid: GUID,
    szIconExe: [260]u16,
    cchIconExe: i32,
};
type
  OLEUICHANGEICONW {.bycopy.} = object
    cbStruct: uint32
    dwFlags: uint32
    hWndOwner: pointer
    lpszCaption: pointer
    lpfnHook: pointer
    lCustData: int
    hInstance: pointer
    lpszTemplate: pointer
    hResource: pointer
    hMetaPict: pointer
    clsid: GUID
    szIconExe: array[260, uint16]
    cchIconExe: int32
struct OLEUICHANGEICONW
{
    uint cbStruct;
    uint dwFlags;
    void* hWndOwner;
    void* lpszCaption;
    void* lpfnHook;
    ptrdiff_t lCustData;
    void* hInstance;
    void* lpszTemplate;
    void* hResource;
    void* hMetaPict;
    GUID clsid;
    wchar[260] szIconExe;
    int cchIconExe;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OLEUICHANGEICONW サイズ: 580 バイト(x86)
dim st, 145    ; 4byte整数×145(構造体サイズ 580 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : CHANGE_ICON_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hWndOwner : HWND (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lpszCaption : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpfnHook : LPFNOLEUIHOOK (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lCustData : LPARAM (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; hInstance : HINSTANCE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpszTemplate : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; hResource : HRSRC (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; hMetaPict : HGLOBAL (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; clsid : GUID (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; szIconExe : WCHAR (+56, 520byte)  varptr(st)+56 を基点に操作(520byte:入れ子/配列)
; cchIconExe : INT (+576, 4byte)  st.144 = 値  /  値 = st.144   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OLEUICHANGEICONW サイズ: 616 バイト(x64)
dim st, 154    ; 4byte整数×154(構造体サイズ 616 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : CHANGE_ICON_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hWndOwner : HWND (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lpszCaption : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpfnHook : LPFNOLEUIHOOK (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lCustData : LPARAM (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; hInstance : HINSTANCE (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lpszTemplate : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; hResource : HRSRC (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; hMetaPict : HGLOBAL (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; clsid : GUID (+72, 16byte)  varptr(st)+72 を基点に操作(16byte:入れ子/配列)
; szIconExe : WCHAR (+88, 520byte)  varptr(st)+88 を基点に操作(520byte:入れ子/配列)
; cchIconExe : INT (+608, 4byte)  st.152 = 値  /  値 = st.152   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global OLEUICHANGEICONW
    #field int cbStruct
    #field int dwFlags
    #field intptr hWndOwner
    #field intptr lpszCaption
    #field intptr lpfnHook
    #field intptr lCustData
    #field intptr hInstance
    #field intptr lpszTemplate
    #field intptr hResource
    #field intptr hMetaPict
    #field GUID clsid
    #field wchar szIconExe 260
    #field int cchIconExe
#endstruct

stdim st, OLEUICHANGEICONW        ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct