ProvideLanguageServiceAttribute.ShowDropDownOptions Property
Determines if the Navigation bar option is enabled in the Options dialog box.
Namespace: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.12.0 (in Microsoft.VisualStudio.Shell.12.0.dll)
Syntax
'Declaration
Public Property ShowDropDownOptions As Boolean
public bool ShowDropDownOptions { get; set; }
public:
property bool ShowDropDownOptions {
bool get ();
void set (bool value);
}
member ShowDropDownOptions : bool with get, set
function get ShowDropDownOptions () : boolean
function set ShowDropDownOptions (value : boolean)
Property Value
Type: Boolean
Returns true if the Navigation bar option is to be enabled; otherwise, returns false.
Remarks
The navigation bar appears across the top of an editor window and allows for quick navigation to various elements in the file. Typically, the navigation bar contains two combo-boxes, one for types, and the other for members. Selecting a type or member immediately moves that type or member into the edit window. The navigation bar can be shown or hidden for each language using the Navigation bar option in the Options dialog box (available from the Tools -> Options menu). If a language service supports the navigation bar then it should set the ShowDropDownOptions property to true. If the registry entry is not defined at all, then the Navigation bar option in the Options dialog box is disabled and cannot be changed. Otherwise, the value of the registry entry controls whether the Navigation bar option is initially selected or not.
This property is available for any language service implementation.
The default is false, indicating the Navigation bar option is not selected (actually, unless this property is explicitly set to true or false, the registry entry is not created and therefore the Navigation bar option is disabled).
The registry entry looks like this:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\[X.Y]\Languages\Language Services\
[Language Name]\
ShowDropDownBarOption = reg_dword: 0x00000001
Examples
[ProvideLanguageService(typeof(MyLanguageService), // Required
MyConstants.languageName, // Required
MyConstants.languageNameResourceID, // Required
// Optional language service properties
ShowDropDownOptions = true, // drop down bar options are supported
)]
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.