CPictureHolder クラス
Picture プロパティを実装します。これにより、ユーザーはコントロールに画像を表示できます。
構文
class CPictureHolder
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CPictureHolder::CPictureHolder | CPictureHolder オブジェクトを構築します。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CPictureHolder::CreateEmpty | 空の CPictureHolder オブジェクトを作成します。 |
| CPictureHolder::CreateFromBitmap | CPictureHolderビットマップからオブジェクトを作成します。 |
| CPictureHolder::CreateFromIcon | CPictureHolderアイコンからオブジェクトを作成します。 |
| CPictureHolder::CreateFromMetafile | CPictureHolderメタファイルからオブジェクトを作成します。 |
| CPictureHolder::GetDisplayString | コントロール コンテナーのプロパティ ブラウザーに表示される文字列を取得します。 |
| CPictureHolder::GetPictureDispatch | オブジェクトのインターフェイスをCPictureHolderIDispatch返します。 |
| CPictureHolder::GetType | オブジェクトが CPictureHolder ビットマップ、メタファイル、アイコンのいずれであるかを示します。 |
| CPictureHolder::Render | 図をレンダリングします。 |
| CPictureHolder::SetPictureDispatch | オブジェクトのインターフェイスをCPictureHolderIDispatch設定します。 |
パブリック データ メンバー
| 名前 | 説明 |
|---|---|
| CPictureHolder::m_pPict | 図オブジェクトへのポインター。 |
解説
CPictureHolder には基底クラスはありません。
stock Picture プロパティを使用すると、開発者は表示するビットマップ、アイコン、またはメタファイルを指定できます。
カスタム図プロパティの作成の詳細については、「MFC ActiveX コントロール: ActiveX コントロールでの画像の使用」を参照してください。
継承階層
CPictureHolder
必要条件
ヘッダー: afxctl.h
CPictureHolder::CPictureHolder
CPictureHolder オブジェクトを構築します。
CPictureHolder();
CPictureHolder::CreateEmpty
空 CPictureHolder のオブジェクトを作成し、インターフェイスに IPicture 接続します。
BOOL CreateEmpty();
戻り値
オブジェクトが正常に作成された場合は 0 以外。それ以外の場合は 0。
CPictureHolder::CreateFromBitmap
ビットマップを使用して画像オブジェクトを初期化します。CPictureHolder
BOOL CreateFromBitmap(
UINT idResource);
BOOL CreateFromBitmap(
CBitmap* pBitmap,
CPalette* pPal = NULL,
BOOL bTransferOwnership = TRUE);
BOOL CreateFromBitmap(
HBITMAP hbm,
HPALETTE hpal = NULL,
BOOL bTransferOwnership = FALSE);
パラメーター
idResource
ビットマップ リソースのリソース ID。
pBitmap
CBitmap オブジェクトへのポインター。
pPal
CPalette オブジェクトへのポインター。
bTransferOwnership
図オブジェクトがビットマップ オブジェクトとパレット オブジェクトの所有権を取得するかどうかを示します。
Hbm
オブジェクトの作成元のビットマップを CPictureHolder 処理します。
hpal
ビットマップのレンダリングに使用されるパレットへのハンドル。
戻り値
オブジェクトが正常に作成された場合は 0 以外。それ以外の場合は 0。
解説
bTransferOwnership が TRUE の場合、呼び出し元は、この呼び出しが返された後、ビットマップまたはパレット オブジェクトを使用しないでください。 bTransferOwnership が FAL Standard Edition の場合、呼び出し元は、ビットマップ オブジェクトとパレット オブジェクトがメインピクチャ オブジェクトの有効期間中有効であることを確認する責任を負います。
CPictureHolder::CreateFromIcon
アイコンを使用して、画像オブジェクトを初期化します CPictureHolder。
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
パラメーター
idResource
ビットマップ リソースのリソース ID。
hIcon
オブジェクトの作成元のアイコンを CPictureHolder 処理します。
bTransferOwnership
図オブジェクトがアイコン オブジェクトの所有権を取得するかどうかを示します。
戻り値
オブジェクトが正常に作成された場合は 0 以外。それ以外の場合は 0。
解説
bTransferOwnership が TRUE の場合、呼び出し元は、この呼び出しが返された後、アイコン オブジェクトを使用しないでください。 bTransferOwnership が FAL Standard Edition の場合、呼び出し元は、アイコン オブジェクトが画像オブジェクトの有効期間中に再メイン有効であることを確認する責任を負います。
CPictureHolder::CreateFromMetafile
メタファイルを使用して、.CPictureHolder
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
パラメーター
hmf
オブジェクトの作成に使用されるメタファイルへの CPictureHolder ハンドル。
xExt
図の X エクステント。
yExt
図の Y 範囲。
bTransferOwnership
図オブジェクトがメタファイル オブジェクトの所有権を取得するかどうかを示します。
戻り値
オブジェクトが正常に作成された場合は 0 以外。それ以外の場合は 0。
解説
bTransferOwnership が TRUE の場合、呼び出し元は、この呼び出しが返された後でメタファイル オブジェクトを使用しないでください。 bTransferOwnership が FAL Standard Edition の場合、呼び出し元は、画像オブジェクトの有効期間中にメタファイル オブジェクトが再メイン有効であることを確認する必要があります。
CPictureHolder::GetDisplayString
コンテナーのプロパティ ブラウザーに表示される文字列を取得します。
BOOL GetDisplayString(CString& strValue);
パラメーター
strValue
表示文字列を 保持する CString への参照。
戻り値
文字列が正常に取得された場合は 0 以外。それ以外の場合は 0。
CPictureHolder::GetPictureDispatch
この関数は、オブジェクトIPictureDispのインターフェイスへのポインターをCPictureHolder返します。
LPPICTUREDISP GetPictureDispatch();
戻り値
オブジェクトIPictureDispのCPictureHolderインターフェイスへのポインター。
解説
呼び出し元は、このポインターが終了したら、このポインターを呼び出す Release 必要があります。
CPictureHolder::GetType
図がビットマップ、メタファイル、アイコンのいずれであるかを示します。
short GetType();
戻り値
図の種類を示す値。 指定できる値とその意味は次のとおりです。
| Value | 意味 |
|---|---|
| PICTYPE_UNINITIALIZED | CPictureHolder オブジェクトが一元化されます。 |
| PICTYPE_NONE | CPictureHolder オブジェクトが空です。 |
| PICTYPE_BITMAP | 図はビットマップです。 |
| PICTYPE_METAFILE | 図はメタファイルです。 |
| PICTYPE_ICON | 画像はアイコンです。 |
CPictureHolder::m_pPict
オブジェクトIPictureのCPictureHolderインターフェイスへのポインター。
LPPICTURE m_pPict;
CPictureHolder::Render
rcRender によって 参照される四角形内の図をレンダリングします。
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
パラメーター
pDC
画像をレンダリングする表示コンテキストへのポインター。
rcRender
図をレンダリングする四角形。
rcWBounds
図をレンダリングするオブジェクトの外接する四角形を表す四角形。 コントロールの場合、この四角形は COleControl::OnDraw のオーバーライドに渡される rcBounds パラメーターです。
CPictureHolder::SetPictureDispatch
オブジェクトを CPictureHolder インターフェイスに IPictureDisp 接続します。
void SetPictureDispatch(LPPICTUREDISP pDisp);
パラメーター
pDisp
新しい IPictureDisp インターフェイスへのポインター。
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示