Partager via

Feuille de propriétés

  • Article

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

Aperçus

Sujet 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.
Création d’Assistants Un Assistant est un type de feuille de propriétés qui fournit un moyen simple et puissant de guider les utilisateurs dans une procédure.
à l’aide de feuilles de propriétés Cette section fournit des détails d’implémentation et un exemple de code pour l’utilisation de feuilles de propriétés.

Fonctions

Sujet Contenu
AddPropSheetPageProc Spécifie une fonction de rappel définie par l’application utilisée par une extension de feuille de propriétés 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.
PropertySheet 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 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.
PropSheetProc Fonction de rappel définie par l’application que le système appelle lorsque la feuille de propriétés est créée et initialisée.

Messages

Sujet 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 notification PSN_APPLY la plus récente 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 Assistant une fois les pages 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, puis 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 de 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 du 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 les boutons d’un Assistant. Vous pouvez également utiliser la macro PropSheet_SetWizButtons pour publier le message.
PSM_SHOWWIZBUTTONS Affiche ou masque les boutons d’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 ont rétabli l’état précédemment enregistré. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro PropSheet_UnChanged.

Notifications

Sujet 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 prennent effet. 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épôt lorsque le curseur passe sur l’un des boutons du contrôle Tab.
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’il est sur le point de perdre l’activation, soit parce qu’une autre page est activée 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 fournir une page de feuille de propriétés une opportunité 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é. 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

Sujet 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 feuille de propriétés.