Pages de propriétés (C++)

Article
03/04/2013

À l'aide des pages de propriétés, vous pouvez spécifier des paramètres pour les projets Visual Studio.Pour ouvrir la boîte de dialogue Pages de propriétés pour un projet Visual Studio, dans le menu Projet, cliquez sur Propriétés.

Vous pouvez spécifier et appliquer des paramètres de projet à toutes les configurations de build, ou spécifier des propriétés de projet différentes pour chaque configuration de génération.Par exemple, vous pouvez spécifier certains paramètres pour la configuration de la version et d'autres paramètres pour la configuration du débogage.

Toutes les pages disponibles sont toujours affichées dans la boîte de dialogue Pages de propriétés.Les pages affichées dépendent des types de fichier du projet.

Pour plus d'informations, consultez Comment : spécifier des propriétés de projet avec des pages de propriétés.

Propriétés par défaut VS. les propriétés modifiées

Lorsque vous utilisez la boîte de dialogue Nouveau projet pour créer un projet, Visual Studio utilise le modèle de projet spécifié pour initialiser les propriétés du projet.Par conséquent, les valeurs de propriété dans le modèle peuvent être considérées comme des valeurs par défaut pour ce type de projet.Dans d'autres types de projets, les propriétés peuvent avoir des valeurs par défaut différentes.

Une valeur de propriété de projet apparaît en gras si elle est modifiée.Une propriété de projet peut être modifiée pour les raisons suivantes :

L'Assistant Application modifie la propriété car elle requiert une valeur de propriété différente que celle qui est spécifiée dans le modèle de projet.
Vous spécifiez une valeur de propriété différente dans la boîte de dialogue Nouveau projet.
Vous spécifiez une valeur de propriété différente sur une page de propriétés du projet.

Conseil
Pour afficher le jeu final de valeurs de propriété que MSBuild utilise pour générer votre projet, examinez le fichier de sortie du préprocesseur, que vous pouvez créer à l'aide de la ligne de commande : MSBuild /preprocess:NomFichier_Sortie_PreprocesseuroptNomFichier_Projetopt

Réinitialisation des propriétés

Lorsque vous affichez la boîte de dialogue Pages de propriétés pour un projet et qu'un nœud de projet est sélectionné dans Explorateur de solutions, vous pouvez choisir pour de nombreuses propriétés hériter des paramètres par défaut du parent ou du projet ou modifier la valeur d'une autre manière.

Lorsque vous affichez la boîte de dialogue Pages de propriétés pour un projet et qu'un fichier est sélectionné dans Explorateur de solutions, vous pouvez choisir pour de nombreuses propriétés hériter des paramètres par défaut du parent ou du projet ou modifier la valeur d'une autre manière.Toutefois, si le projet contient de nombreux fichiers qui ont des valeurs de propriété qui diffèrent des valeurs par défaut du projet, le projet prendra plus de temps pour être généré.

Conseil
Pour actualiser la boîte de dialogue Pages de propriétés afin qu'elle affiche les dernières sélections, cliquez sur Appliquer.

La plupart des valeurs par défaut du projet sont les valeurs par défaut du système (plateforme).Certains paramètres par défaut du projet sont dérivés des feuilles de style qui sont appliquées lors de la mise à jour des propriétés dans la section Paramètres par défaut du projet de la page de configuration générale du projet.Pour plus d'informations, consultez Général, page de propriétés (Projet).

Spécification des valeurs définies par l'utilisateur

Vous devez définir la valeur pour certaines propriétés.Une valeur définie par l'utilisateur peut contenir un ou plusieurs caractères alphanumériques ou noms de macros du fichier projet.Certaines de ces propriétés peuvent prendre uniquement une valeur définie par l'utilisateur, mais d'autres peuvent prendre une liste délimitée par des points-virgules de plusieurs valeurs.

Pour spécifier une valeur définie par l'utilisateur pour une propriété ou une liste si la propriété peut prendre plusieurs valeurs définies par l'utilisateur, exécutez l'une des actions suivantes dans la colonne à droite du nom de la propriété :

Tapez la valeur ou la liste de valeurs.
Cliquez sur la flèche déroulante.Si Modifier est disponible, cliquez dessus puis, dans la zone de texte, tapez la valeur ou la liste de valeurs.Une autre façon de spécifier une liste consiste à taper chaque valeur sur une ligne distincte dans la zone de texte.Sur la page de propriétés, les valeurs sont affichées sous la forme d'une liste délimitée par des points-virgules.

Pour insérer une macro de fichier projet comme valeur, cliquez sur Macros puis double-cliquer sur le nom de la macro.
Cliquez sur la flèche déroulante.Si Parcourir est disponible, cliquez dessus, puis sélectionnez une ou plusieurs valeurs.

Pour une propriété à valeurs multiples, l'option hériter des paramètres par défaut du parent ou du projet est disponible lorsque vous cliquez sur la flèche déroulante dans la colonne à droite du nom de la propriété, puis que vous cliquez sur Modifier.Cette option est activée par défaut.

Notez qu'une page de propriétés affiche uniquement les paramètres au niveau actuel pour une propriété à valeurs multiples qui hérite d'un autre niveau.Par exemple, si un fichier est sélectionné dans l'Explorateur de solutions, et si vous sélectionnez la propriété C/C++ Définitions du préprocesseur, les définitions de niveau fichier sont affichées, mais les définitions héritées de niveau de projet ne sont pas affichées.Pour afficher le niveau actuel et les valeurs héritées, cliquez sur la flèche déroulante dans la colonne à droite du nom de la propriété, puis cliquez sur Modifier.Si vous utilisez le modèle de projet Visual C++, ce comportement est également valable pour les objets dans les fichiers et les projets.Autrement dit, lorsque vous interrogez pour des valeurs sur une propriété au niveau du fichier, vous n'obtiendrez pas les valeurs pour cette même propriété au niveau du projet.Vous devez obtenir explicitement les valeurs de la propriété au niveau du projet.En outre, certaines valeurs héritées d'une propriété peuvent provenir d'une feuille de style qui n'est pas accessible par programme.