为自定义编辑器实现“导航栏”

Question

注册自定义语言服务扩展时，Visual Studio 会在 Text Editor 节点（在 Visual Studio 选项对话框中）为该语言创建一个新选项条目。在该节点下方创建了两个默认节点，名为 General 和 Tabs，其中 General 选项卡包含语句完成和显示设置...

在Dispay 组中有三个选项；其中之一是Navigation Bar 复选框（显示/隐藏编辑器的导航栏）。对于我的自定义语言服务，此选项已禁用。当然，它还没有实现。

我想知道，我必须做什么，为我的自定义编辑器提供导航栏...我想我必须在编辑器的工厂或语言服务中实现某个接口包必须导出某个 MEF 组件，或者，或者，...

Answer 1

Jon Senchyna 的回答引导我走向正确的方向。 OnSynchronizeDropdowns 方法永远不会被调用（SDK 文档在这种情况下是错误的）。最后的技巧是覆盖至少GetComboAttributes、GetEntryAttributes 和GetEntryText 以获得两个组合框的纯文本项...

[ComVisible(true)]
public sealed class CustomTypeAndMemberDropdownBars : TypeAndMemberDropdownBars
{
    private readonly IList<string> declarations;

    private readonly IList<string> members;

    public CustomTypeAndMemberDropdownBars(
        LanguageService languageService, 
        IVsTextView view)
        : base(languageService)
    {
        // TODO: initialize declarations and members from the given text view...
        this.declarations = ...
        this.members = ...
    }

    private enum ComboIndex
    {
        Types = 0, 

        Members = 1
    }

    public override int GetComboAttributes(
        int combo, 
        out uint entries, 
        out uint entryType, 
        out IntPtr imageList)
    {
        entries = 0;
        imageList = IntPtr.Zero;

        entryType = (uint)DROPDOWNENTRYTYPE.ENTRY_TEXT;

        var comboType = (ComboIndex)combo;
        switch (comboType)
        {
            case ComboIndex.Types:
                entries = (uint)this.declarations.Count();
                break;

            case ComboIndex.Members:
                entries = (uint)this.members.Count();
                break;
        }

        return VSConstants.S_OK;
    }

    public override int GetEntryAttributes(
        int combo, 
        int entry, 
        out uint fontAttrs)
    {
        fontAttrs = (uint)DROPDOWNFONTATTR.FONTATTR_PLAIN;

        return VSConstants.S_OK;
    }

    public override int GetEntryText(
        int combo, 
        int entry, 
        out string text)
    {
        text = null;
        var comboType = (ComboIndex)combo;
        switch (comboType)
        {
            case ComboIndex.Types:
                text = this.declarations[entry];
                break;

            case ComboIndex.Members:
                text = this.members[entry];
                break;
        }

        return VSConstants.S_OK;
    }

    public override bool OnSynchronizeDropdowns(
        LanguageService languageService, 
        IVsTextView textView, 
        int line, 
        int col, 
        ArrayList dropDownTypes, 
        ArrayList dropDownMembers, 
        ref int selectedType, 
        ref int selectedMember)
    {
        return false;
    }
}

Answer 2

我相信以下步骤应该是您需要的：

1. 在Package 类中，将ProvideLanguageService 属性中的ShowDropDownOptions 属性设置为true
2. 创建一个实现TypeAndMemberDropdownBars的类
3. 在您的LanguageService 类中，实现CreateDropDownHelper 函数并让它返回您的TypeAndMemberDropdownBars 的一个实例