IVsLanguageTextOps.GetDataTip Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Displays a tip over a span of text when the mouse hovers over this location.
public:
int GetDataTip(Microsoft::VisualStudio::TextManager::Interop::IVsTextLayer ^ pTextLayer, cli::array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ ptsSel, cli::array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ ptsTip, [Runtime::InteropServices::Out] System::String ^ % pbstrText);
int GetDataTip(Microsoft::VisualStudio::TextManager::Interop::IVsTextLayer const & pTextLayer, std::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> const & ptsSel, std::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> const & ptsTip, [Runtime::InteropServices::Out] std::wstring const & & pbstrText);
public int GetDataTip (Microsoft.VisualStudio.TextManager.Interop.IVsTextLayer pTextLayer, Microsoft.VisualStudio.TextManager.Interop.TextSpan[] ptsSel, Microsoft.VisualStudio.TextManager.Interop.TextSpan[] ptsTip, out string pbstrText);
abstract member GetDataTip : Microsoft.VisualStudio.TextManager.Interop.IVsTextLayer * Microsoft.VisualStudio.TextManager.Interop.TextSpan[] * Microsoft.VisualStudio.TextManager.Interop.TextSpan[] * string -> int
Public Function GetDataTip (pTextLayer As IVsTextLayer, ptsSel As TextSpan(), ptsTip As TextSpan(), ByRef pbstrText As String) As Integer
Parameters
- pTextLayer
- IVsTextLayer
[in] An IVsTextLayer object representing the text file.
- ptsSel
- TextSpan[]
[in] Span of text relevant to the specified text layer. For more information, see TextSpan.
- ptsTip
- TextSpan[]
[out] Returns a span of text to center the tip over. For more information, see Microsoft.VisualStudio.TextManager.Interop.
- pbstrText
- String
[out] Returns the text of the tip to display.
Returns
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From textmgr.idl:
HRESULT IVsLanguageTextOps::GetDataTip(
[in] IVsTextLayer *pTextLayer,
[in] const TextSpan *ptsSel,
[out] TextSpan *ptsTip,
[out, retval] BSTR *pbstrText
);
Use the IVsTextLayer object to access the applicable text within the text span (ptsSel
) for the tip.
What is displayed depends on the language service. For example, in Visual C#, holding the cursor over a variable typically shows the type of that variable. This method is also used with when debugging a program: this method is called to obtain the type and name of a variable while the debugger is asked for the value of the variable. The two pieces of information are then combined and displayed in a single data tip.