IVsSymbolicNavigationNotify Interface


Facilitates redirection of Goto Definition on a code symbol.

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

public interface IVsSymbolicNavigationNotify

System_CAPS_pubmethodOnBeforeNavigateToSymbol(IVsHierarchy, UInt32, String, Int32)

Determines if there is an alternate source file to navigate to for a code symbol.

System_CAPS_pubmethodQueryNavigateToSymbol(IVsHierarchy, UInt32, String, IVsHierarchy, UInt32, TextSpan[], Int32)

Returns the alternate navigation target for the symbol if there is one.

Implemented by an advanced code generator system that wants to re-direct the result of Goto Definition on a code symbol. Instead of going to the definition of the symbol in the generated code file, an implementor of this interface can cause the navigation to the definition of the equivalent element in the source file used to generate the code file (e.g. an XAML file).

It is expected that IVsSymbolicNavigationNotify implementations should quickly be able to recognize code files they care about by checking if the input CodeFile matches the naming conventions of the generated files they produce. This might be something like file ends in ".g.vb". It is important that this operation be fast because every "Goto Definition" operation will be passed to these implementations.

Implementors of this interface should register a pointer to their implementation with the IVsSymbolicNavigationManager service.

Return to top