Método EditPoint.Cut

Artigo
08/01/2011

Copia o intervalo especificado de texto na área de transferência e a exclui do documento.

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

Sintaxe

'Declaração
Sub Cut ( _
    PointOrCount As Object, _
    Append As Boolean _
)

void Cut(
    Object PointOrCount,
    bool Append
)

void Cut(
    [InAttribute] Object^ PointOrCount, 
    [InAttribute] bool Append
)

abstract Cut : 
        PointOrCount:Object * 
        Append:bool -> unit

function Cut(
    PointOrCount : Object, 
    Append : boolean
)

Parâmetros

PointOrCount
Tipo: System.Object
Obrigatório.Tanto um TextPoint objeto ou um número de caracteres.

Append
Tipo: System.Boolean
Opcional.Indica se deve acrescentar o texto selecionado para a área de transferência.O padrão é false.

Comentários

Se PointOrCount é um TextPoint o objeto, Cut recorta o texto entre o ponto de edição e PointOrCount e coloca-na área de transferência. Se PointOrCount é um número inteiro, em seguida, Cut recorta o texto após o ponto de edição para o número especificado de caracteres após o ponto de edição (adicionando um para cada seqüência newline implícita no final de cada linha). Se PointOrCount for negativo, em seguida, Cut recorta o texto antes do ponto de edição.

Se Append é true, em seguida, Cut acrescenta a seleção para o conteúdo da área de transferência atual, em vez de substituir o proprietário.

Exemplos

Sub CutExample()
   Dim objTextDoc As TextDocument
   Dim objEditPt As EditPoint, iCtr As Integer
        
   ' Create a new text file.
   DTE.ItemOperations.NewFile("General\Text File")
        
   ' Get a handle to the new document and create an EditPoint.
   objTextDoc = DTE.ActiveDocument.Object("TextDocument")
   objEditPt = objTextDoc.StartPoint.CreateEditPoint
       
   ' Insert ten lines of text.
   For iCtr = 1 To 10
      objeditpt.Insert("This is a test." & Chr(13))
   Next iCtr
        
   ' Copies the fourth word of the fourth line and pastes it, 
   ' then cuts the fourth word of the eighth line.
   objEditPt.StartOfDocument()
   objEditPt.LineDown(3)
   objEditPt.WordRight(3)
   objEditPt.Copy(4)
   objEditPt.Paste()
   objEditPt.LineDown(3)
   objEditPt.WordRight(3)
   objEditPt.Cut(4)
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

EditPoint Interface

Namespace EnvDTE

Compartilhar via