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

Artikel
02/29/2024

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.