ITrackShellMenu

COM

IID8278f932-2a3e-11d2-838f-00c04fd918d0継承元IShellMenu自前メソッド開始 vtbl12

公式ドキュメント

IShellMenu インターフェースを拡張し、ツールバーのボタンとメニューを連携させる機能や、ポップアップメニューを表示する機能を提供するメソッドを公開します。

解説(Remarks)

このインターフェースは、継承元である IShellMenu インターフェースのメソッドも提供します。

このインターフェースは、トラック Shell メニューオブジェクトによって実装されます。このオブジェクトは、クラス識別子 (CLSID) に CLSID_TrackShellMenu を指定して CoCreateInstance を呼び出すことで取得できます。インターフェースポインターは、標準的な Component Object Model (COM) の手順で取得できます。CLSID_TrackShellMenu の値は {8278F931-2A3E-11d2-838F-00C04FD918D0} です。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 12 HRESULT SetObscured(HWND hwndTB, IUnknown* punkBand, DWORD dwSMSetFlags)

ツールバー上の隠れた項目とメニュー内の項目を連携させます。

hwndTB

HWND

ボタンのコマンド ID が、トラッキング対象メニューのメニュー ID に対応するツールバーコントロールへのハンドル。

punkBand

IUnknown*

このパラメーターが IShellMenu インターフェースをサポートする COM オブジェクトを指している場合、表示されているツールバーボタンに対応するメニュー項目はメニューからフィルターで除外され、両方の場所に重複して表示されないようになります。

このパラメーターが NULL であるか、IShellMenu インターフェースをサポートしない COM オブジェクトを指している場合、ツールバー上の隠れたボタンが dwSMSetFlags で指定された位置に Shell メニューへ追加されます。

dwSMSetFlags

DWORD

次のいずれかの値。

SMSET_TOP (0x10000000)

新しいメニュー項目がメニューの先頭に追加されます。

SMSET_BOTTOM (0x20000000)

新しいメニュー項目がメニューの末尾に追加されます。

SMSET_DONTOWN

予約済み。使用しないでください。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

隠れたボタンとは、ツールバーのサイズ制限により表示できないボタンのことです。通常、これらを表示するには、ツールバーの末尾にあるシェブロン (>>) を押す必要があります。

vtbl 13 HRESULT Popup(HWND hwnd, POINTL* ppt, RECTL* prcExclude, INT dwFlags)

指定した位置にモーダルのポップアップメニューを表示します。

hwnd	HWND	in	ポップアップメニューの親ウィンドウのハンドル。
ppt	POINTL*	inout	スクリーン座標での初期基準点を指定する POINTL 構造体へのポインター。ポップアップメニューは、dwFlags に設定された位置フラグに従って、この点を基準として表示されます。
prcExclude	RECTL*	inout	メニューを配置する際に除外する矩形を指定する RECTL 構造体へのポインター。この領域に対するメニューの配置は、dwFlags に設定された配置フラグによって決定されます。このパラメーターには NULL を設定できます。
dwFlags	INT	in	ポップアップメニューの表示に関するオプションを指定する、1 つ以上の MP_POPUPFLAGS 定数。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

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

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ITrackShellMenu "{8278F932-2A3E-11D2-838F-00C04FD918D0}"
#usecom global ITrackShellMenu IID_ITrackShellMenu "{8278F931-2A3E-11D2-838F-00C04FD918D0}"
#comfunc global ITrackShellMenu_SetObscured  12 sptr,sptr,int
#comfunc global ITrackShellMenu_Popup        13 sptr,var,var,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ITrackShellMenu "{8278F932-2A3E-11D2-838F-00C04FD918D0}"
#usecom global ITrackShellMenu IID_ITrackShellMenu "{8278F931-2A3E-11D2-838F-00C04FD918D0}"
#comfunc global ITrackShellMenu_SetObscured  12 sptr,sptr,int
#comfunc global ITrackShellMenu_Popup        13 sptr,sptr,sptr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。