DrvDocumentPropertySheets-Funktion (winddiui.h)
Die Funktion "DrvDocumentPropertySheets " einer Druckerschnittstelle 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
Aufrufer-bereitgestellter Zeiger auf eine PROPSHEETUI_INFO Struktur. Kann NULL sein (siehe den folgenden Abschnitt "Hinweise").
lParam
Aufrufer-bereitgestellter ganzzahliger Wert, der vom Inhalt des Grundelements der PROPSHEETUI_INFO-Struktur abhängig ist, wie in der folgenden Tabelle aufgeführt.
| Grundwert | Definition von lParam |
|---|---|
| PROPSHEETUI_REASON_INIT | Zeiger auf eine DOCUMENTPROPERTYHEADER-Struktur . |
| Alle anderen Grundwerte |
Siehe die Beschreibung des lParam-Parameters für den PFNPROPSHEETUI-Funktionstyp .
(Die Adresse der DOCUMENTPROPERTYHEADER-Struktur ist im lParamInit-Element der PROPSHEETUI_INFO-Struktur enthalten.) |
Rückgabewert
Wenn pPSUIInfoNULL ist, und wenn entweder lParam ->fMode null oder lParam -pdmOutNULL ist, sollte diese Funktion die Größe des Druckers in Bytes der DEVMODEW-Struktur> des Druckers zurückgeben. Andernfalls ist der Rückgabewert der Funktion identisch wie im Abschnitt "ReturnValue" des PFNPROPSHEETUI-Funktionstyps beschrieben. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
Bemerkungen
Alle Druckerschnittstellen-DLLs müssen eine DrvDocumentPropertySheets-Funktion bereitstellen, die mithilfe des PFNPROPSHEETUI-Funktionstyps definiert ist. Der Zweck der Funktion besteht darin, die Von CPSUI bereitgestellte ComPropSheet-Funktion aufzurufen, um Eigenschaftenblattseiten anzugeben, die benutzerveränderbare Eigenschaften für Druckdokumente enthalten.
Wenn der für den pPSUIInfo-Parameter empfangene Wert nicht NULL ist, ruft der NT-basierte Betriebssystemdruckspooler die Funktion indirekt über CPSUI auf. Es gelten die folgenden Regeln:
- Die Funktion sollte Vorgänge ausführen, wie für den PFNPROPSHEETUI-Funktionstyp beschrieben.
- Flags im fMode-Element der 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 das fMode-Element der DOCUMENTPROPERTYHEADER-Struktur null ist oder das pdmOut-Element der gleichen Struktur NULL ist, sollte die Funktion nur die Gesamtgröße der DEVMODEW-Struktur des Druckers zurückgeben, einschließlich öffentlicher und privater Strukturmitglieder, im CBOut-Element der DOCUMENTPROPERTYHEADER-Struktur.
- Wenn das fMode-Element der DOCUMENTPROPERTYHEADER-Struktur nicht null ist, sollte die Funktion die von den 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
| Zielplattform | Power BI Desktop |
| Header | winddiui.h (einschließlich Winddiui.h) |