Cut Method

Applies To

Field object, FormField object, Frame object, MailMergeField object, PageNumber object, Range object, Selection object.

Description

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

Syntax

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.

See Also

AppendToSpike method, Copy method, Paste method, PasteSpecial method.

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