ViewFilter.GetFullDataTipText(String, TextSpan, String) Method

Definition

Namespace:

Microsoft.VisualStudio.Package

Assembly:

Microsoft.VisualStudio.Package.LanguageService.15.0.dll

Package:

Microsoft.VisualStudio.Package.LanguageService.15.0 v17.11.40262

This method checks to see if the IVsDebugger is running, and if so, calls it to get additional information about the current token and returns a combined result. You can return an HRESULT here like TipSuccesses2.TIP_S_NODEFAULTTIP.

public:
 virtual int GetFullDataTipText(System::String ^ textValue, Microsoft::VisualStudio::TextManager::Interop::TextSpan ts, [Runtime::InteropServices::Out] System::String ^ % fullTipText);

 virtual int GetFullDataTipText(std::wstring const & textValue, Microsoft::VisualStudio::TextManager::Interop::TextSpan ts, [Runtime::InteropServices::Out] std::wstring const & & fullTipText);

public virtual int GetFullDataTipText (string textValue, Microsoft.VisualStudio.TextManager.Interop.TextSpan ts, out string fullTipText);

abstract member GetFullDataTipText : string * Microsoft.VisualStudio.TextManager.Interop.TextSpan * string -> int
override this.GetFullDataTipText : string * Microsoft.VisualStudio.TextManager.Interop.TextSpan * string -> int

Public Overridable Function GetFullDataTipText (textValue As String, ts As TextSpan, ByRef fullTipText As String) As Integer

Parameters

textValue

String

[in] The string to use as the default.

ts

TextSpan

[in] A TextSpan object specifying the span of source to examine.

fullTipText

String

[out] Returns a string to be used as a tool tip.

Returns

Int32

If successful, returns S_OK; otherwise, returns an error code. Other possible success codes are TIP_S_NODEFAULTTIP (only the value returned from the debugger is used) and TIP_S_ONLYIFNOMARKER (show the tool tip only if no parsing errors have occurred in the same location).

Remarks

This method is called to make the final adjustments to the given text to be displayed in a tool tip. These adjustments take into account other sources of information such as a debugger. This additional information is then either combined with the default text or replaces the default text before the text is returned.

The base method determines if a debugger is running and if so, gets the extent of the expression the cursor is over by calling the GetWordExtent method with the flag WORDEXT_FINDEXPRESSION. The resulting TextSpan object is then passed to the GetDataTipValue method on the IVsDebugger interface representing the debugger. If GetDataTipValue returns a valid string, this string either replaces the default string specified by textValue or is appended to the default string (the debugger string replaces the default string if GetDataTipValue returns TIP_S_NODEFAULTTIP.

If the debugger is not running or there was no expression to pass to the debugger, the value in textValue is returned in fullTipText.

In the default managed package framework's implementation of the language service classes, this method is called from the GetDataTipText and HandleQuickInfo methods.