Eigenschaftenblatt

Dieser Abschnitt enthält Informationen zu Programmierelementen, die mit Eigenschaftenblättern verwendet werden.

Überblicke

Thema	Inhalt
Zu Eigenschaftenblättern	Ein Eigenschaftenblatt ist ein Fenster, in dem der Benutzer die Eigenschaften eines Elements anzeigen und bearbeiten kann.
Erstellen von Assistenten	Ein Assistent ist eine Art von Eigenschaftenblatt, das eine einfache und leistungsstarke Möglichkeit bietet, Benutzer durch eine Prozedur zu führen.
Verwenden von Eigenschaftenblättern	Dieser Abschnitt enthält Implementierungsdetails und Beispielcode zum Arbeiten mit Eigenschaftenblättern.

Funktionen

Thema	Inhalt
AddPropSheetPageProc-	Gibt eine anwendungsdefinierte Rückruffunktion an, die von einer Eigenschaftenblatterweiterung zum Hinzufügen einer Seite zu einem Eigenschaftenblatt verwendet wird.
CreatePropertySheetPage-	Erstellt eine neue Seite für ein Eigenschaftenblatt.
DestroyPropertySheetPage-	Zerstört eine Eigenschaftenblattseite. Eine Anwendung muss diese Funktion für Seiten aufrufen, die nicht an die PropertySheet--Funktion übergeben wurden.
PropertySheet-	Erstellt ein Eigenschaftenblatt und fügt die in der angegebenen Eigenschaftenblattkopfstruktur definierten Seiten hinzu.
PropSheetPageProc-	Gibt eine anwendungsdefinierte Rückruffunktion an, die von einem Eigenschaftenblatt aufgerufen wird, wenn eine Seite erstellt wird und wann sie zerstört werden soll. Eine Anwendung kann diese Funktion verwenden, um Initialisierungs- und Bereinigungsvorgänge für die Seite auszuführen.
PropSheetProc-	Eine anwendungsdefinierte Rückruffunktion, die das System aufruft, wenn das Eigenschaftenblatt erstellt und initialisiert wird.

Meldungen

Thema	Inhalt
PSM_ADDPAGE	Fügt am Ende eines vorhandenen Eigenschaftenblatts eine neue Seite hinzu. Sie können diese Nachricht explizit oder mithilfe des PropSheet_AddPage Makros senden.
PSM_APPLY	Simuliert die Auswahl der Schaltfläche Anwenden, die angibt, dass eine oder mehrere Seiten geändert wurden und die Änderungen überprüft und aufgezeichnet werden müssen.
PSM_CANCELTOCLOSE	Wird von einer Anwendung gesendet, wenn änderungen seit der letzten PSN_APPLY Benachrichtigung ausgeführt wurden, die nicht abgebrochen werden kann. Sie können diese Nachricht explizit oder mithilfe des PropSheet_CancelToClose-Makros senden.
PSM_CHANGED	Informiert ein Eigenschaftenblatt, dass sich Die Informationen auf einer Seite geändert haben. Sie können diese Nachricht explizit oder mithilfe des PropSheet_Changed-Makros senden.
PSM_ENABLEWIZBUTTONS	Aktiviert oder deaktiviert alle Standardschaltflächen in einem Aero-Assistenten. Sie können diese Nachricht explizit senden oder das PropSheet_EnableWizButtons Makro verwenden.
PSM_GETCURRENTPAGEHWND	Ruft ein Handle zum Fenster der aktuellen Seite eines Eigenschaftenblatts ab. Sie können diese Nachricht explizit oder mithilfe des PropSheet_GetCurrentPageHwnd-Makros senden.
PSM_GETRESULT	Wird von moduslosen Eigenschaftenblättern verwendet, um die Informationen abzurufen, die von PropertySheet-an modale Eigenschaftenblätter zurückgegeben werden. Sie können diese Nachricht explizit senden oder das PropSheet_GetResult Makro verwenden.
PSM_GETTABCONTROL	Ruft das Handle zum Registersteuerelement eines Eigenschaftenblatts ab. Sie können diese Nachricht explizit oder mithilfe des PropSheet_GetTabControl Makros senden.
PSM_HWNDTOINDEX	Übernimmt das Fensterhandle der Eigenschaftenblattseite und gibt den nullbasierten Index zurück. Sie können diese Nachricht explizit senden oder das PropSheet_HwndToIndex Makro verwenden.
PSM_IDTOINDEX	Verwendet die Ressourcen-ID einer Eigenschaftenblattseite und gibt den nullbasierten Index zurück. Sie können diese Nachricht explizit senden oder das PropSheet_IdToIndex Makro verwenden.
PSM_INDEXTOHWND	Verwendet den Index einer Eigenschaftenblattseite und gibt dessen Fensterziehpunkt zurück. Sie können diese Nachricht explizit senden oder das PropSheet_IndexToHwnd Makro verwenden.
PSM_INDEXTOID	Verwendet den Index einer Eigenschaftenblattseite und gibt seine Ressourcen-ID zurück. Sie können diese Nachricht explizit senden oder das PropSheet_IndexToId Makro verwenden.
PSM_INDEXTOPAGE	Verwendet den Index einer Eigenschaftenblattseite und gibt den HPROPSHEETPAGE-Handle zurück. Sie können diese Nachricht explizit senden oder das PropSheet_IndexToPage Makro verwenden.
PSM_INSERTPAGE	Fügt eine neue Seite in ein vorhandenes Eigenschaftenblatt ein. Die Seite kann entweder an einem angegebenen Index oder nach einer angegebenen Seite eingefügt werden. Sie können diese Nachricht explizit oder mithilfe des PropSheet_InsertPage-Makros senden.
PSM_ISDIALOGMESSAGE	Übergibt eine Nachricht an ein Eigenschaftenblattdialogfeld und gibt an, ob das Dialogfeld die Nachricht verarbeitet hat. Sie können diese Nachricht explizit oder mithilfe des PropSheet_IsDialogMessage Makros senden.
PSM_PAGETOINDEX	Übernimmt das HPROPSHEETPAGE-Handle der Eigenschaftenblattseite und gibt den nullbasierten Index zurück. Sie können diese Nachricht explizit senden oder das PropSheet_PageToIndex Makro verwenden.
PSM_PRESSBUTTON	Simuliert die Auswahl einer Eigenschaftenblattschaltfläche. Sie können diese Nachricht explizit oder mithilfe des PropSheet_PressButton Makros senden.
PSM_QUERYSIBLINGS	Wird an ein Eigenschaftenblatt gesendet, das die Nachricht dann an die einzelnen Seiten weiterleitet. Sie können diese Nachricht explizit oder mithilfe des PropSheet_QuerySiblings Makros senden.
PSM_REBOOTSYSTEM	Gibt an, dass das System neu gestartet werden muss, damit die Änderungen wirksam werden. Sie können die PSM_REBOOTSYSTEM Nachricht explizit oder mithilfe des PropSheet_RebootSystem Makros senden.
PSM_RECALCPAGESIZES	Berechnet die Seitengröße eines Standard- oder Assistenteneigenschaftenblatts neu, nachdem Seiten hinzugefügt oder entfernt wurden. Sie können diese Nachricht explizit senden oder das PropSheet_RecalcPageSizes Makro verwenden.
PSM_REMOVEPAGE	Entfernt eine Seite aus einem Eigenschaftenblatt. Sie können diese Nachricht explizit oder mithilfe des PropSheet_RemovePage Makros senden.
PSM_RESTARTWINDOWS	Gibt an, dass Windows neu gestartet werden muss, damit die Änderungen wirksam werden.
PSM_SETBUTTONTEXT	Legt den Text auf einer Schaltfläche in einem Aero-Assistenten fest. Sie können diese Nachricht explizit oder mithilfe des PropSheet_SetButtonText Makros senden.
PSM_SETCURSEL	Aktiviert die angegebene Seite in einem Eigenschaftenblatt. Sie können diese Nachricht explizit oder mithilfe des PropSheet_SetCurSel Makros senden.
PSM_SETCURSELID	Aktiviert die angegebene Seite in einem Eigenschaftenblatt basierend auf dem Ressourcenbezeichner der Seite. Sie können diese Nachricht explizit oder mithilfe des PropSheet_SetCurSelByID-Makros senden.
PSM_SETFINISHTEXT	Legt den Text der Schaltfläche Fertig stellen in einem Assistenten fest, zeigt die Schaltfläche an und aktiviert sie und blendet die Schaltflächen Weiter und Schaltflächen "Zurück" aus. Sie können diese Nachricht explizit oder mithilfe des PropSheet_SetFinishText Makros senden.
PSM_SETHEADERBITMAP	Diese Nachricht ist nicht implementiert.
PSM_SETHEADERBITMAPRESOURCE	Diese Nachricht ist nicht implementiert.
PSM_SETHEADERSUBTITLE	Legt den Untertiteltext für die Kopfzeile der Innenseite eines Assistenten fest. Sie können diese Nachricht explizit senden oder das PropSheet_SetHeaderSubTitle-Makro verwenden.
PSM_SETHEADERTITLE	Legt den Titeltext für die Kopfzeile der Innenseite eines Assistenten fest. Sie können diese Nachricht explizit senden oder das PropSheet_SetHeaderTitle Makro verwenden.
PSM_SETNEXTTEXT	Legt den Text der Schaltfläche Nächsten in einem Assistenten fest. Sie können diese Nachricht explizit oder mithilfe des PropSheet_SetNextText Makros senden.
PSM_SETTITLE	Legt den Titel eines Eigenschaftenblatts fest. Sie können diese Nachricht explizit oder mithilfe des PropSheet_SetTitle-Makros senden.
PSM_SETWIZBUTTONS	Aktiviert oder deaktiviert die Schaltflächen "Zurück", "Weiter" und Schaltflächen "Fertig stellen" in einem Assistenten. Sie können auch das PropSheet_SetWizButtons Makro verwenden, um die Nachricht zu posten.
PSM_SHOWWIZBUTTONS	Blendet Schaltflächen in einem Assistenten ein oder aus. Sie können diese Nachricht explizit oder mithilfe des PropSheet_ShowWizButtons Makros senden.
PSM_UNCHANGED	Informiert ein Eigenschaftenblatt, dass Informationen auf einer Seite auf den zuvor gespeicherten Zustand zurückgesetzt wurden. Sie können diese Nachricht explizit oder mithilfe des PropSheet_UnChanged-Makros senden.

Benachrichtigungen

Thema	Inhalt
PSN_APPLY	Wird an jede Seite im Eigenschaftenblatt gesendet, um anzugeben, dass der Benutzer auf die Schaltfläche "OK", "Schließen" oder "Übernehmen" geklickt hat und alle Änderungen wirksam werden sollen. Diese Benachrichtigung wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_GETOBJECT	Gesendet von einem Eigenschaftenblatt, um ein Dropzielobjekt anzufordern, wenn der Cursor über eine der Schaltflächen des Registerkartensteuerelements übergibt.
PSN_HELP	Benachrichtigt eine Seite, dass der Benutzer auf die Schaltfläche "Hilfe" geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_KILLACTIVE	Benachrichtigt eine Seite, dass die Aktivierung entweder verloren geht, weil eine andere Seite aktiviert wird oder der Benutzer auf die Schaltfläche OK geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_QUERYCANCEL	Gibt an, dass der Benutzer das Eigenschaftenblatt abgebrochen hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_QUERYINITIALFOCUS	Wird von einem Eigenschaftenblatt gesendet, um eine Eigenschaftenblattseite bereitzustellen, können Sie angeben, welches Dialogfeld-Steuerelement den anfänglichen Fokus erhalten soll. Diese Benachrichtigung wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_RESET	Benachrichtigt eine Seite, dass das Eigenschaftenblatt gerade zerstört werden soll. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_SETACTIVE	Benachrichtigt eine Seite darüber, dass sie aktiviert werden soll. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_TRANSLATEACCELERATOR	Benachrichtigt ein Eigenschaftenblatt, dass eine Tastaturnachricht empfangen wurde. Sie bietet der Seite die Möglichkeit, private Tastenkombinationen zu übersetzen. Diese Benachrichtigung wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_WIZBACK	Benachrichtigt eine Seite, dass der Benutzer in einem Assistenten auf die Schaltfläche Zurück geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_WIZFINISH	Benachrichtigt eine Seite, dass der Benutzer in einem Assistenten auf die Schaltfläche Fertig stellen geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_WIZNEXT	Benachrichtigt eine Seite, dass der Benutzer in einem Assistenten auf die Schaltfläche Weiter geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

Strukturen

Thema	Inhalt
PROPSHEETHEADER-	Definiert den Rahmen und die Seiten eines Eigenschaftenblatts.
PROPSHEETPAGE-	Definiert eine Seite in einem Eigenschaftenblatt.
PSHNOTIFY	Enthält Informationen für die Eigenschaftenblatt-Benachrichtigungscodes.