ToolWindowPane Class

Creates a new tool window pane with a null parent service provider

Constructor

Get or Set the ImageMoniker for the icon for this tool window. This property should be used instead of BitmapResource and BitmapIndex to allow for DPI-aware icons.

Get or Set the index of the image to use in the bitmap strip for the window frame icon. BitmapImageMoniker should be used instead, as using BitmapIndex and BitmapResourceId results in an icon that is not DPI-aware.

Get or Set the resource ID for the bitmap strip from which to take the window frame icon. BitmapImageMoniker should be used instead, as using BitmapIndex and BitmapResourceId results in an icon that is not DPI-aware.

Get or Set the text on the title bar of the ToolWindow

Gets or sets the content of this tool window.

Get or Set the Frame (IvsWindowFrame) hosting the ToolWindow

Gets the initialization mode that is associated with this window pane.

Get or Set the Package (Microsoft.VisualStudio.Shell.Package) owning the ToolWindow. This should only be set by the base Package class when it creates the toolwindow.

The search category that's used for storing MRU items (should the window search implementation for your toolwindow support most-recently-used search strings) By default, the toolwindow guid is used for the search category.

Override this if you want to support search in your window. You will also need to override other functions from IVsWindowSearch interface, like CreateSearch, etc.

Override this function if the toolwindow supports search filters The class WindowSearchFilterEnumerator can be used to construct an enumerator over an array of search filters implementing IVsWindowSearchFilter interface.

Gets the search host implementation associated with this tool window.

Override this function if the toolwindow supports search options The class WindowSearchOptionEnumerator can be used to construct an enumerator over an array of search options implementing IVsWindowSearchOption interface.

If the toolwindow has a ToolBar, it is described by this parameter. Otherwise this is null

If the toolwindow has a ToolBar then this property allows to customize its command target. If this value is null then window frame of this toolwindow is used as the command target for the ToolBar. Like other toolbar related properties, this property must be set before the initialization of the ToolWindowPane is complete.

If the toolwindow has a ToolBar, allows intercepting drag and drop operations on the toolbar. Otherwise this is null

Get or Set where the toolbar should be in the tool window (Up, down, left, right). This parameter is based on VSTWT_LOCATION

This is used to specify the CLSID of a tool that should be used for this toolwindow

Gets the window associated with this window pane.

Adds an info bar to this ToolWindowPane. The info bar will show at the top of the pane's frame when that frame is visible on screen.

Adds an info bar to this ToolWindowPane. The info bar will show at the top of the pane's frame when that frame is visible on screen.

Clear the pane of results from a previously completed or partial search

Override at least this function if you need to support search in a toolwindow

Disposes the window pane and its resources.

Disposes the resources of the window pane.

This method makes it possible to provide an IVsWindowPane not derived from ToolWindowPane To support that scenario one would override this method and create their IVsWindowPane and return it.

Gets the service of the specified type.

Initializes services after the window pane has been sited.

Override to load previously saved state of the pane

Raised when the window is closed.

Raised when the window pane is created.

Called when an action item on an info bar added via AddInfoBar is clicked. If this method is overridden, the base implementation must be called to raise the InfoBarActionItemClicked event.

Called when an info bar added via AddInfoBar is closed. If this method is overridden, the base implementation must be called to raise the InfoBarClosed event.

Allows the pane to intercept certains keys (after a search is started), and navigate between the results or select one of the results displayed in the pane.

This should be overriden if you want to run code before the window is shown but after its toolbar is added.

This method can be overriden by the derived class to execute any code that needs to run after the IVsWindowFrame is created. If the toolwindow has a toolbar with a combobox, it should make sure its command handler are set by the time they return from this method. This is called when someone set the Frame property.

Preprocesses the messages from navigation keys.

Allows override of default search settings. By default, the search is started delayed, with indefinite progress. The named of properties that can be overriden are defined in the class SearchSettingsDataSource.PropertyNames. Values implementing IVsUIObject interface can be constructed for common types using Microsoft.Internal.VisualStudio.PlatformUI.BuiltInPropertyValue class, or one could use helper functions like Microsoft.Internal.VisualStudio.PlatformUI.Utilities.SetValue(Microsoft.VisualStudio.Shell.Interop.IVsUIDataSource,System.String,System.Object) to set values in the data source.

Removes an info bar from this ToolWindowPane.

Removes and info bar from this ToolWindowPane.

Override to save custom state information to be used later when the pane is reconstructed.

Event raised when a button or hyperlink on an info bar associated with this ToolWindowPane is clicked.

Event raised when an info bar associated with this ToolWindowPane is closed.

Executes the specified command.

Gets the status of the commands.

Gets the service of the specified type.

Closes the pane.

Creates the pane.

When implemented in a derived class, gets the default size of the pane.

When implemented in a derived class, loads custom state storage.

Stores the state of the pane to the specified stream.

Sets the site for this window pane.

Handles keyboard accelerators before the shell processes the message.

Closes the window pane. Obsolete.

Creates a window pane. Obsolete.

Gets the default size of the window pane. Obsolete.

Loads the saved view state. Obsolete.

Saves the loaded view state. Obsolete.

Initializes this window pane with the specified service provider. Obsolete.

Handles the translation of navigation keys. Obsolete

Return the search category.