Funzione DrvDocumentPropertySheets (winddiui.h)

La funzione DrvDocumentPropertySheets di un'interfaccia della stampante è responsabile della creazione di pagine della finestra delle proprietà che descrivono le proprietà di un documento di stampa.

Sintassi

LONG DrvDocumentPropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

Parametri

[in, optional] pPSUIInfo

Puntatore fornito dal chiamante a una struttura PROPSHEETUI_INFO . Può essere NULL (vedere la sezione Osservazioni seguente).

lParam

Valore intero fornito dal chiamante che dipende dal contenuto del membro Reason della struttura PROPSHEETUI_INFO, come indicato nella tabella seguente.

Valore restituito

Se pPSUIInfo è NULL e se lParam ->fMode è zero o lParam ->pdmOut è NULL, questa funzione deve restituire le dimensioni, in byte, della struttura DEVMODEW della stampante. In caso contrario, il valore restituito della funzione è uguale a quello descritto nella sezione ReturnValue del tipo di funzione PFNPROPSHEETUI . Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Tutte le DLL dell'interfaccia della stampante devono fornire una funzione DrvDocumentPropertySheets , definita usando il tipo di funzione PFNPROPSHEETUI . Lo scopo della funzione è chiamare la funzione ComPropSheet , fornita da CPSUI, per specificare le pagine della finestra delle proprietà contenenti proprietà modificabili dall'utente per i documenti di stampa.

Se il valore ricevuto per il parametro pPSUIInfo non è NULL, lo spooler di stampa del sistema operativo basato su NT chiama indirettamente la funzione tramite CPSUI. Sono applicabili le regole seguenti:

• La funzione deve eseguire operazioni come descritto per il tipo di funzione PFNPROPSHEETUI .

• I flag nel membro fMode della struttura DOCUMENTPROPERTYHEADER indicano le pagine della finestra delle proprietà da visualizzare e se l'utente deve essere autorizzato a modificare le proprietà di un documento. Gli unici flag che possono essere impostati sono DM_IN_PROMPT (o DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION e DM_OUT_BUFFER (o DM_COPY).

Se il valore ricevuto per il parametro pPSUIInfo è NULL, lo spooler di stampa chiama direttamente la funzione, senza passare attraverso CPSUI. In questo caso, il parametro lParam contiene l'indirizzo di una struttura DOCUMENTPROPERTYHEADER e si applicano le regole seguenti:

• Se il membro fMode della struttura DOCUMENTPROPERTYHEADER è zero o se il membro pdmOut della stessa struttura è NULL, la funzione deve restituire solo le dimensioni totali della struttura DEVMODEW della stampante, inclusi i membri della struttura public e private, nel membro cbOut della struttura DOCUMENTPROPERTYHEADER.

• Se il membro fMode della struttura DOCUMENTPROPERTYHEADER non è zero, la funzione deve eseguire le operazioni indicate dai flag fMode . Gli unici flag che possono essere impostati sono DM_IN_BUFFER (o DM_MODIFY) e DM_OUT_BUFFER (o DM_COPY).

Requisiti

Vedi anche

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets