IReadOnlyRegionEdit Interface

Reference

Definition

Namespace:: Microsoft.VisualStudio.Text

Assembly:: Microsoft.VisualStudio.Text.Data.dll

Package:: Microsoft.VisualStudio.Text.Data v17.11.260

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides for an atomic set of read-only region editing operations on an ITextBuffer. Edition positions are specified with respect to the state of the ITextBuffer at the time the IReadOnlyRegionEdit object was created.

public interface class IReadOnlyRegionEdit : IDisposable, Microsoft::VisualStudio::Text::ITextBufferEdit

public interface IReadOnlyRegionEdit : IDisposable, Microsoft.VisualStudio.Text.ITextBufferEdit

type IReadOnlyRegionEdit = interface
    interface ITextBufferEdit
    interface IDisposable

Public Interface IReadOnlyRegionEdit
Implements IDisposable, ITextBufferEdit

Implements: ITextBufferEdit IDisposable

Remarks

At most one ITextBufferEdit object may be active for a particular ITextBuffer. It is considered active as long as it has been neither applied nor canceled; calling Dispose() on an unapplied object is equivalent to calling Cancel.

The operations performed using this object do not appear in the ITextBuffer until the Apply() method has been called.

Properties

Canceled	Determines whether this edit has been canceled. (Inherited from ITextBufferEdit)
Snapshot	A snapshot of the ITextBuffer at the time this ITextBufferEdit object was created. (Inherited from ITextBufferEdit)

Methods

Apply()	Commits all the modifications made with this ITextBufferEdit object to the underlying ITextBuffer. Depending on the type of edit, it may also cause the ITextBuffer to generate a new snapshot and raise its Changed event if any modifications were made. This method may be called only once. After it is called, any other calls on this object (other than Dispose) will result in an InvalidOperationException. (Inherited from ITextBufferEdit)
Cancel()	Abandons all modifications started using this ITextBufferEdit object. Any further calls on this object will result in an InvalidOperationException. (Inherited from ITextBufferEdit)
CreateDynamicReadOnlyRegion(Span, SpanTrackingMode, EdgeInsertionMode, DynamicReadOnlyRegionQuery)	Marks a span of text in this buffer as 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.
CreateReadOnlyRegion(Span, SpanTrackingMode, EdgeInsertionMode)	Marks a span of text in this buffer as read-only. The span remains read-only until it is marked as writable or forced writable again.
CreateReadOnlyRegion(Span)	Marks a span of text in this buffer as read-only. The span remains read-only until the IReadOnlyRegion is removed.
RemoveReadOnlyRegion(IReadOnlyRegion)	Removes the read-only region from the list of read-only regions in this buffer.

Applies to

Share via