ImportFormatMode

ImportFormatMode enumeration

Spécifie comment le formatage est fusionné lors de l’importation de contenu à partir d’un autre document.

public enum ImportFormatMode

Valeurs

NomÉvaluerLa description
UseDestinationStyles0Utilisez les styles du document de destination et copiez 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 dumodeImportFormat paramètre passé à Document.ImportNode comme décrit ci-dessous.

Lors de l’utilisation duUseDestinationStyles , 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é pourrait avoir un aspect 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 Times New. Police Roman 14pt. Lors de l’importation de texte de style « Titre 1 » sans autre formatage direct, il apparaîtra en tant que police Times New Roman 14pt dans le document de destination.

KeepSourceFormattingL’option permet de s’assurer que le contenu importé a le même aspect dans le document de destination que dans le document source. Si un style correspondant existe déjà dans le document de destination, le formatage du style source est étendu en attributs de nœud directs et le style est changé en Normal. Si le style n’existe pas dans le document de destination, alors 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, le formatage d’un tel style sera étendu aux attributs de nœud directs en faveur de la préservation du formatage de nœud d’origine.

L’inconvénient de l’utilisationKeepSourceFormattingest que si vous effectuez plusieurs importations, vous pourriez vous retrouver avec de nombreux styles dans le document de destination, ce qui 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 le formatage 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 alors 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