PSM_INSERTPAGE message
Insère une nouvelle page dans une feuille de propriétés existante. La page peut être insérée à un index spécifié ou après une page spécifiée. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_InsertPage .
Paramètres
-
wParam
-
Emplacement d’insertion de la page. Définissez ce paramètre sur NULL pour que la nouvelle page soit la première page. Pour spécifier l’emplacement d’insertion de la nouvelle page, vous pouvez passer un index ou le handle HPROPSHEETPAGE d’une page existante.
Valeur Signification - index
Si le paramètre wParam est inférieur à MAXUSHORT (le plus grand entier court non signé), wParam spécifie l’index de base zéro pour la nouvelle page. Par exemple, pour que la page insérée soit la troisième page de la feuille de propriétés, définissez wParam sur 2. Pour en faire la première page, définissez wParam sur 0. Si wParam a une valeur supérieure au nombre de pages et inférieure à MAXUSHORT, la page est ajoutée. - hpageInsertAfter
Si vous définissez le paramètre wParam sur le handle HPROPSHEETPAGE d’une page existante, la nouvelle page sera insérée après celle-ci. -
lParam
-
Gérez la page à insérer. La page doit d’abord être créée par un appel à la fonction CreatePropertySheetPage .
Valeur retournée
Retourne une valeur différente de zéro si la page a été correctement insérée, ou zéro dans le cas contraire.
Notes
Les pages après le point d’insertion sont déplacées vers la droite pour prendre en charge la nouvelle page.
La feuille de propriétés n’est pas redimensionnée pour s’adapter à la nouvelle page. Ne placez pas la nouvelle page plus grande que la plus grande page de la feuille de propriétés.
Un certain nombre de messages et un appel de fonction se produisent pendant que la feuille de propriétés manipule la liste des pages. Pendant cette action, la tentative de modification de la liste de pages aura des résultats imprévisibles. Par conséquent, vous ne devez pas utiliser le message PSM_INSERTPAGE dans votre implémentation de PropSheetPageProc ou lors de la gestion des notifications et messages Windows suivants.
Si vous devez modifier une page de feuille de propriétés pendant que vous gérez l’un de ces messages ou que PropSheetPageProc est en cours d’exploitation, publiez-vous un message Windows privé. Votre application ne recevra pas ce message tant que le gestionnaire de feuilles de propriétés n’aura pas terminé ses tâches. Vous pouvez ensuite modifier la liste des pages.
Les notifications suivantes sont également affectées par la modification de la feuille de propriétés.
Vous pouvez ajouter ou supprimer des pages en réponse à ces notifications, à condition que vous renvoyiez (via DWL_MSGRESULT) une valeur différente de zéro pour spécifier la nouvelle page souhaitée. Notez toutefois que si vous insérez une page qui se trouve avant la page active (qui a un index plus petit que la page active), PSN_KILLACTIVE peut être envoyé à la mauvaise page.
Notes
Ce message n’est pas pris en charge lors de l’utilisation du style de l’Assistant Aero (PSH_AEROWIZARD).
Spécifications
| 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] |
| En-tête |
|