通过

IExtendPropertySheet2：：GetWatermarks 方法 (mmc.h)

  • 项目

IExtendPropertySheet2：：GetWatermarks 方法获取作为向导 97 样式向导实现的向导表的水印位图和标头位图。

语法

HRESULT GetWatermarks(
  [in]  LPDATAOBJECT lpIDataObject,
  [out] HBITMAP      *lphWatermark,
  [out] HBITMAP      *lphHeader,
  [out] HPALETTE     *lphPalette,
  [out] BOOL         *bStretch
);

parameters

[in] lpIDataObject

指向对象上的 IDataObject 接口的指针，该接口包含有关范围或结果项的上下文信息。

[out] lphWatermark

指向位图句柄的指针，位图用作向导 97 页的水印。 如果位图的句柄为 NULL，则向导不会显示水印。 如果此值不为 NULL，则管理单元（为了保持兼容性）应管理水印资源的生存期。 管理单元负责释放水印资源。

[out] lphHeader

指向位图句柄的指针，该位图用作向导 97 页的页眉。 如果位图的句柄为 NULL，则向导页的标头中不会显示任何位图。 如果此值不是 NULL，则管理单元（为了保持兼容性）应管理标头资源的生存期。 管理单元负责释放标头资源。

[out] lphPalette

指向调色板的句柄的指针，该调色板应用于 lphWatermark 和 lphHeader 指定的位图。 默认情况下，调色板为 NULL 。 如果未返回调色板，则调色板为 NULL。 如果此值不为 NULL，则管理单元应管理调色板资源的生存期，以保持兼容性。 管理单元负责释放调色板资源。

[out] bStretch

一个 值，该值指定水印和标题位图是否应拉伸（而不是平铺）以适应属性表的背景或标题区域。 TRUE 指定应拉伸水印和标头位图; FALSE 指定水印和标题位图应保持其大小并平铺。 此参数默认为 FALSE 。 如果未返回 bStretch 值， 则 bStretch 为 FALSE。

返回值

此方法可以返回其中一个值。

注解

MMC 仅在以下情况下调用此方法：

  1. 对于向导表) ，IPropertySheetProvider：：CreatePropertySheet 的 type 参数设置为 FALSE (，而对于 Wizard 97 样式 ) ，dwOptions 参数设置为 MMC_PSO_NEWWIZARDTYPE (。
  2. 管理单元将指向其 IComponentData 或 IComponent 接口的指针作为调用 IPropertySheetProvider：：AddPrimaryPages 方法的第一个参数。
如果管理单元的此方法实现返回失败值 (（例如 E_NOTIMPL) ），MMC 会将调用 IPropertySheetProvider：：CreatePropertySheet 时管理单元请求的向导表还原为非向导 97 样式。 这是为了保持与 MMC 1.1 的兼容性。

为了防止图像失真，建议水印和标题位图的以下尺寸 (像素) bStretch 设置为 FALSE。

Bitmap 维度
lphWatermark 164w x 628h
lphHeader 49w x 49h

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h

另请参阅

添加属性页和向导页

添加向导页：实现详细信息

IExtendPropertySheet2