TextSelection.WordRight - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Перемещает выделенный текст на указанное число слов вправо.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
Sub WordRight ( _
    Extend As Boolean, _
    Count As Integer _
)
'Применение
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
)

Параметры

Extend
Тип: System.Boolean
Необязательный компонент. Определяет, следует ли свертывать перемещаемый текст. Значение по умолчанию — false.

Count
Тип: System.Int32
Необязательный компонент. Представляет собой число слов, на которое требуется переместиться вправо. Значение по умолчанию — 1.

Заметки

Если аргумент Extend имеет значение true, то активная конечная точка выделенного текста перемещается вправо на Count слов. В противном случае выделенный текст свертывается и размещается на Count слов вправо от активной конечной точки. Если конец документа находится менее чем на Count слов влево, смещенная позиция остается в конце документа.

Если значение Count отрицательно, то WordRight выполняется идентично методу WordLeft.

Точный смысл понятия "слово" определяется активным диспетчером языка, используемым для данного текстового документа.

Примеры

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

TextSelection Интерфейс

TextSelection - члены

EnvDTE - пространство имен

Поделиться через