NOTIFYICONDATAA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 |
| hWnd | HWND | 8/4 | +4 | +4 | 通知領域のアイコンに関連付けられた通知を受け取るウィンドウへのハンドル。 |
| uID | DWORD | 4 | +12 | +8 | タスクバーアイコンのアプリケーション定義の識別子。Shell_NotifyIcon が呼び出されたとき、シェルは (hWnd と uID の組み合わせ) または guidItem のいずれかを使用して、どのアイコンを操作するかを識別します。それぞれに異なる uID を割り当てることで、1 つの hWnd に複数のアイコンを関連付けることができます。guidItem が指定されている場合、uID は無視されます。 |
| uFlags | NOTIFY_ICON_DATA_FLAGS | 4 | +16 | +12 | 構造体の他のメンバーのうちどれが有効なデータを含んでいるかを示すか、またはツールチップの表示方法に関する追加情報を提供するフラグ。このメンバーには次の値の組み合わせを指定できます。 NIF_MESSAGE (0x00000001)0x00000001。uCallbackMessage メンバーが有効です。 NIF_ICON (0x00000002)0x00000002。hIcon メンバーが有効です。 NIF_TIP (0x00000004)0x00000004。szTip メンバーが有効です。 NIF_STATE (0x00000008)0x00000008。dwState メンバーと dwStateMask メンバーが有効です。 NIF_INFO (0x00000010)0x00000010。バルーン通知を表示します。szInfo、szInfoTitle、dwInfoFlags、uTimeout の各メンバーが有効です。uTimeout は Windows 2000 と Windows XP でのみ有効であることに注意してください。
NIF_GUID (0x00000020)0x00000020。
NIF_REALTIME (0x00000040)0x00000040。Windows Vista 以降。バルーン通知をすぐに表示できない場合は破棄します。後で表示すると意味がなくなる、または誤解を招くようなリアルタイム情報を表す通知に、このフラグを使用します。たとえば「電話が鳴っています。」というメッセージなどです。NIF_REALTIME は NIF_INFO フラグと組み合わせた場合にのみ意味を持ちます。 NIF_SHOWTIP (0x00000080)0x00000080。Windows Vista 以降。標準のツールチップを使用します。通常、uVersion に NOTIFYICON_VERSION_4 が設定されている場合、標準のツールチップは抑制され、アプリケーションが描画するポップアップ UI に置き換えることができます。NOTIFYICON_VERSION_4 で標準のツールチップを表示したい場合は、NIF_SHOWTIP を指定して、標準のツールチップを引き続き表示することを示すことができます。 |
| uCallbackMessage | DWORD | 4 | +20 | +16 | アプリケーション定義のメッセージ識別子。システムはこの識別子を使用して、hWnd で指定されたウィンドウに通知メッセージを送信します。これらの通知メッセージは、アイコンの外接矩形内でマウスイベントやホバーが発生したとき、キーボードでアイコンが選択またはアクティブ化されたとき、あるいはバルーン通知内でそれらの操作が発生したときに送信されます。 uVersion メンバーが 0 または NOTIFYICON_VERSION の場合、メッセージの wParam パラメーターには、イベントが発生したタスクバーアイコンの識別子が格納されます。この識別子の長さは 32 ビットになることがあります。lParam パラメーターには、イベントに関連付けられたマウスまたはキーボードのメッセージが格納されます。たとえば、ポインターがタスクバーアイコンの上に移動すると、lParam には WM_MOUSEMOVE が設定されます。 uVersion メンバーが NOTIFYICON_VERSION_4 の場合、アプリケーションは引き続き uCallbackMessage メンバーを通じてアプリケーション定義のメッセージという形で通知イベントを受け取りますが、そのメッセージの lParam パラメーターと wParam パラメーターの解釈は次のように変更されます。
|
| hIcon | HICON | 8/4 | +24 | +20 | 追加、変更、または削除するアイコンへのハンドル。Windows XP 以降では、最大 32 BPP のアイコンをサポートします。 16x16 ピクセルのアイコンのみを指定した場合、高い dpi 値が設定されたシステムではより大きいサイズに拡大されます。これは見栄えの悪い結果につながる可能性があります。リソースファイルには 16x16 ピクセルのアイコンと 32x32 のアイコンの両方を用意することをお勧めします。正しいアイコンが読み込まれ、適切に拡大縮小されるように、LoadIconMetric を使用してください。コード例については「解説」を参照してください。 |
| szTip | CHAR | 128 | +32 | +24 | 標準のツールチップに表示するテキストを指定する、null で終わる文字列。終端の null 文字を含めて最大 64 文字です。 Windows 2000 以降では、szTip は終端の null 文字を含めて最大 128 文字を指定できます。 |
| dwState | NOTIFY_ICON_STATE | 4 | +160 | +152 | Windows 2000 以降。アイコンの状態。次の値のいずれか、または両方です。 NIS_HIDDEN (0x00000001)0x00000001。アイコンは非表示です。 NIS_SHAREDICON (0x00000002)0x00000002。アイコンリソースは複数のアイコンで共有されます。 |
| dwStateMask | NOTIFY_ICON_STATE | 4 | +164 | +156 | Windows 2000 以降。dwState メンバーのどのビットを取得または変更するかを指定する値。指定できる値は dwState と同じです。たとえば、このメンバーに NIS_HIDDEN を設定すると、項目の非表示状態だけが変更され、アイコン共有ビットはその値に関係なく無視されます。 |
| szInfo | CHAR | 256 | +168 | +160 | Windows 2000 以降。バルーン通知に表示するテキストを指定する、null で終わる文字列。終端の null 文字を含めて最大 256 文字ですが、ローカライズに対応できるよう英語では 200 文字以内に制限してください。UI からバルーン通知を削除するには、アイコンを削除する (NIM_DELETE) か、uFlags に NIF_INFO フラグを設定して szInfo を空の文字列にします。 |
| Anonymous | _Anonymous_e__Union | 4 | +424 | +416 | uTimeout と uVersion を共用する無名共用体。 |
| szInfoTitle | CHAR | 64 | +428 | +420 | Windows 2000 以降。バルーン通知のタイトルを指定する、null で終わる文字列。このタイトルは、テキストのすぐ上に大きなフォントで表示されます。終端の null 文字を含めて最大 64 文字ですが、ローカライズに対応できるよう英語では 48 文字以内に制限してください。 |
| dwInfoFlags | NOTIFY_ICON_INFOTIP_FLAGS | 4 | +492 | +484 | Windows 2000 以降。バルーン通知の動作と外観を変更するために設定できるフラグ。アイコンはタイトルの左側に配置されます。szInfoTitle メンバーの長さが 0 の場合、アイコンは表示されません。 NIIF_NONE (0x00000000)0x00000000。アイコンなし。 NIIF_INFO (0x00000001)0x00000001。情報アイコン。 NIIF_WARNING (0x00000002)0x00000002。警告アイコン。 NIIF_ERROR (0x00000003)0x00000003。エラーアイコン。 NIIF_USER (0x00000004)0x00000004。Windows XP SP2 以降。
NIIF_NOSOUND (0x00000010)0x00000010。Windows XP 以降。関連付けられたサウンドを再生しません。通知にのみ適用されます。 NIIF_LARGE_ICON (0x00000020)0x00000020。Windows Vista 以降。通知アイコンとして、アイコンの大きいバージョンを使用します。これは SM_CXICON x SM_CYICON のサイズのアイコンに対応します。このフラグが設定されていない場合は、SM_CXSMICON x SM_CYSMICON のサイズのアイコンが使用されます。
NIIF_RESPECT_QUIET_TIME (0x00000080)0x00000080。Windows 7 以降。現在のユーザーが「クワイエットタイム」中の場合は、バルーン通知を表示しません。クワイエットタイムとは、新しいユーザーが自分のアカウントに初めてログオンしてからの最初の 1 時間のことです。この間、ほとんどの通知は送信または表示すべきではありません。これにより、ユーザーは煩わされることなく新しいコンピューターシステムに慣れることができます。クワイエットタイムは、オペレーティングシステムのアップグレードまたはクリーンインストールの後にも、各ユーザーに対して発生します。クワイエットタイム中にこのフラグを設定して送信された通知はキューに入れられず、表示されないまま破棄されます。アプリケーションは、その時点で通知がまだ有効であれば、後で再送信できます。 アプリケーションはクワイエットタイムにいつ遭遇するかを予測できないため、クワイエットタイムを尊重するアプリケーションでは、該当するすべての通知に対して常にこのフラグを設定することをお勧めします。 クワイエットタイム中でも、USB デバイスを接続したときやドキュメントを印刷したときなど、ユーザーの操作に対するフィードバックとしてユーザーが期待する特定の通知は、引き続き送信すべきです。 現在のユーザーがクワイエットタイム中でない場合、このフラグは効果がありません。 NIIF_ICON_MASK (0x0000000F)0x0000000F。Windows XP 以降。予約済みです。 |
| guidItem | GUID | 16 | +496 | +488 | Windows XP 以降。
Shell_NotifyIcon のある呼び出しで通知アイコンを GUID で識別した場合、その同じアイコンを扱う以降の Shell_NotifyIcon の呼び出しでも、同じ GUID を使用してアイコンを識別する必要があります。 このメンバーで使用する GUID を生成するには、Guidgen.exe などの GUID 生成ツールを使用します。 |
| hBalloonIcon | HICON | 8/4 | +512 | +504 | Windows Vista 以降。通知領域アイコンとは独立して使用される、アプリケーションが提供するカスタマイズされた通知アイコンのハンドル。このメンバーが NULL 以外で、かつ dwInfoFlags メンバーに NIIF_USER フラグが設定されている場合、このアイコンが通知アイコンとして使用されます。このメンバーが NULL の場合は、従来の動作が行われます。 - uVersion.0Windows 2000 より前の Windows バージョン向けに設計されたアプリケーションでは、この値を使用します。 - uVersion.NOTIFYICON_VERSIONWindows 2000 の動作を使用します。Windows 2000 以降向けに設計されたアプリケーションでは、この値を使用します。 - uVersion.NOTIFYICON_VERSION_4現在の動作を使用します。Windows Vista 以降向けに設計されたアプリケーションでは、この値を使用します。 |
共用体: _Anonymous_e__Union x64 4B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| uTimeout | DWORD | 4 | +0 | +0 | Windows 2000 以降。 注意 このメンバーは Windows Vista 以降では非推奨です。通知の表示時間は、現在ではシステムのアクセシビリティ設定に基づいて決まります。
|
| uVersion | DWORD | 4 | +0 | +0 | Windows 2000 以降。uTimeout との共用体です (Windows Vista 以降では非推奨)。使用するシェル通知アイコンインターフェイスのバージョンを指定します。これらのバージョンの違いの詳細については、Shell_NotifyIcon を参照してください。このメンバーは、Shell_NotifyIcon を使用して NIM_SETVERSION メッセージを送信する場合にのみ使用されます。 |
公式ドキュメント
通知領域に通知を表示するためにシステムが必要とする情報を格納します。Shell_NotifyIcon で使用されます。
解説(Remarks)
通知の UI とコンテンツのベストプラクティスの詳細については、Windows ユーザーエクスペリエンス操作ガイドラインの「Notifications」を参照してください。
uFlags メンバーに NIF_INFO フラグを設定すると、バルーン形式の通知が使用されます。これらの通知の詳細については、バルーンツールチップを参照してください。
タスクバーには、一度に 1 つのバルーン通知しか表示できません。既に通知が表示されているときにアプリケーションが別の通知を表示しようとすると、新しい通知はキューに入れられ、古い通知が消えたときに表示されます。Windows Vista より前のバージョンの Windows では、元の通知の uTimeout 値に関係なく、既存の通知が少なくともシステムの最小タイムアウト時間だけ表示されるまで、新しい通知は表示されませんでした。ユーザーがコンピューターを使用していないと判断される場合、システムはこの時間をタイムアウトに算入しません。
この構造体のいくつかのメンバーは、Windows 2000 以降でのみサポートされます。これらのメンバーを有効にするには、ヘッダーに次の行のいずれかを含めます。
// Windows Vista and later:
#define NTDDI_VERSION NTDDI_WIN2K
#define NTDDI_VERSION NTDDI_WINXP
#define NTDDI_VERSION NTDDI_VISTA
// Windows XP and earlier:
#define _WIN32_IE 0x0500
この構造体は、そのサイズを設定して初期化しなければならないことに注意してください。現在定義されている構造体のサイズを使用すると、より小さい構造体を想定している以前のバージョンの Shell32.dll ではアプリケーションが動作しない可能性があります。適切なバージョン番号を定義すれば (シェルとコモンコントロールのバージョンを参照)、以前のバージョンの Shell32.dll に対してアプリケーションを実行できます。ただし、アプリケーションをより新しいシステムでも実行する必要がある場合は、これが問題を引き起こす可能性があります。
NOTIFYICONDATA 構造体のサイズを適切に設定すれば、現在のヘッダーファイルを使用しながら、すべてのバージョンの Shell32.dll との互換性を維持できます。構造体を初期化する前に、DllGetVersion を使用してシステムにインストールされている Shell32.dll のバージョンを判定し、cbSize を次の値のいずれかで初期化します。
| Shell32.dll のバージョン | cbSize |
|---|---|
| 6.0.6 以降 (Windows Vista 以降) | sizeof(NOTIFYICONDATA) |
| 6.0 (Windows XP) | NOTIFYICONDATA_V3_SIZE |
| 5.0 (Windows 2000) | NOTIFYICONDATA_V2_SIZE |
| 5.0 より前のバージョン | NOTIFYICONDATA_V1_SIZE |
cbSize にこの値を使用することで、アプリケーションは以前のバージョンの Shell32.dll と互換性のある方法で NOTIFYICONDATA を使用できます。
次のコード例は、guidItem メンバーを使用するアプリケーションが Windows Vista と Windows 7 の両方で実行できるようにするための、バージョンチェックを示しています。オペレーティングシステムが Windows 7 の場合に TRUE を返すブール型の関数を提供します。この関数が TRUE を返さない限り、guidItem メンバーは 0 に設定しなければなりません。
BOOL IsWin7OrLater()
{
// Initialize the OSVERSIONINFOEX structure.
OSVERSIONINFOEX osvi;
ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
osvi.dwMajorVersion = 6;
osvi.dwMinorVersion = 1;
// Initialize the condition mask.
DWORDLONG dwlConditionMask = 0;
VER_SET_CONDITION(dwlConditionMask, VER_MAJORVERSION, VER_GREATER_EQUAL);
VER_SET_CONDITION(dwlConditionMask, VER_MINORVERSION, VER_GREATER_EQUAL);
// Perform the test.
return VerifyVersionInfo(&osvi,
VER_MAJORVERSION | VER_MINORVERSION,
dwlConditionMask);
}
次のコード例は、高 DPI で使用するアイコンを読み込むための LoadIconMetric の使用方法を示しています。
// Declare NOTIFYICONDATA details.
// Error handling is omitted here for brevity. Do not omit it in your code.
NOTIFYICONDATA nid = {};
nid.cbSize = sizeof(nid);
nid.hWnd = hWnd;
nid.uFlags = NIF_ICON | NIF_TIP | NIF_GUID;
// Note: This is an example GUID only and should not be used.
// Normally, you should use a GUID-generating tool to provide the value to
// assign to guidItem.
static const GUID myGUID =
{0x23977b55, 0x10e0, 0x4041, {0xb8, 0x62, 0xb1, 0x95, 0x41, 0x96, 0x36, 0x69}};
nid.guidItem = myGUID;
// This text will be shown as the icon's tooltip.
StringCchCopy(nid.szTip, ARRAYSIZE(nid.szTip), L"Test application");
// Load the icon for high DPI.
LoadIconMetric(hInst, MAKEINTRESOURCE(IDI_SMALL), LIM_SMALL, &(nid.hIcon));
// Show the notification.
Shell_NotifyIcon(NIM_ADD, &nid) ? S_OK : E_FAIL;
トラブルシューティング
guidItem メンバーを使用してアイコンを識別している場合に、そのアイコンが表示されない、または Shell_NotifyIcon の一部の呼び出しが失敗するときは、次のいずれかが原因である可能性があります。- Shell_NotifyIcon のすべての呼び出しで NIF_GUID フラグが設定されていない。Shell_NotifyIcon のある呼び出しで通知アイコンを GUID で識別したら、その同じアイコンを扱う以降の Shell_NotifyIcon の呼び出しでも、同じ GUID を使用してアイコンを識別する必要があります。
-
アイコンを含むバイナリファイルが移動された。バイナリファイルのパスはアイコンの GUID の登録に含まれており、変更できません。アイコンに関連付けられた設定は、ファイルパスと GUID が変更されていない場合にのみ、アップグレードを通じて保持されます。パスを変更しなければならない場合、アプリケーションは既存のアイコンを登録したときに追加された GUID 情報をすべて削除する必要があります。その情報を削除すれば、バイナリファイルを新しい場所に移動し、新しい GUID で再登録できます。元の GUID 登録に関連付けられていた設定はすべて失われます。
これは、サイドバイサイドインストールの場合にも発生します。サイドバイサイドインストールを扱う場合、アプリケーションの新しいバージョンではバイナリファイルの GUID を更新する必要があります。
注意 ファイルの移動における唯一の例外は、移動前と移動後の両方のバイナリファイルが同じ会社によって Authenticode 署名されている場合です。その場合、設定は移動後も保持されます。
shellapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして NOTIFYICONDATA を定義します。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則 を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// NOTIFYICONDATAA (x64 520 / x86 508 バイト)
#pragma pack(push, 1)
typedef struct NOTIFYICONDATAA {
DWORD cbSize;
HWND hWnd;
DWORD uID;
NOTIFY_ICON_DATA_FLAGS uFlags;
DWORD uCallbackMessage;
HICON hIcon;
CHAR szTip[128];
NOTIFY_ICON_STATE dwState;
NOTIFY_ICON_STATE dwStateMask;
CHAR szInfo[256];
_Anonymous_e__Union Anonymous;
CHAR szInfoTitle[64];
NOTIFY_ICON_INFOTIP_FLAGS dwInfoFlags;
GUID guidItem;
HICON hBalloonIcon;
} NOTIFYICONDATAA;
#pragma pack(pop)using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct NOTIFYICONDATAA
{
public uint cbSize;
public IntPtr hWnd;
public uint uID;
public uint uFlags;
public uint uCallbackMessage;
public IntPtr hIcon;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 128)] public sbyte[] szTip;
public uint dwState;
public uint dwStateMask;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] public sbyte[] szInfo;
public _Anonymous_e__Union Anonymous;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public sbyte[] szInfoTitle;
public uint dwInfoFlags;
public Guid guidItem;
public IntPtr hBalloonIcon;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure NOTIFYICONDATAA
Public cbSize As UInteger
Public hWnd As IntPtr
Public uID As UInteger
Public uFlags As UInteger
Public uCallbackMessage As UInteger
Public hIcon As IntPtr
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=128)> Public szTip() As SByte
Public dwState As UInteger
Public dwStateMask As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=256)> Public szInfo() As SByte
Public Anonymous As _Anonymous_e__Union
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=64)> Public szInfoTitle() As SByte
Public dwInfoFlags As UInteger
Public guidItem As Guid
Public hBalloonIcon As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class NOTIFYICONDATAA(ctypes.Structure):
_pack_ = 1
_fields_ = [
("cbSize", wintypes.DWORD),
("hWnd", ctypes.c_void_p),
("uID", wintypes.DWORD),
("uFlags", wintypes.DWORD),
("uCallbackMessage", wintypes.DWORD),
("hIcon", ctypes.c_void_p),
("szTip", ctypes.c_byte * 128),
("dwState", wintypes.DWORD),
("dwStateMask", wintypes.DWORD),
("szInfo", ctypes.c_byte * 256),
("Anonymous", _Anonymous_e__Union),
("szInfoTitle", ctypes.c_byte * 64),
("dwInfoFlags", wintypes.DWORD),
("guidItem", GUID),
("hBalloonIcon", ctypes.c_void_p),
]#[repr(C, packed(1))]
pub struct NOTIFYICONDATAA {
pub cbSize: u32,
pub hWnd: *mut core::ffi::c_void,
pub uID: u32,
pub uFlags: u32,
pub uCallbackMessage: u32,
pub hIcon: *mut core::ffi::c_void,
pub szTip: [i8; 128],
pub dwState: u32,
pub dwStateMask: u32,
pub szInfo: [i8; 256],
pub Anonymous: _Anonymous_e__Union,
pub szInfoTitle: [i8; 64],
pub dwInfoFlags: u32,
pub guidItem: GUID,
pub hBalloonIcon: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type NOTIFYICONDATAA struct {
cbSize uint32
hWnd uintptr
uID uint32
uFlags uint32
uCallbackMessage uint32
hIcon uintptr
szTip [128]int8
dwState uint32
dwStateMask uint32
szInfo [256]int8
Anonymous _Anonymous_e__Union
szInfoTitle [64]int8
dwInfoFlags uint32
guidItem windows.GUID
hBalloonIcon uintptr
}type
NOTIFYICONDATAA = packed record
cbSize: DWORD;
hWnd: Pointer;
uID: DWORD;
uFlags: DWORD;
uCallbackMessage: DWORD;
hIcon: Pointer;
szTip: array[0..127] of Shortint;
dwState: DWORD;
dwStateMask: DWORD;
szInfo: array[0..255] of Shortint;
Anonymous: _Anonymous_e__Union;
szInfoTitle: array[0..63] of Shortint;
dwInfoFlags: DWORD;
guidItem: TGUID;
hBalloonIcon: Pointer;
end;const NOTIFYICONDATAA = extern struct {
cbSize: u32,
hWnd: ?*anyopaque,
uID: u32,
uFlags: u32,
uCallbackMessage: u32,
hIcon: ?*anyopaque,
szTip: [128]i8,
dwState: u32,
dwStateMask: u32,
szInfo: [256]i8,
Anonymous: _Anonymous_e__Union,
szInfoTitle: [64]i8,
dwInfoFlags: u32,
guidItem: GUID,
hBalloonIcon: ?*anyopaque,
};type
NOTIFYICONDATAA {.packed.} = object
cbSize: uint32
hWnd: pointer
uID: uint32
uFlags: uint32
uCallbackMessage: uint32
hIcon: pointer
szTip: array[128, int8]
dwState: uint32
dwStateMask: uint32
szInfo: array[256, int8]
Anonymous: _Anonymous_e__Union
szInfoTitle: array[64, int8]
dwInfoFlags: uint32
guidItem: GUID
hBalloonIcon: pointeralign(1)
struct NOTIFYICONDATAA
{
uint cbSize;
void* hWnd;
uint uID;
uint uFlags;
uint uCallbackMessage;
void* hIcon;
byte[128] szTip;
uint dwState;
uint dwStateMask;
byte[256] szInfo;
_Anonymous_e__Union Anonymous;
byte[64] szInfoTitle;
uint dwInfoFlags;
GUID guidItem;
void* hBalloonIcon;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NOTIFYICONDATAA サイズ: 508 バイト(x86)
dim st, 127 ; 4byte整数×127(構造体サイズ 508 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hWnd : HWND (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; uID : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; uFlags : NOTIFY_ICON_DATA_FLAGS (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; uCallbackMessage : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; hIcon : HICON (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; szTip : CHAR (+24, 128byte) varptr(st)+24 を基点に操作(128byte:入れ子/配列)
; dwState : NOTIFY_ICON_STATE (+152, 4byte) st.38 = 値 / 値 = st.38 (lpoke/lpeek も可)
; dwStateMask : NOTIFY_ICON_STATE (+156, 4byte) st.39 = 値 / 値 = st.39 (lpoke/lpeek も可)
; szInfo : CHAR (+160, 256byte) varptr(st)+160 を基点に操作(256byte:入れ子/配列)
; Anonymous : _Anonymous_e__Union (+416, 4byte) varptr(st)+416 を基点に操作(4byte:入れ子/配列)
; szInfoTitle : CHAR (+420, 64byte) varptr(st)+420 を基点に操作(64byte:入れ子/配列)
; dwInfoFlags : NOTIFY_ICON_INFOTIP_FLAGS (+484, 4byte) st.121 = 値 / 値 = st.121 (lpoke/lpeek も可)
; guidItem : GUID (+488, 16byte) varptr(st)+488 を基点に操作(16byte:入れ子/配列)
; hBalloonIcon : HICON (+504, 4byte) st.126 = 値 / 値 = st.126 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NOTIFYICONDATAA サイズ: 520 バイト(x64)
dim st, 130 ; 4byte整数×130(構造体サイズ 520 / 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,上位
; uID : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; uFlags : NOTIFY_ICON_DATA_FLAGS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; uCallbackMessage : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; hIcon : HICON (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; szTip : CHAR (+32, 128byte) varptr(st)+32 を基点に操作(128byte:入れ子/配列)
; dwState : NOTIFY_ICON_STATE (+160, 4byte) st.40 = 値 / 値 = st.40 (lpoke/lpeek も可)
; dwStateMask : NOTIFY_ICON_STATE (+164, 4byte) st.41 = 値 / 値 = st.41 (lpoke/lpeek も可)
; szInfo : CHAR (+168, 256byte) varptr(st)+168 を基点に操作(256byte:入れ子/配列)
; Anonymous : _Anonymous_e__Union (+424, 4byte) varptr(st)+424 を基点に操作(4byte:入れ子/配列)
; szInfoTitle : CHAR (+428, 64byte) varptr(st)+428 を基点に操作(64byte:入れ子/配列)
; dwInfoFlags : NOTIFY_ICON_INFOTIP_FLAGS (+492, 4byte) st.123 = 値 / 値 = st.123 (lpoke/lpeek も可)
; guidItem : GUID (+496, 16byte) varptr(st)+496 を基点に操作(16byte:入れ子/配列)
; hBalloonIcon : HICON (+512, 8byte) qpoke st,512,値 / qpeek(st,512) ※IronHSPのみ。3.7/3.8は lpoke st,512,下位 : lpoke st,516,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global NOTIFYICONDATAA, pack=1
#field int cbSize
#field intptr hWnd
#field int uID
#field int uFlags
#field int uCallbackMessage
#field intptr hIcon
#field byte szTip 128
#field int dwState
#field int dwStateMask
#field byte szInfo 256
#field byte Anonymous 4
#field byte szInfoTitle 64
#field int dwInfoFlags
#field GUID guidItem
#field intptr hBalloonIcon
#endstruct
stdim st, NOTIFYICONDATAA ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。