IVsHiddenTextClient.MakeBaseSpanVisible(IVsHiddenRegion, TextSpan[]) Method

Definition

Called when a particular hidden region needs to be displayed.

public:
 int MakeBaseSpanVisible(Microsoft::VisualStudio::TextManager::Interop::IVsHiddenRegion ^ pHidReg, cli::array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ pBaseSpan);
public:
 int MakeBaseSpanVisible(Microsoft::VisualStudio::TextManager::Interop::IVsHiddenRegion ^ pHidReg, Platform::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ pBaseSpan);
int MakeBaseSpanVisible(Microsoft::VisualStudio::TextManager::Interop::IVsHiddenRegion const & pHidReg, std::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> const & pBaseSpan);
public int MakeBaseSpanVisible (Microsoft.VisualStudio.TextManager.Interop.IVsHiddenRegion pHidReg, Microsoft.VisualStudio.TextManager.Interop.TextSpan[] pBaseSpan);
abstract member MakeBaseSpanVisible : Microsoft.VisualStudio.TextManager.Interop.IVsHiddenRegion * Microsoft.VisualStudio.TextManager.Interop.TextSpan[] -> int
Public Function MakeBaseSpanVisible (pHidReg As IVsHiddenRegion, pBaseSpan As TextSpan()) As Integer

Parameters

pHidReg
IVsHiddenRegion

[in] Pointer to a hidden region object, IVsHiddenRegion

pBaseSpan
TextSpan[]

[in] Pointer to a base span object. For more information, see TextSpan .

Returns

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

Remarks

COM Signature

From textmgr.idl:

HRESULT IVsHiddenTextClient::MakeBaseSpanVisible(  
   [in] IVsHiddenRegion *pHidReg,   
   [in] TextSpan *pBaseSpan  
);  

This method is called when the text within a hidden region should be exposed. If the user does something that requires a piece of hidden text to be visible (for example, Goto line command, debugger stepping, find in files hit, and so on) then the environment calls this method for regions that the hidden text manager cannot automatically make visible. In the current implementation this will only happen for concealed regions; collapsible regions will be automatically expanded.

Note

When this method is called, the client must expose the text in the specified hidden region. The client must either destroy the hidden region by calling Invalidate or reset the hidden region's range so that it no longer includes the required text. It is acceptable to add or remove other regions when this method is called.

Applies to