FindReplaceOptions

FindReplaceOptions class

Gibt Optionen für Suchen/Ersetzen-Vorgänge an.

public class FindReplaceOptions

Konstrukteure

Name Beschreibung
FindReplaceOptions() Default_Constructor
FindReplaceOptions(FindReplaceDirection)
FindReplaceOptions(IReplacingCallback)
FindReplaceOptions(FindReplaceDirection, IReplacingCallback)

Eigenschaften

Name Beschreibung
ApplyFont { get; } Textformatierung auf neuen Inhalt angewendet.
ApplyParagraphFormat { get; } Absatzformatierung auf neuen Inhalt angewendet.
Direction { get; set; } Wählt die Richtung zum Ersetzen aus. Standardwert istForward .
FindWholeWordsOnly { get; set; } True zeigt an, dass oldValue ein eigenständiges Wort sein muss.
IgnoreDeleted { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text innerhalb von Löschrevisionen ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreFieldCodes { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text in Feldcodes ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreFields { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text in Feldern ignoriert werden soll. Der Standardwert istFALSCH .
IgnoreFootnotes { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Fußnoten ignoriert werden sollen. Der Standardwert istFALSCH .
IgnoreInserted { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Text innerhalb von Einfügungsrevisionen ignoriert werden soll. Der Standardwert istFALSCH .
LegacyMode { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, dass der alte Suchen/Ersetzen-Algorithmus verwendet wird.
MatchCase { get; set; } „True“ gibt die Groß-/Kleinschreibung an, „false“ gibt die Groß- und Kleinschreibung an.
ReplacingCallback { get; set; } Die benutzerdefinierte Methode, die vor jedem Ersetzen aufgerufen wird.
SmartParagraphBreakReplacement { get; set; } Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob Absatz break ersetzt werden darf, wenn kein nächster gleichgeordneter Absatz vorhanden ist.
UseLegacyOrder { get; set; } True gibt an, dass eine Textsuche sequentiell von oben nach unten unter Berücksichtigung der Textfelder durchgeführt wird. Der Standardwert ist false.
UseSubstitutions { get; set; } Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob Ersetzungen innerhalb von Ersetzungsmustern erkannt und verwendet werden sollen. Der Standardwert istFALSCH .

Beispiele

Zeigt, wie die Groß-/Kleinschreibung beim Ausführen eines Suchen-und-Ersetzen-Vorgangs umgeschaltet wird.

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

builder.Writeln("Ruby bought a ruby necklace.");

// Wir können ein "FindReplaceOptions"-Objekt verwenden, um den Suchen-und-Ersetzen-Prozess zu ändern.
FindReplaceOptions options = new FindReplaceOptions();

// Setzen Sie das "MatchCase"-Flag auf "true", um die Groß-/Kleinschreibung beim Suchen von zu ersetzenden Zeichenfolgen anzuwenden.
// Setzen Sie das "MatchCase"-Flag auf "false", um die Groß-/Kleinschreibung bei der Suche nach zu ersetzendem Text zu ignorieren.
options.MatchCase = matchCase;

doc.Range.Replace("Ruby", "Jade", options);

Assert.AreEqual(matchCase ? "Jade bought a ruby necklace." : "Jade bought a Jade necklace.",
    doc.GetText().Trim());

Zeigt, wie Sie eigenständige Suchen-und-Ersetzen-Operationen nur für Wörter umschalten können.

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

builder.Writeln("Jackson will meet you in Jacksonville.");

// Wir können ein "FindReplaceOptions"-Objekt verwenden, um den Suchen-und-Ersetzen-Prozess zu ändern.
FindReplaceOptions options = new FindReplaceOptions();

// Setzen Sie das Flag "FindWholeWordsOnly" auf "true", um den gefundenen Text zu ersetzen, wenn er nicht Teil eines anderen Worts ist.
// Setzen Sie das Flag "FindWholeWordsOnly" auf "false", um den gesamten Text unabhängig von seiner Umgebung zu ersetzen.
options.FindWholeWordsOnly = findWholeWordsOnly;

doc.Range.Replace("Jackson", "Louis", options);

Assert.AreEqual(
    findWholeWordsOnly ? "Louis will meet you in Jacksonville." : "Louis will meet you in Louisville.",
    doc.GetText().Trim());

Siehe auch