DFMICS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 |
| fMask | DWORD | 4 | +4 | +4 | 0、または pici が指す CMINVOKECOMMANDINFO 構造体あるいは CMINVOKECOMMANDINFOEX 構造体内のデータの扱い方を指定する、次のフラグの 1 つ以上。 CMIC_MASK_HOTKEYdwHotKey メンバーが有効です。 CMIC_MASK_ICON使用されません。 CMIC_MASK_FLAG_NO_UIIContextMenu::InvokeCommand の実装は、コマンドの実行中にユーザーインターフェイス要素 (エラーメッセージなど) を表示できなくなります。 CMIC_MASK_UNICODEpici が CMINVOKECOMMANDINFOEX 構造体を指す場合にのみ使用されます。ショートカットメニューハンドラーが ANSI 版のメンバーではなく lpVerbW、lpParametersW、lpTitleW、lpDirectoryW の各メンバーを使用することを示します。一部のショートカットメニューハンドラーは Unicode をサポートしていない可能性があるため、lpVerb、lpParameters、lpTitleW、lpDirectory の各メンバーにも有効な ANSI 文字列を渡してください。 CMIC_MASK_NO_CONSOLEショートカットメニューハンドラーが新しいプロセスを作成する必要がある場合、通常は新しいコンソールを作成します。CMIC_MASK_NO_CONSOLE フラグを設定すると、新しいコンソールの作成が抑止されます。 CMIC_MASK_FLAG_SEP_VDMこのフラグは、16 ビットの Windows ベースアプリケーションを参照する場合にのみ有効です。設定した場合、ショートカットが指すアプリケーションはプライベートな仮想 DOS マシン (VDM) 内で実行されます。「解説」を参照してください。 CMIC_MASK_ASYNCOKIContextMenu::InvokeCommand の実装は、呼び出しを処理するために新しいスレッドまたはプロセスを起動することができ、呼び出された関数の完了を待ってブロックする必要はありません。たとえば動詞が "delete" の場合、IContextMenu::InvokeCommand の呼び出しは、すべての項目が削除される前に戻ることがあります。これは助言的なものであるため、このフラグを指定する呼び出し側アプリケーションは、呼び出す動詞の実装を把握していない限り、この要求が尊重される保証はありません。 CMIC_MASK_NOASYNCWindows Vista 以降。 IContextMenu::InvokeCommand の実装は同期的であり、処理が完了する前に戻らないようにする必要があります。これは推奨事項であるため、このフラグを指定する呼び出し側アプリケーションは、呼び出す動詞の実装を把握していない限り、この要求が尊重される保証はありません。 CMIC_MASK_SHIFT_DOWNSHIFT キーが押されています。動詞が呼び出された後に変化している可能性のあるキーボードの現在の状態をポーリングする代わりに、これを使用してください。 CMIC_MASK_CONTROL_DOWNCTRL キーが押されています。動詞が呼び出された後に変化している可能性のあるキーボードの現在の状態をポーリングする代わりに、これを使用してください。 CMIC_MASK_FLAG_LOG_USAGEIContextMenu::InvokeCommand の実装が、「最近使ったドキュメント」メニューなどの機能のために、呼び出された項目を記録しておく場合があることを示します。 CMIC_MASK_NOZONECHECKSゾーンチェックを実行しません。このフラグにより、ShellExecuteEx は IAttachmentExecute によって設定されたゾーンチェックをバイパスできます。 CMIC_MASK_PTINVOKEpici が CMINVOKECOMMANDINFOEX 構造体を指す場合にのみ使用されます。ptInvoke メンバーが有効です。 |
| lParam | LPARAM | 8/4 | +8 | +8 | 選択されたメニューコマンドに対する追加の引数を格納する、null で終わる文字列へのポインター。このメンバーは NULL でもかまいません。 |
| idCmdFirst | DWORD | 4 | +16 | +12 | ハンドラーがメニュー項目の識別子として指定できる最小値。 |
| idDefMax | DWORD | 4 | +20 | +16 | ハンドラーがメニュー項目の識別子として指定できる最大値。 |
| pici | CMINVOKECOMMANDINFO* | 8/4 | +24 | +20 | CMINVOKECOMMANDINFO 構造体または CMINVOKECOMMANDINFO 構造体へのポインター。 |
| punkSite | IUnknown* | 8/4 | +32 | +24 | コンテキストメニューハンドラーのサイトへのポインター。 |
公式ドキュメント
DFM_INVOKECOMMANDEX で使用される追加の引数を格納します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DFMICS (x64 40 / x86 28 バイト)
typedef struct DFMICS {
DWORD cbSize;
DWORD fMask;
LPARAM lParam;
DWORD idCmdFirst;
DWORD idDefMax;
CMINVOKECOMMANDINFO* pici;
IUnknown* punkSite;
} DFMICS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DFMICS
{
public uint cbSize;
public uint fMask;
public IntPtr lParam;
public uint idCmdFirst;
public uint idDefMax;
public IntPtr pici;
public IntPtr punkSite;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DFMICS
Public cbSize As UInteger
Public fMask As UInteger
Public lParam As IntPtr
Public idCmdFirst As UInteger
Public idDefMax As UInteger
Public pici As IntPtr
Public punkSite As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class DFMICS(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("fMask", wintypes.DWORD),
("lParam", ctypes.c_ssize_t),
("idCmdFirst", wintypes.DWORD),
("idDefMax", wintypes.DWORD),
("pici", ctypes.c_void_p),
("punkSite", ctypes.c_void_p),
]#[repr(C)]
pub struct DFMICS {
pub cbSize: u32,
pub fMask: u32,
pub lParam: isize,
pub idCmdFirst: u32,
pub idDefMax: u32,
pub pici: *mut core::ffi::c_void,
pub punkSite: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type DFMICS struct {
cbSize uint32
fMask uint32
lParam uintptr
idCmdFirst uint32
idDefMax uint32
pici uintptr
punkSite uintptr
}type
DFMICS = record
cbSize: DWORD;
fMask: DWORD;
lParam: NativeInt;
idCmdFirst: DWORD;
idDefMax: DWORD;
pici: Pointer;
punkSite: Pointer;
end;const DFMICS = extern struct {
cbSize: u32,
fMask: u32,
lParam: isize,
idCmdFirst: u32,
idDefMax: u32,
pici: ?*anyopaque,
punkSite: ?*anyopaque,
};type
DFMICS {.bycopy.} = object
cbSize: uint32
fMask: uint32
lParam: int
idCmdFirst: uint32
idDefMax: uint32
pici: pointer
punkSite: pointerstruct DFMICS
{
uint cbSize;
uint fMask;
ptrdiff_t lParam;
uint idCmdFirst;
uint idDefMax;
void* pici;
void* punkSite;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DFMICS サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; fMask : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; lParam : LPARAM (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; idCmdFirst : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; idDefMax : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pici : CMINVOKECOMMANDINFO* (+20, 4byte) varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; punkSite : IUnknown* (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DFMICS サイズ: 40 バイト(x64)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; fMask : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; lParam : LPARAM (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; idCmdFirst : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; idDefMax : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pici : CMINVOKECOMMANDINFO* (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; punkSite : IUnknown* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DFMICS
#field int cbSize
#field int fMask
#field intptr lParam
#field int idCmdFirst
#field int idDefMax
#field intptr pici
#field intptr punkSite
#endstruct
stdim st, DFMICS ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize