CPictureHolder クラス
Picture プロパティを実装します。これにより、ユーザーはコントロールに画像を表示できます。
構文
class CPictureHolder
メンバー
パブリック コンストラクター
名前 | 説明 |
---|---|
CPictureHolder::CPictureHolder | CPictureHolder オブジェクトを構築します。 |
パブリック メソッド
名前 | 説明 |
---|---|
CPictureHolder::CreateEmpty | 空の CPictureHolder オブジェクトを作成します。 |
CPictureHolder::CreateFromBitmap | ビットマップから CPictureHolder オブジェクトを作成します。 |
CPictureHolder::CreateFromIcon | アイコンから CPictureHolder オブジェクトを作成します。 |
CPictureHolder::CreateFromMetafile | メタファイルから CPictureHolder オブジェクトを作成します。 |
CPictureHolder::GetDisplayString | コントロール コンテナーのプロパティ ブラウザーに表示される文字列を取得します。 |
CPictureHolder::GetPictureDispatch | CPictureHolder オブジェクトのIDispatch インターフェイスを返します。 |
CPictureHolder::GetType | CPictureHolder オブジェクトがビットマップ、メタファイル、アイコンのいずれであるかを示します。 |
CPictureHolder::Render | 図をレンダリングします。 |
CPictureHolder::SetPictureDispatch | CPictureHolder オブジェクトのIDispatch インターフェイスを設定します。 |
パブリック データ メンバー
名前 | 説明 |
---|---|
CPictureHolder::m_pPict | 図オブジェクトへのポインター。 |
解説
CPictureHolder
には基底クラスはありません。
stock Picture プロパティを使用すると、開発者は表示するビットマップ、アイコン、またはメタファイルを指定できます。
カスタム図プロパティの作成については、「 MFC ActiveX コントロール: ActiveX コントロールでのピクチャの使用」を参照してください。
継承階層
CPictureHolder
要件
Header: 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 が FALSE の場合、呼び出し元は、ビットマップ オブジェクトとパレット オブジェクトがピクチャ オブジェクトの有効期間中も有効であることを確認する必要があります。
CPictureHolder::CreateFromIcon
アイコンを使用して、 CPictureHolder
内の図オブジェクトを初期化します。
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
パラメーター
idResource
ビットマップ リソースのリソース ID。
hIcon
CPictureHolder
オブジェクトの作成元のアイコンを処理します。
bTransferOwnership
図オブジェクトがアイコン オブジェクトの所有権を取得するかどうかを示します。
戻り値
オブジェクトが正常に作成された場合は 0 以外。それ以外の場合は 0。
解説
bTransferOwnership が TRUE の場合、呼び出し元は、この呼び出しが返された後でアイコン オブジェクトを使用しないでください。 bTransferOwnership が FALSE の場合、呼び出し元は、アイコン オブジェクトが画像オブジェクトの有効期間中も有効であることを確認する必要があります。
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 が FALSE の場合、呼び出し元は、画像オブジェクトの有効期間中、メタファイル オブジェクトが有効なままであることを確認する必要があります。
CPictureHolder::GetDisplayString
コンテナーのプロパティ ブラウザーに表示される文字列を取得します。
BOOL GetDisplayString(CString& strValue);
パラメーター
strValue
表示文字列を保持する CString への参照。
戻り値
文字列が正常に取得された場合は 0 以外。それ以外の場合は 0。
CPictureHolder::GetPictureDispatch
この関数は、 CPictureHolder
オブジェクトの IPictureDisp
インターフェイスへのポインターを返します。
LPPICTUREDISP GetPictureDispatch();
戻り値
CPictureHolder
オブジェクトのIPictureDisp
インターフェイスへのポインター。
解説
呼び出し元は、このポインターの終了時に Release
を呼び出す必要があります。
CPictureHolder::GetType
図がビットマップ、メタファイル、アイコンのいずれであるかを示します。
short GetType();
戻り値
図の種類を示す値。 指定できる値とその意味は次のとおりです。
Value | 意味 |
---|---|
PICTYPE_UNINITIALIZED | CPictureHolder オブジェクトが一元化されます。 |
PICTYPE_NONE | CPictureHolder オブジェクトが空です。 |
PICTYPE_BITMAP | 図はビットマップです。 |
PICTYPE_METAFILE | 図はメタファイルです。 |
PICTYPE_ICON | 画像はアイコンです。 |
CPictureHolder::m_pPict
CPictureHolder
オブジェクトのIPicture
インターフェイスへのポインター。
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
インターフェイスへのポインター。