Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |