CPropertySheetEx

CPropertySheetEx 支 持 在 W indows 98 和 W indows NT 5 中 引 进 的

PROPSHEETHEADER 结 构 。 该 结 构 包 含 了 附 加 的 标 志 和 成 员 ， 支 持 下 面 的 特征 ：

• 一个 “ 水 印 ” 背 景 位 图 。

为 了 在 你 的 属 性 表 对 象 中 自 动 显 示 这 些 新 的 图 像 ， 在 调 用CPropertySheetEx::Construct 或 CPropertySheetEx:: CPropertySheetEx 时 要 给 位 图和 剪 贴 板 图 像 传 递 有 效 的 值 。

在 所 有 其 它 的 方 面 ， CPropertySheetEx 具 有 与 它 的 基 类 CPropertySheet 相 同 的行 为 。

请 参 阅 CPropertyPage ， CPropertyPageEx

CPropertySheetEx 类 成 员

Construction

CPropertySheetEx 构 造 一 个 CPropertySheetEx 对 象

Construct 构 造 一 个 CPropertySheetEx 对 象 。 由 具 有 多 个 参数 的 属 性 页 使 用

Data M embers

m_psh PRO P SHEETHEADER 结 构 ， 它 的 成 员 包 含 了 要创 建 的 属 性 表 的 特 征

Operation

AddPage 给 属 性 表 添 加 一 个 页

请 参 阅 CPropertyPage ， CPropertyPageEx

成 员 函 数

CPropertySheetEx::AddPage

void AddPage(CPropertyPageEx* pPage );

参 数

pPage

指 向 一 个 要 被 添 加 到 属 性 表 中 的 页 。 不 能 是 NULL 。

说 明

此 成 员 函 数 用 来 向 属 性 表 中 添 加 一 个 属 性 页 。 按 你 所 希 望 的 从 左 至 右 的 顺 序 来添 加 页 。

CPropertySheetEx::Construct

void Construct( UINT nIDCaption , CWnd* pParentWnd = NULL, UINT

iSelectPage = 0,

HBITMAP hbmWatermark = NULL, HPALETTE hpalWatermark = NULL, HBITMAP hbmHeader = NULL );

void Construct( LPCTSTR pszCaption , CWnd* pParentWnd = NULL, UINT

iSelectPage = 0,

HBITMAP hbmWatermark = NULL, HPALETTE hpalWatermark = NULL, HBITMAP hbmHeader = NULL );

参 数

nIDCaption

要 用 在 属 性 表 中 的 标 题 的 ID 。

pParentWnd

指 向 属 性 表 的 父 窗 口 的 指 针 。 如 果 是 NULL ， 则 父 窗 口 将 是 应 用 程 序 的 主窗 口 。

iSelectPage

最 初 将 要 在 最 项 上 的 页 的 索 引 。 缺 省 的 是 被 添 加 到 表 中 的 第 一 页 。

hbmWatermark

属 性 页 的 水 印 位 图 的 句 柄 。

hpalWatermark

水 印 位 图 和 /或 页 眉 位 图 的 调 色 板 的 句 柄 。

hbmHeader

属 性 页 的 页 眉 位 图 的 句 柄 。

pszCaption

指 向 一 个 字 符 串 的 指 针 ， 该 字 符 串 包 含 了 用 于 属 性 表 的 标 题 。 它 不 能 是

NULL 。

说 明

此 成 员 函 数 用 来 构 造 一 个 CPropertySheetEx 对 象 。 要 获 取 更 多 的 信 息 ， 请 参 见

CPropertySheet::Construc t。

要 显 示 这 个 属 性 表 ， 请 调 用 DoModal 或 Create 。 包 含 在 第 一 个 参 数 中 的 字 符 串将 被 放 在 属 性 表 的 标 题 条 中 。

如 果 在 调 用 Construct 时 传 递 的 值 是 有 效 的 ， 则 水 印 和 /或 页 眉 图 像 被 自 动 显 示 。

请 参 阅 CPropertySheetEx:: CPropertySheetEx

CPropertySheetEx::CPropertySheetEx

CPropertySheetEx();

CPropertySheetEx( UINT nIDCaption , CW nd* pParentWnd = NULL, UINT

iSelectPage = 0,

HBITMAP hbmWatermark = NULL, HPALETTE hpalWatermark = NULL, HBITMAP hbmHeader = NULL );

CPropertySheetEx(LPCTSTR pszCaption ,CWnd* pParentWnd = NULL,UINT

iSelectPage = 0,

HBITMAP hbmWatermark = NULL, HPALETTE hpalWatermark = NULL, HBITMAP hbmHeader = NULL );

参 数

nIDCaption

要 用 在 属 性 表 中 的 标 题 的 ID 。

pParentWnd

指 向 属 性 表 的 父 窗 口 的 指 针 。 如 果 是 NULL ， 则 父 窗 口 将 是 应 用 程 序 的 主窗 口 。

iSelectPage

最 初 将 要 在 最 项 上 的 页 的 索 引 。 缺 省 的 是 被 添 加 到 表 中 的 第 一 页 。

hbmWatermark

属 性 页 的 水 印 位 图 的 句 柄 。

hpalWatermark

水 印 位 图 和 /或 页 眉 位 图 的 调 色 板 的 句 柄 。

hbmHeader

属 性 页 的 页 眉 位 图 的 句 柄 。

pszCaption

指 向 一 个 字 符 串 的 指 针 ， 该 字 符 串 包 含 了 用 于 属 性 表 的 标 题 。 它 不 能 是

NULL 。

说 明

此 成 员 函 数 用 来 构 造 一 个 CPropertySheetEx 对 象 。 要 显 示 这 个 属 性 表 ， 请 调 用DoModal 或 Create 。 包 含 在 第 一 个 参 数 中 的 字 符 串 将 被 放 置 在 属 性 表 的 标 题 条中 。

如 果 你 有 多 个 参 数 （ 例 如 ， 如 果 你 正 使 用 一 个 数 组 ） ， 使 用

CPropertySheetEx::Construct 来 代 替 CPropertySheetEx。

如 果 在 调 用 Construct 时 传 递 的 值 是 有 效 的 ， 则 水 印 和 /或 页 眉 图 像 被 自 动 显 示 。

请 参 阅 CPropertySheetEx::Construct

数 据 成 员

CPropertySheetEx::m_psh

说 明

此 数 据 成 员 是 一 个 结 构 ， 它 的 成 员 保 存 了 PROPSHFETHEADER 的 特 征 。 在 创建 了 一 个 属 性 表 之 后 ， 并 在 调 用 CPropertySheetEx::DoModal 来 显 示 它 之 前 ， 可以 使 用 这 个 结 构 来 初 始 化 这 个 属 性 表 的 外 观 。 例 如 ， 将 m_psh 的 成 员 dwSize 的 设 置 为 你 的 属 性 表 想 要 具 有 的 尺 寸 。

如 果 要 获 取 更 多 有 关 这 个 结 构 的 信 息 ， 包 括 它 的 成 员 的 列 表 ， 请 参 见 “ Platform SDK ” 中 的 PROPSHEETHEADER 。

请 参 阅 CPropertySheetEx::Construct