Win32 API 日本語リファレンス
ホームSystem.Mmc › MMCBUTTON

MMCBUTTON

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

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

フィールド

フィールドサイズx64x86説明
nBitmapINT4+0+0ボタン イメージの 0 から始まるインデックスを指定する値です。
idCommandINT4+4+4ボタンがクリックされたときに返されるコマンド識別子を指定する値です。これにはユーザーが必要とする任意の整数値を指定できます。int の下位ワードのみが使用されます。
fsStateBYTE1+8+8

ボタンの状態フラグを指定する値です。このメンバーには次のいずれかの値を指定できます。

TBSTATE_CHECKED

ボタンは TBSTYLE_CHECKED スタイルを持ち、押された状態です。

TBSTATE_ENABLED

ボタンはユーザー入力を受け付けます。この状態を持たないボタンはユーザー入力を受け付けず、淡色表示になります。

TBSTATE_HIDDEN

ボタンは表示されず、ユーザー入力を受け取ることができません。

TBSTATE_INDETERMINATE

ボタンは淡色表示になります。

TBSTATE_PRESSED

ボタンは押された状態です。

fsTypeBYTE1+9+9

ボタンのスタイルを指定する値です。このメンバーには次の値の任意の組み合わせを指定できます。

TBSTYLE_BUTTON

標準のプッシュ ボタンを作成します。

TBSTYLE_CHECK

ユーザーがクリックするたびに、押された状態と押されていない状態が切り替わるボタンを作成します。このボタンは、押された状態のときに背景色が変わります。

TBSTYLE_CHECKGROUP

グループ内の別のボタンが押されるまで、押された状態を保持するチェック ボタンを作成します。

TBSTYLE_GROUP

グループ内の別のボタンが押されるまで、押された状態を保持するボタンを作成します。

TBSTYLE_SEP

セパレーターを作成し、ボタン グループの間に小さな間隔を設けます。このスタイルを持つボタンはユーザー入力を受け取りません。

lpButtonTextLPWSTR8/4+16+12MMCBUTTON 構造体の特定のインスタンスに関連付けられたテキストへのポインターです。
lpTooltipTextLPWSTR8/4+24+16特定のツールヒントのテキストへのポインターです。

公式ドキュメント

MMCBUTTON 構造体には、ツールバー上にボタンを作成する際に使用される値が格納されます。この構造体は、Platform Software Development Kit (SDK) の共通コントロールに関連するトピックで説明されている TBBUTTON 構造体に似ています。

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

各言語での定義

#include <windows.h>

// MMCBUTTON  (x64 32 / x86 20 バイト)
typedef struct MMCBUTTON {
    INT nBitmap;
    INT idCommand;
    BYTE fsState;
    BYTE fsType;
    LPWSTR lpButtonText;
    LPWSTR lpTooltipText;
} MMCBUTTON;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MMCBUTTON
{
    public int nBitmap;
    public int idCommand;
    public byte fsState;
    public byte fsType;
    public IntPtr lpButtonText;
    public IntPtr lpTooltipText;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MMCBUTTON
    Public nBitmap As Integer
    Public idCommand As Integer
    Public fsState As Byte
    Public fsType As Byte
    Public lpButtonText As IntPtr
    Public lpTooltipText As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class MMCBUTTON(ctypes.Structure):
    _fields_ = [
        ("nBitmap", ctypes.c_int),
        ("idCommand", ctypes.c_int),
        ("fsState", ctypes.c_ubyte),
        ("fsType", ctypes.c_ubyte),
        ("lpButtonText", ctypes.c_void_p),
        ("lpTooltipText", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct MMCBUTTON {
    pub nBitmap: i32,
    pub idCommand: i32,
    pub fsState: u8,
    pub fsType: u8,
    pub lpButtonText: *mut core::ffi::c_void,
    pub lpTooltipText: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type MMCBUTTON struct {
	nBitmap int32
	idCommand int32
	fsState byte
	fsType byte
	lpButtonText uintptr
	lpTooltipText uintptr
}
type
  MMCBUTTON = record
    nBitmap: Integer;
    idCommand: Integer;
    fsState: Byte;
    fsType: Byte;
    lpButtonText: Pointer;
    lpTooltipText: Pointer;
  end;
const MMCBUTTON = extern struct {
    nBitmap: i32,
    idCommand: i32,
    fsState: u8,
    fsType: u8,
    lpButtonText: ?*anyopaque,
    lpTooltipText: ?*anyopaque,
};
type
  MMCBUTTON {.bycopy.} = object
    nBitmap: int32
    idCommand: int32
    fsState: uint8
    fsType: uint8
    lpButtonText: pointer
    lpTooltipText: pointer
struct MMCBUTTON
{
    int nBitmap;
    int idCommand;
    ubyte fsState;
    ubyte fsType;
    void* lpButtonText;
    void* lpTooltipText;
}

HSP用 定義

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

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

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