IPrintOemUI::D ocumentPropertySheets-Methode (prcomoem.h)

Artikel
02/07/2025

Mit der IPrintOemUI::DocumentPropertySheets-Methode kann ein Benutzeroberflächen-Plug-In eine neue Seite an das Dokumenteigenschaftenblatt eines Druckergeräts anfü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-->Reasonabhä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 lParam Parameterbeschreibung im PFNPROPSHEETUI- Funktionstyp.

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 der PROPSHEETUI_INFO Struktur Reason Member ab. Weitere Informationen finden Sie in der Beschreibung von DrvDocumentPropertySheets.

Bemerkungen

Die IPrintOemUI::DocumentPropertySheets-Methode eines Plug-Ins für die Benutzeroberfläche führt dieselben Arten von Vorgängen wie die DrvDocumentPropertySheets--Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Beide Funktionen haben dieselben Eingabeparameter.

Wenn Sie ein Plug-In für die Benutzeroberfläche bereitstellen, wird die IPrintOemUI::DocumentPropertySheets-Methode aufgerufen, nachdem die DrvDocumentPropertySheets--Funktion des Treibers aufgerufen wurde.

Wenn IPrintOemUI::DocumentPropertySheets aufgerufen wird, enthält das lParamInit- Mitglied der PROPSHEETUI_INFO-Struktur die Adresse einer OEMUIPSPARAM- Struktur.

Wenn Sie diese Methode implementieren, geben Sie in der Regel auch eine _CPSUICALLBACK-typed callback function to handle user modifications an. Diese Rückruffunktion muss IPrintOemDriverUI::D rvUpdateUISetting aufrufen, um den Treiber darüber zu informieren, wenn der mit einer Benutzeroberflächeneinstellung verknüpfte 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 ist.

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 Plug-In für die Benutzeroberfläche mehrere Druckermodelle unterstützt und die neue Seite nur für einige dieser Modelle angezeigt werden soll, sollte die methode IPrintOemUI::DocumentPropertySheets nur einen Erfolgsrücklaufwert bereitstellen, ohne die Seite tatsächlich hinzuzufügen, für die Modelle, die die Seite nicht erfordern.

Weitere Informationen zum Erstellen und Installieren von Plug-Ins für die Benutzeroberfläche finden Sie unter Anpassen der Druckertreiber von Microsoft.