IVsDebugger2::ShowSource Method (Object^, Int32, Int32, Int32, Int32, IVsTextView^)

Visual Studio 2015

Displays a source file in the IDE. Takes as arguments a pointer to an IUnknown interface that can be queried for IDebugDocumentContext2 and display options.

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

Syntax

C++

int ShowSource(
	Object^ pUnkDebugDocContext,
	int fMakeActive,
	int fAlwaysMoveCaret,
	int fPromptToFindSource,
	int fIgnoreIfNotFound,
	[OutAttribute] IVsTextView^% ppTextView
)

Parameters

pUnkDebugDocContext: Type: System::Object^
[in] Pointer to an IUnknown interface on an object implementing IDebugDocumentContext2.

fMakeActive: Type: System::Int32
[in] Boolean. If true, makes the source file window the active window.

fAlwaysMoveCaret: Type: System::Int32
[in] Boolean. If true, move the caret to the position indicated by the document context through the IDebugDocumentContext2::GetStatementRange method of the IDebugDocumentContext2 interface.

fPromptToFindSource: Type: System::Int32
[in] Boolean. If true, prompt the user if the file is not found.

fIgnoreIfNotFound: Type: System::Int32
[in] Boolean. If true, do not try to find the file in the future if it is not found now.

ppTextView: Type: Microsoft.VisualStudio.TextManager.Interop::IVsTextView^
[out] Pointer to a IVsTextView interface representing the opened source view. May be null.

Return Value

Type: System::Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell80.idl:

C++

HRESULT IVsDebugger2::ShowSource(
   [in] IUnknown *pUnkDebugDocContext,
   [in] BOOL fMakeActive,
   [in] BOOL fAlwaysMoveCaret,
   [in] BOOL fPromptToFindSource,
   [in] BOOL fIgnoreIfNotFound,
   [out] IVsTextView **ppTextView
);