Freigeben über


DrvDocumentPropertySheets-Funktion (winddiui.h)

Die DrvDocumentPropertySheets Funktion einer Druckerschnittstellen-DLL ist für das Erstellen von Eigenschaftenblattseiten verantwortlich, die die Eigenschaften eines Druckdokuments beschreiben.

Syntax

LONG DrvDocumentPropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

Parameter

[in, optional] pPSUIInfo

Vom Aufrufer bereitgestellter Zeiger auf eine PROPSHEETUI_INFO-Struktur. Kann NULL- sein (siehe den folgenden Abschnitt "Hinweise").

lParam

Vom Aufrufer bereitgestellter ganzzahliger Wert, der vom Inhalt des Reason Member der PROPSHEETUI_INFO Struktur abhängig ist, wie in der folgenden Tabelle aufgeführt.

Reason-Wert Definition von lParam-
PROPSHEETUI_REASON_INIT Zeiger auf eine DOCUMENTPROPERTYHEADER Struktur.
Alle anderen Grundwerte Weitere Informationen finden Sie in der Beschreibung des lParam--Parameters für den PFNPROPSHEETUI- Funktionstyp. (Die Adresse der DOCUMENTPROPERTYHEADER Struktur ist im lParamInit Mitglied der PROPSHEETUI_INFO Struktur enthalten.)

Rückgabewert

Wenn pPSUIInfo-NULL-ist und wenn entweder lParam ->fMode null oder lParam ->pdmOutNULList, sollte diese Funktion die Größe der DEVMODEW- Struktur des Druckers in Byte zurückgeben. Andernfalls entspricht der Rückgabewert der Funktion dem im Abschnitt "ReturnValue" des PFNPROPSHEETUI Funktionstyps beschrieben. Weitere Informationen finden Sie im Abschnitt "Hinweise".

Bemerkungen

Alle Druckerschnittstellen-DLLs müssen eine DrvDocumentPropertySheets--Funktion bereitstellen, die mithilfe des PFNPROPSHEETUI- Funktionstyps definiert wird. Der Zweck der Funktion besteht darin, die ComPropSheet--Funktion aufzurufen, die von CPSUI-bereitgestellt wird, um Eigenschaftenblattseiten anzugeben, die benutzerdefinierte Eigenschaften für Druckdokumente enthalten.

Wenn der für den pPSUIInfo Parameter empfangene Wert nicht NULL-ist, ruft der NT-basierte Betriebssystemspooler die Funktion indirekt über CPSUI auf. Die folgenden Regeln gelten:

  • Die Funktion sollte Vorgänge wie für den PFNPROPSHEETUI- Funktionstyp beschrieben ausführen.

  • Flags im fMode Member des DOCUMENTPROPERTYHEADER Struktur geben an, welche Eigenschaftenblattseiten angezeigt werden sollen und ob der Benutzer die Eigenschaften eines Dokuments ändern darf. Die einzigen Kennzeichen, die festgelegt werden können, sind DM_IN_PROMPT (oder DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION und DM_OUT_BUFFER (oder DM_COPY).

Wenn der für den pPSUIInfo Parameter empfangene Wert NULL-ist, ruft der Druckspooler die Funktion direkt auf, ohne cpSUI zu durchlaufen. In diesem Fall enthält der parameter lParam die Adresse einer DOCUMENTPROPERTYHEADER-Struktur, und die folgenden Regeln gelten:

  • Wenn das fMode-Element des DOCUMENTPROPERTYHEADER Struktur null ist, oder wenn das pdmOut- Mitglied derselben Struktur NULL-ist, sollte die Funktion nur die Gesamtgröße der DEVMODEW--Struktur des Druckers zurückgeben, einschließlich elemente der öffentlichen und privaten Struktur, im cbOut Member der DOCUMENTPROPERTYHEADER-Struktur.

  • Wenn der fMode Member der DOCUMENTPROPERTYHEADER-Struktur nicht 0 ist, sollte die Funktion die durch die fMode Flags angegebenen Vorgänge ausführen. Die einzigen Kennzeichen, die festgelegt werden können, sind DM_IN_BUFFER (oder DM_MODIFY) und DM_OUT_BUFFER (oder DM_COPY).

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- winddiui.h (include Winddiui.h)

Siehe auch

DOCUMENTPROPERTYHEADER-

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets