Share via


IVsTextHidingLayerModule.MakeBaseSpanVisible Method

Makes a text span visible.

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

Syntax

'Declaration
Function MakeBaseSpanVisible ( _
    pBaseSpan As TextSpan() _
) As Integer
int MakeBaseSpanVisible(
    TextSpan[] pBaseSpan
)
int MakeBaseSpanVisible(
    array<TextSpan>^ pBaseSpan
)
abstract MakeBaseSpanVisible : 
        pBaseSpan:TextSpan[] -> int
function MakeBaseSpanVisible(
    pBaseSpan : TextSpan[]
) : int

Parameters

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
S_OK : the span was hidden but is now visible
S_FALSE : the span wasn't hidden by this layer
E_FAIL : the span is hidden but the layer doesn't know how to unhide it (will result in the layer being destroyed)

Remarks

COM Signature

From textmgr.idl:

HRESULT IVsTextHidingLayerModule::MakeBaseSpanVisible(
   TextSpan *pBaseSpan
);

The pBaseSpan parameter indicates that all of the base text therein must be made visible. For example, if there is hidden text in the middle of a line and the start and end of the line is passed in pBaseSpan to MakeBaseSpanVisible, this is not sufficient to ensure that only the start and end of the line are visible; every character in the span must be visible.

In some cases (for example, highlighting a find hit) you want to use this on a span of text. In others (for example, the "Go To Line" command), you only want to ensure that the beginning of the physical line is visible, but you don't want to force the entire contents of the physical line to be revealed.

The required side effect of this function succeeding is that a call to BaseLineIndexToLocal on any character within *pBaseSpan must succeed and not return VIEW_E_LOCATION_HIDDEN.

.NET Framework Security

See Also

Reference

IVsTextHidingLayerModule Interface

Microsoft.VisualStudio.TextManager.Interop Namespace