One of ReSharper's core abilities is to present various types of tool windows. Broadly speaking, there are two varieties of tool window: one where its content structure is predefined, and one where you decide what the content of the window is.
General-Purpose Tool Window
The general-purpose tool window typically consists of the following:
- Descriptor - an empty metadata-carrying class for describing the tool window particulars.
- Registrar - a component that is used to register the tool window with the tool window manager.
- Action - the action which, when fired, brings up the tool window.
- The window class, if you need one. Alternatively, you can create UI from existing building blocks.
The descriptor is simply an empty class that inherits from
ToolWindowDescriptor and is decorated with the
ToolWindowDescriptor attribute. All of the configuration happens in the attribute. Here is an example:
Let us briefly go over the information that is provided in the above:
- Id - this is the tool window's identifier. Note that, unlike with Actions, this identifier isn't used for instantiation.
- Text - the text that appears in the title of the tool window.
- Guid - a unique identifier for this window. Use the
nguidlive template to make one.
- Type - determines whether the tool window is single- or multi-instance.
- VisibilityPersistenceScope - controls how the tool window's visibility is recorded. The tool window's visibility can be associated with a particular solution, or can be global, i.e., apply to all solutions.
- Icon - name of a resource identifier for the icon that appears in the tool window.
- InitialDocking specifies the initial part of the window in which the tool window is docked when shown.
To create an action that opens up a tool window, simply create a class that inherits from
ActivateToolWindowHandle<YourDescriptorType> and decorate it with the
The registrar is a component (it can be shell or solution) that is used to register the tool window class with the tool window manager. Actual UI creation happens here. The UI can be created in one of the two ways.
The first option is to simply use a
UserControl (it can be either WinForms or WPF):
Another alternative it to construct the UI in situ, without creating a separate control class. To do this, you can use ReSharper-provided controls (such as
RichTextBox) and subsequently use the same
BindToLifetime() method in much the same fashion.