Win32 API 日本語リファレンス
ホームUI.Shell › DEFCONTEXTMENU

DEFCONTEXTMENU

構造体
サイズx64: 72 バイト / x86: 36 バイト

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

フィールド

フィールドサイズx64x86説明
hwndHWND8/4+0+0コンテキストメニューのハンドルです。このメンバーには CreateMenu から返されたハンドルを設定します。
pcmcbIContextMenuCB*8/4+8+4コールバックオブジェクトがサポートする IContextMenuCB インターフェイスへのポインターです。この値は省略可能であり、NULL にすることができます。
pidlFolderITEMIDLIST*8/4+16+8選択されたファイルオブジェクトを含むフォルダーの PIDL です。ファイルオブジェクトが選択されていない場合は、コンテキストメニューのフォルダーの PIDL です。この値は省略可能であり、NULL にすることができます。その場合、PIDL は psf メンバーから計算されます。
psfIShellFolder*8/4+24+12選択されたファイルオブジェクトを含むフォルダーオブジェクト、またはファイルオブジェクトが選択されていない場合はコンテキストメニューを含むフォルダーの IShellFolder インターフェイスへのポインターです。
cidlDWORD4+32+16apidl メンバー内の項目数です。
apidlITEMIDLIST**8/4+40+20ITEMIDLIST 構造体の定数配列へのポインターです。配列の各エントリは、コンテキストメニューが適用される子項目 (たとえば、ユーザーが Open (開く) を実行しようとしている選択済みのファイル) を表します。
punkAssociationInfoIUnknown*8/4+48+24

拡張機能の読み込み元となるオブジェクトの IQueryAssociations インターフェイスへのポインターです。このパラメーターは省略可能であるため、NULL にすることができます。この値が NULL で、かつ aKeys メンバーと cKeys メンバーも NULL の場合 (「解説」を参照)、punkAssociationInfoIShellFolder::GetUIObjectOf を通じて IQueryAssociations を要求することにより、apidl メンバーと cidl メンバーから計算されます。

IShellFolder::GetUIObjectOfE_NOTIMPL を返す場合は、IShellFolder::GetAttributesOf から返される SFGAO_FOLDER 属性および SFGAO_FILESYSTEM 属性に基づく既定の実装が提供されます。

cKeysDWORD4+56+28

aKeys メンバー内の項目数です。この値は 0 にすることができます。値が 0 の場合、拡張機能は punkAssociationInfo メンバーで指定された、IQueryAssociations インターフェイスをサポートするオブジェクトに基づいて読み込まれます。値が NULL 以外の場合、拡張機能は aKeys メンバーのみに基づいて読み込まれ、punkAssociationInfo メンバーは使用されません。

注意 キーの最大数は 16 です。API はこの制限を強制しないため、呼び出し元がこの制限を守る必要があります。守らない場合、メモリ破損が発生する可能性があります。
aKeysHKEY*8/4+64+32拡張機能の読み込み元となるレジストリキーを指定する HKEY へのポインターです。このパラメーターは省略可能であり、NULL にすることができます。値が NULL の場合、拡張機能は punkAssociationInfo で指定された、IQueryAssociations インターフェイスをサポートするオブジェクトに基づいて読み込まれます。

公式ドキュメント

SHCreateDefaultContextMenu が使用するコンテキストメニュー情報を格納します。

解説(Remarks)

aKeys メンバーと cKeys メンバーが有効で、かつ punkAssociationInfo メンバーも有効 (NULL ではない) の場合、システムは aKeyscKeys の値を使用してメニューを構築し、punkAssociationInfo メンバー (IQueryAssociations) は無視します。

apidl メンバーと cidl メンバーは、IDataObject を取得するために IShellFolder::GetUIObjectOf メソッドのパラメーターとして使用できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// DEFCONTEXTMENU  (x64 72 / x86 36 バイト)
typedef struct DEFCONTEXTMENU {
    HWND hwnd;
    IContextMenuCB* pcmcb;
    ITEMIDLIST* pidlFolder;
    IShellFolder* psf;
    DWORD cidl;
    ITEMIDLIST** apidl;
    IUnknown* punkAssociationInfo;
    DWORD cKeys;
    HKEY* aKeys;
} DEFCONTEXTMENU;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DEFCONTEXTMENU
{
    public IntPtr hwnd;
    public IntPtr pcmcb;
    public IntPtr pidlFolder;
    public IntPtr psf;
    public uint cidl;
    public IntPtr apidl;
    public IntPtr punkAssociationInfo;
    public uint cKeys;
    public IntPtr aKeys;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DEFCONTEXTMENU
    Public hwnd As IntPtr
    Public pcmcb As IntPtr
    Public pidlFolder As IntPtr
    Public psf As IntPtr
    Public cidl As UInteger
    Public apidl As IntPtr
    Public punkAssociationInfo As IntPtr
    Public cKeys As UInteger
    Public aKeys As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DEFCONTEXTMENU(ctypes.Structure):
    _fields_ = [
        ("hwnd", ctypes.c_void_p),
        ("pcmcb", ctypes.c_void_p),
        ("pidlFolder", ctypes.c_void_p),
        ("psf", ctypes.c_void_p),
        ("cidl", wintypes.DWORD),
        ("apidl", ctypes.c_void_p),
        ("punkAssociationInfo", ctypes.c_void_p),
        ("cKeys", wintypes.DWORD),
        ("aKeys", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DEFCONTEXTMENU {
    pub hwnd: *mut core::ffi::c_void,
    pub pcmcb: *mut core::ffi::c_void,
    pub pidlFolder: *mut core::ffi::c_void,
    pub psf: *mut core::ffi::c_void,
    pub cidl: u32,
    pub apidl: *mut core::ffi::c_void,
    pub punkAssociationInfo: *mut core::ffi::c_void,
    pub cKeys: u32,
    pub aKeys: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DEFCONTEXTMENU struct {
	hwnd uintptr
	pcmcb uintptr
	pidlFolder uintptr
	psf uintptr
	cidl uint32
	apidl uintptr
	punkAssociationInfo uintptr
	cKeys uint32
	aKeys uintptr
}
type
  DEFCONTEXTMENU = record
    hwnd: Pointer;
    pcmcb: Pointer;
    pidlFolder: Pointer;
    psf: Pointer;
    cidl: DWORD;
    apidl: Pointer;
    punkAssociationInfo: Pointer;
    cKeys: DWORD;
    aKeys: Pointer;
  end;
const DEFCONTEXTMENU = extern struct {
    hwnd: ?*anyopaque,
    pcmcb: ?*anyopaque,
    pidlFolder: ?*anyopaque,
    psf: ?*anyopaque,
    cidl: u32,
    apidl: ?*anyopaque,
    punkAssociationInfo: ?*anyopaque,
    cKeys: u32,
    aKeys: ?*anyopaque,
};
type
  DEFCONTEXTMENU {.bycopy.} = object
    hwnd: pointer
    pcmcb: pointer
    pidlFolder: pointer
    psf: pointer
    cidl: uint32
    apidl: pointer
    punkAssociationInfo: pointer
    cKeys: uint32
    aKeys: pointer
struct DEFCONTEXTMENU
{
    void* hwnd;
    void* pcmcb;
    void* pidlFolder;
    void* psf;
    uint cidl;
    void* apidl;
    void* punkAssociationInfo;
    uint cKeys;
    void* aKeys;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DEFCONTEXTMENU サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; hwnd : HWND (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pcmcb : IContextMenuCB* (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pidlFolder : ITEMIDLIST* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; psf : IShellFolder* (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; cidl : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; apidl : ITEMIDLIST** (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; punkAssociationInfo : IUnknown* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; cKeys : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; aKeys : HKEY* (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DEFCONTEXTMENU サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; hwnd : HWND (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pcmcb : IContextMenuCB* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pidlFolder : ITEMIDLIST* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; psf : IShellFolder* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; cidl : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; apidl : ITEMIDLIST** (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; punkAssociationInfo : IUnknown* (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; cKeys : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; aKeys : HKEY* (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DEFCONTEXTMENU
    #field intptr hwnd
    #field intptr pcmcb
    #field intptr pidlFolder
    #field intptr psf
    #field int cidl
    #field intptr apidl
    #field intptr punkAssociationInfo
    #field int cKeys
    #field intptr aKeys
#endstruct

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