Método TextSelection.WordLeft

Artigo
08/01/2011

Move o texto selecionado à esquerda o número especificado de palavras.

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

Sintaxe

'Declaração
Sub WordLeft ( _
    Extend As Boolean, _
    Count As Integer _
)

void WordLeft(
    bool Extend,
    int Count
)

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

abstract WordLeft : 
        Extend:bool * 
        Count:int -> unit

function WordLeft(
    Extend : boolean, 
    Count : int
)

Parâmetros

Extend
Tipo: System.Boolean
Opcional.Determina se o texto movido é recolhido ou não.O padrão é false.

Count
Tipo: System.Int32
Opcional.Representa o número de palavras para mover para a esquerda.O valor padrão é 1.

Comentários

Se Extend é True, o final ativo do texto selecionado é movido para a esquerda Count número de palavras. Caso contrário, o texto selecionado é recolhido e posicionado Count esquerda de palavras do final ativo. Se o início do documento for encontrado antes de Count palavras, e a posição permanece no início do documento.

Se o valor de Count for negativo, em seguida, WordLeft executa como o WordRight método.

O Gerenciador de idioma ativo para o documento de texto define o significado de "word".

Exemplos

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

TextSelection Interface

Namespace EnvDTE

Compartilhar via