PFNPROPSHEETCALLBACK-Rückruffunktion (prsht.h)

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.

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