EditPoint.Cut-Methode

Artikel
10/24/2012

Kopiert den angegebenen Textbereich in die Zwischenablage und löscht diesen aus dem Dokument.

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

Syntax

'Declaration
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
)

Parameter

PointOrCount
Typ: System.Object
Erforderlich.Entweder ein TextPoint-Objekt oder eine Anzahl von Zeichen.

Append
Typ: System.Boolean
Dies ist optional.Zeigt an, ob der markierte Text in die Zwischenablage angefügt werden soll.Die Standardeinstellung ist false.

Hinweise

Wenn PointOrCount ein TextPoint-Objekt ist, schneidet Cut den Text zwischen dem Bearbeitungspunkt und PointOrCount aus und fügt ihn in die Zwischenablage ein.Wenn PointOrCount eine ganze Zahl ist, schneidet Cut die angegebene Anzahl von Zeichen aus, die auf den Bearbeitungspunkt folgen (wobei für jede implizierte Zeilenumbruchsequenz am Ende jeder Zeile ein Zeichen hinzugefügt wird).Wenn PointOrCount negativ ist, schneidet Cut Text vor dem Bearbeitungspunkt aus.

Wenn Appendtrue ist, fügt Cut die Auswahl an den aktuellen Inhalt der Zwischenablage an, anstatt diesen zu ersetzen.

Beispiele

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

.NET Framework-Sicherheit

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

EditPoint Schnittstelle

EnvDTE-Namespace

Share via