ProvideLanguageServiceAttribute.ShowDropDownOptions Property

 

Determines if the Navigation bar option is enabled in the Options dialog box.

Namespace:   Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.14.0 (in Microsoft.VisualStudio.Shell.14.0.dll)

public bool ShowDropDownOptions { get; set; }

Property Value

Type: System.Boolean

Returns true if the Navigation bar option is to be enabled; otherwise, returns false.

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

[ProvideLanguageService(typeof(MyLanguageService),           // Required
                        MyConstants.languageName,            // Required
                        MyConstants.languageNameResourceID,  // Required
    // Optional language service properties
    ShowDropDownOptions = true,  // drop down bar options are supported
                       )]
Return to top
Show: