-Eigenschaftenblatt

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

Übersichten

Thema	Inhalte
Informationen über Eigenschaftenblätter	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 für die Arbeit mit Eigenschaftenblättern.

Functions

Thema	Inhalte
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.showdialog	Erstellt ein Eigenschaftenblatt und fügt die in der angegebenen Headerstruktur des Eigenschaftenblatts 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.

Nachrichten

Thema	Inhalte
PSM_ADDPAGE	Fügt am Ende eines vorhandenen Eigenschaftenblatts eine neue Seite hinzu. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_AddPage senden.
PSM_APPLY	Simuliert die Auswahl der Schaltfläche Anwenden , wodurch angegeben wird, dass sich eine oder mehrere Seiten geändert haben und die Änderungen überprüft und aufgezeichnet werden müssen.
PSM_CANCELTOCLOSE	Wird von einer Anwendung gesendet, wenn änderungen seit dem letzten PSN_APPLY Benachrichtigung ausgeführt wurden, die nicht abgebrochen werden kann. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_CancelToClose senden.
PSM_CHANGED	Informiert ein Eigenschaftenblatt darüber, dass sich die Informationen auf einer Seite geändert haben. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_Changed senden.
PSM_ENABLEWIZBUTTONS	Aktiviert oder deaktiviert eine der Standardschaltflächen in einem Aero-Assistenten. Sie können diese Nachricht explizit senden oder das Makro PropSheet_EnableWizButtons verwenden.
PSM_GETCURRENTPAGEHWND	Ruft ein Handle für das Fenster der aktuellen Seite eines Eigenschaftenblatts ab. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_GetCurrentPageHwnd 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 Makro PropSheet_GetResult verwenden.
PSM_GETTABCONTROL	Ruft das Handle für das Registerkartensteuerelement eines Eigenschaftenblatts ab. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_GetTabControl senden.
PSM_HWNDTOINDEX	Verwendet das Fensterhandle der Eigenschaftenblattseite und gibt den nullbasierten Index zurück. Sie können diese Nachricht explizit senden oder das Makro PropSheet_HwndToIndex verwenden.
PSM_IDTOINDEX	Übernimmt die Ressourcen-ID einer Eigenschaftenblattseite und gibt den nullbasierten Index zurück. Sie können diese Nachricht explizit senden oder das Makro PropSheet_IdToIndex verwenden.
PSM_INDEXTOHWND	Übernimmt den Index einer Eigenschaftenblattseite und gibt den zugehörigen Fensterhandle zurück. Sie können diese Nachricht explizit senden oder das Makro PropSheet_IndexToHwnd verwenden.
PSM_INDEXTOID	Übernimmt den Index einer Eigenschaftenblattseite und gibt dessen Ressourcen-ID zurück. Sie können diese Nachricht explizit senden oder das makro PropSheet_IndexToId verwenden.
PSM_INDEXTOPAGE	Übernimmt den Index einer Eigenschaftenblattseite und gibt dessen HPROPSHEETPAGE-Handle zurück. Sie können diese Nachricht explizit senden oder das Makro PropSheet_IndexToPage 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 Makros PropSheet_InsertPage senden.
PSM_ISDIALOGMESSAGE	Übergibt eine Meldung an ein Eigenschaftenblattdialogfeld und gibt an, ob das Dialogfeld die Nachricht verarbeitet hat. Sie können diese Nachricht explizit oder mithilfe des makros PropSheet_IsDialogMessage senden.
PSM_PAGETOINDEX	Verwendet das HPROPSHEETPAGE-Handle der Eigenschaftenblattseite und gibt den nullbasierten Index zurück. Sie können diese Nachricht explizit senden oder das Makro PropSheet_PageToIndex verwenden.
PSM_PRESSBUTTON	Simuliert die Auswahl einer Eigenschaftenblattschaltfläche. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_PressButton senden.
PSM_QUERYSIBLINGS	Wird an ein Eigenschaftenblatt gesendet, das die Nachricht dann an jede seiner Seiten weiterleitet. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_QuerySiblings 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 Makros PropSheet_RebootSystem 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 Makro PropSheet_RecalcPageSizes verwenden.
PSM_REMOVEPAGE	Entfernt eine Seite aus einem Eigenschaftenblatt. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_RemovePage 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 Makros PropSheet_SetButtonText senden.
PSM_SETCURSEL	Aktiviert die angegebene Seite in einem Eigenschaftenblatt. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_SetCurSel 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 Makros PropSheet_SetCurSelByID 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 Zurück aus. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_SetFinishText senden.
PSM_SETHEADERBITMAP	Diese Meldung ist nicht implementiert.
PSM_SETHEADERBITMAPRESOURCE	Diese Meldung ist nicht implementiert.
PSM_SETHEADERSUBTITLE	Legt den Untertiteltext für die Kopfzeile der inneren Seite eines Assistenten fest. Sie können diese Nachricht explizit senden oder das Makro PropSheet_SetHeaderSubTitle verwenden.
PSM_SETHEADERTITLE	Legt den Titeltext für die Kopfzeile der inneren Seite eines Assistenten fest. Sie können diese Nachricht explizit senden oder das Makro PropSheet_SetHeaderTitle verwenden.
PSM_SETNEXTTEXT	Legt den Text der Schaltfläche Weiter in einem Assistenten fest. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_SetNextText senden.
PSM_SETTITLE	Legt den Titel eines Eigenschaftenblatts fest. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_SetTitle senden.
PSM_SETWIZBUTTONS	Aktiviert oder deaktiviert die Schaltflächen "Zurück", " Weiter" und " Fertig stellen " in einem Assistenten. Sie können auch das Makro PropSheet_SetWizButtons verwenden, um die Nachricht zu posten.
PSM_SHOWWIZBUTTONS	Zeigt Schaltflächen in einem Assistenten an oder blendet sie aus. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_ShowWizButtons senden.
PSM_UNCHANGED	Informiert ein Eigenschaftenblatt darüber, dass die Informationen auf einer Seite in den zuvor gespeicherten Zustand zurückgesetzt wurden. Sie können diese Nachricht explizit oder mithilfe des Makros PropSheet_UnChanged senden.

Benachrichtigungen

Thema	Inhalte
PSN_APPLY	Wird an jede Seite im Eigenschaftenblatt gesendet, um anzugeben, dass der Benutzer auf die Schaltfläche OK, Schließen oder Anwenden geklickt hat und alle Änderungen wirksam werden sollen. Diese Benachrichtigung wird in Form einer WM_NOTIFY-Nachricht gesendet.
PSN_GETOBJECT	Wird von einem Eigenschaftenblatt gesendet, um ein Dropzielobjekt anzufordern, wenn der Cursor 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 sie die Aktivierung verlieren wird, entweder 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 einer Eigenschaftenblattseite die Möglichkeit zu geben, anzugeben, welches Dialogfeldsteuerelement den anfänglichen Fokus erhalten soll. Diese Benachrichtigung wird in Form einer WM_NOTIFY-Nachricht gesendet.
PSN_RESET	Benachrichtigt eine Seite darüber, dass das Eigenschaftenblatt zerstört wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
PSN_SETACTIVE	Benachrichtigt eine Seite, 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. Es bietet der Seite die Möglichkeit, private Tastaturbeschleunigung 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	Inhalte
PROPSHEETHEADER	Definiert den Rahmen und die Seiten eines Eigenschaftenblatts.
PROPSHEETPAGE	Definiert eine Seite in einem Eigenschaftenblatt.
PSHNOTIFY	Enthält Informationen für die Benachrichtigungscodes des Eigenschaftenblatts.