Metodo IPrintOemUI::D ocumentPropertySheets (prcomoem.h)

Articolo
02/29/2024

Il IPrintOemUI::DocumentPropertySheets metodo consente a un plug-in dell'interfaccia utente di aggiungere una nuova pagina alla scheda delle proprietà del dispositivo stampante.

Sintassi

HRESULT DocumentPropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Parametri

pPSUIInfo

Puntatore fornito dal chiamante a una struttura di PROPSHEETUI_INFO .

lParam

Valore fornito dal chiamante che dipende dal valore motivo in pPSUIInfo-->Reason. Il valore motivo può essere una delle costanti seguenti, definite in compstui.h. Per altre informazioni su queste costanti, vedere la sezione Osservazioni e la descrizione del parametro lParam nel tipo di funzione PFNPROPSHEETUI .

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

Valore restituito

Il valore restituito dipende dal contenuto del membro Motivo della struttura di PROPSHEETUI_INFO. Per altre informazioni, vedere la descrizione di DrvDocumentPropertySheets.

Commenti

Il metodo del plug-in dell'interfaccia IPrintOemUI::DocumentPropertySheets utente esegue gli stessi tipi di operazioni della funzione DrvDocumentPropertySheets esportata dalle DLL dell'interfaccia della stampante in modalità utente. Entrambe le funzioni hanno gli stessi parametri di input.

Se si specifica un plug-in dell'interfaccia utente, il IPrintOemUI::DocumentPropertySheets metodo viene chiamato dopo la chiamata della funzione DrvDocumentPropertySheets del driver.

Quando IPrintOemUI::DocumentPropertySheets viene chiamato, il membro lParamInit della struttura PROPSHEETUI_INFO contiene l'indirizzo di una struttura OEMUIPSPARAM .

Se si implementa questo metodo, in genere si specifica anche una funzione di callback tipizzata _CPSUICALLBACK per gestire le modifiche utente. Questa funzione di callback deve chiamare IPrintOemDriverUI::D rvUpdateUISetting per informare il driver quando il valore associato a un'impostazione dell'interfaccia utente è stato modificato, se il valore viene archiviato nella struttura DEVMODEW del driver (anziché i membri DEVMODEW privati del plug-in) o nelle chiavi del Registro di sistema.

Se IPrintOemUI::DocumentPropertySheets i metodi vengono esportati da più plug-in dell'interfaccia utente, i metodi vengono chiamati nell'ordine in cui vengono specificati i plug-in per l'installazione.

Se un plug-in dell'interfaccia utente supporta diversi modelli di stampante e se si vuole visualizzare solo la nuova pagina per alcuni di questi modelli, il IPrintOemUI::DocumentPropertySheets metodo deve solo fornire un valore restituito riuscito, senza aggiungere effettivamente la pagina, per i modelli che non richiedono la pagina.

Per altre informazioni sulla creazione e l'installazione dei plug-in dell'interfaccia utente, vedere Personalizzazione dei driver di stampante microsoft.