MSGBOXPARAMSW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 構造体のサイズ (バイト単位)。 |
| hwndOwner | HWND | 8/4 | +8 | +4 | オーナーウィンドウへのハンドル。このメンバーは NULL でもかまいません。 |
| hInstance | HINSTANCE | 8/4 | +16 | +8 | lpszIcon メンバーで識別されるアイコンリソース、および lpszText または lpszCaption メンバーで識別される文字列リソースを含むモジュールへのハンドル。 |
| lpszText | LPWSTR | 8/4 | +24 | +12 | 表示するメッセージを含む、null で終わる文字列、または文字列リソースの識別子。 |
| lpszCaption | LPWSTR | 8/4 | +32 | +16 | メッセージボックスのタイトルを含む、null で終わる文字列、または文字列リソースの識別子。このメンバーが NULL の場合、既定のタイトルである Error が使用されます。 |
| dwStyle | MESSAGEBOX_STYLE | 4 | +40 | +20 | ダイアログボックスの内容と動作。このメンバーには、MessageBoxEx 関数の uType パラメーターについて説明されているフラグの組み合わせを指定できます。 さらに、lpszIcon メンバーで指定したアイコンをメッセージボックスに表示する場合は、MB_USERICON フラグ (0x00000080L) を指定できます。 |
| lpszIcon | LPWSTR | 8/4 | +48 | +24 | アイコンリソースを識別します。このパラメーターには、null で終わる文字列、または MAKEINTRESOURCE マクロに渡す整数のリソース識別子のいずれかを指定できます。 標準のシステム定義アイコンのいずれかを読み込むには、hInstance メンバーを NULL に設定し、lpszIcon に LoadIcon 関数で挙げられている値のいずれかを設定します。 dwStyle メンバーで MB_USERICON フラグが指定されていない場合、このメンバーは無視されます。 |
| dwContextHelpId | UINT_PTR | 8/4 | +56 | +28 | ヘルプコンテキストを識別します。ヘルプイベントが発生すると、この値は、メッセージボックスがオーナーウィンドウまたはコールバック関数に送信する HELPINFO 構造体に格納されます。 |
| lpfnMsgBoxCallback | MSGBOXCALLBACK | 8/4 | +64 | +32 | メッセージボックスのヘルプイベントを処理するコールバック関数へのポインター。コールバック関数の形式は次のとおりです。
このメンバーが NULL の場合、ヘルプイベントが発生すると、メッセージボックスはオーナーウィンドウに WM_HELP メッセージを送信します。 |
| dwLanguageId | DWORD | 4 | +72 | +36 | 定義済みのプッシュボタンに含まれるテキストを表示する言語。この値は、MAKELANGID マクロが返す形式でなければなりません。 サポートされる言語識別子の一覧については、言語識別子を参照してください。なお、ローカライズされた各 Windows リリースには、通常、限られた言語セットのリソースしか含まれていません。たとえば、米国版では LANG_ENGLISH、フランス語版では LANG_FRENCH、ドイツ語版では LANG_GERMAN、日本語版では LANG_JAPANESE が提供されます。いずれの版でも LANG_NEUTRAL は提供されます。このため、dwLanguageId パラメーターで使用できる値は制限されます。言語識別子を指定する前に、システムにインストールされているロケールを列挙してください。 |
公式ドキュメント
メッセージボックスの表示に使用される情報を格納します。MessageBoxIndirect 関数はこの構造体を使用します。
解説(Remarks)
winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして MSGBOXPARAMS を定義します。エンコーディングに依存しないエイリアスの使用と、エンコーディングに依存するコードとを混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// MSGBOXPARAMSW (x64 80 / x86 40 バイト)
typedef struct MSGBOXPARAMSW {
DWORD cbSize;
HWND hwndOwner;
HINSTANCE hInstance;
LPWSTR lpszText;
LPWSTR lpszCaption;
MESSAGEBOX_STYLE dwStyle;
LPWSTR lpszIcon;
UINT_PTR dwContextHelpId;
MSGBOXCALLBACK lpfnMsgBoxCallback;
DWORD dwLanguageId;
} MSGBOXPARAMSW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MSGBOXPARAMSW
{
public uint cbSize;
public IntPtr hwndOwner;
public IntPtr hInstance;
public IntPtr lpszText;
public IntPtr lpszCaption;
public uint dwStyle;
public IntPtr lpszIcon;
public UIntPtr dwContextHelpId;
public IntPtr lpfnMsgBoxCallback;
public uint dwLanguageId;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MSGBOXPARAMSW
Public cbSize As UInteger
Public hwndOwner As IntPtr
Public hInstance As IntPtr
Public lpszText As IntPtr
Public lpszCaption As IntPtr
Public dwStyle As UInteger
Public lpszIcon As IntPtr
Public dwContextHelpId As UIntPtr
Public lpfnMsgBoxCallback As IntPtr
Public dwLanguageId As UInteger
End Structureimport ctypes
from ctypes import wintypes
class MSGBOXPARAMSW(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("hwndOwner", ctypes.c_void_p),
("hInstance", ctypes.c_void_p),
("lpszText", ctypes.c_void_p),
("lpszCaption", ctypes.c_void_p),
("dwStyle", wintypes.DWORD),
("lpszIcon", ctypes.c_void_p),
("dwContextHelpId", ctypes.c_size_t),
("lpfnMsgBoxCallback", ctypes.c_void_p),
("dwLanguageId", wintypes.DWORD),
]#[repr(C)]
pub struct MSGBOXPARAMSW {
pub cbSize: u32,
pub hwndOwner: *mut core::ffi::c_void,
pub hInstance: *mut core::ffi::c_void,
pub lpszText: *mut core::ffi::c_void,
pub lpszCaption: *mut core::ffi::c_void,
pub dwStyle: u32,
pub lpszIcon: *mut core::ffi::c_void,
pub dwContextHelpId: usize,
pub lpfnMsgBoxCallback: *mut core::ffi::c_void,
pub dwLanguageId: u32,
}import "golang.org/x/sys/windows"
type MSGBOXPARAMSW struct {
cbSize uint32
hwndOwner uintptr
hInstance uintptr
lpszText uintptr
lpszCaption uintptr
dwStyle uint32
lpszIcon uintptr
dwContextHelpId uintptr
lpfnMsgBoxCallback uintptr
dwLanguageId uint32
}type
MSGBOXPARAMSW = record
cbSize: DWORD;
hwndOwner: Pointer;
hInstance: Pointer;
lpszText: Pointer;
lpszCaption: Pointer;
dwStyle: DWORD;
lpszIcon: Pointer;
dwContextHelpId: NativeUInt;
lpfnMsgBoxCallback: Pointer;
dwLanguageId: DWORD;
end;const MSGBOXPARAMSW = extern struct {
cbSize: u32,
hwndOwner: ?*anyopaque,
hInstance: ?*anyopaque,
lpszText: ?*anyopaque,
lpszCaption: ?*anyopaque,
dwStyle: u32,
lpszIcon: ?*anyopaque,
dwContextHelpId: usize,
lpfnMsgBoxCallback: ?*anyopaque,
dwLanguageId: u32,
};type
MSGBOXPARAMSW {.bycopy.} = object
cbSize: uint32
hwndOwner: pointer
hInstance: pointer
lpszText: pointer
lpszCaption: pointer
dwStyle: uint32
lpszIcon: pointer
dwContextHelpId: uint
lpfnMsgBoxCallback: pointer
dwLanguageId: uint32struct MSGBOXPARAMSW
{
uint cbSize;
void* hwndOwner;
void* hInstance;
void* lpszText;
void* lpszCaption;
uint dwStyle;
void* lpszIcon;
size_t dwContextHelpId;
void* lpfnMsgBoxCallback;
uint dwLanguageId;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MSGBOXPARAMSW サイズ: 40 バイト(x86)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hwndOwner : HWND (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hInstance : HINSTANCE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lpszText : LPWSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; lpszCaption : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwStyle : MESSAGEBOX_STYLE (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; lpszIcon : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; dwContextHelpId : UINT_PTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; lpfnMsgBoxCallback : MSGBOXCALLBACK (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; dwLanguageId : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MSGBOXPARAMSW サイズ: 80 バイト(x64)
dim st, 20 ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hwndOwner : HWND (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; hInstance : HINSTANCE (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpszText : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpszCaption : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; dwStyle : MESSAGEBOX_STYLE (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; lpszIcon : LPWSTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; dwContextHelpId : UINT_PTR (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; lpfnMsgBoxCallback : MSGBOXCALLBACK (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; dwLanguageId : DWORD (+72, 4byte) st.18 = 値 / 値 = st.18 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MSGBOXPARAMSW
#field int cbSize
#field intptr hwndOwner
#field intptr hInstance
#field intptr lpszText
#field intptr lpszCaption
#field int dwStyle
#field intptr lpszIcon
#field intptr dwContextHelpId
#field intptr lpfnMsgBoxCallback
#field int dwLanguageId
#endstruct
stdim st, MSGBOXPARAMSW ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize