VsDockStyle Enumeration
Defines constants for tool window orientation.
Namespace: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.10.0 (in Microsoft.VisualStudio.Shell.10.0.dll)
Syntax
'Declaration
Public Enumeration VsDockStyle
public enum VsDockStyle
public enum class VsDockStyle
type VsDockStyle
public enum VsDockStyle
Members
Member name | Description | |
---|---|---|
none | The registration attribute ProvideToolWindowAttribute initializes to this value if no style is specified. | |
MDI | If the VsDockStyle value is MDI, the tool window will be linked to the multiple-document interface (MDI) area, and Window is ignored. | |
Float | If the VsDockStyle value is Float, the tool window will float initially, but when the title bar is double-clicked, Orientation and Window apply, and the window will default to Tabbed. | |
Linked | If the VsDockStyle value is Linked, Orientation can be Left, Right, Top, or Bottom. | |
Tabbed | If the VsDockStyle value is Tabbed, Orientation can be Left or Right and tab placement can be specified. | |
AlwaysFloat | If the VsDockStyle value is AlwaysFloat, the tool window cannot be docked. |
Remarks
The orientation of a tool window is the position in which the tool window docks when the title bar is double-clicked. This position is relative to the tool window that is specified in the Window keyword of the ProvideToolWindowAttribute attribute. For an example of ProvideToolWindowAttribute, see ToolWindowOrientation.
Note
You cannot specify that a tool window is docked by default. However, you can specify that it will dock when its title bar is double-clicked.
Examples
The attribute ProvideToolWindowAttribute, applied to your Microsoft.VisualStudio.Package-derived class and specifying that the tool window should always float, resembles the following code.
// MyToolWindow is the class that implements the tool window.
[Microsoft.VisualStudio.Package.ProvideToolWindowAttribute(typeof(MyToolWindow),Style= Microsoft.VisualStudio.Shell.VsDockStyle.AlwaysFloat)]