IPicture インターフェイス (ocidl.h)
図オブジェクトとそのプロパティを管理します。 画像オブジェクトは、ビットマップ、アイコン、メタファイルに対して言語に依存しない抽象化を提供します。 標準フォント オブジェクトと同様に、システムは画像オブジェクトの標準実装を提供します。 その主なインターフェイスは IPicture と IPictureDisp です。後者は IDispatch から派生し、オートメーションを介して画像のプロパティにアクセスできるようにします。 図オブジェクトは 、OleCreatePictureIndirect を使用して作成されます。
picture オブジェクトは、出力インターフェイス IPropertyNotifySink もサポートしているため、クライアントは画像のプロパティがいつ変更されたのかを判断できます。 図オブジェクトは、少なくとも 1 つの発信インターフェイスをサポートしているため、この目的のために IConnectionPointContainer とそれに関連付けられているインターフェイスも実装します。
picture オブジェクトは IPersistStream もサポートしているため、 IStream のインスタンスから自身を保存して読み込むことができます。 画像オブジェクトを内部的に使用するオブジェクトは、通常、オブジェクト独自の永続化処理の一部として画像を保存して読み込みます。 OleLoadPicture 関数を使用すると、ストリームコンテンツに基づいて画像オブジェクトを簡単に作成できます。
継承
IPicture インターフェイスは、IUnknown インターフェイスから継承されます。 IPicture には、次の種類のメンバーもあります。
メソッド
IPicture インターフェイスには、これらのメソッドがあります。
| IPicture::get_Attributes 図のビット属性の現在のセットを取得します。 |
| IPicture::get_CurDC 現在のデバイス コンテキストのハンドルを取得します。 このプロパティは、ビットマップ画像に対してのみ有効です。 |
| IPicture::get_Handle この図オブジェクト内で管理されている画像のハンドルを、指定した場所に取得します。 |
| IPicture::get_Height 図オブジェクト内の図の現在の高さを取得します。 |
| IPicture::get_hPal 図オブジェクトで現在使用されているパレットのコピーを取得します。 |
| IPicture::get_KeepOriginalFormat 図の KeepOriginalFormat プロパティの現在の値を取得します。 |
| IPicture::get_Type 図オブジェクトに含まれる図の現在の種類を取得します。 |
| IPicture::get_Width 図オブジェクト内の図の現在の幅を取得します。 |
| IPicture::P ictureChanged ピクチャ リソースが変更されたことをピクチャ オブジェクトに通知します。 このメソッドは、接続されているシンクに対して IPropertyNotifySink::OnChanged とDISPID_PICT_HANDLEのみを呼び出します。 |
| IPicture::p ut_KeepOriginalFormat 図の KeepOriginalFormat プロパティの値を設定します。 |
| IPicture::Render ソース図のオフセット (xSrc,ySrc) とコピーする寸法 (cxSrc,xySrc) によって定義された図の指定された部分をレンダリング (描画) します。 |
| IPicture::SaveAsFile 画像のデータを、ファイルに保存するのと同じ形式でストリームに保存します。 ビットマップは BMP ファイル形式を使用し、WMF 形式をメタファイルし、ICO 形式をアイコンにします。 |
| IPicture::SelectPicture 特定のデバイス コンテキストにビットマップ画像を選択し、図が以前に選択されたデバイス コンテキストと、図の GDI ハンドルを返します。 このメソッドは IPicture::get_CurDC と組み合わせて動作します。 |
| IPicture::set_hPal 図オブジェクトに含まれる図に GDI パレットを割り当てます。 |
注釈
IPicture インターフェイスの各プロパティには、プロパティが読み取りアクセスをサポートしている場合は get_PropertyName メソッド、書き込みアクセスがサポートされている場合は put_PropertyName メソッドが含まれます。
| プロパティ | Type | アクセス | 説明 |
|---|---|---|---|
| Handle | OLE_HANDLE (int) | R | 画像の Windows GDI ハンドル |
| hPal | OLE_HANDLE (int) | RW | 画像で使用されるパレットの Windows ハンドル。 |
| 型 | short | R | 図の種類 ( PICTYPE を参照)。 |
| 幅 | OLE_XSIZE_HIMETRIC (長) | R | 図の幅。 |
| [高さ] | OLE_YSIZE_HIMETRIC (長) | R | 図の高さ。 |
| CurDC | Hdc | R | 現在のデバイス コンテキスト。 |
| KeepOriginalFormat | BOOL | RW | TRUE の場合、ピクチャ オブジェクトはメモリ内の図の元の状態全体を維持します。 FALSE の場合、ユーザーのコンピューターに適用できない状態は破棄されます。 |
| 属性 | DWORD | R | 画像のその他のビット属性。 |
OLE の実装
画像オブジェクトは、ビットマップ、アイコン、メタファイルに対して言語に依存しない抽象化を提供します。 標準フォント オブジェクトと同様に、システムは画像オブジェクトの標準実装を提供します。 その主なインターフェイスは 、IPicture と IPictureDisp です。 図オブジェクトは OleCreatePictureIndirect を使用して作成され、IPicture インターフェイスと IPictureDisp インターフェイスの両方をサポートします。OLE 提供の picture オブジェクトは、IPicture インターフェイスと IPictureDisp インターフェイスの完全なセマンティクスを実装します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ocidl.h |