CommonPropertySheetUIA-Funktion (compstui.h)

Die CommonPropertySheetUI-Funktion von CPSUI zeigt Eigenschaftenblattseiten an und ermöglicht Benutzeränderungen, um angezeigte Werte anzuzeigen.

Syntax

LONG CommonPropertySheetUIA(
  HWND           hWndOwner,
  PFNPROPSHEETUI pfnPropSheetUI,
  LPARAM         lParam,
  LPDWORD        pResult
);

Parameter

hWndOwner

Vom Aufrufer bereitgestelltes Fensterhandle, das das Fenster angibt, in dem neue Eigenschaftenblattseiten platziert werden sollen.

pfnPropSheetUI

Vom Aufrufer bereitgestellter Zeiger auf eine PFNPROPSHEETUI-typisierte Rückruffunktion.

lParam

Vom Aufrufer bereitgestellter Wert, der als Eingabeargument für die PfnPropSheetUI-Funktion verwendet wird. Dieser Wert kann ein Zeiger sein.

pResult

Vom Aufrufer bereitgestellter Zeiger auf ein DWORD, das die endgültige Rückgabe status der Funktion pfnPropSheetUI empfängt. Bei NULL wird die endgültige rückgabe status nicht zurückgegeben. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Die CommonPropertySheetUI-Funktion gibt einen der folgenden Werte zurück:

Hinweise

Die CommonPropertySheetUI-Funktion ist der Einstiegspunkt von CPSUI für Anwendungen. Eine CPSUI-Anwendung (z. B. der Microsoft NT-basierte Betriebssystemdruckspooler) kann die Funktion aufrufen, um einem vordefinierten übergeordneten Fenster eine oder mehrere Eigenschaftenblattseiten hinzuzufügen. CPSUI zeigt die Seiten an, ermöglicht es dem Benutzer, sie zu ändern, und benachrichtigt die Anwendung der Benutzeraktivität über Rückruffunktionen.

Der NT-basierte Betriebssystemdruckspooler ruft die CommonPropertySheetUI-Funktion auf, wenn eine Win32-Anwendung die DocumentProperties - oder PrinterProperties-Funktionen des Spoolers aufruft.

Die vom PfnPropSheetUI-Parameter angegebene Rückruffunktion ist für die Beschreibung der hinzuzufügenden Eigenschaftenblattseiten verantwortlich. Weitere Informationen finden Sie in der Beschreibung des PFNPROPSHEETUI-Funktionstyps .

Die Reihenfolge des Vorgangs lautet wie folgt:

1. Die CommonPropertySheetUI-Funktion ruft den pfnPropSheetUI-Rückruf auf, damit der Rückruf die hinzuzufügenden Seiten beschreiben kann, indem die ComPropSheet-Funktion von CPSUI aufgerufen wird.

2. Wenn der pfnPropSheetUI-Rückruf erfolgreich ist, zeigt die CommonPropertySheetUI-Funktion die neuen Eigenschaftenblattseiten an und ermöglicht es dem Benutzer, Seitenwerte zu ändern.

3. Wenn der Benutzer Seitenwerte ändert, benachrichtigt ein Seitenereignisrückruf die Anwendung der Änderungen.

4. Wenn der Benutzer die Schaltfläche OK oder Abbrechen auswähelt, zerstört die CommonPropertySheetUI-Funktion die angezeigten Seiten und gibt zurück.

Weitere Informationen zur Reihenfolge der Vorgänge finden Sie unter Verwenden von CPSUI mit Druckertreibern im Abschnitt CPSUI.

Die CommonPropertySheetUI-Funktion ruft den pfnPropSheetUI-Rückruf tatsächlich mehrmals auf und gibt unterschiedliche Reason-Memberwerte in der PROPSHEETUI_INFO Struktur des Rückrufs an. Jedes Mal, wenn der Rückruf zurückgegeben wird, platziert er ein Ergebnis status im Ergebniselement der PROPSHEETUI_INFO-Struktur. Wenn die CommonPropertySheetUI-Funktion zurückgibt, kopiert sie den endgültigen Inhalt von Result an die Position, auf die pResult verweist.

Anforderungen