Boutons de la fenêtre Propriétés
Selon le langage de développement et le type de produit, certains boutons sont affichés par défaut dans la barre d’outils de la fenêtre Propriétés . Dans tous les cas, les boutons Catégorisés, Alphabétiques, Propriétés et Pages de propriétés sont affichés. Dans Visual C# et Visual Basic, le bouton Événements s’affiche également. Dans certains projets Visual C++, les messages VC++ et les boutons remplacements VC sont affichés . Des boutons supplémentaires peuvent être affichés pour d’autres types de projet. Pour plus d’informations sur les boutons dans la fenêtre Propriétés, consultez Fenêtre Propriétés.
Implémentation des boutons de fenêtre Propriétés
Lorsque vous cliquez sur le bouton Catégorisé , Visual Studio appelle l’interface ICategorizeProperties sur l’objet qui a le focus pour trier ses propriétés par catégorie. ICategorizeProperties est implémenté sur l’objet IDispatch présenté à la fenêtre Propriétés .
Il existe 11 catégories de propriétés prédéfinies, qui ont des valeurs négatives. Vous pouvez définir des catégories personnalisées, mais nous vous recommandons de leur attribuer des valeurs positives pour les distinguer des catégories prédéfinies.
La MapPropertyToCategory méthode retourne la valeur de catégorie de propriété appropriée pour la propriété spécifiée. La GetCategoryName méthode retourne une chaîne qui contient le nom de catégorie. Vous devez uniquement prendre en charge les valeurs de catégorie personnalisées, car Visual Studio connaît les valeurs de catégorie de propriétés standard.
Lorsque vous cliquez sur le bouton alphabétique , les propriétés sont affichées par ordre alphabétique par nom. Les noms sont récupérés IDispatch en fonction d’un algorithme de tri localisé.
Lorsque la fenêtre Propriétés est ouverte, le bouton Propriétés s’affiche automatiquement comme sélectionné. Dans d’autres parties de l’environnement, le même bouton s’affiche et vous pouvez cliquer dessus pour afficher la fenêtre Propriétés .
Le bouton Pages de propriétés n’est pas disponible s’il ISpecifyPropertyPages n’est pas implémenté pour l’objet sélectionné. Les pages de propriétés affichent des propriétés dépendantes de la configuration qui sont généralement associées à des solutions et des projets, mais elles peuvent également être associées à des éléments de projet (par exemple, dans Visual C++).
Remarque
Vous ne pouvez pas ajouter de boutons de barre d’outils à la fenêtre Propriétés à l’aide du code non managé. Pour ajouter un bouton de barre d’outils, vous devez créer un objet managé qui dérive de PropertyTab.