ImportFormatMode

ImportFormatMode enumeration

Spécifie comment la mise en forme est fusionnée lors de l’importation de contenu à partir d’un autre document.

public enum ImportFormatMode

Valeurs

NomÉvaluerLa description
UseDestinationStyles0Utiliser les styles du document cible et copier les nouveaux styles. Il s’agit de l’option par défaut.
KeepSourceFormatting1Copiez tous les styles requis dans le document de destination, générez des noms de style uniques si nécessaire.
KeepDifferentStyles2Copiez uniquement les styles différents de ceux du document source.

Remarques

Lorsque vous copiez des nœuds d’un document à un autre, cette option spécifie comment formatting est résolu lorsque les deux documents ont un style avec le même nom, mais un formatage différent.

Le formatage est résolu comme suit :

  1. Les styles intégrés sont mis en correspondance à l’aide de leur identifiant de style indépendant des paramètres régionaux. Les styles définis par l’utilisateur sont mis en correspondance à l’aide d’un nom de style sensible à la casse.
  2. Si aucun style correspondant n’est trouvé dans le document de destination, le style (et tous les styles référencés par celui-ci) sont copiés dans le document de destination et les nœuds importés sont mis à jour pour référencer le nouveau style.
  3. Si un style correspondant existe déjà dans le document de destination, ce qui se passe dépend duimportFormatMode paramètre passé à ImportNode comme décrit ci-dessous.

Lors de l’utilisation duUseDestinationStyles option, si un style correspondant existe déjà dans le document de destination, le style n’est pas copié et les nœuds importés sont mis à jour pour référencer le style existant.

L’inconvénient de l’utilisationUseDestinationStylesest que le texte importé peut sembler différent dans le document de destination par rapport au document source. Par exemple, le style « Titre 1 » dans le document source utilise la police Arial 16 pt et le style « Titre 1 » dans le document de destination utilise la police Times New Roman 14 pt. Lors de l’importation de texte de style « Titre 1 » sans autre formatage direct, il apparaîtra comme une police Times New Roman 14 pt dans le document de destination.

KeepSourceFormattingL’option permet de s’assurer que le contenu importé a la même apparence dans le document de destination que dans le document source. Si un style correspondant existe déjà dans le document de destination, la mise en forme du style source est étendue dans les attributs de nœud directs et le style est modifié en Normal. Si le style n’existe pas dans le document de destination, le style source est importé dans le document de destination et appliqué au nœud importé. Notez qu’il n’est pas toujours possible de conserver le style source même s’il n’existe pas dans le document de destination. Dans ce cas, la mise en forme d’un tel style sera étendue dans les attributs de nœud directs en faveur de la préservation de la mise en forme de nœud d’origine.

L’inconvénient de l’utilisationKeepSourceFormattingc’est que si vous effectuez plusieurs importations, vous pourriez vous retrouver avec de nombreux styles dans le document de destination et cela pourrait rendre difficile l’utilisation d’un formatage de style cohérent dans Microsoft Word pour ce document.

En utilisantKeepDifferentStyles L’option permet de réutiliser les styles de destination si la mise en forme qu’ils fournissent est identique aux styles du document source. Si le style du document de destination est différent de celui de la source, il est importé.

Exemples

Montre comment insérer un document dans un autre document.

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");

Voir également

ImageWatermarkOptions Class ImportFormatOptions Class