Fonction de rappel LPFNPSPCALLBACKA (prsht.h)

Article
03/01/2024

Spécifie une fonction de rappel définie par l’application qu’une feuille de propriétés appelle lorsqu’une page est créée et qu’elle est sur le point d’être détruite. Une application peut utiliser cette fonction pour effectuer des opérations d’initialisation et de nettoyage pour la page.

Syntaxe

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Paramètres

hwnd

Type : HWND

Réservés au; doit être NULL.

[in] uMsg

Type : UINT

Indicateur d’action. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
PSPCB_ADDREF	Version 5.80 ou ultérieure. Une page est en cours de création. La valeur de retour n’est pas utilisée.
PSPCB_CREATE	Une boîte de dialogue pour une page est en cours de création. Retourne une valeur différente de zéro pour permettre sa création, ou zéro pour l’empêcher.
PSPCB_RELEASE	Une page est en cours de destruction. La valeur de retour est ignorée.

[in, out] ppsp

Type : LPPROPSHEETPAGE

Pointeur vers une structure PROPSHEETPAGE qui définit la page en cours de création ou de destruction. Pour plus d’informations, consultez la section Remarques.

Valeur retournée

Type : UINT

La valeur de retour dépend de la valeur du paramètre uMsg .

Remarques

Une application doit spécifier l’adresse de cette fonction de rappel dans le membre pfnCallback d’une structure PROPSHEETPAGE avant de passer la structure à la fonction CreatePropertySheetPage .

Note La feuille de propriétés est en cours de manipulation de la liste des pages lorsque cette fonction est appelée. N’essayez pas d’ajouter, de supprimer ou d’insérer des pages lors de la gestion de cette notification. Cela aura des résultats imprévisibles.

À l’exception du membre lParam , votre application ne doit pas modifier la structure PROPSHEETPAGE . Cela aura des résultats imprévisibles. Le membre lParam contient des données définies par l’application et peut être modifié en fonction des besoins.

Notes

L’en-tête prsht.h définit LPFNPSPCALLBACK comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	prsht.h

Partager via