Replacement Object

Multiple objects

Represents the replace criteria for a find-and-replace operation. The properties and methods of the Replacement object correspond to the options in the Find and Replace dialog box.

Using the Replacement Object

Use the Replacement property to return a Replacement object. The following example replaces the next occurrence of the word "hi" with the word "hello."

With Selection.Find
    .Text = "hi"
    .Replacement.Text = "hello"
    .Execute Replace:=wdReplaceOne, Forward:=True
End With

To find and replace formatting, set both the find text and the replace text to empty strings ("") and set the Format argument of the Execute method to True. The following example removes all the bold formatting in the active document. The Bold property is True for the Find object and False for the Replacement object.

With ActiveDocument.Content.Find
    .Font.Bold = True
    .Text = ""
    With .Replacement
        .Font.Bold = False
        .Text = ""
    End With
    .Execute Format:=True, Replace:=wdReplaceAll
End With

Properties | Application Property | Creator Property | Font Property | Frame Property | Highlight Property | LanguageID Property | LanguageIDFarEast Property | NoProofing Property | ParagraphFormat Property | Parent Property | Style Property | Text Property

Methods | ClearFormatting Method

Parent Objects | Find Object

Child Objects | Font Object | Frame Object | ParagraphFormat Object

See Also | Find Object | Finding and Replacing Text or Formatting