[Update 7/20/2010]: Updated changes made for version 10.0.10710.22 of the Pro Power Tools. Please take a look at the changelog.

A couple of posts ago I announced the availability of Document Well 2010 Plus as part of the Visual Studio 2010 Pro Power Tools. Since then we have received lots of feedback about our extension, for which I am very grateful. User feedback has centered around two main points:

  1. There should be an option to hide the pin button
  2. When using custom colors for tabs, the selected tab is sometimes not clearly distinguishable

Fortunately, the extension has a couple of hidden options that will let you alleviate these two points, as well as others that hopefully will help you in your daily work. During development of the extension we experimented internally with many different options for the features available in the extension. For the first release it was decided that exposing all options could be confusing and overwhelming to our users, and so the options dialog UI was simplified. You will find here all options that were hidden due to this simplification. I encourage you to try them out and let us know if you find them useful or not.

 

Pinned Tabs Options

Pin button visible in unpinned tabs

This has been added to the options UI in our latest release.

Maintain pinned status if document is removed from document well

By default, when a document is pinned and it is removed from the document well (by making it float or closing it) it loses its pinned status, and you will need to mark it as pinned again when you return it to the document well. Running the following command will maintain pinned status for documents that are floated or closed. Pinned status will only be removed if you manually unpin the tab.

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.GeneralOptions /v IsPinStatusSticky /t REG_SZ /d True /f

Pinned tabs appear in original order

By default, when you pin tabs they will be added to the pinned tabs group in the order in which they were pinned. Running the following command will make them appear in the order in which they originally appeared instead:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.GeneralOptions /v ArePinnedTabsInPinOrder /t REG_SZ /d False /f

This might become more clear with an example. Say you had the following three tabs open:

 

By default, when you pin Class3.cs, then Class2.cs, then Class1.cs, they will appear in the order in which they were pinned, as shown here:

 

After running the above command and pinning the three tabs in the same order shown above, however, they will appear as follows, which is the same order in which they appeared originally:

 

Tab Panel Position

By default tabs appear on top of the document well. The options UI provides the ability to show tabs vertically, which positions them on the left of the well. Additionally, the extension has the ability to position tabs on the bottom and on the right of the document well.

Tabs on bottom of document well

Run the following command to position tabs on the bottom of the document well:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.GeneralOptions /v TabPanelPosition /t REG_SZ /d Bottom /f

Tabs will then appear as shown in this image:

 

Tabs on right of document well

Run the following command to position tabs on the right of the document well:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.GeneralOptions /v TabPanelPosition /t REG_SZ /d Right /f

Tabs will then appear as shown in this image:

 

Color Options

Selected tab color options

Due to customer feedback, we have made the selected tab use a gradient when using custom colors, in order to make it more distinguishable:

 

If you try one of the two options below and later wish to return to using a gradient, you can run the following command:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v SelectedOption /t REG_SZ /d FadeToVS /f


Default custom color for selected tab

If you prefer to keep the color for the selected tab as was in the previous version, you can run the following command:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v SelectedOption /t REG_SZ /d Default /f

You will then have the same behavior as before for the selected tab:

 

Use VS colors for selected tab

If you run the command below, the selected tab will use default VS colors always:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v SelectedOption /t REG_SZ /d VS /f

This will also make it easier to distinguish it, as seen below:

 

 

Use gradients for custom colors

By default custom colors appear flat. You can run the following command to enable gradients for custom colors. This option might also help you to distinguish the active tab with custom colors enabled:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v ForceFlatColors /t REG_SZ /d False /f

There are three different options for showing gradients for custom colors, described in the following paragraphs.

 

Custom color fades to default tab color

Run the following command to make the tab gradient go from the custom color to the default Visual Studio tab color:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v FadeOption /t REG_SZ /d Default /f

This will make colored tabs appear as shown in the following image:

 

Notice that gradient for unselected tabs starts with the custom color and fades to the default VS unselected tab color, which is transparent. The selected tab gradient starts with the custom color and fades to the default VS selected tab color, which is yellow.

 

Custom color fades to more intense tab color

Run the following command to make the tab gradient go from the custom color to a more intense shade of the same custom color:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v FadeOption /t REG_SZ /d MoreIntense /f

This option will make the tab gradient appear as follows:

 

 

Custom color fades to less intense tab color

Run the following command to make the tab gradient go from the custom color to a less intense shade of the same custom color:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v FadeOption /t REG_SZ /d LessIntense /f

This option will make the tab gradient appear as follows:

 

Regular expression colors have precedence over project colors

By default, if you turn on both tab coloring by project and by regular expressions, regular expression colors will have precedence over project colors. You can run the following command to make project colors have precedence over regular expression colors instead:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.ColorGeneralOptions /v RegExHasPrecedence /t REG_SZ /d False /f

 

Regular Expression Options

Use full document path for regular expression match

By default, only the text that is visible in the tab is used to match regular expression for custom coloring. You can run the following command to instead match the full document path, which gives you greater flexibility:

reg add HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\DialogPage\Microsoft.DocWellBehavior.GeneralOptions /v UseFullPathForRegEx /t REG_SZ /d True /f

 

Changelog

Version 10.0.10710.22

  • Added to UI option to show/hide pin button in unpinned tabs
  • Removed UseCustomColorForSelected registry key, replaced with SelectedOption registry key
  • Added registry key for matching full document path when using regular expressions for custom colors

 

Tell Us What You Think

As always, we welcome your feedback. Please let us know if you find these options useful or not. You will find a hyperlink in our options dialog which you can use to provide us with feedback. You can also add comments to this post directly, add/contribute to a discussion in the Visual Studio Gallery page for the Visual Studio 2010 Pro Power Tools, or send us feedback directly at docwell2010plus [at] microsoft.com.

 

Radames Cruz Moreno – Software Developer, Visual Studio Platform Team
Biography: Radames arrived at Microsoft in 2008, just in time to help with development of Visual Studio 2010 since its early stages. He worked mainly helping develop the new WPF window docking system. Prior to that he worked in several interesting projects in Mexico using every technology and language imaginable, from C++ and Java to COBOL (shudder).