Cut Method

Microsoft Word Visual Basic

Cut Method

       

Removes the specified object from the document and places it on the Clipboard.

expression.Cut

expression   Required. An expression that returns a Field, FormField, Frame, MailMergeField, PageNumber, Range, or Selection object.

Remarks

If expression returns a Range or Selection object, the contents of the object are cut to the Clipboard but the collapsed object remains in the document.

Example

This example cuts the first field in the active document and pastes the field at the insertion point.

If ActiveDocument.Fields.Count >= 1 Then
    ActiveDocument.Fields(1).Cut
    Selection.Collapse Direction:=wdCollapseEnd
    Selection.Paste
End If

This example cuts the first word in the first paragraph and pastes the word at the end of the paragraph.

With ActiveDocument.Paragraphs(1).Range
    .Words(1).Cut
    .Collapse Direction:=wdCollapseEnd
    .Move Unit:=wdCharacter, Count:=-1
    .Paste
End With

This example cuts the contents of the selection and pastes them into a new document.

If Selection.Type = wdSelectionNormal Then
    Selection.Cut
    Documents.Add.Content.Paste
End If