ImportFormatMode

ImportFormatMode enumeration

Указывает, как форматирование объединяется при импорте содержимого из другого документа.

public enum ImportFormatMode

Ценности

Имя Ценность Описание
UseDestinationStyles 0 Используйте стили целевого документа и скопируйте новые стили. Это опция по умолчанию.
KeepSourceFormatting 1 Скопируйте все необходимые стили в конечный документ, при необходимости создайте уникальные имена стилей.
KeepDifferentStyles 2 Копировать только те стили, которые отличаются от тех, что в исходном документе.

Примечания

Когда вы копируете узлы из одного документа в другой, этот параметр указывает, как разрешается форматирование , когда оба документа имеют стиль с одинаковым именем, но разным форматированием.

Форматирование решается следующим образом:

  1. Встроенные стили сопоставляются с использованием идентификатора стиля, независимого от языкового стандарта. Определенные пользователем стили сопоставляются с использованием имени стиля с учетом регистра.
  2. Если соответствующий стиль не найден в целевом документе, style (и все стили, на которые он ссылается) копируются в целевой документ , а импортированные узлы обновляются для ссылки на новый стиль.
  3. Если соответствующий стиль уже существует в целевом документе, то, что произойдет , зависит отимпортформатмоде параметр передан to Document.ImportNode , как описано ниже.

При использовании Использование стилей назначениявариант, если соответствующий стиль уже существует в целевом документе, стиль не копируется, а импортированные узлы обновляются для ссылки на существующий стиль.

Недостаток использования Использование стилей назначения заключается в том, что импортированный текст может выглядеть в целевом документе иначе, чем в исходном документе. Например, стиль «Заголовок 1» в исходном документе использует шрифт Arial 16pt, а стиль «Заголовок 1» в целевом документе использует Times New Шрифт Roman 14pt. При импорте текста в стиле «Заголовок 1» без другого прямого форматирования он будет отображаться как шрифт Times New Roman 14pt в целевом документе.

KeepSourceFormattingПараметр позволяет убедиться, что импортированный контент выглядит так же в целевом документе, как и в исходном документе. изменяется на Обычный. Если стиль не существует в целевом документе, то исходный стиль импортируется в целевой документ и применяется к импортированному узлу. Обратите внимание, что не всегда возможно сохранить исходный стиль, даже если он не существует в целевом документе. В этом случае форматирование такого стиля будет расширено за счет прямых атрибутов узла в пользу сохранения исходного форматирования узла.

Недостаток использования KeepSourceFormattingзаключается в том, что если вы выполните несколько импортов, вы можете получить много стилей в целевом документе, и это может затруднить использование форматирования согласованного стиля в Microsoft Word для этого документа.

С использованием Держите разные стили Параметр позволяет повторно использовать целевые стили , если предоставляемое ими форматирование идентично стилям в исходном документе. Если стиль в целевом документе отличается от исходного, он импортируется.

Примеры

Показывает, как вставить документ в другой документ.

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

Смотрите также