Share via


ViewFilter.GetFullDataTipText Method

Returns a string that can be used in a tool tip, taking into account additional sources of text such as a debugger.

Namespace:  Microsoft.VisualStudio.Package
Assemblies:   Microsoft.VisualStudio.Package.LanguageService (in Microsoft.VisualStudio.Package.LanguageService.dll)
  Microsoft.VisualStudio.Package.LanguageService.10.0 (in Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.9.0 (in Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.11.0 (in Microsoft.VisualStudio.Package.LanguageService.11.0.dll)

Syntax

'Declaration
Public Overridable Function GetFullDataTipText ( _
    textValue As String, _
    ts As TextSpan, _
    <OutAttribute> ByRef fullTipText As String _
) As Integer
public virtual int GetFullDataTipText(
    string textValue,
    TextSpan ts,
    out string fullTipText
)
public:
virtual int GetFullDataTipText(
    String^ textValue, 
    TextSpan ts, 
    [OutAttribute] String^% fullTipText
)
abstract GetFullDataTipText : 
        textValue:string * 
        ts:TextSpan * 
        fullTipText:string byref -> int  
override GetFullDataTipText : 
        textValue:string * 
        ts:TextSpan * 
        fullTipText:string byref -> int
public function GetFullDataTipText(
    textValue : String, 
    ts : TextSpan, 
    fullTipText : String
) : int

Parameters

  • textValue
    Type: System.String

    [in] The string to use as the default.

  • fullTipText
    Type: System.String%

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

Return Value

Type: System.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.

.NET Framework Security

See Also

Reference

ViewFilter Class

Microsoft.VisualStudio.Package Namespace