This documentation is archived and is not being maintained.

MoveToPoint Method (TextSelection Object)

Visual Studio .NET 2003

Moves the active point to the given position.

[Visual Basic .NET]
Public Sub MoveToPoint( _
   ByVal Point As TextPoint, _
   Optional ByVal Extend As Boolean = False _
) 
[Visual Basic 6]
Sub MoveToPoint( _
   ByVal Point As TextPoint, _
   Optional ByVal Extend As Boolean = False _
) 
[C++]
HRESULT __stdcall MoveToPoint(
   TextPoint* Point,
   VARIANT_BOOL Extend
);
[C#]
public void MoveToPoint(
   TextPoint Point,
   bool Extend
);
[JScript .NET]
public function MoveToPoint(
   Point : TextPoint,
   Extend : Boolean
)

Parameters

Point
Required. The location in which to move the character.
Extend
Optional. Default = False. Determines whether to extend the current selection. If Extend is True, then the active end of the selection moves to the location while the anchor end remains where it is. Otherwise, both ends are moved to the specified location. This argument applies only to the TextSelection object.

Example

Sub MoveToPointExample()
    ' Before running this example, open a text document.
    Dim objSel As TextSelection = DTE.ActiveDocument.Selection
    If objSel.IsEmpty Then
        ' If there is no text selected, swap the words before and after 
        ' the insertion point. We begin by selecting the word before the 
        ' insertion point.
        objSel.WordLeft(True)
        If Not objSel.IsEmpty Then
            ' We can continue only if the selection was not already at the 
            ' beginning of the document.
            Dim strBefore As String = objSel.Text

            ' The text is saved in strBefore; now delete it and move past 
            ' the following word.
            objSel.Delete()
            objSel.WordRight(True)
            If objSel.Text.StartsWith(" ") Or objSel.Text.StartsWith(Microsoft.VisualBasic.ControlChars.Tab) Then
                ' The previous call to WordRight may have skipped some 
                ' white space instead of an actual word. In that case, we 
                ' should call it again.
                objSel.WordRight(True)
            End If

            ' Insert the new text at the end of the selection.
            objSel.Insert(strBefore, vsInsertFlags.vsInsertFlagsInsertAtEnd)
        End If
    Else
        ' If some text is selected, replace the following word with the 
        ' selected text.
        Dim strSelected As String = objSel.Text

        objSel.MoveToPoint(objSel.BottomPoint)
        objSel.WordRight(True)
        If objSel.Text.StartsWith(" ") Or objSel.Text.StartsWith(Microsoft.VisualBasic.ControlChars.Tab) Then
            ' The previous call to WordRight may have skipped some 
            ' white space instead of an actual word. In that case, we 
            ' should call it again.
            objSel.WordRight(True)
        End If

        ' Insert the text, overwriting the existing text and leaving the 
        ' selection containing the inserted text.
        objSel.Insert(strSelected, vsInsertFlags.vsInsertFlagsContainNewText)
    End If
End Sub

See Also

Applies To: TextSelection Object

Show: