Étendre et personnaliser des fenêtres OutilExtending and Customizing Tool Windows

Visual Studio fournit plusieurs types différents de windows, par exemple les fenêtres d’outil, les fenêtres de document et les boîtes de dialogue.Visual Studio provides several different types of windows, for example tool windows, document windows, and dialog windows. Autres fenêtres telles que la fenêtre Propriétés, la fenêtre Sortie et la fenêtre liste des tâches, sont des types de fenêtres Outil.Other windows such as the Properties window, the Output window, and the Task List window, are types of tool windows.

Fenêtres d'outilsTool Windows

Fenêtres Outil Visual Studio sont des fenêtres généralement en lecture seule qui ne sont pas basées sur le fichier.Visual Studio tool windows are usually read-only windows that are not file-based. En cela, elles diffèrent des fenêtres de document qui affichent des fichiers en mode lecture-écriture.In this they differ from document windows, which display files in read-write mode. La Boîte à outils, l’ Explorateur de solutions, la fenêtre Propriétés et le Navigateur web sont des exemples de fenêtres Outil.The Toolbox, Solution Explorer, Properties window, and Web Browser are examples of tool windows.

Pour savoir comment créer une fenêtre outil simple, consultez Ajout d’une fenêtre outil.To find out how to create a simple tool window, see Adding a Tool Window.

Pour inscrire une fenêtre outil avec Visual Studio, consultez l’inscription d’une fenêtre outil.To register a tool window with Visual Studio, see Registering a Tool Window.

Les fenêtres Outil sont par défaut à instance unique, ce qui signifie que seule une instance de la fenêtre Outil peut être ouverte à la fois.Tool windows are single-instance by default, meaning that only one instance of the tool window can be open at a time. Quand une fenêtre Outil à instance unique est ouverte, elle le reste jusqu’à la fermeture de l’IDE.After a single-instance tool window is opened, it remains open until the IDE is closed. Lorsque vous fermez une fenêtre outil à instance unique, seule sa visibilité change.When you close a single-instance tool window, only its visibility changes. Vous pouvez également créer des fenêtres Outil multi-instances, ce qui vous permet d’ouvrir simultanément plusieurs instances de la fenêtre.You can also create multi-instance tool windows, such that multiple instances of the window can be open simultaneously. Consultez création d’une fenêtre d’outil multi-instance pour plus d’informations.See Creating a Multi-Instance Tool Window for more information.

Les fenêtres Outil peuvent être dynamique, ce qui signifie qu’ils sont visibles chaque fois que leur contexte de l’interface utilisateur associée s’applique.Tool windows can be dynamic, meaning that they are visible whenever their related UI context applies. La visibilité automatique peut permettre de réduire l’encombrement des fenêtres dans l’IDE.The use of auto-visibility can reduce the clutter of windows in the IDE. Pour plus d’informations, consultez ouverture d’une fenêtre outil dynamique.For more information, see Opening a Dynamic Tool Window.

Dans le frame de document, les fenêtres Outils peuvent être des fenêtres ancrées, flottantes ou avec onglets.Tool windows can be docked, floating, or tabbed in the document frame. Le frame de fenêtre Outil, fourni par l’IDE, permet de contrôler la taille, l’emplacement, l’état d’ancrage et d’autres propriétés persistantes.The tool window frame is provided by the IDE and is used to control the size, location, docking state, and other persistent properties. Le volet de la fenêtre Outil affiche le contenu.The tool window pane displays the contents. La taille et l’emplacement par défaut s’appliquent uniquement à la première ouverture de la fenêtre Outil ; après cela, l’état de la fenêtre Outil est rendu persistant.The default size and location apply only when the tool window is first opened; after that the tool window state is persisted.

Les volets de la fenêtre Outil peuvent héberger des contrôles utilisateur WPF et prendre en charge des barres d’outils.Tool window panes can host WPF user controls and support toolbars. Vous pouvez remplacer le Window propriété à retourner le handle du contrôle hébergé.You can override the Window property to return the handle of the hosted control.

Vous pouvez ajouter de nombreuses fonctionnalités différentes pour les fenêtres Outil.You can add many different features to tool windows. Par exemple, vous pouvez ajouter une barre d’outils : Ajout d’une barre d’outils à une fenêtre outil ou un menu contextuel : Ajout d’un Menu contextuel dans une fenêtre outil.For example, you can add a toolbar: Adding a Toolbar to a Tool Window or a shortcut menu: Adding a Shortcut Menu in a Tool Window. Vous pouvez ajouter un contrôle de recherche qui vous permet de rechercher des éléments à l’intérieur de votre fenêtre outil : Ajout d’une recherche dans une fenêtre outil.You can add a Search control that allows you to search items inside your tool window: Adding Search to a Tool Window.

Vous pouvez vous abonner aux événements de fenêtre outil : s’abonner à un événement.You can subscribe to tool window events: Subscribing to an Event.

Extension des fenêtres Outil existantesExtending Existing Tool Windows

Vous pouvez ajouter des informations à propos de votre fenêtre outil vers un nouveau Options page et un nouveau paramètre sur le propriétés page, écrire dans le liste des tâches et sortie windows.You can add information about your tool window to a new Options page and a new setting on the Properties page, write to the Task List and Output windows. Pour plus d’informations, consultez étendre les Options de Windows, liste des tâches, de sortie et propriétés et extension de propriétés, de liste des tâches, de sortie et d’Options Windows.For more information, see Extending the Properties, Task List, Output, and Options Windows and Extending the Properties, Task List, Output, and Options Windows.

Dans une extension Visual Studio vous devez créer des boîtes de dialogue modales en les dérivant de Microsoft.VisualStudio.PlatformUI.DialogWindow, qui vous permet de contrôler les et le reste de l’interface utilisateur.In a Visual Studio extension you should create modal dialog boxes by deriving them from Microsoft.VisualStudio.PlatformUI.DialogWindow, which allows you to control them and the rest of the UI. Pour plus d’informations, consultez .For more information, see . Créer et gérer des boîtes de dialogue modales.Creating and Managing Modal Dialog Boxes.

Voir aussiSee Also

Création d’une extension avec une fenêtre d’outilCreating an Extension with a Tool Window