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

IControlbar

COM
📘 Microsoft Learn (日本語) · English
IID69fb811e-6c1c-11d0-a2cb-00c04fd909dd継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IControlbar インターフェースは、ツールバーやその他のコントロールを作成する手段を提供します。

メソッド 3

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

vtbl 3 HRESULT Create(MMC_CONTROL_TYPE nType, IExtendControlbar* pExtendControlbar, IUnknown** ppUnknown)

IControlbar::Create メソッドは、スナップインが要求したコントロールを作成して返します。

nTypeMMC_CONTROL_TYPEin関連付けるコントロールの種類を指定する値。 MMC_CONTROL_TYPE 列挙型から取得します。
pExtendControlbarIExtendControlbar*in作成されるコントロール(ツールバーまたはメニューボタン)に関連付けるスナップインの IExtendControlbar インターフェースへのポインター。新しいコントロールが生成する通知は IExtendControlBar::ControlbarNotify に送信されます。
ppUnknownIUnknown**out作成されたコントロールの IUnknown インターフェースのアドレスへのポインター。

戻り値

このメソッドは次の値のいずれかを返します。

解説(Remarks)

IControlbar::Create メソッドは、作成するコントロールバーオブジェクトの参照カウントをインクリメントするため、スナップインがインターフェースの AddRef メソッドを呼び出す必要はありません。

COMBOBOXBAR は nType パラメーターに関連して Mmc.idl に含まれていますが、実装されていません。

vtbl 4 HRESULT Attach(MMC_CONTROL_TYPE nType, IUnknown* lpUnknown)

IControlbar::Attach メソッドを使用すると、スナップインはコントロールをコントロールバーに関連付けることができます。

nTypeMMC_CONTROL_TYPEinコントロールバーに関連付けるコントロールの種類を指定する値。 MMC_CONTROL_TYPE 列挙型から取得します。
lpUnknownIUnknown*in挿入するコントロールオブジェクトの IUnknown インターフェースへのポインター。

戻り値

このメソッドは次の値のいずれかを返します。

解説(Remarks)

COMBOBOXBAR は nType パラメーターに関連して Mmc.idl に現れますが、実装されていません。

vtbl 5 HRESULT Detach(IUnknown* lpUnknown)

IControlbar::Detach メソッドは、コントロールとコントロールバーの関連付けを解除します。このコマンドは、コントロールが表示されているコントロールバーからそのコントロールを削除(デタッチ)します。

lpUnknownIUnknown*in削除されるコントロールを表すコントロールオブジェクトの IUnknown インターフェースへのポインター。

戻り値

このメソッドは次の値のいずれかを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IControlbar "{69FB811E-6C1C-11D0-A2CB-00C04FD909DD}"
#usecom global IControlbar IID_IControlbar "{}"
#comfunc global IControlbar_Create  3 int,sptr,sptr
#comfunc global IControlbar_Attach  4 int,sptr
#comfunc global IControlbar_Detach  5 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。