Método IExtendPropertySheet2::GetWatermarks (mmc.h)

Artículo
03/08/2023

El método IExtendPropertySheet2::GetWatermarks obtiene el mapa de bits de marca de agua y el mapa de bits de encabezado para las hojas del asistente implementadas como asistentes de estilo 97 del Asistente.

Sintaxis

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

Parámetros

[in] lpIDataObject

Puntero a la interfaz IDataObject del objeto que contiene información de contexto sobre el ámbito o el elemento de resultado.

[out] lphWatermark

Puntero al identificador de un mapa de bits que actúa como marca de agua para las páginas del Asistente 97. Si el identificador del mapa de bits es NULL, no se muestra ninguna marca de agua para el asistente. Si este valor no es NULL, el complemento, por motivos de compatibilidad, debe administrar la duración del recurso de marca de agua. El complemento es responsable de liberar el recurso de marca de agua.

[out] lphHeader

Puntero al identificador de un mapa de bits que actúa como encabezado para las páginas del Asistente 97. Si el identificador del mapa de bits es NULL, no se mostrará ningún mapa de bits en el encabezado de las páginas del asistente. Si este valor no es NULL, el complemento, por motivos de compatibilidad, debe administrar la duración del recurso de encabezado. El complemento es responsable de liberar el recurso de encabezado.

[out] lphPalette

Puntero al identificador de una paleta que se debe usar para los mapas de bits especificados por lphWatermark y lphHeader. La paleta es NULL de forma predeterminada. Si no se devuelve una paleta, la paleta es NULL. Si este valor no es NULL, el complemento, por motivos de compatibilidad, debe administrar la duración del recurso de paleta. El complemento es responsable de liberar el recurso de paleta.

[out] bStretch

Valor que especifica si se deben estirar la marca de agua y los mapas de bits de encabezado ( en lugar de en mosaico) para ajustarse al área de fondo o encabezado de la hoja de propiedades. TRUE especifica que se deben estirar las marcas de agua y los mapas de bits de encabezado; FALSE especifica que la marca de agua y los mapas de bits de encabezado deben mantener su tamaño y estar en mosaico. Este parámetro es FALSE de forma predeterminada. Si no se devuelve un valor bStretch , bStretch es FALSE.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

MMC llama a este método solo cuando:

El parámetro type de IPropertySheetProvider::CreatePropertySheet se establece en FALSE (para la hoja del asistente) y que el parámetro dwOptions se establece en MMC_PSO_NEWWIZARDTYPE (para el estilo del Asistente 97).
El complemento pasa un puntero a su interfaz IComponentData o IComponent como primer parámetro de las llamadas al método IPropertySheetProvider::AddPrimaryPages .

Si la implementación del complemento de este método devuelve un valor de error (como E_NOTIMPL), MMC revierte la hoja del asistente solicitada por el complemento en la llamada a IPropertySheetProvider::CreatePropertySheet al estilo que no es del Asistente 97. Esto es para mantener la compatibilidad con MMC 1.1.

Para evitar la distorsión de la imagen, se recomienda que las marcas de agua y los mapas de bits de encabezado tengan las dimensiones siguientes (en píxeles) con bStretch establecido en FALSE.