FindReplaceOptions

FindReplaceOptions class

Especifica opciones para operaciones de buscar/reemplazar.

Para obtener más información, visite elEncontrar y reemplazar artículo de documentación.

public class FindReplaceOptions

Constructores

NombreDescripción
FindReplaceOptions()Constructor predeterminado
FindReplaceOptions(FindReplaceDirection)
FindReplaceOptions(IReplacingCallback)
FindReplaceOptions(FindReplaceDirection, IReplacingCallback)

Propiedades

NombreDescripción
ApplyFont { get; }Formato de texto aplicado al contenido nuevo.
ApplyParagraphFormat { get; }Formato de párrafo aplicado al contenido nuevo.
Direction { get; set; }Selecciona la dirección para reemplazar. El valor predeterminado esForward .
FindWholeWordsOnly { get; set; }Verdadero indica que oldValue debe ser una palabra independiente.
IgnoreDeleted { get; set; }Obtiene o establece un valor booleano que indica que se debe ignorar el texto dentro de las revisiones de eliminación. El valor predeterminado esFALSO .
IgnoreFieldCodes { get; set; }Obtiene o establece un valor booleano que indica que se debe ignorar el texto dentro de los códigos de campo. El valor predeterminado esFALSO .
IgnoreFields { get; set; }Obtiene o establece un valor booleano que indica que se debe ignorar el texto dentro de los campos. El valor predeterminado esFALSO .
IgnoreFootnotes { get; set; }Obtiene o establece un valor booleano que indica que se deben ignorar las notas al pie. El valor predeterminado esFALSO .
IgnoreInserted { get; set; }Obtiene o establece un valor booleano que indica que se debe ignorar el texto dentro de las revisiones de inserción. El valor predeterminado esFALSO .
IgnoreShapes { get; set; }Obtiene o establece un valor booleano que indica que se deben ignorar las formas dentro de un texto.
IgnoreStructuredDocumentTags { get; set; }Obtiene o establece un valor booleano que indica que se debe ignorar el contenido deStructuredDocumentTag . El valor predeterminado esFALSO .
LegacyMode { get; set; }Obtiene o establece un valor booleano que indica que se utiliza el antiguo algoritmo de búsqueda/reemplazo.
MatchCase { get; set; }Verdadero indica una comparación que distingue entre mayúsculas y minúsculas, falso indica una comparación que no distingue entre mayúsculas y minúsculas.
ReplacingCallback { get; set; }El método definido por el usuario que se llama antes de cada sustitución.
SmartParagraphBreakReplacement { get; set; }Obtiene o establece un valor booleano que indica que se permite reemplazar el párrafo break cuando no hay un siguiente párrafo hermano.
UseLegacyOrder { get; set; }Verdadero indica que una búsqueda de texto se realiza secuencialmente de arriba a abajo considerando los cuadros de texto. El valor predeterminado esFALSO .
UseSubstitutions { get; set; }Obtiene o establece un valor booleano que indica si se reconocen y utilizan sustituciones dentro de los patrones de reemplazo. El valor predeterminado esFALSO .

Ejemplos

Muestra cómo alternar la distinción entre mayúsculas y minúsculas al realizar una operación de buscar y reemplazar.

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

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

// Podemos utilizar un objeto "FindReplaceOptions" para modificar el proceso de buscar y reemplazar.
FindReplaceOptions options = new FindReplaceOptions();

// Establece el indicador "MatchCase" en "true" para aplicar distinción entre mayúsculas y minúsculas mientras buscas cadenas para reemplazar.
// Establece el indicador "MatchCase" en "false" para ignorar las mayúsculas y minúsculas mientras buscas texto para reemplazar.
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());

Muestra cómo alternar operaciones independientes de búsqueda y reemplazo de solo palabras.

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

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

// Podemos utilizar un objeto "FindReplaceOptions" para modificar el proceso de buscar y reemplazar.
FindReplaceOptions options = new FindReplaceOptions();

// Establece el indicador "FindWholeWordsOnly" en "true" para reemplazar el texto encontrado si no forma parte de otra palabra.
// Establece el indicador "FindWholeWordsOnly" en "false" para reemplazar todo el texto independientemente de su entorno.
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());

Ver también

FindReplaceDirection Enum IReplacingCallback Interface