IVsLibrary Interface

This core interface describes the library and is used by the Object Manager to access symbols pertinent to it.

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

Syntax

'Declaration
<GuidAttribute("E86128E4-3B1B-4BE9-BEB6-D30E5BF40850")> _
<InterfaceTypeAttribute()> _
Public Interface IVsLibrary
[GuidAttribute("E86128E4-3B1B-4BE9-BEB6-D30E5BF40850")]
[InterfaceTypeAttribute()]
public interface IVsLibrary
[GuidAttribute(L"E86128E4-3B1B-4BE9-BEB6-D30E5BF40850")]
[InterfaceTypeAttribute()]
public interface class IVsLibrary
[<GuidAttribute("E86128E4-3B1B-4BE9-BEB6-D30E5BF40850")>]
[<InterfaceTypeAttribute()>]
type IVsLibrary =  interface end
public interface IVsLibrary

The IVsLibrary type exposes the following members.

Methods

  Name Description
Public method AddBrowseContainer Adds a browse container to be browsed by the library.
Public method GetBrowseContainersForHierarchy Returns an array of Browse Containers that correspond to the given IVsHierarchy.
Public method GetGuid Returns a pointer to the GUID of the library.
Public method GetLibFlags Returns flags associated with the library.
Public method GetLibList Returns the list of browse containers currently being browsed by the library as an IVsLiteTreeList interface.
Public method GetList Returns the requested list of symbols as an IVsObjectList interface.
Public method GetSeparatorString Returns the string used to separate symbols for this type of Browse Container.
Public method GetSupportedCategoryFields Returns the category values supported by the library for a specified category.
Public method LoadState Asks the library to load its persisted global Browse Containers.
Public method RemoveBrowseContainer Removes a Browse Container being browsed by the library.
Public method SaveState Asks the library to save its persisted global Browse Containers.
Public method UpdateCounter Returns the current change counter for the library and is used to indicate that the library contents have changed.

Top

Remarks

The smallest unit that can be browsed by a library is referred to as a Browse Container. A library typically browses one type of Browse Container. Each project type implements one, and possibly more, libraries to track its symbols, objects, and so on. The package's IVsLibraryMgr tracks these libraries. Libraries may be project specific, or global. Global libraries provide information on browse containers that are not a part of any project, but are added by a user through the Add Reference dialog. For more details on libraries and their relationship to the object browser see Object Browser and Class View.

See illustrations of the implementation and/or calling of this interface in the sample My C Package.

Notes to Implementers

The IVsLibrary interface has been deprecated. Implement instead IVsLibrary2

Notes to Callers

Called by the environment's object manager to obtain information about the library and its contents.

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace