Feuille de propriétés

Cette section contient des informations sur les éléments de programmation utilisés avec les feuilles de propriétés.

Vues d'ensemble

Rubrique	Contenu
À propos des feuilles de propriétés	Une feuille de propriétés est une fenêtre qui permet à l’utilisateur d’afficher et de modifier les propriétés d’un élément.
Assistant Création	Un Assistant est un type de feuille de propriétés qui fournit un moyen simple et puissant de guider les utilisateurs à travers une procédure.
Utilisation de feuilles de propriétés	Cette section fournit des détails d’implémentation et des exemples de code pour l’utilisation des feuilles de propriétés.

Fonctions

Rubrique	Contenu
AddPropSheetPageProc	Spécifie une fonction de rappel définie par l’application qu’une extension de feuille de propriétés utilise pour ajouter une page à une feuille de propriétés.
CreatePropertySheetPage	Crée une page pour une feuille de propriétés.
DestroyPropertySheetPage	Détruit une page de feuille de propriétés. Une application doit appeler cette fonction pour les pages qui n’ont pas été passées à la fonction PropertySheet .
Feuille de propriétés	Crée une feuille de propriétés et ajoute les pages définies dans la structure d’en-tête de feuille de propriétés spécifiée.
PropSheetPageProc	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.
PropSheetProc	Fonction de rappel définie par l’application que le système appelle lorsque la feuille de propriétés est en cours de création et d’initialisation.

Messages

Rubrique	Contenu
PSM_ADDPAGE	Ajoute une nouvelle page à la fin d’une feuille de propriétés existante. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_AddPage .
PSM_APPLY	Simule la sélection du bouton Appliquer , indiquant qu’une ou plusieurs pages ont changé et que les modifications doivent être validées et enregistrées.
PSM_CANCELTOCLOSE	Envoyé par une application lorsqu’elle a effectué des modifications depuis la dernière PSN_APPLY notification qui ne peut pas être annulée. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_CancelToClose .
PSM_CHANGED	Informe une feuille de propriétés que les informations d’une page ont changé. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_Changed .
PSM_ENABLEWIZBUTTONS	Active ou désactive l’un des boutons standard d’un Assistant Aero. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_EnableWizButtons .
PSM_GETCURRENTPAGEHWND	Récupère un handle dans la fenêtre de la page active d’une feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_GetCurrentPageHwnd .
PSM_GETRESULT	Utilisé par les feuilles de propriétés sans mode pour récupérer les informations retournées aux feuilles de propriétés modales par PropertySheet. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_GetResult .
PSM_GETTABCONTROL	Récupère le handle dans le contrôle tab d’une feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_GetTabControl .
PSM_HWNDTOINDEX	Prend le handle de fenêtre de la page de la feuille de propriétés et retourne son index de base zéro. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_HwndToIndex .
PSM_IDTOINDEX	Prend l’ID de ressource d’une page de feuille de propriétés et retourne son index de base zéro. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_IdToIndex .
PSM_INDEXTOHWND	Prend l’index d’une page de feuille de propriétés et retourne son handle de fenêtre. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_IndexToHwnd .
PSM_INDEXTOID	Prend l’index d’une page de feuille de propriétés et retourne son ID de ressource. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_IndexToId .
PSM_INDEXTOPAGE	Prend l’index d’une page de feuille de propriétés et retourne son handle HPROPSHEETPAGE. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_IndexToPage .
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 .
PSM_ISDIALOGMESSAGE	Transmet un message à une boîte de dialogue de feuille de propriétés et indique si la boîte de dialogue a traité le message. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_IsDialogMessage .
PSM_PAGETOINDEX	Prend le handle HPROPSHEETPAGE de la page de feuille de propriétés et retourne son index de base zéro. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_PageToIndex .
PSM_PRESSBUTTON	Simule la sélection d’un bouton de feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_PressButton .
PSM_QUERYSIBLINGS	Envoyé à une feuille de propriétés, qui transfère ensuite le message à chacune de ses pages. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_QuerySiblings .
PSM_REBOOTSYSTEM	Indique que le système doit être redémarré pour que les modifications prennent effet. Vous pouvez envoyer le message PSM_REBOOTSYSTEM explicitement ou à l’aide de la macro PropSheet_RebootSystem .
PSM_RECALCPAGESIZES	Recalcule la taille de page d’une feuille de propriétés standard ou d’assistant une fois que des pages ont été ajoutées ou supprimées. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_RecalcPageSizes .
PSM_REMOVEPAGE	Supprime une page d'une feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_RemovePage .
PSM_RESTARTWINDOWS	Indique que Windows doit être redémarré pour que les modifications prennent effet.
PSM_SETBUTTONTEXT	Définit le texte d’un bouton dans un Assistant Aero. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_SetButtonText .
PSM_SETCURSEL	Active la page spécifiée dans une feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_SetCurSel .
PSM_SETCURSELID	Active la page donnée dans une feuille de propriétés en fonction de l’identificateur de ressource de la page. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_SetCurSelByID .
PSM_SETFINISHTEXT	Définit le texte du bouton Terminer dans un Assistant, affiche et active le bouton et masque les boutons Suivant et Précédent . Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_SetFinishText .
PSM_SETHEADERBITMAP	Ce message n’est pas implémenté.
PSM_SETHEADERBITMAPRESOURCE	Ce message n’est pas implémenté.
PSM_SETHEADERSUBTITLE	Définit le texte du sous-titre pour l’en-tête de la page intérieure d’un Assistant. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_SetHeaderSubTitle .
PSM_SETHEADERTITLE	Définit le texte de titre de l’en-tête de la page intérieure d’un Assistant. Vous pouvez envoyer ce message explicitement ou utiliser la macro PropSheet_SetHeaderTitle .
PSM_SETNEXTTEXT	Définit le texte du bouton Suivant dans un Assistant. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_SetNextText .
PSM_SETTITLE	Définit le titre d’une feuille de propriétés. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_SetTitle .
PSM_SETWIZBUTTONS	Active ou désactive les boutons Précédent, Suivant et Terminer dans un Assistant. Vous pouvez également utiliser la macro PropSheet_SetWizButtons pour publier le message.
PSM_SHOWWIZBUTTONS	Affiche ou masque les boutons dans un Assistant. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_ShowWizButtons .
PSM_UNCHANGED	Informe une feuille de propriétés que les informations d’une page sont revenues à l’état précédemment enregistré. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_UnChanged .

Notifications

Rubrique	Contenu
PSN_APPLY	Envoyé à chaque page de la feuille de propriétés pour indiquer que l’utilisateur a cliqué sur le bouton OK, Fermer ou Appliquer et souhaite que toutes les modifications soient prises en compte. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
PSN_GETOBJECT	Envoyé par une feuille de propriétés pour demander un objet cible de déplacement lorsque le curseur passe sur l’un des boutons du contrôle d’onglet.
PSN_HELP	Avertit une page que l’utilisateur a cliqué sur le bouton Aide. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_KILLACTIVE	Avertit une page qu’elle est sur le point de perdre l’activation, soit parce qu’une autre page est en cours d’activation ou que l’utilisateur a cliqué sur le bouton OK . Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_QUERYCANCEL	Indique que l’utilisateur a annulé la feuille de propriétés. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_QUERYINITIALFOCUS	Envoyé par une feuille de propriétés pour permettre à une page de feuille de propriétés de spécifier le contrôle de boîte de dialogue qui doit recevoir le focus initial. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
PSN_RESET	Avertit une page que la feuille de propriétés est sur le point d’être détruite. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_SETACTIVE	Avertit une page qu’elle est sur le point d’être activée. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_TRANSLATEACCELERATOR	Avertit une feuille de propriétés qu’un message clavier a été reçu. Il permet à la page d’effectuer une traduction d’accélérateur de clavier privée. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
PSN_WIZBACK	Avertit une page que l’utilisateur a cliqué sur le bouton Précédent dans un Assistant. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_WIZFINISH	Avertit une page que l’utilisateur a cliqué sur le bouton Terminer dans un Assistant. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
PSN_WIZNEXT	Avertit une page que l’utilisateur a cliqué sur le bouton Suivant dans un Assistant. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .

Structures

Rubrique	Contenu
PROPSHEETHEADER	Définit le cadre et les pages d’une feuille de propriétés.
PROPSHEETPAGE	Définit une page dans une feuille de propriétés.
PSHNOTIFY	Contient des informations pour les codes de notification de la feuille de propriétés.