次の方法で共有

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 の type パラメーターは FALSE (ウィザード シートの場合) に設定され、dwOptions パラメーターは MMC_PSO_NEWWIZARDTYPE (ウィザード 97 スタイルの場合) に設定されます。
  2. スナップインは、IPropertySheetProvider::AddPrimaryPages メソッドの呼び出しの最初のパラメーターとして、IComponentData または IComponent インターフェイスへのポインターを渡します。
このメソッドのスナップインの実装でエラー値 ( E_NOTIMPL など) が返された場合、MMC は IPropertySheetProvider::CreatePropertySheet の呼び出しでスナップインによって要求されたウィザード シートをウィザード 97 以外のスタイルに戻します。 これは、MMC 1.1 との互換性を維持するためです。

イメージの歪みを防ぐために、透かしとヘッダーのビットマップには、 bStretch を FALSE に設定した次のサイズ (ピクセル単位) を使用することをお勧めします。

Bitmap Dimensions
lphWatermark 164w x 628h
lphHeader 49w x 49h

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー mmc.h

関連項目

プロパティ ページとウィザード ページの追加

ウィザード ページの追加: 実装の詳細

IExtendPropertySheet2