Freigeben über


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.