TextSelection.WordRight-Methode

Článek
08/23/2008

Aktualisiert: November 2007

Verschiebt den markierten Text um die angegebene Anzahl von Wörtern nach rechts.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
Sub WordRight ( _
    Extend As Boolean, _
    Count As Integer _
)
'Usage
Dim instance As TextSelection
Dim Extend As Boolean
Dim Count As Integer

instance.WordRight(Extend, Count)

void WordRight(
    bool Extend,
    int Count
)

void WordRight(
    [InAttribute] bool Extend, 
    [InAttribute] int Count
)

function WordRight(
    Extend : boolean, 
    Count : int
)

Parameter

Extend
Typ: System.Boolean

Optional. Bestimmt, ob der verschobene Text reduziert wird. Der Standardwert ist false.

Count
Typ: System.Int32

Optional. Stellt die Anzahl der Wörter dar, um die nach rechts verschoben werden soll. Der Standardwert ist 1.

Hinweise

Wenn Extend den Wert true hat, wird das aktive Ende des markierten Textes um die durch Count vorgegebene Anzahl von Wörtern nach rechts verschoben. Andernfalls wird der markierte Text reduziert und Count Wörter rechts vom aktiven Ende eingefügt. Wenn das Ende des Dokuments vor Count Wörtern erreicht wird, wird die Position am Ende des Dokuments beibehalten.

Wenn der Wert von Count negativ ist, verhält sich WordRight wie die WordLeft-Methode.

Die Bedeutung eines "Wortes" wird durch den aktiven Sprach-Manager für das Textdokument definiert.

Beispiele

Sub WordRightExample()
    ' 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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

TextSelection-Schnittstelle

TextSelection-Member

EnvDTE-Namespace

Sdílet prostřednictvím