IReadOnlyRegionEdit.CreateDynamicReadOnlyRegion Method

Marks a span of text in this buffer as conditionally read-only, subject to a check performed when the region is queried. The span remains read-only until it is marked as writable or forced writable again.

Namespace:  Microsoft.VisualStudio.Text
Assembly:  Microsoft.VisualStudio.Text.Data (in Microsoft.VisualStudio.Text.Data.dll)

Syntax

‘선언
Function CreateDynamicReadOnlyRegion ( _
    span As Span, _
    trackingMode As SpanTrackingMode, _
    edgeInsertionMode As EdgeInsertionMode, _
    callback As DynamicReadOnlyRegionQuery _
) As IReadOnlyRegion

IReadOnlyRegion CreateDynamicReadOnlyRegion(
    Span span,
    SpanTrackingMode trackingMode,
    EdgeInsertionMode edgeInsertionMode,
    DynamicReadOnlyRegionQuery callback
)

IReadOnlyRegion^ CreateDynamicReadOnlyRegion(
    Span span, 
    SpanTrackingMode trackingMode, 
    EdgeInsertionMode edgeInsertionMode, 
    DynamicReadOnlyRegionQuery^ callback
)

abstract CreateDynamicReadOnlyRegion : 
        span:Span * 
        trackingMode:SpanTrackingMode * 
        edgeInsertionMode:EdgeInsertionMode * 
        callback:DynamicReadOnlyRegionQuery -> IReadOnlyRegion 

function CreateDynamicReadOnlyRegion(
    span : Span, 
    trackingMode : SpanTrackingMode, 
    edgeInsertionMode : EdgeInsertionMode, 
    callback : DynamicReadOnlyRegionQuery
) : IReadOnlyRegion

Parameters

• span
  Type: Microsoft.VisualStudio.Text.Span
  The span to mark as read-only.

• trackingMode
  Type: Microsoft.VisualStudio.Text.SpanTrackingMode
  Specifies the tracking behavior of the read-only region.

• edgeInsertionMode
  Type: Microsoft.VisualStudio.Text.EdgeInsertionMode
  Specifies the edge insertion behavior of the read-only region.

• callback
  Type: Microsoft.VisualStudio.Text.DynamicReadOnlyRegionQuery
  The delegate that notifies the read-only region of read-only checks and edits. May be null.
  See QueryCallback.

Return Value

Type: Microsoft.VisualStudio.Text.IReadOnlyRegion
The IReadOnlyRegion used to track this read-only region. This object will be used to remove the read-only region.

Exceptions

Exception	Condition
ArgumentNullException	span is nulla null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	span is past the end of the buffer.

Remarks

Zero-length read-only regions restrict inserts only at the exact point defined by the region. A deletion or modification that includes that point can still occur.

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

See Also

Reference

IReadOnlyRegionEdit Interface

Microsoft.VisualStudio.Text Namespace