ホーム › System.Ole › IPictureDisp

IPictureDisp

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID7bf80981-bf32-101a-8bbb-00aa00300cab継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

ピクチャオブジェクトのプロパティを Automation を通じて公開します。IPicture のメソッドで利用できる機能の一部を提供します。

解説(Remarks)

次の表は、各ピクチャプロパティの dispID を示しています。

定数	値
DISPID_PICT_HANDLE	0
DISPID_PICT_HPAL	2
DISPID_PICT_TYPE	3
DISPID_PICT_WIDTH	4
DISPID_PICT_HEIGHT	5
DISPID_PICT_RENDER	6

IPictureDisp インターフェイスの各プロパティには、プロパティが読み取りアクセスをサポートする場合は get_PropertyName メソッドが、書き込みアクセスをサポートする場合は put_PropertyName メソッドが含まれます。ほとんどのプロパティは読み取りアクセスのみをサポートしますが、hPal プロパティは例外です。

プロパティ	型	アクセス	説明
Handle	OLE_HANDLE (int)	R	ピクチャの Windows GDI ハンドル
hPal	OLE_HANDLE (int)	RW	ピクチャが使用するパレットの Windows ハンドル。
Type	short	R	ピクチャの種類 (PICTYPE を参照)。
Width	OLE_XSIZE_HIMETRIC (long)	R	ピクチャの幅。
Height	OLE_YSIZE_HIMETRIC (long)	R	ピクチャの高さ。

OLE 実装

ピクチャオブジェクトは、ビットマップ、アイコン、メタファイルに対して言語に依存しない抽象化を提供します。標準のフォントオブジェクトと同様に、システムはピクチャオブジェクトの標準実装を提供します。その主要なインターフェイスは IPicture と IPictureDisp です。ピクチャオブジェクトは OleCreatePictureIndirect で作成され、IPicture と IPictureDisp の両方のインターフェイスをサポートします。

OLE が提供するピクチャオブジェクトは、IPicture と IPictureDisp インターフェイスの完全なセマンティクスを実装します。

メソッド 0

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は 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_IPictureDisp "{7BF80981-BF32-101A-8BBB-00AA00300CAB}"
#usecom global IPictureDisp IID_IPictureDisp "{}"
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。