ITextBuffer Interface
A mutable sequence of Unicode (UTF-16) characters.
Namespace: Microsoft.VisualStudio.Text
Assembly: Microsoft.VisualStudio.Text.Data (in Microsoft.VisualStudio.Text.Data.dll)
Syntax
'宣言
Public Interface ITextBuffer _
Inherits IPropertyOwner
public interface ITextBuffer : IPropertyOwner
public interface class ITextBuffer : IPropertyOwner
type ITextBuffer =
interface
interface IPropertyOwner
end
public interface ITextBuffer extends IPropertyOwner
The ITextBuffer type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
ContentType | Gets the content type of the text in the buffer. |
|
CurrentSnapshot | Gets the current content of the buffer. |
|
EditInProgress | Determines whether an edit operation is currently in progress on the ITextBuffer. |
|
Properties | Gets the collection of properties controlled by the property owner. (Inherited from IPropertyOwner.) |
Top
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
ChangeContentType | Changes the IContentType for this ITextBuffer. |
|
CheckEditAccess | Determines whether edit operations on this text buffer are permitted on the calling thread. |
|
CreateEdit() | Creates an ITextEdit object that handles compound edit operations on this buffer. |
|
CreateEdit(EditOptions, Nullable<Int32>, Object) | Creates an ITextEdit object that handles compound edit operations on this buffer. |
|
CreateReadOnlyRegionEdit | Creates an IReadOnlyRegionEdit object that handles adding or removing read-only regions from this buffer. |
|
Delete | Deletes a sequence of characters from the buffer. |
|
GetReadOnlyExtents | Gets a list of read-only regions that overlap the given span. |
|
Insert | Inserts the given text at the specified position in the ITextBuffer. |
|
IsReadOnly(Int32) | Determines whether a text insertion would be prohibited at the specified position due to an IReadOnlyRegion. |
|
IsReadOnly(Span) | Determines whether a text modification or deletion would be prohibited at span due to an IReadOnlyRegion. |
|
IsReadOnly(Int32, Boolean) | Determines whether a text insertion would be prohibited at the specified position due to an IReadOnlyRegion. |
|
IsReadOnly(Span, Boolean) | Determines whether a text modification or deletion would be prohibited at span due to an IReadOnlyRegion. |
|
Replace | Replaces a sequence of characters with different text. This is equivalent to first deleting the text to be replaced and then inserting the new text. |
|
TakeThreadOwnership | Claims ownership of this buffer for the current thread. All subsequent modifications of this ITextBuffer must be made from the current thread, or else an InvalidOperationException will be raised. |
Top
Events
| Name | Description | |
|---|---|---|
.gif "Public event") |
Changed | Occurs when a non-empty ITextEdit is successfully applied. |
|
ChangedHighPriority | Occurs when a non-empty ITextEdit is successfully applied. |
|
ChangedLowPriority | Occurs when a non-empty ITextEdit is successfully applied. |
|
Changing | Occurs just before a non-empty ITextEdit is applied. |
|
ContentTypeChanged | Occurs whenever the IContentType has been changed. |
|
PostChanged | Occurs after the Changed event and any resulting edits. |
|
ReadOnlyRegionsChanged | Occurs when a IReadOnlyRegionEdit has created or removed read-only regions. |
Top
Remarks
For more information about text buffers, see the section "A Closer Look at the Text Model and the Text View" in Inside the Editor.
Positions in this buffer are treated as a sequence of characters (starting at character zero), or as a sequence of lines (starting at line zero). An empty buffer has a single line containing no characters.