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

NMTOOLBARW

構造体
サイズx64: 96 バイト / x86: 64 バイト

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

フィールド

フィールドサイズx64x86説明
hdrNMHDR24/12+0+0通知に関する追加情報を格納する NMHDR 構造体です。
iItemINT4+24+12通知コードに関連付けられたボタンのコマンド識別子です。
tbButtonTBBUTTON32/24+32+16通知コードに関連付けられたツールバーボタンに関する情報を格納する TBBUTTON 構造体です。このメンバーが有効な情報を格納するのは、TBN_QUERYINSERT 通知コードおよび TBN_QUERYDELETE 通知コードの場合のみです。
cchTextINT4+64+40ボタンのテキストの文字数です。
pszTextLPWSTR8/4+72+44ボタンのテキストを格納する文字バッファーのアドレスです。
rcButtonRECT16+80+48バージョン 5.80。 ボタンが占める領域を定義する RECT 構造体です。

公式ドキュメント

ツールバーの通知コードを処理するために使用される情報を格納します。この構造体は TBNOTIFY 構造体に代わるものです。

解説(Remarks)

メモ

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

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

各言語での定義

#include <windows.h>

// NMHDR  (x64 24 / x86 12 バイト)
typedef struct NMHDR {
    HWND hwndFrom;
    UINT_PTR idFrom;
    DWORD code;
} NMHDR;

// TBBUTTON  (x64 32 / x86 24 バイト)
typedef struct TBBUTTON {
    INT iBitmap;
    INT idCommand;
    BYTE fsState;
    BYTE fsStyle;
    BYTE bReserved[6];
    UINT_PTR dwData;
    INT_PTR iString;
} TBBUTTON;

// RECT  (x64 16 / x86 16 バイト)
typedef struct RECT {
    INT left;
    INT top;
    INT right;
    INT bottom;
} RECT;

// NMTOOLBARW  (x64 96 / x86 64 バイト)
typedef struct NMTOOLBARW {
    NMHDR hdr;
    INT iItem;
    TBBUTTON tbButton;
    INT cchText;
    LPWSTR pszText;
    RECT rcButton;
} NMTOOLBARW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMHDR
{
    public IntPtr hwndFrom;
    public UIntPtr idFrom;
    public uint code;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TBBUTTON
{
    public int iBitmap;
    public int idCommand;
    public byte fsState;
    public byte fsStyle;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public byte[] bReserved;
    public UIntPtr dwData;
    public IntPtr iString;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECT
{
    public int left;
    public int top;
    public int right;
    public int bottom;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMTOOLBARW
{
    public NMHDR hdr;
    public int iItem;
    public TBBUTTON tbButton;
    public int cchText;
    public IntPtr pszText;
    public RECT rcButton;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMHDR
    Public hwndFrom As IntPtr
    Public idFrom As UIntPtr
    Public code As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TBBUTTON
    Public iBitmap As Integer
    Public idCommand As Integer
    Public fsState As Byte
    Public fsStyle As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public bReserved() As Byte
    Public dwData As UIntPtr
    Public iString As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECT
    Public left As Integer
    Public top As Integer
    Public right As Integer
    Public bottom As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMTOOLBARW
    Public hdr As NMHDR
    Public iItem As Integer
    Public tbButton As TBBUTTON
    Public cchText As Integer
    Public pszText As IntPtr
    Public rcButton As RECT
End Structure
import ctypes
from ctypes import wintypes

class NMHDR(ctypes.Structure):
    _fields_ = [
        ("hwndFrom", ctypes.c_void_p),
        ("idFrom", ctypes.c_size_t),
        ("code", wintypes.DWORD),
    ]

class TBBUTTON(ctypes.Structure):
    _fields_ = [
        ("iBitmap", ctypes.c_int),
        ("idCommand", ctypes.c_int),
        ("fsState", ctypes.c_ubyte),
        ("fsStyle", ctypes.c_ubyte),
        ("bReserved", ctypes.c_ubyte * 6),
        ("dwData", ctypes.c_size_t),
        ("iString", ctypes.c_ssize_t),
    ]

class RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class NMTOOLBARW(ctypes.Structure):
    _fields_ = [
        ("hdr", NMHDR),
        ("iItem", ctypes.c_int),
        ("tbButton", TBBUTTON),
        ("cchText", ctypes.c_int),
        ("pszText", ctypes.c_void_p),
        ("rcButton", RECT),
    ]
#[repr(C)]
pub struct NMHDR {
    pub hwndFrom: *mut core::ffi::c_void,
    pub idFrom: usize,
    pub code: u32,
}

#[repr(C)]
pub struct TBBUTTON {
    pub iBitmap: i32,
    pub idCommand: i32,
    pub fsState: u8,
    pub fsStyle: u8,
    pub bReserved: [u8; 6],
    pub dwData: usize,
    pub iString: isize,
}

#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct NMTOOLBARW {
    pub hdr: NMHDR,
    pub iItem: i32,
    pub tbButton: TBBUTTON,
    pub cchText: i32,
    pub pszText: *mut core::ffi::c_void,
    pub rcButton: RECT,
}
import "golang.org/x/sys/windows"

type NMHDR struct {
	hwndFrom uintptr
	idFrom uintptr
	code uint32
}

type TBBUTTON struct {
	iBitmap int32
	idCommand int32
	fsState byte
	fsStyle byte
	bReserved [6]byte
	dwData uintptr
	iString uintptr
}

type RECT struct {
	left int32
	top int32
	right int32
	bottom int32
}

type NMTOOLBARW struct {
	hdr NMHDR
	iItem int32
	tbButton TBBUTTON
	cchText int32
	pszText uintptr
	rcButton RECT
}
type
  NMHDR = record
    hwndFrom: Pointer;
    idFrom: NativeUInt;
    code: DWORD;
  end;

  TBBUTTON = record
    iBitmap: Integer;
    idCommand: Integer;
    fsState: Byte;
    fsStyle: Byte;
    bReserved: array[0..5] of Byte;
    dwData: NativeUInt;
    iString: NativeInt;
  end;

  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  NMTOOLBARW = record
    hdr: NMHDR;
    iItem: Integer;
    tbButton: TBBUTTON;
    cchText: Integer;
    pszText: Pointer;
    rcButton: RECT;
  end;
const NMHDR = extern struct {
    hwndFrom: ?*anyopaque,
    idFrom: usize,
    code: u32,
};

const TBBUTTON = extern struct {
    iBitmap: i32,
    idCommand: i32,
    fsState: u8,
    fsStyle: u8,
    bReserved: [6]u8,
    dwData: usize,
    iString: isize,
};

const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const NMTOOLBARW = extern struct {
    hdr: NMHDR,
    iItem: i32,
    tbButton: TBBUTTON,
    cchText: i32,
    pszText: ?*anyopaque,
    rcButton: RECT,
};
type
  NMHDR {.bycopy.} = object
    hwndFrom: pointer
    idFrom: uint
    code: uint32

  TBBUTTON {.bycopy.} = object
    iBitmap: int32
    idCommand: int32
    fsState: uint8
    fsStyle: uint8
    bReserved: array[6, uint8]
    dwData: uint
    iString: int

  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  NMTOOLBARW {.bycopy.} = object
    hdr: NMHDR
    iItem: int32
    tbButton: TBBUTTON
    cchText: int32
    pszText: pointer
    rcButton: RECT
struct NMHDR
{
    void* hwndFrom;
    size_t idFrom;
    uint code;
}

struct TBBUTTON
{
    int iBitmap;
    int idCommand;
    ubyte fsState;
    ubyte fsStyle;
    ubyte[6] bReserved;
    size_t dwData;
    ptrdiff_t iString;
}

struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct NMTOOLBARW
{
    NMHDR hdr;
    int iItem;
    TBBUTTON tbButton;
    int cchText;
    void* pszText;
    RECT rcButton;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NMTOOLBARW サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; hdr : NMHDR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; iItem : INT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; tbButton : TBBUTTON (+16, 24byte)  varptr(st)+16 を基点に操作(24byte:入れ子/配列)
; cchText : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pszText : LPWSTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; rcButton : RECT (+48, 16byte)  varptr(st)+48 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NMTOOLBARW サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; hdr : NMHDR (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; iItem : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; tbButton : TBBUTTON (+32, 32byte)  varptr(st)+32 を基点に操作(32byte:入れ子/配列)
; cchText : INT (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; pszText : LPWSTR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; rcButton : RECT (+80, 16byte)  varptr(st)+80 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global NMHDR
    #field intptr hwndFrom
    #field intptr idFrom
    #field int code
#endstruct

#defstruct global TBBUTTON
    #field int iBitmap
    #field int idCommand
    #field byte fsState
    #field byte fsStyle
    #field byte bReserved 6
    #field intptr dwData
    #field intptr iString
#endstruct

#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global NMTOOLBARW
    #field NMHDR hdr
    #field int iItem
    #field TBBUTTON tbButton
    #field int cchText
    #field intptr pszText
    #field RECT rcButton
#endstruct

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