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

MSGBOXPARAMSA

構造体
サイズx64: 80 バイト / x86: 40 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0構造体のサイズ (バイト単位)。
hwndOwnerHWND8/4+8+4オーナーウィンドウへのハンドル。このメンバーは NULL でもかまいません。
hInstanceHINSTANCE8/4+16+8
                <b>lpszIcon</b> メンバーで識別されるアイコンリソース、および 
                <b>lpszText</b> または 
                <b>lpszCaption</b> メンバーで識別される文字列リソースを含むモジュールへのハンドル。
lpszTextLPSTR8/4+24+12表示するメッセージを格納した、NULL 終端の文字列、または文字列リソースの識別子。
lpszCaptionLPSTR8/4+32+16メッセージボックスのタイトルを格納した、NULL 終端の文字列、または文字列リソースの識別子。このメンバーが NULL の場合は、既定のタイトル Error が使用されます。
dwStyleMESSAGEBOX_STYLE4+40+20

ダイアログボックスの内容と動作。このメンバーには、MessageBoxEx 関数の uType パラメーターについて説明されているフラグの組み合わせを指定できます。

さらに、 lpszIcon メンバーで指定したアイコンをメッセージボックスに表示させたい場合は、MB_USERICON フラグ (0x00000080L) を指定できます。

lpszIconLPSTR8/4+48+24

アイコンリソースを識別します。このパラメーターには、NULL 終端の文字列、または MAKEINTRESOURCE マクロに渡す整数のリソース識別子のいずれかを指定できます。

システム定義の標準アイコンのいずれかを読み込むには、 hInstance メンバーを NULL に設定し、 lpszIcon には LoadIcon 関数に記載されている値のいずれかを設定します。

                    <b>dwStyle</b> メンバーで <b>MB_USERICON</b> フラグが指定されていない場合、このメンバーは無視されます。
dwContextHelpIdUINT_PTR8/4+56+28ヘルプコンテキストを識別します。ヘルプイベントが発生すると、この値は、メッセージボックスがオーナーウィンドウまたはコールバック関数に送信する HELPINFO 構造体に設定されます。
lpfnMsgBoxCallbackMSGBOXCALLBACK8/4+64+32

メッセージボックスのヘルプイベントを処理するコールバック関数へのポインター。コールバック関数の形式は次のとおりです。

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

このメンバーが NULL の場合、ヘルプイベントが発生すると、メッセージボックスはオーナーウィンドウに WM_HELP メッセージを送信します。

dwLanguageIdDWORD4+72+36

定義済みのプッシュボタンに表示されるテキストの言語。この値は、 MAKELANGID マクロが返す形式でなければなりません。

サポートされる言語識別子の一覧については、Language Identifiers を参照してください。ローカライズされた各 Windows リリースには、通常、限られた言語セットのリソースしか含まれていない点に注意してください。たとえば、米国版では LANG_ENGLISH、フランス語版では LANG_FRENCH、ドイツ語版では LANG_GERMAN、日本語版では LANG_JAPANESE が提供されます。いずれの版でも LANG_NEUTRAL は提供されます。このため、 dwLanguageId パラメーターに使用できる値は限られます。言語識別子を指定する前に、システムにインストールされているロケールを列挙してください。

公式ドキュメント

メッセージボックスを表示するために使用される情報を格納します。MessageBoxIndirect 関数はこの構造体を使用します。

解説(Remarks)

メモ

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして MSGBOXPARAMS を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーの原因となる場合があります。詳細については、Conventions for Function Prototypes を参照してください。

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

各言語での定義

#include <windows.h>

// MSGBOXPARAMSA  (x64 80 / x86 40 バイト)
typedef struct MSGBOXPARAMSA {
    DWORD cbSize;
    HWND hwndOwner;
    HINSTANCE hInstance;
    LPSTR lpszText;
    LPSTR lpszCaption;
    MESSAGEBOX_STYLE dwStyle;
    LPSTR lpszIcon;
    UINT_PTR dwContextHelpId;
    MSGBOXCALLBACK lpfnMsgBoxCallback;
    DWORD dwLanguageId;
} MSGBOXPARAMSA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MSGBOXPARAMSA
{
    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 MSGBOXPARAMSA
    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 Structure
import ctypes
from ctypes import wintypes

class MSGBOXPARAMSA(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 MSGBOXPARAMSA {
    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 MSGBOXPARAMSA struct {
	cbSize uint32
	hwndOwner uintptr
	hInstance uintptr
	lpszText uintptr
	lpszCaption uintptr
	dwStyle uint32
	lpszIcon uintptr
	dwContextHelpId uintptr
	lpfnMsgBoxCallback uintptr
	dwLanguageId uint32
}
type
  MSGBOXPARAMSA = record
    cbSize: DWORD;
    hwndOwner: Pointer;
    hInstance: Pointer;
    lpszText: Pointer;
    lpszCaption: Pointer;
    dwStyle: DWORD;
    lpszIcon: Pointer;
    dwContextHelpId: NativeUInt;
    lpfnMsgBoxCallback: Pointer;
    dwLanguageId: DWORD;
  end;
const MSGBOXPARAMSA = extern struct {
    cbSize: u32,
    hwndOwner: ?*anyopaque,
    hInstance: ?*anyopaque,
    lpszText: ?*anyopaque,
    lpszCaption: ?*anyopaque,
    dwStyle: u32,
    lpszIcon: ?*anyopaque,
    dwContextHelpId: usize,
    lpfnMsgBoxCallback: ?*anyopaque,
    dwLanguageId: u32,
};
type
  MSGBOXPARAMSA {.bycopy.} = object
    cbSize: uint32
    hwndOwner: pointer
    hInstance: pointer
    lpszText: pointer
    lpszCaption: pointer
    dwStyle: uint32
    lpszIcon: pointer
    dwContextHelpId: uint
    lpfnMsgBoxCallback: pointer
    dwLanguageId: uint32
struct MSGBOXPARAMSA
{
    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 レイアウト)
; MSGBOXPARAMSA サイズ: 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 : LPSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpszCaption : LPSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwStyle : MESSAGEBOX_STYLE (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpszIcon : LPSTR (+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 レイアウト)
; MSGBOXPARAMSA サイズ: 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 : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpszCaption : LPSTR (+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 : LPSTR (+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 MSGBOXPARAMSA
    #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, MSGBOXPARAMSA        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize