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 motivo | Definizione di lParam |
|---|---|
| PROPSHEETUI_REASON_INIT | Puntatore a una struttura DOCUMENTPROPERTYHEADER . |
| Tutti gli altri valori motivo | Vedere la descrizione del parametro lParam per il tipo di funzione PFNPROPSHEETUI . L'indirizzo della struttura DOCUMENTPROPERTYHEADER è contenuto nel membro lParamInit della struttura PROPSHEETUI_INFO . |
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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winddiui.h (include Winddiui.h) |