IVsHiddenTextClient.MakeBaseSpanVisible Method

Article
05/06/2010

Called when a particular hidden region needs to be displayed.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

Syntax

'Déclaration
Function MakeBaseSpanVisible ( _
    pHidReg As IVsHiddenRegion, _
    pBaseSpan As TextSpan() _
) As Integer
'Utilisation
Dim instance As IVsHiddenTextClient
Dim pHidReg As IVsHiddenRegion
Dim pBaseSpan As TextSpan()
Dim returnValue As Integer

returnValue = instance.MakeBaseSpanVisible(pHidReg, _
    pBaseSpan)

int MakeBaseSpanVisible(
    IVsHiddenRegion pHidReg,
    TextSpan[] pBaseSpan
)

int MakeBaseSpanVisible(
    [InAttribute] IVsHiddenRegion^ pHidReg, 
    [InAttribute] array<TextSpan>^ pBaseSpan
)

abstract MakeBaseSpanVisible : 
        pHidReg:IVsHiddenRegion * 
        pBaseSpan:TextSpan[] -> int

function MakeBaseSpanVisible(
    pHidReg : IVsHiddenRegion, 
    pBaseSpan : TextSpan[]
) : int

Parameters

pHidReg
Type: Microsoft.VisualStudio.TextManager.Interop.IVsHiddenRegion
[in] Pointer to a hidden region object, IVsHiddenRegion

pBaseSpan
Type: array<Microsoft.VisualStudio.TextManager.Interop.TextSpan[]
[in] Pointer to a base span object. For more information, see TextSpan .

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 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.

Notes

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.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Partager via