Utilisation de feuilles de propriétés dans votre application

Pour utiliser une feuille de propriétés dans votre application, procédez comme suit :

1. Créez une ressource de modèle de dialogue pour chaque page de propriétés. N’oubliez pas que l’utilisateur peut passer d’une page à une autre, de sorte que la mise en page de chaque page soit aussi cohérente que possible.

   Les modèles de boîte de dialogue pour toutes les pages n’ont pas besoin d’être de la même taille. L’infrastructure utilise la taille de la plus grande page pour déterminer la quantité d’espace à allouer dans la feuille de propriétés des pages de propriétés.

   Lorsque vous créez la ressource de modèle de boîte de dialogue pour une page de propriétés, vous devez spécifier les styles suivants dans la feuille de propriétés de boîte de dialogue :

   • Définissez la zone d’édition de légende sur la page Général sur le texte que vous souhaitez afficher dans l’onglet de cette page.

   • Définissez la zone de liste Style à la page Styles sur Enfant.

   • Définissez la zone de liste Bordure à la page Styles sur Mince.

   • Assurez-vous que la case à cocher barre de titre sur la page Styles est sélectionnée.

   • Vérifiez que la case à cocher Désactivé dans la page Autres styles est activée.

2. Créez une classe dérivée de CPropertyPage correspondant à chaque modèle de boîte de dialogue de page de propriétés. Voir Ajout d’une classe. Choisissez CPropertyPage comme classe de base.

3. Créez des variables membres pour contenir les valeurs de cette page de propriétés. Le processus d’ajout de variables membres à une page de propriétés est exactement le même que l’ajout de variables membres à une boîte de dialogue, car une page de propriétés est une boîte de dialogue spécialisée. Pour plus d’informations, consultez Définition des variables de membre pour les contrôles de boîte de dialogue.

4. Construisez un objet CPropertySheet dans votre code source. En règle générale, vous construisez l’objet CPropertySheet dans le gestionnaire pour la commande qui affiche la feuille de propriétés. Cet objet représente l’intégralité de la feuille de propriétés. Si vous créez une feuille de propriétés modale avec la fonction DoModal , l’infrastructure fournit trois boutons de commande par défaut : OK, Annuler et Appliquer. Le cadre ne crée aucun bouton de commande pour les feuilles de propriétés non modales obtenues par la fonction Create. Vous n'avez pas besoin de dériver une classe CPropertySheet à moins de vouloir ajouter d'autres contrôles (comme une fenêtre d'aperçu) ou afficher une feuille de propriétés non modales. Cette étape est nécessaire pour les feuilles de propriétés non modales car elles ne contiennent aucun contrôle par défaut qui peut être utilisé pour fermer la feuille de propriétés.

5. Pour que chaque page soit ajoutée à la feuille de propriétés, procédez comme suit :

   • Créez un objet pour chaque CPropertyPageclasse dérivée que vous avez créée précédemment dans ce processus.

   • Appelez CPropertySheet ::AddPage pour chaque page.

   En règle générale, l’objet qui crée le CPropertySheet crée également les objets CPropertyPage à cette étape. Toutefois, si vous implémentez une classe dérivée de CPropertySheet, vous pouvez intégrer les objets CPropertyPage dans l'objet CPropertySheet et appeler AddPage pour chaque page depuis le constructeur de classe dérivé de CPropertySheet. AddPage ajoute l’objet CPropertyPage à la liste des pages de la feuille de propriétés, mais ne crée pas réellement la fenêtre de cette page. Par conséquent, il n’est pas nécessaire d’attendre la création de la fenêtre de feuille de propriétés pour appeler AddPage; vous pouvez appeler AddPage à partir du constructeur de la feuille de propriétés.

   Par défaut, si une feuille de propriétés comporte plus d’onglets que ce qui correspond à une seule ligne de la feuille de propriétés, les onglets sont empilés dans plusieurs lignes. Pour désactiver l’empilement, appelez CPropertySheet ::EnableStackedTabs avec le paramètre défini sur FALSE. Vous devez appeler EnableStackedTabs lorsque vous créez la feuille de propriétés.

6. Appelez CPropertySheet::DoModal ou Create pour afficher la feuille de propriétés. Appelez DoModal pour créer une feuille de propriétés en tant que boîte de dialogue modale. Appelez Créer pour créer la feuille de propriétés en tant que boîte de dialogue non modale.

7. Échangez des données entre les pages de propriétés et le propriétaire de la feuille de propriétés. Ceci est expliqué dans l’article Échange de données.

Pour obtenir un exemple d’utilisation de feuilles de propriétés, consultez l’exemple GÉNÉRAL MFC PROPDLG.

Voir aussi

Feuilles de propriétés