IVBGetControl
COM公式ドキュメント
Visual Basic コンテナー上のすべてのコントロールへのアクセスを提供します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
フォーム上のコントロールを列挙します。
| dwOleContF | DWORD | in | 列挙する OLE オブジェクトの種類を指定します。このパラメーターには、OLECONTF 列挙体で列挙される次の 値のいずれかを指定できます。 OLE コントロールを列挙する際は、 OLECONTF_ONLYUSER、OLECONTF_ONLYIFRUNNING、および OLECONTF_EMBEDDINGS のフラグを組み合わせることを推奨します。OLE コントロールと VBX コントロールの両方を含めるには、この一覧に OLECONTF_OTHERS フラグを追加します。VBX コントロールのみを列挙するには、 OLECONTF_EMBEDDINGS フラグを削除し、OLECONTF_OTHERS フラグを含めます。 | ||||||||||||||||||
| dwWhich | ENUM_CONTROLS_WHICH_FLAGS | in | 列挙するコントロールの集合を指定します。このパラメーターには、次の値のいずれかを指定できます。
GC_WCH_SIBLING、GC_WCH_CONTAINER、 GC_WCH_CONTAINED、または GC_WCH_ALL のいずれかのフラグを、 任意の GC_WCH_Fxxx フラグと組み合わせて使用します。 VBX コードでは、フォームへのポインターを取得するために VBGetControl に GC_FORM フラグを渡していました。OLE コントロールのコードでは、このフラグに直接対応するものはありません。代わりに、 EnumControls に GC_WHC_ALL を渡し、列挙内の最初のコントロールへのポインターを使用します。 GC_WHC_ALL を使用する場合、列挙内の最初のコントロールは常にフォームになります。 | ||||||||||||||||||
| ppenumUnk | IEnumUnknown** | out | OLE オブジェクトの列挙へのポインター。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、 E_OUTOFMEMORY、E_UNEXPECTED に加え、 次の値をサポートします。
解説(Remarks)
VBX コントロールを OLE コントロールに移行する際、 EnumControls は、サポートされなくなった Visual Basic の VBGetControl を置き換えます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IVBGetControl "{40A050A0-3C31-101B-A82E-08002B2B2337}"
#usecom global IVBGetControl IID_IVBGetControl "{}"
#comfunc global IVBGetControl_EnumControls 3 int,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。