Boutons de la fenêtre PropriétésProperties Window Buttons

Selon le langage de développement et le type de produit, certains boutons sont affichés par défaut dans la barre d’outils pour le propriétés fenêtre.Depending on the development language and the product type, certain buttons are displayed by default on the toolbar for the Properties window. Dans tous les cas, le par catégorie, Alphabetized, propriétés, et Pages de propriétés boutons sont affichés.In all cases, the Categorized, Alphabetized, Properties, and Property Pages buttons are displayed. Dans Visual c# et Visual Basic, le événements bouton s’affiche également.In Visual C# and Visual Basic, the Events button is also displayed. Dans des projets Visual C++, le Messages VC ++ et VC substitue boutons sont affichés.In certain Visual C++ projects, the VC++ Messages and the VC Overrides buttons are displayed. Des boutons supplémentaires peuvent s’afficher pour les autres types de projet.Additional buttons may be displayed for other project types. Pour plus d’informations sur les boutons dans les propriétés fenêtre, consultez fenêtre Propriétés.For more information about buttons in the Properties window, see Properties Window.

Implémentation de boutons de la fenêtre PropriétésImplementation of Properties Window Buttons

Lorsque vous cliquez sur le par catégorie bouton, Visual Studio appelle le ICategorizeProperties interface sur l’objet qui a le focus pour trier ses propriétés par catégorie.When you click the Categorized button, Visual Studio calls the ICategorizeProperties interface on the object that has focus to sort its properties by category. ICategorizeProperties est implémentée sur le IDispatch objet qui est présenté à la propriétés fenêtre.ICategorizeProperties is implemented on the IDispatch object that is presented to the Properties window.

Il existe des catégories de propriété prédéfinie 11, qui ont des valeurs négatives.There are 11 predefined property categories, which have negative values. Vous pouvez définir des catégories personnalisées, mais nous recommandons d’attribuer les valeurs positives pour les différencier des catégories prédéfinies.You can define custom categories, but we recommend that you assign them positive values to distinguish them from the predefined categories.

Le MapPropertyToCategory méthode retourne la valeur de catégorie de propriété appropriée pour la propriété spécifiée.The MapPropertyToCategory method returns the appropriate property category value for the specified property. Le GetCategoryName méthode retourne une chaîne qui contient le nom de catégorie.The GetCategoryName method returns a string that contains the category name. Vous avez uniquement prendre en charge les valeurs de catégorie personnalisée, car Visual Studio sait que les valeurs de catégorie de propriété standard.You only have to provide support for custom category values because Visual Studio knows the standard property category values.

Lorsque vous cliquez sur le Alphabetized bouton, les propriétés sont affichées dans l’ordre alphabétique par nom.When you click the Alphabetized button, the properties are displayed in alphabetical order by name. Les noms sont récupérés par IDispatch selon un algorithme de tri localisé.The names are retrieved by IDispatch according to a localized sorting algorithm.

Lorsque le propriétés fenêtre est ouverte, la propriétés automatiquement du bouton est affiché comme étant sélectionnée.When the Properties window is open, the Properties button is automatically shown as selected. Dans d’autres parties de l’environnement, le même bouton s’affiche et vous pouvez cliquer dessus pour afficher la propriétés fenêtre.In other parts of the environment, the same button is displayed, and you can click it to show the Properties window.

Le Pages de propriétés bouton n’est pas disponible si ISpecifyPropertyPages n’est pas implémentée pour l’objet sélectionné.The Property Pages button is unavailable if ISpecifyPropertyPages is not implemented for the selected object. Propriétés dépendantes de la configuration d’affichage qui sont généralement associées à des projets et solutions des pages de propriétés, mais ils peuvent être également être associés à des éléments de projet (par exemple, dans Visual C++).Property pages display configuration-dependent properties that are typically associated with solutions and projects, but they can be also be associated with project items (for example, in Visual C++).

Note

Vous ne pouvez pas ajouter des boutons de barre d’outils pour le propriétés fenêtre à l’aide de code non managé.You cannot add toolbar buttons to the Properties window by using unmanaged code. Pour ajouter un bouton de barre d’outils, vous devez créer un objet managé qui dérive de PropertyTab.To add a toolbar button, you must create a managed object that derives from PropertyTab.

Voir aussiSee Also

Extension des propriétésExtending Properties