Metodo IExtendPropertySheet2::GetWatermarks (mmc.h)

Articolo
03/08/2023

Il metodo IExtendPropertySheet2::GetWatermarks ottiene la bitmap della filigrana e l'intestazione bitmap per i fogli della procedura guidata implementati come procedure guidate in stile Wizard 97.

Sintassi

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

Parametri

[in] lpIDataObject

Puntatore all'interfaccia IDataObject dell'oggetto che contiene informazioni di contesto sull'ambito o sull'elemento risultato.

[out] lphWatermark

Puntatore all'handle a una bitmap che funge da filigrana per le pagine della procedura guidata 97. Se l'handle per la bitmap è NULL, non viene visualizzata alcuna filigrana per la procedura guidata. Se questo valore non è NULL, lo snap-in, per la compatibilità, deve gestire la durata della risorsa limite. Lo snap-in è responsabile della liberazione della risorsa limite.

[out] lphHeader

Puntatore all'handle a una bitmap che funge da intestazione per le pagine della procedura guidata 97. Se l'handle per la bitmap è NULL, non verrà visualizzata alcuna bitmap nell'intestazione per le pagine della procedura guidata. Se questo valore non è NULL, lo snap-in, per la compatibilità, deve gestire la durata della risorsa di intestazione. Lo snap-in è responsabile della liberazione della risorsa di intestazione.

[out] lphPalette

Puntatore all'handle a una tavolozza che deve essere usata per le bitmap specificate da lphWatermark e lphHeader. La tavolozza è NULL per impostazione predefinita. Se non viene restituita una tavolozza, la tavolozza è NULL. Se questo valore non è NULL, lo snap-in, per la compatibilità, deve gestire la durata della risorsa tavolozza. Lo snap-in è responsabile della liberazione della risorsa tavolozza.

[out] bStretch

Valore che specifica se le bitmap di filigrana e intestazione devono essere estese, anziché affiancate, per adattarsi all'area di sfondo o di intestazione della finestra delle proprietà. TRUE specifica che le bitmap di filigrana e intestazione devono essere estese; FALSE specifica che le bitmap della filigrana e dell'intestazione devono mantenere le dimensioni e essere affiancate. Questo parametro è FALSE per impostazione predefinita. Se non viene restituito un valore bStretch , bStretch è FALSE.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

MMC chiama questo metodo solo quando:

Il parametro di tipo di IPropertySheetProvider::CreatePropertySheet è impostato su FALSE (per il foglio della procedura guidata) e che il parametro dwOptions è impostato su MMC_PSO_NEWWIZARDTYPE (per lo stile della procedura guidata 97).
Lo snap-in passa un puntatore alla relativa interfaccia IComponentData o IComponent come primo parametro nelle chiamate al metodo IPropertySheetProvider::AddPrimaryPages .

Se l'implementazione dello snap-in di questo metodo restituisce un valore di errore (ad esempio E_NOTIMPL), MMC ripristina il foglio della procedura guidata richiesto dallo snap-in nella chiamata a IPropertySheetProvider::CreatePropertySheet allo stile non 97 della procedura guidata. Si tratta di mantenere la compatibilità con MMC 1.1.

Per evitare distorsioni dell'immagine, è consigliabile che le bitmap della filigrana e dell'intestazione abbiano le dimensioni seguenti (in pixel) con bStretch impostato su FALSE.