Direction

FindReplaceOptions.Direction property

Selects direction for replace. Default value is Forward.

public FindReplaceDirection Direction { get; set; }

Examples

Shows how to determine which direction a find-and-replace operation traverses the document in.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert three runs which we can search for using a regex pattern.
// Place one of those runs inside a text box.
builder.Writeln("Match 1.");
builder.Writeln("Match 2.");
builder.Writeln("Match 3.");
builder.Writeln("Match 4.");

// We can use a "FindReplaceOptions" object to modify the find-and-replace process.
FindReplaceOptions options = new FindReplaceOptions();

// Assign a custom callback to the "ReplacingCallback" property.
TextReplacementRecorder callback = new TextReplacementRecorder();
options.ReplacingCallback = callback;

// Set the "Direction" property to "FindReplaceDirection.Backward" to get the find-and-replace
// operation to start from the end of the range, and traverse back to the beginning.
// Set the "Direction" property to "FindReplaceDirection.Forward" to get the find-and-replace
// operation to start from the beginning of the range, and traverse to the end.
options.Direction = findReplaceDirection;

doc.Range.Replace(new Regex(@"Match \d*"), "Replacement", options);

Assert.That(doc.GetText().Trim(), Is.EqualTo("Replacement.\r" +
                "Replacement.\r" +
                "Replacement.\r" +
                "Replacement."));

switch (findReplaceDirection)
{
    case FindReplaceDirection.Forward:
        Assert.That(callback.Matches, Is.EqualTo(new[] { "Match 1", "Match 2", "Match 3", "Match 4" }));
        break;
    case FindReplaceDirection.Backward:
        Assert.That(callback.Matches, Is.EqualTo(new[] { "Match 4", "Match 3", "Match 2", "Match 1" }));
        break;
}

Shows how to determine which direction a find-and-replace operation traverses the document in (TextReplacementRecorder).

/// <summary>
/// Records all matches that occur during a find-and-replace operation in the order that they take place.
/// </summary>
private class TextReplacementRecorder : IReplacingCallback
{
    ReplaceAction IReplacingCallback.Replacing(ReplacingArgs e)
    {
        Matches.Add(e.Match.Value);
        return ReplaceAction.Replace;
    }

    public List<string> Matches { get; } = new List<string>();
}

Direction

FindReplaceOptions.Direction property

Examples

See Also