Fonction de rappel LPFNPSPCALLBACKA (prsht.h)

Article
11/20/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 lorsqu’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é; doit être NULL .

[in] uMsg

Type : UINT

Indicateur d’action. Ce paramètre peut être l’une des 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. Retournez un non-zéro pour l’autoriser à être créé, ou zéro pour l’empêcher.
PSPCB_RELEASE	Une page est détruite. 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 de retour

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.

Remarque 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.

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	prsht.h

Partager via