com.aspose.words

Class ImportFormatMode

java.lang.Object

com.aspose.words.ImportFormatMode

public class ImportFormatMode
extends java.lang.Object

Specifies how formatting is merged when importing content from another document.

Remarks:

When you copy nodes from one document to another, this option specifies how formatting is resolved when both documents have a style with the same name, but different formatting.

The formatting is resolved as follows:

1. Built-in styles are matched using their locale independent style identifier. User defined styles are matched using case-sensitive style name.
2. If a matching style is not found in the destination document, the style (and all styles referenced by it) are copied into the destination document and the imported nodes are updated to reference the new style.
3. If a matching style already exists in the destination document, what happens depends on the importFormatMode parameter passed to M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode) as described below.

When using the USE_DESTINATION_STYLES option, if a matching style already exists in the destination document, the style is not copied and the imported nodes are updated to reference the existing style.

The drawback of using USE_DESTINATION_STYLES is that the imported text might look different in the destination document comparing to the source document. For example, the "Heading 1" style in the source document uses Arial 16pt font and the "Heading 1" style in the destination document uses Times New Roman 14pt font. When importing text of "Heading 1" style with no other direct formatting, it will appear as Times New Roman 14pt font in the destination document.

KEEP_SOURCE_FORMATTING option allows to make sure the imported content looks the same in the destination document like it looks in the source document. If a matching style already exists in the destination document, the source style formatting is expanded into direct Node attributes and the style is changed to Normal. If the style does not exist in the destination document, then the source style is imported into the destination document and applied to the imported node. Note, that it is not always possible to preserve the source style even if it does not exist in the destination document. In this case formatting of such style will be expanded into direct Node attributes in favor of preserving original Node formatting.

The drawback of using KEEP_SOURCE_FORMATTING is that if you perform several imports, you could end up with many styles in the destination document and that could make using consistent style formatting in Microsoft Word difficult for this document.

Using KEEP_DIFFERENT_STYLES option allows to reuse destination styles if the formatting they provide is identical to the styles in the source document. If the style in destination document is different from the source then it is imported.

Examples:

Shows how to insert a document into another document.

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

 DocumentBuilder builder = new DocumentBuilder(doc);
 builder.moveToDocumentEnd();
 builder.insertBreak(BreakType.PAGE_BREAK);

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

 builder.insertDocument(docToInsert, ImportFormatMode.KEEP_SOURCE_FORMATTING);
 builder.getDocument().save(getArtifactsDir() + "DocumentBuilder.InsertDocument.docx");
 
 

M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)

Field Summary

Fields

Modifier and Type	Field and Description
static int	KEEP_DIFFERENT_STYLES Only copy styles that are different from those in the source document.
static int	KEEP_SOURCE_FORMATTING Copy all required styles to the destination document, generate unique style names if needed.
static int	length
static int	USE_DESTINATION_STYLES Use the destination document styles and copy new styles.

Method Summary

Modifier and Type	Method and Description
static int	fromName(java.lang.String importFormatModeName)
static java.lang.String	getName(int importFormatMode)
static int[]	getValues()
static java.lang.String	toString(int importFormatMode)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

USE_DESTINATION_STYLES

public static int USE_DESTINATION_STYLES

Use the destination document styles and copy new styles. This is the default option.

KEEP_SOURCE_FORMATTING

public static int KEEP_SOURCE_FORMATTING

Copy all required styles to the destination document, generate unique style names if needed.

KEEP_DIFFERENT_STYLES

public static int KEEP_DIFFERENT_STYLES

Only copy styles that are different from those in the source document.

length

public static int length

Method Detail

getName

public static java.lang.String getName(int importFormatMode)

toString

public static java.lang.String toString(int importFormatMode)

fromName

public static int fromName(java.lang.String importFormatModeName)

getValues

public static int[] getValues()