Share via


TextRange.Replace Method

Finds specific text in a text range, replaces the found text with a specified string, and returns a TextRange object that represents the first occurrence of the found text. Returns a null reference (Nothing in Visual Basic) if no match is found.

Namespace:  Microsoft.Office.Interop.PowerPoint
Assembly:  Microsoft.Office.Interop.PowerPoint (in Microsoft.Office.Interop.PowerPoint.dll)

Syntax

'Declaration
Function Replace ( _
    FindWhat As String, _
    ReplaceWhat As String, _
    After As Integer, _
    MatchCase As MsoTriState, _
    WholeWords As MsoTriState _
) As TextRange
'Usage
Dim instance As TextRange
Dim FindWhat As String
Dim ReplaceWhat As String
Dim After As Integer
Dim MatchCase As MsoTriState
Dim WholeWords As MsoTriState
Dim returnValue As TextRange

returnValue = instance.Replace(FindWhat, _
    ReplaceWhat, After, MatchCase, WholeWords)
TextRange Replace(
    string FindWhat,
    string ReplaceWhat,
    int After,
    MsoTriState MatchCase,
    MsoTriState WholeWords
)

Parameters

  • ReplaceWhat
    Type: System.String
    The text that you want to use to replace the found text.
  • After
    Type: System.Int32
    The position of the character (in the specified text range) after which you want to search for the next occurrence of FindWhat. For example, if you want to search from the fifth character of the text range, specify 4 for After. If this argument is omitted, the first character of the text range is used as the starting point for the search.

Return Value

Type: Microsoft.Office.Interop.PowerPoint.TextRange

Remarks

The MatchCase parameter value can be one of these MsoTriState constants.

Constant

Description

msoFalse

The default. Does not distinguish between uppercase and lowercase characters.

msoTrue

Distinguish between uppercase and lowercase characters.

The WholeWords parameter value can be one of these MsoTriState constants.

Constant

Description

msoFalse

The default. Does not find only entire words.

msoTrue

Finds only entire words.

See Also

Reference

TextRange Interface

TextRange Members

Microsoft.Office.Interop.PowerPoint Namespace