_Message PSM INSERTPAGE
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
-
Où la page doit être insérée. Affectez la valeur null à ce paramètre pour faire de la nouvelle page la première page. Pour spécifier l’emplacement où la nouvelle page doit être insérée, 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 (l’entier Short non signé le plus grand), wParam spécifie l’index de base zéro de la nouvelle page. Par exemple, pour faire de la page insérée la troisième page sur la feuille de propriétés, affectez la valeur 2 à wParam . Pour en faire la première page, affectez la valeur 0 à wParam . 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 est insérée après celle-ci. -
lParam
-
Handle vers la page à insérer. La page doit d’abord être créée par un appel à la fonction CreatePropertySheetPage .
Valeur de retour
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écalées vers la droite pour s’adapter à la nouvelle page.
La feuille de propriétés n’est pas redimensionnée pour s’ajuster à la nouvelle page. Ne rendez pas la nouvelle page plus grande que la page la plus grande 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 de pages. Pendant cette action, toute tentative de modification de la liste de pages aura des résultats imprévisibles. en conséquence, vous ne devez pas utiliser le _ message PSM INSERTPAGE dans votre implémentation de PropSheetPageProc ou pendant la gestion des notifications et des messages Windows suivants.
si vous avez besoin de modifier une page de feuille de propriétés pendant que vous gérez l’un de ces messages ou lorsque PropSheetPageProc est en cours d’exécution, publiez un message Windows privé. Votre application ne recevra pas ce message tant que le gestionnaire de feuille 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 reveniez (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 actuelle (avec 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 [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| En-tête |
|