IPrintOemUI::D ocumentPropertySheets-Methode (prcomoem.h)
Die IPrintOemUI::DocumentPropertySheets -Methode ermöglicht es einem Benutzeroberflächen-Plug-In, eine neue Seite an das Dokumenteigenschaftenblatt eines Druckergeräts anzufügen.
Syntax
HRESULT DocumentPropertySheets(
PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parameter
pPSUIInfo
Vom Aufrufer bereitgestellter Zeiger auf eine PROPSHEETUI_INFO-Struktur .
lParam
Vom Aufrufer bereitgestellter Wert, der vom Grundwert in pPSUIInfo--Reason> abhängt. Der Grundwert kann eine der folgenden Konstanten sein, die in compstui.h definiert sind. Weitere Informationen zu diesen Konstanten finden Sie im Abschnitt Hinweise und im Abschnitt lParam-Parameterbeschreibung im Funktionstyp PFNPROPSHEETUI .
PROPSHEETUI_REASON_DESTROY
PROPSHEETUI_REASON_GET_ICON
PROPSHEETUI_REASON_GET_INFO_HEADER
PROPSHEETUI_REASON_INIT
PROPSHEETUI_REASON_SET_RESULT
Rückgabewert
Der Rückgabewert hängt vom Inhalt des Reason-Elements der PROPSHEETUI_INFO-Struktur ab. Weitere Informationen finden Sie in der Beschreibung von DrvDocumentPropertySheets.
Hinweise
Die Methode eines Benutzeroberflächen-Plug-Ins IPrintOemUI::DocumentPropertySheets führt dieselben Arten von Vorgängen wie die DrvDocumentPropertySheets-Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Beide Funktionen verfügen über die gleichen Eingabeparameter.
Wenn Sie ein Benutzeroberflächen-Plug-In bereitstellen, wird die IPrintOemUI::DocumentPropertySheets -Methode aufgerufen, nachdem die DrvDocumentPropertySheets-Funktion des Treibers aufgerufen wurde.
Wenn IPrintOemUI::DocumentPropertySheets aufgerufen wird, enthält das lParamInit-Element der PROPSHEETUI_INFO-Struktur die Adresse einer OEMUIPSPARAM-Struktur .
Wenn Sie diese Methode implementieren, stellen Sie in der Regel auch eine _CPSUICALLBACK typisierte Rückruffunktion bereit, um Benutzeränderungen zu verarbeiten. Diese Rückruffunktion muss IPrintOemDriverUI::D rvUpdateUISetting aufrufen, um den Treiber zu informieren, wenn der einer Benutzeroberflächeneinstellung zugeordnete Wert geändert wurde, wenn der Wert in der DEVMODEW-Struktur des Treibers (anstelle der privaten DEVMODEW-Member des Plug-Ins) oder in Registrierungsschlüsseln gespeichert wird.
Wenn IPrintOemUI::DocumentPropertySheets Methoden von mehreren Benutzeroberflächen-Plug-Ins exportiert werden, werden die Methoden in der Reihenfolge aufgerufen, in der die Plug-Ins für die Installation angegeben werden.
Wenn ein Benutzeroberflächen-Plug-In mehrere Druckermodelle unterstützt und Sie möchten, dass die neue Seite nur für einige dieser Modelle angezeigt wird, sollte die IPrintOemUI::DocumentPropertySheets Methode nur einen Erfolgsrückgabewert bereitstellen, ohne die Seite tatsächlich hinzuzufügen, für die Modelle, die die Seite nicht benötigen.
Weitere Informationen zum Erstellen und Installieren von Benutzeroberflächen-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (einschließlich Prcomoem.h, Compstui.h) |