共用方式為

識別程式庫中的符號

  • 發行項

符號瀏覽工具會顯示符號的階層式檢視。 符號代表命名空間、物件、類別、類別成員和其他語言元素。

階層中的每個符號都可以經由下列介面，透過符號程式庫傳遞至 Visual Studio 物件管理員的導覽資訊來識別：

階層中符號的位置會區分符號。 它可讓符號瀏覽工具導覽至特定符號。 符號的唯一完整路徑會決定位置。 路徑中的每個元素都是一個節點。 路徑從最上層節點為起點，並以特定符號為終點。 例如，如果 M1 方法是 C1 類別的成員，而 C1 位於 N1 命名空間中，則 M1 方法的完整路徑為 N1.C1.M1。 此路徑包含三個節點：N1、C1 和 M1。

導覽資訊可讓 Visual Studio 物件管理員在階層中定位、選取及保留選取的符號。 它允許從一個瀏覽工具導覽到另一個瀏覽工具。 使用 [物件瀏覽器] 瀏覽 Visual C++ 專案中的符號時，能以滑鼠右鍵按一下方法並啟動 [呼叫瀏覽器] 工具以在呼叫歷程圖中顯示該方法。

有兩種格式描述符號位置。 標準格式是以符號的完整路徑為基礎。 它代表符號在階層中的唯一位置。 它與符號瀏覽工具無關。 為了取得標準格式資訊，Visual Studio 物件管理器呼叫 EnumCanonicalNodes 方法。 顯示格式描述符號在特定符號瀏覽工具中的位置。 符號的位置相對於階層中其他符號的位置。 指定的符號可能有數個顯示路徑，但只有一個標準路徑。 例如，如果 C1 類別繼承自 C2 類別，而且這兩個類別都在 N1 命名空間中，則 [物件瀏覽器] 會顯示下列階層式樹狀結構：

N1
    C1
        Bases and Interfaces
            C2
    C2
        Bases and Interfaces
. . . . . . . . . . .

在此範例中，C2 類別的標準路徑是 N1 + C2。 C2 的顯示路徑包含 C1 和「基底和介面」 (Bases and Interfaces) 節點：N1 + C1 + "Bases and Interfaces" + C2。

為了取得顯示格式資訊，物件管理員會呼叫 EnumPresentationNodes 方法。

取得標準和顯示格式資訊

  1. 實作 EnumCanonicalNodes 方法。

    物件管理員呼叫這個方法來取得符號標準路徑中包含的節點清單。

    public int EnumCanonicalNodes(out Microsoft.VisualStudio.Shell.Interop.IVsEnumNavInfoNodes ppEnum)
{
    CallBrowserEnumNavInfoNodes EnumNavInfoNodes =
        new CallBrowserEnumNavInfoNodes(m_strMethod);
    ppEnum = (IVsEnumNavInfoNodes)(EnumNavInfoNodes);
    return 0;
}

  2. 實作 EnumPresentationNodes 方法。

    物件管理員呼叫這個方法來取得符號顯示路徑中包含的節點清單。

相關內容