EditPoint2.Cut メソッド (Object, Boolean)

[アーティクル]
08/09/2011

指定したテキスト範囲をクリップボードにコピーし、ドキュメントから削除します。

名前空間: EnvDTE80
アセンブリ: EnvDTE80 (EnvDTE80.dll 内)

構文

'宣言
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
)

パラメーター

PointOrCount
型: System.Object
必ず指定します。TextPoint オブジェクトまたは文字数。

Append
型: System.Boolean
省略可能です。選択したテキストをクリップボードに追加するかどうかを指定します。既定値は、false です。

実装

EditPoint.Cut(Object, Boolean)

解説

PointOrCount が TextPoint オブジェクトの場合、Cut は、エディットポイントと PointOrCount 間のテキストを切り取り、クリップボードに配置します。 PointOrCount が整数の場合、Cut は、エディットポイントの後のテキストを指定した文字数だけ切り取ります。各行の末尾で暗黙的に指定される改行シーケンスも 1 文字と見なされます。 PointOrCount が負の値の場合、Cut は、エディットポイントの前にあるテキストを切り取ります。

Append が true の場合、Cut は、選択内容を置き換えるのではなく、選択内容をクリップボードの内容に追加します。

例

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, pastes it, 
   ' and 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