共用方式為

IExtendPropertySheet2：：GetWatermarks 方法 (mmc.h)

  • 發行項

IExtendPropertySheet2：：GetWatermarks方法會取得實作為精靈 97 樣式精靈的精靈工作表浮水印點陣圖和標頭點陣圖。

語法

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

參數

[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 的類型參數會設定為 FALSE (，而 dwOptions 參數設定為精靈 97 樣式) 的 MMC_PSO_NEWWIZARDTYPE (。
  2. 嵌入式管理單元會將指標傳遞至其 IComponentData 或 IComponent 介面，做為呼叫 IPropertySheetProvider：：AddPrimaryPages 方法的第一個參數。
如果這個方法的嵌入式管理單元實作傳回失敗值 (，例如 E_NOTIMPL) ，MMC 會在 呼叫 IPropertySheetProvider：：CreatePropertySheet 時，將嵌入式管理單元所要求的精靈工作表還原為非 Wizard 97 樣式。 這是為了維持與 MMC 1.1 的相容性。

若要避免影像失真，建議浮水印和標頭點陣圖具有下列維度， (圖元) bStretch 設為 FALSE。

點陣圖 維度
lphWatermark 164w x 628h
lphHeader 49w x 49h

需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 mmc.h

另請參閱

新增屬性頁和精靈頁面

新增精靈頁面：實作詳細資料

IExtendPropertySheet2