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

QCMINFO

構造体
サイズx64: 32 バイト / x86: 20 バイト

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

フィールド

フィールドサイズx64x86説明
hmenuHMENU8/4+0+0[in] 新しいコマンドを追加するメニューのハンドルです。
indexMenuDWORD4+8+4[in] 最初のメニュー項目を挿入する位置を示す、0 から始まるインデックスです。
idCmdFirstDWORD4+12+8[in, out] 入力時、このメンバーにはコンテキストメニューに使用できる最初の ID が格納されます。出力時には、追加された最後の ID に 1 を加えた値が格納されます。
idCmdLastDWORD4+16+12[in] メニュー項目識別子の最大値です。idCmdFirst の入力値と idCmdLast の差が、追加できるメニュー項目の最大数になります。
pIdMapQCMINFO_IDMAP*8/4+24+16使用されません。NULL でなければなりません。

公式ドキュメント

Windows Explorer のメニューにメニュー項目をマージするための情報を格納します。

解説(Remarks)

この構造体は IContextMenu::QueryContextMenu のパラメーターと同じ役割を果たすため、あわせて参照してください。ただし、そのメソッドの戻り値が提供する情報は、QCMINFO を伴う操作の戻り値が提供する情報と対応するものではない点に注意してください。

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

各言語での定義

#include <windows.h>

// QCMINFO  (x64 32 / x86 20 バイト)
typedef struct QCMINFO {
    HMENU hmenu;
    DWORD indexMenu;
    DWORD idCmdFirst;
    DWORD idCmdLast;
    QCMINFO_IDMAP* pIdMap;
} QCMINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct QCMINFO
{
    public IntPtr hmenu;
    public uint indexMenu;
    public uint idCmdFirst;
    public uint idCmdLast;
    public IntPtr pIdMap;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure QCMINFO
    Public hmenu As IntPtr
    Public indexMenu As UInteger
    Public idCmdFirst As UInteger
    Public idCmdLast As UInteger
    Public pIdMap As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class QCMINFO(ctypes.Structure):
    _fields_ = [
        ("hmenu", ctypes.c_void_p),
        ("indexMenu", wintypes.DWORD),
        ("idCmdFirst", wintypes.DWORD),
        ("idCmdLast", wintypes.DWORD),
        ("pIdMap", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct QCMINFO {
    pub hmenu: *mut core::ffi::c_void,
    pub indexMenu: u32,
    pub idCmdFirst: u32,
    pub idCmdLast: u32,
    pub pIdMap: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type QCMINFO struct {
	hmenu uintptr
	indexMenu uint32
	idCmdFirst uint32
	idCmdLast uint32
	pIdMap uintptr
}
type
  QCMINFO = record
    hmenu: Pointer;
    indexMenu: DWORD;
    idCmdFirst: DWORD;
    idCmdLast: DWORD;
    pIdMap: Pointer;
  end;
const QCMINFO = extern struct {
    hmenu: ?*anyopaque,
    indexMenu: u32,
    idCmdFirst: u32,
    idCmdLast: u32,
    pIdMap: ?*anyopaque,
};
type
  QCMINFO {.bycopy.} = object
    hmenu: pointer
    indexMenu: uint32
    idCmdFirst: uint32
    idCmdLast: uint32
    pIdMap: pointer
struct QCMINFO
{
    void* hmenu;
    uint indexMenu;
    uint idCmdFirst;
    uint idCmdLast;
    void* pIdMap;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; QCMINFO サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; hmenu : HMENU (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; indexMenu : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; idCmdFirst : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; idCmdLast : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pIdMap : QCMINFO_IDMAP* (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; QCMINFO サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; hmenu : HMENU (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; indexMenu : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; idCmdFirst : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; idCmdLast : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pIdMap : QCMINFO_IDMAP* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global QCMINFO
    #field intptr hmenu
    #field int indexMenu
    #field int idCmdFirst
    #field int idCmdLast
    #field intptr pIdMap
#endstruct

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