C P ictureHolder

CPictureHolder 没 有 基 类 。

CPictureHolder 类 的 目 的 是 Picture 属 性 的 实 现 ， 这 使 得 用 户 可 以 在 其 控 件 中 显示 一 幅 图 画 。 通 过 固 有 的 Picture 属 性 ， 开 发 者 可 以 指 定 用 于 显 示 的 位 图 、 图 标或 图 元 文 件 。

#inclu d e <afxctl.h>

请 参 阅 CFontHolder

CPictureHolder 类 成 员

DataMembers

m_pPict 一 个 指 向 图 画 对 象 的 指 针

Construction

CPictureHolder 构 造 一 个 CPictureHolder 对 象

Operation s GetDisplayString 获 取 一 个 显 示 在 控 件 容 器 的 属 性 浏 览 器 中 的 字 符

串

CreateEmpty 创 建 一 个 空 的 CPictureHolder 对 象CreateFromBitmap 从 位 图 创 建 一 个 CPictureHolder 对象CreateFromMetafile 从 图 元 文 件 创 建 一 个 CPictureHolder 对 象CreateFromIcon 从 图 标 创 建 一 个 CPictureHolder 对象GetPictureDispatch 返 回 CpictureHolder 对 象 的 ID ispatch 接 口SetPictureDispatch 设 置 CpictureHolder 对 象 的 ID ispatch 接 口GetType 表 明 CpictureHolder 对 象 是 位 图 、 图 元 文 件 还 是 图

标

Render 画 出 此 图 画

成 员 函 数

CPictureHolder:: CPictureHolder

CPictureHolder();

说 明

此 函 数 用 来 构 造 一 个 CPictureHolder 对 象 。

请 参 阅 CPictureHolder::CreateEmpty

CPictureHolder::CreateEmpty

BOOL CreateEmpty();

如 果 成 功 地 创 建 了 对 象 ， 则 返 回 非 零 值 ； 否 则 返 回 0 。

说 明

此 函 数 创 建 一 个 空 的 CPictureHolder 对 象 ， 并 将 它 与 一 个 IPicture 接 口 连 接 。

请 参 阅 CPictureHolder::CreateFromBitmap ， CPictureHolder::CreateFromIcon， CPictureHolde r::CreateFromeMetafile

CPictureHolder:: CreateFromBitmap

BOOL CreateFromBitmap( UINT idResource );

BOOL CreateFromBitmap( CBitmap* pBitmap , CPalette* pPal = NULL, BOOL bTransferOwnership = TRUE );

BOOL CreateFromBitmap( HBITMAP hbm , HPALETTE hpal = NULL );

如 果 成 功 地 创 建 了 对 象 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

idResource

一 个 位 图 资 源 的 资 源 ID 。

pBitmap

指 向 一 个 CBitmap 对 象 的 指 针 。

pPal

指 向 一 个 CPalette 对 象 的 指 针 。

bTransferOwnership

表 明 图 画 对 象 是 否 会 获 取 位 图 和 调 色 板 对 象 的 所 有 权 。

hbm

位 图 句 柄 ， CPictureHolder 对 象 是 由 此 创 建 的 。

hpal

调 色 板 句 柄 ， 该 调 色 板 用 来 绘 制 位 图 。

说 明

此 函 数 用 一 个 位 图 来 初 始 化 一 个 CPictureHolder 中 的 图 画 对 象 。 如 果bTransferOwnership 是 TRUE ， 则 在 这 次 调 用 返 回 之 前 ， 调 用 者 不 应 该 以 任 何 方式 来 使 用 这 个 位 图 或 调 色 板 。 如 果 bTransferOwnership 是 FALSE ， 则 在 图 画 对象 的 生 命 周 期 内 由 调 用 者 来 负 责 保 证 位 图 和 调 色 板 保 持 有 效 。

请 参 阅 CPictureHolde r::CreateEmpty ， CPictureHolder::CreateFromIcon ， CPictureHolde r::CreateFromMetafile

CPictureHolder:: CreateFromIcon

BOOL CreateFromIcon( UINT idResource );

BOOL CreateFromIcon( HICON hIcon ,BOOL bTransferOwnership = FALSE );

返 回 值

如 果 创 建 对 象 成 功 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

idResource

一 个 位 图 资 源 的 资 源 ID 。

hIcon

图 标 句 柄 ， CPictureHolder 对 象 由 此 创 建 。

bTransferOwnership

表 明 这 个 图 画 对 象 是 否 会 获 得 图 标 对 象 的 所 有 权 。

此 函 数 用 一 个 图 标 来 初 始 化 一 个 CPictureHolder 中 的 图 画 对 象 。 如 果bTransferOwnership 是 TRUE ， 则 在 这 次 调 用 返 回 之 前 ， 调 用 者 不 应 该 以 任 何方 式 来 使 用 这 个 图 标 。 如 果 bTransferOwnership 是 FALSE ， 则 在 图 画 对 象 的 生命 周 期 内 由 调 用 者 来 负 责 保 证 图 标 保 持 有 效 。

请 参 阅 CPictureHolde r::CreateEmpty ， CPictureHolder::CreateFromBitmap ， CPictureHolde r::CreateFromeMetafile

CPictureHolder::CreateFromMetafile

BOOL CreateFromMetafile( HMETAFILE hm f, int xEx t, int yExt , BOOL bTransferOwnership = FALSE );

如 果 成 功 地 创 建 了 对 象 则 返 回 非 零 值 ； 否 则 返 回 0 。

参 数

hmf

xExt

图 元 文 件 的 句 柄 ， 此 图 元 文 件 用 来 创 建 CPictureHolder 对 象 。图 画 的 X 范 围 。

yExt

图 画 的 Y 范 围 。

bTransferOwnership

表 明 这 个 图 画 对 象 是 否 会 获 得 图 标 对 象 的 所 有 权 。

此 函 数 用 一 个 图 元 文 件 来 初 始 化 一 个 CPictureHolder 中 的 图 画 对 象 。 如 果bTransferOwnership 是 TRUE ， 则 在 这 次 调 用 返 回 之 前 ， 调 用 者 不 应 该 以 任 何方 式 来 使 用 这 个 图 元 文 件 。 如 果 bTransferOwnership 是 FALSE ， 则 在 图 画 对 象的 生 命 周 期 内 由 调 用 者 来 负 责 保 证 这 个 图 元 文 件 保 持 有 效 。

请 参 阅 CPictureHolde r::CreateEmpty ， CPictureHolder::CreateFromBitmap ， CPictureHolde r::CreateFrom Icon

CPictureHolder::GetDisplayString

BOOL GetDisplayString( CString& strValue );

返 回 值

如 果 成 功 地 获 取 了 字 符 串 则 返 回 非 零 值 ； 否 则 返 回 0 。

strValue

用 来 保 存 显 示 字 符 串 的 CString 的 引 用 。

说 明

此 函 数 用 来 获 取 被 显 示 在 一 个 容 器 的 属 性 浏 览 器 中 的 字 符 串 。

CPictureHolder::GetPictureDispatch LPPICTUREDISP GetPictureDispatch(); 返 回 值

返 回 一 个 指 向 CPictrureHolder 对 象 的 IPictureDisp 接 口 的 指 针 。

此 函 数 返 回 一 个 指 向 CPictrureHolder 对 象 的 IPictureDisp 接 口 的 指 针 。 当 使 用完 这 个 指 针 后 ， 用 户 必 须 对 它 调 用 Release 。

请 参 阅 CPictureHolder::SetPictureDispatch

CPictureHolder::GetType

short GetType();

返 回 值

是 一 个 表 明 图 画 类 型 的 值 。 它 可 能 的 取 值 及 含 义 如 下 所 示 ：

Value M ea n ing

PICTYPE_UNINITIALIZ ED

CpictureHolder 对 象 没 有 被 初 始 化

续 表

PICTYPE_NONE CpictureHolder 对 象 是 空 的

PICTYPE_BITMAP 图 画 是 一 个 位 图PICTYPE_METAFILE 图 画 是 一 个 图 元 文 件PICTYPE_ICON 图 画 是 一 个 图 标

说 明

此 函 数 用 来 表 明 图 画 是 位 图 、 图 元 文 件 还 是 一 个 图 标 。

CPictureHolder::Render

void Render( CDC* pDC , const CRect& rcRende r, const CRect& rcWBounds );

参 数

pDC

指 向 一 个 显 示 环 境 的 指 针 ， 图 画 被 显 示 在 这 个 环 境 中 。

rcRe nder

• 个 矩 形 ， 图 画 被 显 示 在 这 个 矩 形 中 。

rcWBounds

• 个 矩 形 ， 它 代 表 显 示 该 图 画 的 对 象 的 边 界 矩 形 。 对 一

  个 控 件 来 说 ， 这 个矩 形 是 被 传 递 给 一 个 重 载 的 COleControl::OnDraw 函 数 的 rcBounds 参 数 。

说 明

此 函 数 将 图 画 显 示 在 由 rcRender 引 用 的 矩 形 中 。

CPictureHolder::SetPictureDispatch

void SetPictureDispatch( LPPICTUREDISP pDisp );

参 数

pDisp

指 向 新 的 IPictureDisp 接 口 的 指 针 。

说 明

此 函 数 将 CPictureHolder 对 象 连 接 到 IPictureDisp 接 口 。

请 参 阅 CPictureHolder::GetPictureDispatc h

数 据 成 员

CPictureHolder::m_pPict

说 明

此 数 据 成 员 是 一 个 指 向 CPictureHolder 对 象 的 IPicture 接 口 的 指 针 。