Partager via


IVsHiddenTextSession.AddHiddenRegions Method

Adds a new hidden region to the text buffer.

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

Syntax

'Déclaration
Function AddHiddenRegions ( _
    dwUpdateFlags As UInteger, _
    cRegions As Integer, _
    rgHidReg As NewHiddenRegion(), _
    <OutAttribute> ppEnum As IVsEnumHiddenRegions() _
) As Integer
int AddHiddenRegions(
    uint dwUpdateFlags,
    int cRegions,
    NewHiddenRegion[] rgHidReg,
    IVsEnumHiddenRegions[] ppEnum
)
int AddHiddenRegions(
    [InAttribute] unsigned int dwUpdateFlags, 
    [InAttribute] int cRegions, 
    [InAttribute] array<NewHiddenRegion>^ rgHidReg, 
    [OutAttribute] array<IVsEnumHiddenRegions^>^ ppEnum
)
abstract AddHiddenRegions : 
        dwUpdateFlags:uint32 * 
        cRegions:int * 
        rgHidReg:NewHiddenRegion[] * 
        ppEnum:IVsEnumHiddenRegions[] byref -> int 
function AddHiddenRegions(
    dwUpdateFlags : uint, 
    cRegions : int, 
    rgHidReg : NewHiddenRegion[], 
    ppEnum : IVsEnumHiddenRegions[]
) : int

Parameters

  • cRegions
    Type: System.Int32
    [in] Number of hidden regions to add to the text buffer.

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 IVsHiddenTextSession::AddHiddenRegions(
   [in] DWORD dwUpdateFlags, 
   [in] long cRegions, 
   [in, size_is(cRegions)] NewHiddenRegion *rgHidReg, 
   [out] IVsEnumHiddenRegions **ppEnum
);

Call AddHiddenRegions to add a new outline or hidden region to the specified span of text.

  • When you create a new region using this method, you can specify whether the region can participate in Undo/Redo (dwUpdateFlags parameter), and the number of regions to create.

  • Additionally, in the rgHidReg parameter, you can specify properties of the region including the type (hidden or outlining), the behavior (editor- or client-controlled), the state (expanded or collapsed), the banner text shown when the region is collapsed, and you can additionally identify a specific cookie that you can use to reference hidden regions or a specific type in methods such as EnumHiddenRegions

.NET Framework Security

See Also

Reference

IVsHiddenTextSession Interface

Microsoft.VisualStudio.TextManager.Interop Namespace