PFNPROPSHEETCALLBACK-Rückruffunktion (prsht.h)

Artikel
08/25/2023

Eine anwendungsdefinierte Rückruffunktion, die das System aufruft, wenn das Eigenschaftenblatt erstellt und initialisiert wird.

Syntax

PFNPROPSHEETCALLBACK Pfnpropsheetcallback;

int Pfnpropsheetcallback(
  HWND unnamedParam1,
  UINT unnamedParam2,
  LPARAM unnamedParam3
)
{...}

Parameter

unnamedParam1

Typ: HWND

Handle für das Eigenschaftenblatt. Dieser Parameter wird in der Regel als hWnd bezeichnet.

unnamedParam2

Typ: UINT

Empfangene Nachricht. Dieser Parameter wird in der Regel als uMsg bezeichnet.

Dieser Parameter ist einer der folgenden Werte.

Wert

Bedeutung

PSCB_INITIALIZED (1)

Gibt an, dass das Eigenschaftenblatt initialisiert wird. Der Wert lParam (unnamedParam3) ist 0 (null) für diese Nachricht.

PSCB_PRECREATE (2)

Gibt an, dass das Eigenschaftenblatt im Entstehen ist. Der hWnd-Parameter (unnamedParam1) ist NULL, und der Parameter lParam (unnamedParam3) ist die Adresse einer Dialogvorlage im Arbeitsspeicher. Diese Vorlage ist in Form einer DLGTEMPLATE- oder DLGTEMPLATEEX-Struktur gefolgt von mindestens einer DLGITEMTEMPLATE-Struktur . Diese Meldung gilt nicht, wenn Sie den Aero-Assistentenstil (PSH_AEROWIZARD) verwenden.

PSCB_BUTTONPRESSED (3)

Version 6.0 und höher. Gibt an, dass der Benutzer eine Schaltfläche im Eigenschaftenblattdialogfeld gedrückt hat. Um dies zu aktivieren, geben Sie PSH_USECALLBACK in PROPSHEETHEADER.dwFlags und den Namen dieser Rückruffunktion in PROPSHEETHEADER.pfnCallback an. Der Wert lParam (Arg3) ist einer der folgenden: Beachten Sie, dass nur PSBTN_CANCEL gültig ist, wenn Sie den Aero-Assistentenstil (PSH_AEROWIZARD) verwenden.

Schaltfläche, aufgerufen	lParam-Wert
OK	PSBTN_OK
Abbrechen	PSBTN_CANCEL
Anwenden	PSBTN_APPLYNOW
Schließen	PSBTN_FINISH

Beachten Sie, dass Comctl32.dll Versionen 6 und höher nicht verteilbar sind. Um diese Versionen von Comctl32.dll zu verwenden, geben Sie die bestimmte Version in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

unnamedParam3

Typ: LPARAM

Zusätzliche Informationen zur Meldung. Dieser Parameter wird in der Regel als lParam bezeichnet.

Die Bedeutung dieses Werts hängt vom uMsg-Parameter (unnamedParam2) ab:

Wenn uMsg PSCB_INITIALIZED oder PSCB_BUTTONPRESSED ist, ist der Wert dieses Parameters null.

Wenn uMsg PSCB_PRECREATE ist, ist dieser Parameter ein Zeiger auf eine DLGTEMPLATE- oder DLGTEMPLATEEX-Struktur , die das Eigenschaftenblattdialogfeld beschreibt. Testen Sie die Signatur der -Struktur, um den Typ zu bestimmen. Wenn die Signatur gleich 0xFFFF ist, handelt es sich bei der Struktur um eine erweiterte Dialogvorlage, andernfalls handelt es sich bei der Struktur um eine Standarddialogvorlage. Im folgenden Beispiel wird die dafür erforderliche Vorgehensweise veranschaulicht.

if (uMsg == PSCB_PRECREATE) 
{
     if (lParam)
     {
          DLGTEMPLATE *pDlgTemplate;
          DLGTEMPLATEEX *pDlgTemplateEx;

          pDlgTemplateEx = (DLGTEMPLATEEX *)lParam;  
          if (pDlgTemplateEx->signature == 0xFFFF)
          {
               // pDlgTemplateEx points to an extended  
               // dialog template structure.
          }
          else
          {
               // This is a standard dialog template
               //  structure.
               pDlgTemplate = (DLGTEMPLATE *)lParam;
          }
     }    
}

Rückgabewert

Typ: int

Gibt 0 (null) zurück.

Hinweise

Um eine PropSheetProc-Rückruffunktion zu aktivieren, verwenden Sie die PROPSHEETHEADER-Struktur , wenn Sie die PropertySheet-Funktion aufrufen, um das Eigenschaftenblatt zu erstellen. Verwenden Sie das pfnCallback-Element , um eine Adresse der Rückruffunktion anzugeben, und legen Sie das flag PSP_USECALLBACK im dwFlags-Element fest.

PropSheetProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen. Der PFNPROPSHEETCALLBACK-Typ ist die Adresse einer PropSheetProc-Rückruffunktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	prsht.h

Freigeben über