Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Moves the caret to the specified buffer position.
Namespace: Microsoft.VisualStudio.Text.Editor
Assembly: Microsoft.VisualStudio.Text.UI (in Microsoft.VisualStudio.Text.UI.dll)
Syntax
'Declaration
Function MoveTo ( _
bufferPosition As VirtualSnapshotPoint, _
caretAffinity As PositionAffinity, _
captureHorizontalPosition As Boolean _
) As CaretPosition
CaretPosition MoveTo(
VirtualSnapshotPoint bufferPosition,
PositionAffinity caretAffinity,
bool captureHorizontalPosition
)
CaretPosition MoveTo(
VirtualSnapshotPoint bufferPosition,
PositionAffinity caretAffinity,
bool captureHorizontalPosition
)
abstract MoveTo :
bufferPosition:VirtualSnapshotPoint *
caretAffinity:PositionAffinity *
captureHorizontalPosition:bool -> CaretPosition
function MoveTo(
bufferPosition : VirtualSnapshotPoint,
caretAffinity : PositionAffinity,
captureHorizontalPosition : boolean
) : CaretPosition
Parameters
- bufferPosition
Type: Microsoft.VisualStudio.Text.VirtualSnapshotPoint
The VirtualSnapshotPoint in the underlying text buffer to which to move the caret.
- caretAffinity
Type: Microsoft.VisualStudio.Text.PositionAffinity
The affinity of the caret. This will be ignored unless bufferPosition specifies a location that is at the seam between two word-wrapped lines.
- captureHorizontalPosition
Type: System.Boolean
If true, the caret captures its horizontal position for subsequent moves up or down, if false, the caret retains its previously-captured horizontal position.
Return Value
Type: Microsoft.VisualStudio.Text.Editor.CaretPosition
A CaretPosition that contains the valid values of the caret position after the move has occurred.
Remarks
This method handles UTF-16 surrogate pairs and combining character sequences.
For example, if the text buffer consists of a high surrogate character at index 0 and a low surrogate character at index 1, and bufferPosition is 1 and caretAffinity is Successor, the actual valid caret index is 0 (since the high surrogate and low surrogate characters form one text element).
If caretAffinity is Predecessor, the actual valid caret index is 2.
.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.