-Eigenschaftenblatt

  • Artikel

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.