FindReplaceOptions

FindReplaceOptions class

Especifica opciones para operaciones de búsqueda y reemplazo.

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

public class FindReplaceOptions

Constructores

NombreDescripción
FindReplaceOptions()Inicializa una nueva instancia de la clase FindReplaceOptions con la configuración predeterminada.
FindReplaceOptions(FindReplaceDirection)Inicializa una nueva instancia de la clase FindReplaceOptions con la dirección especificada.
FindReplaceOptions(IReplacingCallback)Inicializa una nueva instancia de la clase FindReplaceOptions con la devolución de llamada de reemplazo especificada.
FindReplaceOptions(FindReplaceDirection, IReplacingCallback)Inicializa una nueva instancia de la clase FindReplaceOptions con la dirección especificada y la devolución de llamada de reemplazo.

Propiedades

NombreDescripción
ApplyFont { get; }Formato de texto aplicado al nuevo contenido.
ApplyParagraphFormat { get; }Formato de párrafo aplicado al nuevo contenido.
Direction { get; set; }Selecciona la dirección de reemplazo. El valor predeterminado esForward .
FindWholeWordsOnly { get; set; }True indica que el valor anterior debe ser una palabra independiente.
IgnoreDeleted { get; set; }Obtiene o establece un valor booleano que indica si se debe ignorar el texto dentro de las revisiones eliminadas. El valor predeterminado esFALSO .
IgnoreFieldCodes { get; set; }Obtiene o establece un valor booleano que indica si 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 si se debe ignorar el texto dentro de los campos. El valor predeterminado esFALSO .
IgnoreFootnotes { get; set; }Obtiene o establece un valor booleano que indica si se deben ignorar las notas al pie. El valor predeterminado esFALSO .
IgnoreInserted { get; set; }Obtiene o establece un valor booleano que indica si 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 si se deben ignorar las formas dentro de un texto.
IgnoreStructuredDocumentTags { get; set; }Obtiene o establece un valor booleano que indica si 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.
ReplacementFormat { get; set; }Especifica el formato del reemplazo. El valor predeterminado esText .
ReplacingCallback { get; set; }El método definido por el usuario que se llama antes de cada ocurrencia de reemplazo.
SmartParagraphBreakReplacement { get; set; }Obtiene o establece un valor booleano que indica que está permitido reemplazar el párrafo break cuando no hay un siguiente párrafo hermano.
UseLegacyOrder { get; set; }True indica que se realiza una búsqueda de texto 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 deben reconocer y utilizar 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 búsqueda y reemplazo.

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

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

// Podemos usar un objeto "FindReplaceOptions" para modificar el proceso de búsqueda y reemplazo.
FindReplaceOptions options = new FindReplaceOptions();

// Establezca el indicador "MatchCase" en "verdadero" para aplicar distinción entre mayúsculas y minúsculas al buscar cadenas para reemplazar.
// Establezca el indicador "MatchCase" en "falso" para ignorar las mayúsculas y minúsculas mientras busca 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 de búsqueda y reemplazo independientes de solo palabras.

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

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

// Podemos usar un objeto "FindReplaceOptions" para modificar el proceso de búsqueda y reemplazo.
FindReplaceOptions options = new FindReplaceOptions();

// Establezca el indicador "FindWholeWordsOnly" en "verdadero" para reemplazar el texto encontrado si no es parte de otra palabra.
// Establezca el indicador "FindWholeWordsOnly" en "falso" 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