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

APPBARDATA

構造体
サイズx64: 44 バイト / x86: 36 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0構造体のサイズ (バイト単位)。
hWndHWND8/4+4+4アプリバー ウィンドウのハンドルです。すべてのメッセージがこのメンバーを使用するわけではありません。hWind の値を指定する必要があるかどうかは、個々のメッセージのページを参照してください。
uCallbackMessageDWORD4+12+8アプリケーション定義のメッセージ識別子です。アプリケーションは、hWnd メンバーで識別されるアプリバーに送信する通知メッセージに、指定した識別子を使用します。このメンバーは、ABM_NEW メッセージを送信するときに使用します。
uEdgeDWORD4+16+12

画面の端を指定する値です。このメンバーは、次のいずれかのメッセージを送信するときに使用します。

このメンバーには、次のいずれかの値を指定できます。

ABE_BOTTOM

下端。

ABE_LEFT

左端。

ABE_RIGHT

右端。

ABE_TOP

上端。

rcRECT16+20+16

メッセージによって用途が異なる RECT 構造体です。

lParamLPARAM8/4+36+32

メッセージに依存する値です。このメンバーは、次のメッセージで使用します。

詳細については、個々のメッセージのページを参照してください。

公式ドキュメント

システム アプリバー メッセージに関する情報が格納されます。

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

各言語での定義

#include <windows.h>

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

// APPBARDATA  (x64 44 / x86 36 バイト)
#pragma pack(push, 1)
typedef struct APPBARDATA {
    DWORD cbSize;
    HWND hWnd;
    DWORD uCallbackMessage;
    DWORD uEdge;
    RECT rc;
    LPARAM lParam;
} APPBARDATA;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

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

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct APPBARDATA
{
    public uint cbSize;
    public IntPtr hWnd;
    public uint uCallbackMessage;
    public uint uEdge;
    public RECT rc;
    public IntPtr lParam;
}
Imports System.Runtime.InteropServices

<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, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure APPBARDATA
    Public cbSize As UInteger
    Public hWnd As IntPtr
    Public uCallbackMessage As UInteger
    Public uEdge As UInteger
    Public rc As RECT
    Public lParam As IntPtr
End Structure
import ctypes
from ctypes import wintypes

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

class APPBARDATA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("hWnd", ctypes.c_void_p),
        ("uCallbackMessage", wintypes.DWORD),
        ("uEdge", wintypes.DWORD),
        ("rc", RECT),
        ("lParam", ctypes.c_ssize_t),
    ]
#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C, packed(1))]
pub struct APPBARDATA {
    pub cbSize: u32,
    pub hWnd: *mut core::ffi::c_void,
    pub uCallbackMessage: u32,
    pub uEdge: u32,
    pub rc: RECT,
    pub lParam: isize,
}
import "golang.org/x/sys/windows"

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

type APPBARDATA struct {
	cbSize uint32
	hWnd uintptr
	uCallbackMessage uint32
	uEdge uint32
	rc RECT
	lParam uintptr
}
type
  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  APPBARDATA = packed record
    cbSize: DWORD;
    hWnd: Pointer;
    uCallbackMessage: DWORD;
    uEdge: DWORD;
    rc: RECT;
    lParam: NativeInt;
  end;
const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const APPBARDATA = extern struct {
    cbSize: u32,
    hWnd: ?*anyopaque,
    uCallbackMessage: u32,
    uEdge: u32,
    rc: RECT,
    lParam: isize,
};
type
  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  APPBARDATA {.packed.} = object
    cbSize: uint32
    hWnd: pointer
    uCallbackMessage: uint32
    uEdge: uint32
    rc: RECT
    lParam: int
struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

align(1)
struct APPBARDATA
{
    uint cbSize;
    void* hWnd;
    uint uCallbackMessage;
    uint uEdge;
    RECT rc;
    ptrdiff_t lParam;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; APPBARDATA サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hWnd : HWND (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; uCallbackMessage : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; uEdge : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; rc : RECT (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; lParam : LPARAM (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; APPBARDATA サイズ: 44 バイト(x64)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hWnd : HWND (+4, 8byte)  qpoke st,4,値 / qpeek(st,4)  ※IronHSPのみ。3.7/3.8は lpoke st,4,下位 : lpoke st,8,上位
; uCallbackMessage : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; uEdge : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; rc : RECT (+20, 16byte)  varptr(st)+20 を基点に操作(16byte:入れ子/配列)
; lParam : LPARAM (+36, 8byte)  qpoke st,36,値 / qpeek(st,36)  ※IronHSPのみ。3.7/3.8は lpoke st,36,下位 : lpoke st,40,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global APPBARDATA, pack=1
    #field int cbSize
    #field intptr hWnd
    #field int uCallbackMessage
    #field int uEdge
    #field RECT rc
    #field intptr lParam
#endstruct

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