ImportFormatMode

ImportFormatMode enumeration

Especifica cómo se fusiona el formato al importar contenido de otro documento.

public enum ImportFormatMode

Valores

NombreValorDescripción
UseDestinationStyles0Usar los estilos del documento de destino y copiar los nuevos estilos. Esta es la opción predeterminada.
KeepSourceFormatting1Copiar todos los estilos necesarios al documento de destino, generar nombres de estilos únicos si es necesario.
KeepDifferentStyles2Solo copiar estilos que sean diferentes a los del documento de origen.

Observaciones

Al copiar nodos de un documento a otro, esta opción especifica cómo se resuelve formatting cuando ambos documentos tienen un estilo con el mismo nombre, pero con diferente formato.

El formato se resuelve de la siguiente manera:

  1. Los estilos incorporados se corresponden mediante su identificador de estilo independiente de la configuración regional. Los estilos definidos por el usuario se corresponden mediante un nombre de estilo que distingue entre mayúsculas y minúsculas.
  2. Si no se encuentra un estilo coincidente en el documento de destino, el estilo (y todos los estilos a los que hace referencia) se copian en el documento de destino y los nodos importados se actualizan para hacer referencia al nuevo estilo.
  3. Si ya existe un estilo coincidente en el documento de destino, lo que sucede depende de laimportFormatMode parámetro pasado a ImportNode como se describe a continuación.

Al utilizar elUseDestinationStyles opción, si ya existe un estilo coincidente en el documento de destino, el estilo no se copia y los nodos importados se actualizan para hacer referencia al estilo existente.

El inconveniente de usarUseDestinationStyleses que el texto importado puede verse diferente en el documento de destino en comparación con el documento de origen. Por ejemplo, el estilo “Título 1” en el documento de origen usa la fuente Arial de 16 puntos y el estilo “Título 1” en el documento de destino usa la fuente Times New Roman de 14 puntos. Al importar texto del estilo “Título 1” sin otro formato directo, aparecerá como fuente Times New Roman de 14 puntos en el documento de destino.

KeepSourceFormattingLa opción permite asegurarse de que el contenido importado se vea igual en el documento de destino que en el documento de origen. Si ya existe un estilo coincidente en el documento de destino, el formato del estilo de origen se expande en atributos de nodo directos y el estilo se cambia a Normal. Si el estilo no existe en el documento de destino, entonces el estilo de origen se importa en el documento de destino y se aplica al nodo importado. Tenga en cuenta que no siempre es posible preservar el estilo de origen incluso si no existe en el documento de destino. En este caso, el formato de dicho estilo se expandirá en atributos de nodo directos a favor de preservar el formato de nodo original.

El inconveniente de usarKeepSourceFormattinges que si realiza varias importaciones, podría terminar con muchos estilos en el documento de destino y eso podría dificultar el uso de un formato de estilo consistente en Microsoft Word para este documento.

UsandoKeepDifferentStyles La opción permite reutilizar los estilos de destino si el formato que proporcionan es idéntico a los estilos del documento de origen. Si el estilo en el documento de destino es diferente del de origen, entonces se importa.

Ejemplos

Muestra cómo insertar un documento en otro documento.

Document doc = new Document(MyDir + "Document.docx");

DocumentBuilder builder = new DocumentBuilder(doc);
builder.MoveToDocumentEnd();
builder.InsertBreak(BreakType.PageBreak);

Document docToInsert = new Document(MyDir + "Formatted elements.docx");

builder.InsertDocument(docToInsert, ImportFormatMode.KeepSourceFormatting);
builder.Document.Save(ArtifactsDir + "DocumentBuilder.InsertDocument.docx");

Ver también

ImageWatermarkOptions Class ImportFormatOptions Class