HtmlSaveOptions

Наследование: java.lang.Object, com.aspose.words.SaveOptions

Все реализованные интерфейсы: java.lang.Cloneable

public class HtmlSaveOptions extends SaveOptions implements Cloneable

Может использоваться для указания дополнительных параметров при сохранении документа вSaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB или жеSaveFormat.AZW_3 формат.

Чтобы узнать больше, посетитеSpecify Save Options документальная статья.

Конструкторы

КонструкторОписание
HtmlSaveOptions()Инициализирует новый экземпляр этого класса, который можно использовать для сохранения документа вSaveFormat.HTML формат.
HtmlSaveOptions(int saveFormat)Инициализирует новый экземпляр этого класса.

Методы

МетодОписание
createSaveOptions(int saveFormat)
createSaveOptions(String fileName)Создает объект параметров сохранения класса, подходящего для расширения файла, указанного в данном имени файла.
equals(Object arg0)
getAllowEmbeddingPostScriptFonts()Получает логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ после его сохранения.
getAllowNegativeIndent()Указывает, нормализуются ли отрицательные левый и правый отступы абзацев при сохранении в HTML, MHTML или EPUB.
getClass()
getCssClassNamePrefix()Указывает префикс, который добавляется ко всем именам классов CSS.
getCssSavingCallback()Позволяет управлять сохранением стилей CSS при сохранении документа в формате HTML, MHTML или EPUB.
getCssStyleSheetFileName()Указывает путь и имя файла каскадной таблицы стилей (CSS), записываемого при экспорте документа в HTML.
getCssStyleSheetType()Указывает, как стили CSS (каскадные таблицы стилей) экспортируются в HTML, MHTML или EPUB.
getDefaultTemplate()Получает путь к шаблону по умолчанию (включая имя файла).
getDml3DEffectsRenderingMode()Получает значение, определяющее способ визуализации 3D-эффектов.
getDmlEffectsRenderingMode()Получает значение, определяющее способ визуализации эффектов DrawingML.
getDmlRenderingMode()Получает значение, определяющее способ отображения фигур DrawingML.
getDocumentPartSavingCallback()Позволяет управлять сохранением частей документа при сохранении документа в формате HTML или EPUB.
getDocumentSplitCriteria()Указывает, как документ должен быть разделен при сохранении вSaveFormat.HTML, SaveFormat.EPUB или жеSaveFormat.AZW_3 формат.
getDocumentSplitHeadingLevel()Указывает максимальный уровень заголовков, на котором можно разделить документ.
getEncoding()
getEpubNavigationMapLevel()Определяет максимальный уровень заголовков, заполняемых навигационной картой при экспорте в формат IDPF EPUB.
getExportCidUrlsForMhtmlResources()Указывает, следует ли использовать URL-адреса CID (Content-ID) для ссылки на ресурсы (изображения, шрифты, CSS), включенные в документы MHTML.
getExportDocumentProperties()Указывает, следует ли экспортировать встроенные и настраиваемые свойства документа в HTML, MHTML или EPUB.
getExportDropDownFormFieldAsText()Определяет, как поля раскрывающихся форм сохраняются в HTML или MHTML.
getExportFontResources()Указывает, следует ли экспортировать ресурсы шрифта в HTML, MHTML или EPUB.
getExportFontsAsBase64()Указывает, следует ли встраивать ресурсы шрифтов в HTML в кодировке Base64.
getExportGeneratorName()При значении true имя и версия Aspose.Words встраиваются в создаваемые файлы.
getExportHeadersFootersMode()Указывает, как верхние и нижние колонтитулы выводятся в HTML, MHTML или EPUB.
getExportImagesAsBase64()Указывает, сохраняются ли изображения в формате Base64 в выходной HTML, MHTML или EPUB.
getExportLanguageInformation()Указывает, экспортируется ли языковая информация в HTML, MHTML или EPUB.
getExportListLabels()Управляет выводом меток списков в HTML, MHTML или EPUB.
getExportOriginalUrlForLinkedImages()Указывает, следует ли использовать исходный URL-адрес в качестве URL-адреса связанных изображений.
getExportPageMargins()Указывает, экспортируются ли поля страницы в HTML, MHTML или EPUB.
getExportPageSetup()Указывает, экспортируются ли настройки страницы в HTML, MHTML или EPUB.
getExportRelativeFontSize()Указывает, должны ли размеры шрифта выводиться в относительных единицах при сохранении в HTML, MHTML или EPUB.
getExportRoundtripInformation()Указывает, следует ли записывать информацию о цикле приема-передачи при сохранении в HTML, MHTML или EPUB.
getExportShapesAsSvg()Контролирует лиShape узлы преобразуются в изображения SVG при сохранении в HTML, MHTML, EPUB или AZW3.
getExportTextInputFormFieldAsText()Управляет способом сохранения полей формы ввода текста в формате HTML или MHTML.
getExportTocPageNumbers()Указывает, записывать ли номера страниц в оглавление при сохранении HTML, MHTML и EPUB.
getExportXhtmlTransitional()Указывает, следует ли записывать объявление DOCTYPE при сохранении в HTML или MHTML.
getFontResourcesSubsettingSizeThreshold()Определяет, какие ресурсы шрифтов нуждаются в подразделении при сохранении в HTML, MHTML или EPUB.
getFontSavingCallback()Позволяет управлять сохранением шрифтов при сохранении документа в формате HTML, MHTML или EPUB.
getFontsFolder()Указывает физическую папку, в которой сохраняются шрифты при экспорте документа в HTML.
getFontsFolderAlias()Указывает имя папки, используемой для создания URI шрифтов, записываемых в HTML-документ.
getHtmlVersion()Указывает версию стандарта HTML, которую следует использовать при сохранении документа в формате HTML или MHTML.
getImageResolution()Указывает выходное разрешение для изображений при экспорте в HTML, MHTML или EPUB.
getImageSavingCallback()Позволяет управлять способом сохранения изображений при сохранении документа в формате HTML, MHTML или EPUB.
getImagesFolder()Указывает физическую папку, в которой сохраняются изображения при экспорте документа в формат HTML.
getImagesFolderAlias()Указывает имя папки, используемой для создания URI изображений, записываемых в HTML-документ.
getImlRenderingMode()Получает значение, определяющее способ визуализации объектов рукописного ввода (InkML).
getMemoryOptimization()Получает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа.
getMetafileFormat()Указывает, в каком формате сохраняются метафайлы при экспорте в HTML, MHTML или EPUB.
getOfficeMathOutputMode()Управляет экспортом объектов OfficeMath в HTML, MHTML или EPUB.
getPrettyFormat()Когда true , красивые форматы выводятся там, где это применимо.
getProgressCallback()Вызывается при сохранении документа и принимает данные о ходе сохранения.
getResolveFontNames()Указывает, разрешаются ли имена семейств шрифтов, используемые в документе, и заменяются ли они в соответствии сDocument.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) при записи в форматы на основе HTML.
getResourceFolder()Указывает физическую папку, в которой сохраняются все ресурсы, такие как изображения, шрифты и внешний CSS, при экспорте документа в HTML.
getResourceFolderAlias()Задает имя папки, используемой для создания URI всех ресурсов, записываемых в HTML-документ.
getSaveFormat()Указывает формат, в котором будет сохранен документ, если используется этот объект параметров сохранения.
getScaleImageToShapeSize()Указывает, масштабируются ли изображения с помощью Aspose.Words до размера ограничивающей фигуры при экспорте в HTML, MHTML или EPUB.
getTableWidthOutputMode()Определяет, как ширина таблицы, строки и ячейки экспортируется в HTML, MHTML или EPUB.
getTempFolder()Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX.
getUpdateCreatedTimeProperty()Получает значение, определяющее, является лиBuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date) свойство обновляется перед сохранением.
getUpdateFields()Получает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы.
getUpdateLastPrintedProperty()Получает значение, определяющее, является лиBuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date) свойство обновляется перед сохранением.
getUpdateLastSavedTimeProperty()Получает значение, определяющее, является лиBuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date) свойство обновляется перед сохранением.
getUpdateSdtContent()Получает значение, определяющее, будет ли содержимоеStructuredDocumentTag обновляется перед сохранением.
getUseAntiAliasing()Получает значение, определяющее, следует ли использовать сглаживание для рендеринга.
getUseHighQualityRendering()Получает значение, определяющее, следует ли использовать высокое качество (т. е.
hashCode()
notify()
notifyAll()
setAllowEmbeddingPostScriptFonts(boolean value)Задает логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ после его сохранения.
setAllowNegativeIndent(boolean value)Указывает, нормализуются ли отрицательные левый и правый отступы абзацев при сохранении в HTML, MHTML или EPUB.
setCssClassNamePrefix(String value)Указывает префикс, который добавляется ко всем именам классов CSS.
setCssSavingCallback(ICssSavingCallback value)Позволяет управлять сохранением стилей CSS при сохранении документа в формате HTML, MHTML или EPUB.
setCssStyleSheetFileName(String value)Указывает путь и имя файла каскадной таблицы стилей (CSS), записываемого при экспорте документа в HTML.
setCssStyleSheetType(int value)Указывает, как стили CSS (каскадные таблицы стилей) экспортируются в HTML, MHTML или EPUB.
setDefaultTemplate(String value)Устанавливает путь к шаблону по умолчанию (включая имя файла).
setDml3DEffectsRenderingMode(int value)Задает значение, определяющее способ визуализации 3D-эффектов.
setDmlEffectsRenderingMode(int value)Задает значение, определяющее, как визуализируются эффекты DrawingML.
setDmlRenderingMode(int value)Задает значение, определяющее, как отображаются фигуры DrawingML.
setDocumentPartSavingCallback(IDocumentPartSavingCallback value)Позволяет управлять сохранением частей документа при сохранении документа в формате HTML или EPUB.
setDocumentSplitCriteria(int value)Указывает, как документ должен быть разделен при сохранении вSaveFormat.HTML, SaveFormat.EPUB или жеSaveFormat.AZW_3 формат.
setDocumentSplitHeadingLevel(int value)Указывает максимальный уровень заголовков, на котором можно разделить документ.
setEncoding(Charset value)
setEpubNavigationMapLevel(int value)Определяет максимальный уровень заголовков, заполняемых навигационной картой при экспорте в формат IDPF EPUB.
setExportCidUrlsForMhtmlResources(boolean value)Указывает, следует ли использовать URL-адреса CID (Content-ID) для ссылки на ресурсы (изображения, шрифты, CSS), включенные в документы MHTML.
setExportDocumentProperties(boolean value)Указывает, следует ли экспортировать встроенные и настраиваемые свойства документа в HTML, MHTML или EPUB.
setExportDropDownFormFieldAsText(boolean value)Определяет, как поля раскрывающихся форм сохраняются в HTML или MHTML.
setExportFontResources(boolean value)Указывает, следует ли экспортировать ресурсы шрифта в HTML, MHTML или EPUB.
setExportFontsAsBase64(boolean value)Указывает, следует ли встраивать ресурсы шрифтов в HTML в кодировке Base64.
setExportGeneratorName(boolean value)При значении true имя и версия Aspose.Words встраиваются в создаваемые файлы.
setExportHeadersFootersMode(int value)Указывает, как верхние и нижние колонтитулы выводятся в HTML, MHTML или EPUB.
setExportImagesAsBase64(boolean value)Указывает, сохраняются ли изображения в формате Base64 в выходной HTML, MHTML или EPUB.
setExportLanguageInformation(boolean value)Указывает, экспортируется ли языковая информация в HTML, MHTML или EPUB.
setExportListLabels(int value)Управляет выводом меток списков в HTML, MHTML или EPUB.
setExportOriginalUrlForLinkedImages(boolean value)Указывает, следует ли использовать исходный URL-адрес в качестве URL-адреса связанных изображений.
setExportPageMargins(boolean value)Указывает, экспортируются ли поля страницы в HTML, MHTML или EPUB.
setExportPageSetup(boolean value)Указывает, экспортируются ли настройки страницы в HTML, MHTML или EPUB.
setExportRelativeFontSize(boolean value)Указывает, должны ли размеры шрифта выводиться в относительных единицах при сохранении в HTML, MHTML или EPUB.
setExportRoundtripInformation(boolean value)Указывает, следует ли записывать информацию о цикле приема-передачи при сохранении в HTML, MHTML или EPUB.
setExportShapesAsSvg(boolean value)Контролирует лиShape узлы преобразуются в изображения SVG при сохранении в HTML, MHTML, EPUB или AZW3.
setExportTextInputFormFieldAsText(boolean value)Управляет способом сохранения полей формы ввода текста в формате HTML или MHTML.
setExportTocPageNumbers(boolean value)Указывает, записывать ли номера страниц в оглавление при сохранении HTML, MHTML и EPUB.
setExportXhtmlTransitional(boolean value)Указывает, следует ли записывать объявление DOCTYPE при сохранении в HTML или MHTML.
setFontResourcesSubsettingSizeThreshold(int value)Определяет, какие ресурсы шрифтов нуждаются в подразделении при сохранении в HTML, MHTML или EPUB.
setFontSavingCallback(IFontSavingCallback value)Позволяет управлять сохранением шрифтов при сохранении документа в формате HTML, MHTML или EPUB.
setFontsFolder(String value)Указывает физическую папку, в которой сохраняются шрифты при экспорте документа в HTML.
setFontsFolderAlias(String value)Указывает имя папки, используемой для создания URI шрифтов, записываемых в HTML-документ.
setHtmlVersion(int value)Указывает версию стандарта HTML, которую следует использовать при сохранении документа в формате HTML или MHTML.
setImageResolution(int value)Указывает выходное разрешение для изображений при экспорте в HTML, MHTML или EPUB.
setImageSavingCallback(IImageSavingCallback value)Позволяет управлять способом сохранения изображений при сохранении документа в формате HTML, MHTML или EPUB.
setImagesFolder(String value)Указывает физическую папку, в которой сохраняются изображения при экспорте документа в формат HTML.
setImagesFolderAlias(String value)Указывает имя папки, используемой для создания URI изображений, записываемых в HTML-документ.
setImlRenderingMode(int value)Задает значение, определяющее способ визуализации объектов рукописного ввода (InkML).
setMemoryOptimization(boolean value)Задает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа.
setMetafileFormat(int value)Указывает, в каком формате сохраняются метафайлы при экспорте в HTML, MHTML или EPUB.
setOfficeMathOutputMode(int value)Управляет экспортом объектов OfficeMath в HTML, MHTML или EPUB.
setPrettyFormat(boolean value)Когда true , красивые форматы выводятся там, где это применимо.
setProgressCallback(IDocumentSavingCallback value)Вызывается при сохранении документа и принимает данные о ходе сохранения.
setResolveFontNames(boolean value)Указывает, разрешаются ли имена семейств шрифтов, используемые в документе, и заменяются ли они в соответствии сDocument.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) при записи в форматы на основе HTML.
setResourceFolder(String value)Указывает физическую папку, в которой сохраняются все ресурсы, такие как изображения, шрифты и внешний CSS, при экспорте документа в HTML.
setResourceFolderAlias(String value)Задает имя папки, используемой для создания URI всех ресурсов, записываемых в HTML-документ.
setSaveFormat(int value)Указывает формат, в котором будет сохранен документ, если используется этот объект параметров сохранения.
setScaleImageToShapeSize(boolean value)Указывает, масштабируются ли изображения с помощью Aspose.Words до размера ограничивающей фигуры при экспорте в HTML, MHTML или EPUB.
setTableWidthOutputMode(int value)Определяет, как ширина таблицы, строки и ячейки экспортируется в HTML, MHTML или EPUB.
setTempFolder(String value)Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX.
setUpdateCreatedTimeProperty(boolean value)Устанавливает значение, определяющее, будет лиBuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date) свойство обновляется перед сохранением.
setUpdateFields(boolean value)Задает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы.
setUpdateLastPrintedProperty(boolean value)Устанавливает значение, определяющее, будет лиBuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date) свойство обновляется перед сохранением.
setUpdateLastSavedTimeProperty(boolean value)Устанавливает значение, определяющее, будет лиBuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date) свойство обновляется перед сохранением.
setUpdateSdtContent(boolean value)Устанавливает значение, определяющее, будет ли содержимоеStructuredDocumentTag обновляется перед сохранением.
setUseAntiAliasing(boolean value)Задает значение, определяющее, следует ли использовать сглаживание для рендеринга.
setUseHighQualityRendering(boolean value)Устанавливает значение, определяющее, использовать ли высокое качество (т.е.
toString()
wait()
wait(long arg0)
wait(long arg0, int arg1)

HtmlSaveOptions()

public HtmlSaveOptions()

Инициализирует новый экземпляр этого класса, который можно использовать для сохранения документа вSaveFormat.HTML формат.

HtmlSaveOptions(int saveFormat)

public HtmlSaveOptions(int saveFormat)

Инициализирует новый экземпляр этого класса.

Параметры:

ПараметрТипОписание
saveFormatint

createSaveOptions(int saveFormat)

public static SaveOptions createSaveOptions(int saveFormat)

Параметры:

ПараметрТипОписание
saveFormatint

Возвращает: SaveOptions

createSaveOptions(String fileName)

public static SaveOptions createSaveOptions(String fileName)

Создает объект параметров сохранения класса, подходящего для расширения файла, указанного в данном имени файла.

Параметры:

ПараметрТипОписание
fileNamejava.lang.StringРасширение этого имени файла определяет класс создаваемого объекта параметров сохранения.

Возвращает: SaveOptions - Объект класса, производного отSaveOptions.

equals(Object arg0)

public boolean equals(Object arg0)

Параметры:

ПараметрТипОписание
arg0java.lang.Object

Возвращает: логический

getAllowEmbeddingPostScriptFonts()

public boolean getAllowEmbeddingPostScriptFonts()

Получает логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ после его сохранения. Значение по умолчаниюfalse.

Обратите внимание: Word не встраивает шрифты PostScript, но может открывать документы со встроенными шрифтами этого типа.

Этот вариант работает только тогда, когдаFontInfoCollection.getEmbedTrueTypeFonts() / FontInfoCollection.setEmbedTrueTypeFonts(boolean) принадлежащийDocumentBase.getFontInfos() свойство имеет значение true .

Возвращает: boolean — логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ после его сохранения.

getAllowNegativeIndent()

public boolean getAllowNegativeIndent()

Указывает, нормализуются ли отрицательные левый и правый отступы абзацев при сохранении в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Если отрицательный отступ не разрешен, он экспортируется как нулевое поле в HTML. Если разрешен отрицательный отступ, абзац может частично отображаться за пределами окна браузера.

Возвращает: boolean - соответствующее логическое значение.

getClass()

public final native Class<?> getClass()

Возвращает: java.lang.Класс

getCssClassNamePrefix()

public String getCssClassNamePrefix()

Указывает префикс, который добавляется ко всем именам классов CSS. Значение по умолчанию — пустая строка, а сгенерированные имена классов CSS не имеют общего префикса.

Если это значение не пустое, все классы CSS, сгенерированные Aspose.Words, будут начинаться с указанного префикса. Это может быть полезно, например, если вы добавляете пользовательский CSS в сгенерированные документы и хотите предотвратить конфликты имен классов.

Если значение не является нулевым или пустым, оно должно быть допустимым идентификатором CSS.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getCssSavingCallback()

public ICssSavingCallback getCssSavingCallback()

Позволяет управлять сохранением стилей CSS при сохранении документа в формате HTML, MHTML или EPUB.

Возвращает: ICssSavingCallback - соответствующийICssSavingCallback ценность.

getCssStyleSheetFileName()

public String getCssStyleSheetFileName()

Указывает путь и имя файла каскадной таблицы стилей (CSS), записываемого при экспорте документа в HTML. По умолчанию это пустая строка.

Это свойство действует только при сохранении документа в формате HTML и запросе внешней таблицы стилей CSS с помощьюgetCssStyleSheetType() / setCssStyleSheetType(int).

Если это свойство пусто, файл CSS будет сохранен в той же папке и с тем же именем, что и документ HTML, но с расширением «.css».

Если в этом свойстве указан только путь, но не имя файла, файл CSS будет сохранен в указанную папку и будет иметь то же имя, что и документ HTML, но с расширением «.css».

Если папка, указанная этим свойством, не существует, она будет создана автоматически перед сохранением файла CSS.

Другой способ указать папку, в которой сохраняется внешний файл CSS, — использоватьgetResourceFolder() / setResourceFolder(java.lang.String).

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getCssStyleSheetType()

public int getCssStyleSheetType()

Указывает, как стили CSS (каскадные таблицы стилей) экспортируются в HTML, MHTML или EPUB. Значение по умолчаниюCssStyleSheetType.INLINE для HTML/MHTML иCssStyleSheetType.EXTERNAL для EPUB.

Сохранение таблицы стилей CSS во внешний файл поддерживается только при сохранении в формате HTML. При экспорте в один из форматов контейнера (EPUB или MHTML) и указанииCssStyleSheetType.EXTERNAL, файл CSS будет инкапсулирован в выходной пакет.

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изCssStyleSheetType константы.

getDefaultTemplate()

public String getDefaultTemplate()

Получает путь к шаблону по умолчанию (включая имя файла). Значение по умолчанию для этого свойстваempty string . Если указано, этот путь используется для загрузки шаблона, когдаDocument.getAutomaticallyUpdateStyles() / Document.setAutomaticallyUpdateStyles(boolean) правда, ноDocument.getAttachedTemplate() / Document.setAttachedTemplate(java.lang.String) пустой.

Возвращает: java.lang.String — путь к шаблону по умолчанию (включая имя файла).

getDml3DEffectsRenderingMode()

public int getDml3DEffectsRenderingMode()

Получает значение, определяющее способ визуализации 3D-эффектов. Значение по умолчаниюDml3DEffectsRenderingMode.BASIC.

Возвращает: int — значение, определяющее, как визуализируются 3D-эффекты. Возвращаемое значение является одним изDml3DEffectsRenderingMode константы.

getDmlEffectsRenderingMode()

public int getDmlEffectsRenderingMode()

Получает значение, определяющее способ визуализации эффектов DrawingML. Значение по умолчаниюDmlEffectsRenderingMode.SIMPLIFIED.

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

Возвращает: int — значение, определяющее, как визуализируются эффекты DrawingML. Возвращаемое значение является одним изDmlEffectsRenderingMode константы.

getDmlRenderingMode()

public int getDmlRenderingMode()

Получает значение, определяющее способ отображения фигур DrawingML. Значение по умолчаниюDmlRenderingMode.FALLBACK.

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

Возвращает: int — значение, определяющее способ отображения фигур DrawingML. Возвращаемое значение является одним изDmlRenderingMode константы.

getDocumentPartSavingCallback()

public IDocumentPartSavingCallback getDocumentPartSavingCallback()

Позволяет управлять сохранением частей документа при сохранении документа в формате HTML или EPUB.

Возвращает: IDocumentPartSavingCallback - соответствующийIDocumentPartSavingCallback ценность.

getDocumentSplitCriteria()

public int getDocumentSplitCriteria()

Указывает, как документ должен быть разделен при сохранении вSaveFormat.HTML, SaveFormat.EPUB или жеSaveFormat.AZW_3 формат. По умолчаниюDocumentSplitCriteria.NONE для HTML иDocumentSplitCriteria.HEADING_PARAGRAPH для EPUB и AZW3.

Обычно вы хотите, чтобы документ был сохранен в HTML как один файл. Но в некоторых случаях предпочтительнее разделить вывод на несколько меньших HTML-страниц. При сохранении в формате HTML эти страницы будут выводиться в отдельные файлы или потоки. При сохранении в формате EPUB они будут объединены в соответствующие пакеты.

Документ нельзя разделить при сохранении в формате MHTML.

Возвращает: int - соответствующее значение int. Возвращаемое значение представляет собой побитовую комбинациюDocumentSplitCriteria константы.

getDocumentSplitHeadingLevel()

public int getDocumentSplitHeadingLevel()

Указывает максимальный уровень заголовков, на котором можно разделить документ. Значение по умолчанию — 2.

КогдаgetDocumentSplitCriteria() / setDocumentSplitCriteria(int) включаетDocumentSplitCriteria.HEADING_PARAGRAPH и этому свойству присвоено значение от 1 до 9, документ будет разбит на абзацы, отформатированные с использованиемHeading 1, Heading 2 , Heading 3 и т. д. стили до указанного уровня заголовка.

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

Возвращает: int - соответствующее значение int.

getEncoding()

public Charset getEncoding()

Возвращает: java.nio.charset.Charset

getEpubNavigationMapLevel()

public int getEpubNavigationMapLevel()

Определяет максимальный уровень заголовков, заполняемых навигационной картой при экспорте в формат IDPF EPUB. Значение по умолчанию — 3.

Карта навигации в формате IDPF EPUB позволяет агентам пользователя обеспечивать простой способ навигации по структуре документа. Обычно точки навигации соответствуют заголовкам в документе. Чтобы заполнить заголовки до уровняN присвоить это значениеgetEpubNavigationMapLevel() / setEpubNavigationMapLevel(int).

По умолчанию заполняются три уровня заголовков: абзацы стилейHeading 1, Heading 2 а такжеHeading 3. Вы можете установить для этого свойства значение от 1 до 9, чтобы запросить соответствующий максимальный уровень. Установка его на ноль уменьшит карту навигации только до корня документа или корней частей документа.

Возвращает: int - соответствующее значение int.

getExportCidUrlsForMhtmlResources()

public boolean getExportCidUrlsForMhtmlResources()

Указывает, следует ли использовать URL-адреса CID (Content-ID) для ссылки на ресурсы (изображения, шрифты, CSS), включенные в документы MHTML. Значение по умолчанию — ложь.

Этот параметр влияет только на документы, сохраняемые в формате MHTML.

По умолчанию на ресурсы в документах MHTML ссылаются по имени файла (например, «image.png»), которое сопоставляется с заголовками «Content-Location» частей MIME.

Этот параметр включает альтернативный метод, при котором ссылки на файлы ресурсов записываются как URL-адреса CID (Content-ID) (например, «cid:image.png») и сопоставляются с заголовками «Content-ID».

Теоретически не должно быть никакой разницы между двумя способами ссылки, и любой из них должен нормально работать в любом браузере или почтовом агенте. Однако на практике некоторым агентам не удается получить ресурсы по имени файла. Если ваш браузер или почтовый агент отказывается загружать ресурсы, включенные в документ MTHML (не показывает изображения или не загружает стили CSS), попробуйте экспортировать документ с URL-адресами CID.

Возвращает: boolean - соответствующее логическое значение.

getExportDocumentProperties()

public boolean getExportDocumentProperties()

Указывает, следует ли экспортировать встроенные и настраиваемые свойства документа в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Возвращает: boolean - соответствующее логическое значение.

getExportDropDownFormFieldAsText()

public boolean getExportDropDownFormFieldAsText()

Определяет, как поля раскрывающихся форм сохраняются в HTML или MHTML. Значение по умолчанию — ложь.

Если установлено значение true , поля раскрывающейся формы экспортируются как обычный текст. При значении false экспортирует раскрывающиеся поля формы как элемент SELECT в HTML.

При экспорте в EPUB текстовые поля выпадающей формы всегда сохраняются как текст из-за требований этого формата.

Возвращает: boolean - соответствующее логическое значение.

getExportFontResources()

public boolean getExportFontResources()

Указывает, следует ли экспортировать ресурсы шрифта в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Экспорт ресурсов шрифтов обеспечивает согласованную визуализацию документов независимо от шрифтов, доступных в среде данного пользователя.

ЕслиgetExportFontResources() / setExportFontResources(boolean) установлено значение true , основной HTML-документ будет ссылаться на каждый шрифт через CSS 3**@font-face** at-rule и шрифты будут выводиться отдельными файлами. При экспорте в форматы IDPF EPUB или MHTML шрифты будут встроены в соответствующий пакет вместе с другими вспомогательными файлами.

ЕслиgetExportFontsAsBase64() / setExportFontsAsBase64(boolean) установлено значение true , шрифты не будут сохраняться в отдельные файлы. Вместо этого они будут встроены в**@font-face** at-правила в кодировке Base64.

Important!При экспорте ресурсов шрифтов следует учитывать вопросы лицензирования шрифтов. Авторы, которые хотят использовать определенные шрифты с помощью загружаемого механизма шрифтов, должны всегда тщательно проверять, что их предполагаемое использование находится в рамках лицензии на шрифт. Многие коммерческие шрифты в настоящее время не позволяют загружать свои шрифты из Интернета в любой форме. В лицензионных соглашениях, распространяющихся на некоторые шрифты, особо отмечается, что использование через@font-face правила в таблицах стилей CSS не разрешены. Подмножество шрифтов также может нарушать условия лицензии.

Возвращает: boolean - соответствующее логическое значение.

getExportFontsAsBase64()

public boolean getExportFontsAsBase64()

Указывает, следует ли встраивать ресурсы шрифтов в HTML в кодировке Base64. Значение по умолчанию — ложь.

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

Возвращает: boolean - соответствующее логическое значение.

getExportGeneratorName()

public boolean getExportGeneratorName()

При значении true имя и версия Aspose.Words встраиваются в создаваемые файлы. Значение по умолчаниюtrue.

Возвращает: boolean - соответствующее логическое значение.

getExportHeadersFootersMode()

public int getExportHeadersFootersMode()

Указывает, как верхние и нижние колонтитулы выводятся в HTML, MHTML или EPUB. Значение по умолчаниюExportHeadersFootersMode.PER_SECTION для HTML/MHTML иExportHeadersFootersMode.NONE для EPUB.

Трудно осмысленно выводить верхние и нижние колонтитулы в HTML, потому что HTML не разбит на страницы.

Когда это свойствоExportHeadersFootersMode.PER_SECTIONAspose.Words экспортирует только основные верхние и нижние колонтитулы в начале и в конце каждого раздела.

Когда он являетсяExportHeadersFootersMode.FIRST_SECTION_HEADER_LAST_SECTION_FOOTER экспортируются только первый основной заголовок и последний основной нижний колонтитул (включая ссылку на предыдущий).

Вы можете полностью отключить экспорт верхних и нижних колонтитулов, установив для этого свойства значениеExportHeadersFootersMode.NONE.

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изExportHeadersFootersMode константы.

getExportImagesAsBase64()

public boolean getExportImagesAsBase64()

Указывает, сохраняются ли изображения в формате Base64 в выходной HTML, MHTML или EPUB. Значение по умолчанию — ложь.

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

Возвращает: boolean - соответствующее логическое значение.

getExportLanguageInformation()

public boolean getExportLanguageInformation()

Указывает, экспортируется ли языковая информация в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Когда для этого свойства установлено значение true, выходные данные Aspose.Wordslang Атрибут HTML в элементах документа, указывающий язык. Это может быть необходимо для сохранения семантики, связанной с языком.

Возвращает: boolean - соответствующее логическое значение.

getExportListLabels()

public int getExportListLabels()

Управляет выводом меток списков в HTML, MHTML или EPUB. Значение по умолчаниюExportListLabels.AUTO.

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изExportListLabels константы.

getExportOriginalUrlForLinkedImages()

public boolean getExportOriginalUrlForLinkedImages()

Указывает, следует ли использовать исходный URL-адрес в качестве URL-адреса связанных изображений. Значение по умолчанию — ложь.

Если установлено значение trueImageData.getSourceFullName() / ImageData.setSourceFullName(java.lang.String) значение используется в качестве URL-адреса связанных изображений, а связанные изображения не загружаются в папку документа илиgetImagesFolder() / setImagesFolder(java.lang.String).

Если установлено значение false, связанные изображения загружаются в папку документа илиgetImagesFolder() / setImagesFolder(java.lang.String) и URL каждого связанного изображения строится в зависимости от папки документа,getImagesFolder() / setImagesFolder(java.lang.String) а такжеgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) характеристики.

Возвращает: boolean - соответствующее логическое значение.

getExportPageMargins()

public boolean getExportPageMargins()

Указывает, экспортируются ли поля страницы в HTML, MHTML или EPUB. Значение по умолчанию — ложь. По умолчанию Aspose.Words не показывает область полей страницы. Если какие-либо элементы полностью или частично обрезаны краем документа, с помощью этой опции можно расширить отображаемую область.

Возвращает: boolean - соответствующее логическое значение.

getExportPageSetup()

public boolean getExportPageSetup()

Указывает, экспортируются ли настройки страницы в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

КаждыйSection в модели документа Aspose.Words предоставляет информацию о настройках страницы черезPageSetupучебный класс. При экспорте документа в формат HTML может потребоваться сохранить эту информацию для дальнейшего использования. В частности, настройка страницы может быть важна для рендеринга на постраничный носитель (печать) или последующего преобразования в исходные форматы файлов Microsoft Word (DOCX, DOC, RTF, WML).

В большинстве случаев HTML предназначен для просмотра в браузерах, где не выполняется пагинация. Так что эта функция неактивна по умолчанию.

Возвращает: boolean - соответствующее логическое значение.

getExportRelativeFontSize()

public boolean getExportRelativeFontSize()

Указывает, должны ли размеры шрифта выводиться в относительных единицах при сохранении в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Во многих существующих документах (HTML, IDPF EPUB) размеры шрифтов указаны в относительных единицах. Это позволяет приложениям настраивать размер текста при просмотре/обработке документов. Например, в Microsoft Internet Explorer есть подменю «Вид->Размер текста», в Adobe Digital Editions есть две кнопки: Увеличить/Уменьшить размер текста. Если вы ожидаете, что эта функция будет работать, установитеgetExportRelativeFontSize() / setExportRelativeFontSize(boolean) свойство истинное.

Модель документа Aspose Words содержит и работает только с единицами абсолютного размера шрифта. Относительные единицы нуждаются в дополнительной логике для пересчета от некоторого начального (стандартного) размера. Размер шрифтаNormal стиль документа принимается за стандартный. Например, еслиNormal имеет шрифт 12pt, а некоторый текст имеет размер 18pt, тогда он будет выводиться как1.5em. к HTML.

Когда этот параметр включен, элементы документа, кроме текста, по-прежнему будут иметь абсолютные размеры. Также некоторые атрибуты, связанные с текстом, могут быть выражены абсолютно. В частности, межстрочный интервал, указанный с помощью правила «точно», может привести к нежелательным результатам при масштабировании текста. Таким образом, исходные документы должны быть правильно оформлены и протестированы при экспорте с помощьюgetExportRelativeFontSize() / setExportRelativeFontSize(boolean) установить на истину.

Возвращает: boolean - соответствующее логическое значение.

getExportRoundtripInformation()

public boolean getExportRoundtripInformation()

Указывает, следует ли записывать информацию о цикле приема-передачи при сохранении в HTML, MHTML или EPUB. Значение по умолчанию — true для HTML и false для MHTML и EPUB.

Сохранение информации об обходе позволяет восстанавливать свойства документа, такие как позиции табуляции, комментарии, верхние и нижние колонтитулы, во время загрузки HTML-документов обратно в формат.Document объект.

Когда true , информация о пути туда и обратно экспортируется как -aw-* Свойства CSS соответствующих элементов HTML.

При значении false информация о циклическом обходе не выводится в создаваемые файлы.

Возвращает: boolean - соответствующее логическое значение.

getExportShapesAsSvg()

public boolean getExportShapesAsSvg()

Контролирует лиShape узлы преобразуются в изображения SVG при сохранении в HTML, MHTML, EPUB или AZW3. Значение по умолчанию — ложь.

Если для этой опции установлено значение true ,Shape узлы экспортируются как элементы. В противном случае они преобразуются в растровые изображения и экспортируются как![Изображение 1][] элементы.

[Изображение 1]:

Возвращает: boolean - соответствующее логическое значение.

getExportTextInputFormFieldAsText()

public boolean getExportTextInputFormFieldAsText()

Управляет способом сохранения полей формы ввода текста в формате HTML или MHTML. Значение по умолчанию — ложь.

Если установлено значение true , поля формы ввода текста экспортируются как обычный текст. При значении false экспортирует поля формы ввода текста Word как элементы INPUT в HTML.

При экспорте в EPUB поля формы ввода текста всегда сохраняются как текст из-за требований этого формата.

Возвращает: boolean - соответствующее логическое значение.

getExportTocPageNumbers()

public boolean getExportTocPageNumbers()

Указывает, записывать ли номера страниц в оглавление при сохранении HTML, MHTML и EPUB. Значение по умолчанию — ложь.

Возвращает: boolean - соответствующее логическое значение.

getExportXhtmlTransitional()

public boolean getExportXhtmlTransitional()

Указывает, следует ли записывать объявление DOCTYPE при сохранении в HTML или MHTML. При значении true записывает объявление DOCTYPE в документ перед корневым элементом. Значение по умолчанию — ложь. При сохранении в EPUB или HTML5 (HtmlVersion.HTML_5) всегда записывается объявление DOCTYPE.

Aspose.Words всегда пишет правильно сформированный HTML, независимо от этой настройки.

При значении true начало выходного HTML-документа будет выглядеть так:


 
 
 
 

Aspose.Words стремится выводить XHTML в соответствии со спецификацией XHTML 1.0 Transitional, но вывод не всегда будет проверяться на соответствие DTD. Некоторые структуры внутри документа Microsoft Word трудно или невозможно сопоставить с документом, который будет проверяться на соответствие схеме XHTML. Например, XHTML не допускает вложенных списков (UL не может быть вложен в другой элемент UL), но в документах Microsoft Word довольно часто встречаются многоуровневые списки.

Возвращает: boolean - соответствующее логическое значение.

getFontResourcesSubsettingSizeThreshold()

public int getFontResourcesSubsettingSizeThreshold()

Определяет, какие ресурсы шрифтов нуждаются в подразделении при сохранении в HTML, MHTML или EPUB. По умолчанию 0 .

getExportFontResources() / setExportFontResources(boolean) позволяет экспортировать шрифты как вспомогательные файлы или как части выходного пакета. Если в документе используется много шрифтов, особенно с большим количеством глифов, размер вывода может значительно увеличиться. Подмножество шрифтов уменьшает размер экспортируемого ресурса шрифта, отфильтровывая глифы, которые не используются текущим документом.

Подмножество шрифтов работает следующим образом:

  • По умолчанию все экспортируемые шрифты являются подмножествами.
  • ПараметрgetFontResourcesSubsettingSizeThreshold() / setFontResourcesSubsettingSizeThreshold(int)положительное значение указывает Aspose.Words на подмножество шрифтов, размер файла которых превышает указанное значение.
  • Установка свойства подавляет подмножество шрифта.

Important!При экспорте ресурсов шрифтов следует учитывать вопросы лицензирования шрифтов. Авторы, которые хотят использовать определенные шрифты с помощью загружаемого механизма шрифтов, должны всегда тщательно проверять, что их предполагаемое использование находится в рамках лицензии на шрифт. Многие коммерческие шрифты в настоящее время не позволяют загружать свои шрифты из Интернета в любой форме. В лицензионных соглашениях, распространяющихся на некоторые шрифты, особо отмечается, что использование через@font-face правила в таблицах стилей CSS не разрешены. Подмножество шрифтов также может нарушать условия лицензии.

Возвращает: int - соответствующее значение int.

getFontSavingCallback()

public IFontSavingCallback getFontSavingCallback()

Позволяет управлять сохранением шрифтов при сохранении документа в формате HTML, MHTML или EPUB.

Возвращает: IFontSavingCallback - соответствующийIFontSavingCallback ценность.

getFontsFolder()

public String getFontsFolder()

Указывает физическую папку, в которой сохраняются шрифты при экспорте документа в HTML. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML иgetExportFontResources() / setExportFontResources(boolean) установлено значение true , Aspose.Words необходимо сохранить шрифты, используемые в документе, как отдельные файлы.getFontsFolder() / setFontsFolder(java.lang.String) позволяет указать, где будут сохранены шрифты иgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI шрифта.

Если вы сохраняете документ в файл и указываете имя файла, Aspose.Words по умолчанию сохраняет шрифты в той же папке, где сохранен файл документа. ИспользоватьgetFontsFolder() / setFontsFolder(java.lang.String) переопределить это поведение.

Если вы сохраняете документ в поток, Aspose.Words не имеет папки для сохранения шрифтов, но все равно должен где-то сохранять шрифты. В этом случае необходимо указать доступную папку вgetFontsFolder() / setFontsFolder(java.lang.String) свойство или предоставлять пользовательские потоки черезgetFontSavingCallback() / setFontSavingCallback(com.aspose.words.IFontSavingCallback) обработчик события.

Если папка, указаннаяgetFontsFolder() / setFontsFolder(java.lang.String) не существует, он будет создан автоматически.

getResourceFolder() / setResourceFolder(java.lang.String) — это еще один способ указать папку, в которой следует сохранять шрифты.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getFontsFolderAlias()

public String getFontsFolderAlias()

Указывает имя папки, используемой для создания URI шрифтов, записываемых в HTML-документ. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML иgetExportFontResources() / setExportFontResources(boolean) установлено значение true , Aspose.Words необходимо сохранить шрифты, используемые в документе, как отдельные файлы.getFontsFolder() / setFontsFolder(java.lang.String) позволяет указать, где будут сохранены шрифты иgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI шрифта.

ЕслиgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) не является пустой строкой, тогда URI шрифта, записанный в HTML, будетFontsFolderAlias + .

ЕслиgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) является пустой строкой, тогда URI шрифта, записанный в HTML, будетFontsFolder + .

ЕслиgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) установлен в ‘.’ (точка), то имя файла шрифта будет записано в HTML без указания пути независимо от других параметров.

Альтернативный способ указать имя папки для создания URI шрифта — использоватьgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String).

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getHtmlVersion()

public int getHtmlVersion()

Указывает версию стандарта HTML, которую следует использовать при сохранении документа в формате HTML или MHTML. Значение по умолчаниюHtmlVersion.XHTML.

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изHtmlVersion константы.

getImageResolution()

public int getImageResolution()

Указывает выходное разрешение для изображений при экспорте в HTML, MHTML или EPUB. По умолчанию — 96 dpi.

Это свойство влияет на растровые изображения, когдаgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)имеет значение true и влияет на метафайлы, экспортируемые как растровые изображения. Некоторые свойства изображения, такие как обрезка или поворот, требуют сохранения преобразованных изображений, и в этом случае преобразованные изображения создаются в заданном разрешении.

Возвращает: int - соответствующее значение int.

getImageSavingCallback()

public IImageSavingCallback getImageSavingCallback()

Позволяет управлять способом сохранения изображений при сохранении документа в формате HTML, MHTML или EPUB.

Возвращает: IImageSavingCallback - соответствующийIImageSavingCallback ценность.

getImagesFolder()

public String getImagesFolder()

Указывает физическую папку, в которой сохраняются изображения при экспорте документа в формат HTML. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML Aspose.Words должен сохранять все изображения, встроенные в документ, как отдельные файлы.getImagesFolder() / setImagesFolder(java.lang.String) позволяет указать, где изображения будут сохранены иgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI изображения.

Если вы сохраняете документ в файл и указываете имя файла, Aspose.Words по умолчанию сохраняет изображения в той же папке, где сохранен файл документа. ИспользоватьgetImagesFolder() / setImagesFolder(java.lang.String) переопределить это поведение.

Если вы сохраняете документ в потоке, Aspose.Words не имеет папки для сохранения изображений, но все же необходимо где-то сохранять изображения. В этом случае необходимо указать доступную папку вgetImagesFolder() / setImagesFolder(java.lang.String) свойство или предоставлять пользовательские потоки черезgetImageSavingCallback() / setImageSavingCallback(com.aspose.words.IImageSavingCallback) обработчик события.

Если папка, указаннаяgetImagesFolder() / setImagesFolder(java.lang.String) не существует, он будет создан автоматически.

getResourceFolder() / setResourceFolder(java.lang.String) — это еще один способ указать папку, в которую следует сохранять изображения.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getImagesFolderAlias()

public String getImagesFolderAlias()

Указывает имя папки, используемой для создания URI изображений, записываемых в HTML-документ. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML Aspose.Words должен сохранять все изображения, встроенные в документ, как отдельные файлы.getImagesFolder() / setImagesFolder(java.lang.String) позволяет указать, где изображения будут сохранены иgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI изображения.

ЕслиgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) не является пустой строкой, тогда URI изображения, записанный в HTML, будетImagesFolderAlias + ![Image 1][].

ЕслиgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) является пустой строкой, тогда URI изображения, записанный в HTML, будетImagesFolder + ![Image 1][].

ЕслиgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String)установлен в ‘.’ (точка), то имя файла изображения будет записано в HTML без указания пути независимо от других параметров.

Альтернативный способ указать имя папки для создания URI изображений — использоватьgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String).

[Изображение 1]:

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getImlRenderingMode()

public int getImlRenderingMode()

Получает значение, определяющее способ визуализации объектов рукописного ввода (InkML). Значение по умолчаниюImlRenderingMode.INK_ML.

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

Возвращает: int — значение, определяющее способ отображения объектов рукописного ввода (InkML). Возвращаемое значение является одним изImlRenderingMode константы.

getMemoryOptimization()

public boolean getMemoryOptimization()

Получает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойстваfalse. Установка для этого параметра значения true может значительно снизить потребление памяти при сохранении больших документов за счет замедления времени сохранения.

Возвращает: boolean — значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа.

getMetafileFormat()

public int getMetafileFormat()

Указывает, в каком формате сохраняются метафайлы при экспорте в HTML, MHTML или EPUB. Значение по умолчаниюHtmlMetafileFormat.PNG, что означает, что метафайлы преобразуются в растровые изображения PNG.

Метафайлы изначально не отображаются браузерами HTML. По умолчанию Aspose.Words конвертирует изображения WMF и EMF в файлы PNG при экспорте в HTML. Другие варианты — преобразовать метафайлы в изображения SVG или экспортировать их как есть без преобразования.

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

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изHtmlMetafileFormat константы.

getOfficeMathOutputMode()

public int getOfficeMathOutputMode()

Управляет экспортом объектов OfficeMath в HTML, MHTML или EPUB. Значение по умолчанию — HtmlOfficeMathOutputMode.Image .

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изHtmlOfficeMathOutputMode константы.

getPrettyFormat()

public boolean getPrettyFormat()

Когда true , красивые форматы выводятся там, где это применимо. Значение по умолчаниюfalse.

Установлен вtrue чтобы сделать вывод HTML, MHTML, EPUB, WordML, RTF, DOCX и ODT удобочитаемым для человека. Полезно для тестирования или отладки.

Возвращает: boolean - соответствующее логическое значение.

getProgressCallback()

public IDocumentSavingCallback getProgressCallback()

Вызывается при сохранении документа и принимает данные о ходе сохранения.

Прогресс сообщается при сохранении вSaveFormat.DOCX, SaveFormat.FLAT_OPC, SaveFormat.DOCM, SaveFormat.DOTM, SaveFormat.DOTX, SaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB, SaveFormat.XAML_FLOW , или жеSaveFormat.XAML_FLOW_PACK.

Возвращает: IDocumentSavingCallback - соответствующийIDocumentSavingCallback ценность.

getResolveFontNames()

public boolean getResolveFontNames()

Указывает, разрешаются ли имена семейств шрифтов, используемые в документе, и заменяются ли они в соответствии сDocument.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) при записи в форматы на основе HTML.

По умолчанию для этого параметра установлено значение false, и имена семейств шрифтов записываются в HTML, как указано в исходных документах. То есть,Document.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) игнорируются, и разрешение или замена имен семейств шрифтов не выполняются.

Если для этого параметра установлено значение true , Aspose.Words используетDocument.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) преобразовать каждое имя семейства шрифтов, указанное в исходном документе, в имя доступного семейства шрифтов, выполняя замену шрифта по мере необходимости.

Возвращает: boolean - соответствующее логическое значение.

getResourceFolder()

public String getResourceFolder()

Указывает физическую папку, в которой сохраняются все ресурсы, такие как изображения, шрифты и внешний CSS, при экспорте документа в HTML. По умолчанию это пустая строка.

getResourceFolder() / setResourceFolder(java.lang.String) это самый простой способ указать папку, в которую должны быть записаны все ресурсы. Другой способ — использовать отдельные свойстваgetFontsFolder() / setFontsFolder(java.lang.String), getImagesFolder() / setImagesFolder(java.lang.String) , а такжеgetCssStyleSheetFileName() / setCssStyleSheetFileName(java.lang.String).

getResourceFolder() / setResourceFolder(java.lang.String) имеет более низкий приоритет, чем папки, указанные черезgetFontsFolder() / setFontsFolder(java.lang.String), getImagesFolder() / setImagesFolder(java.lang.String) , а такжеgetCssStyleSheetFileName() / setCssStyleSheetFileName(java.lang.String) . Например, если обаgetResourceFolder() / setResourceFolder(java.lang.String) а такжеgetFontsFolder() / setFontsFolder(java.lang.String) указаны, шрифты будут сохранены вgetFontsFolder() / setFontsFolder(java.lang.String) , а изображения и CSS будут сохранены вgetResourceFolder() / setResourceFolder(java.lang.String).

Если папка, указаннаяgetResourceFolder() / setResourceFolder(java.lang.String) не существует, он будет создан автоматически.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getResourceFolderAlias()

public String getResourceFolderAlias()

Задает имя папки, используемой для создания URI всех ресурсов, записываемых в HTML-документ. По умолчанию это пустая строка.

getResourceFolderAlias() / setResourceFolderAlias(java.lang.String) — это самый простой способ указать, как должны быть созданы URI для всех файлов ресурсов. Та же информация может быть указана для изображений и шрифтов отдельно черезgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) а такжеgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) свойства соответственно. Однако для CSS нет отдельного свойства.

getResourceFolderAlias() / setResourceFolderAlias(java.lang.String) имеет более низкий приоритет, чемgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) а такжеgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) . Например, если обаgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String) а такжеgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) указаны, URI шрифтов будут построены с использованиемgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) , а URI изображений и CSS будут создаваться с использованиемgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String).

ЕслиgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String) пусто, т.getResourceFolder() / setResourceFolder(java.lang.String) значение свойства будет использоваться для создания URI ресурсов.

ЕслиgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String) установлен в ‘.’ (точка), URI ресурсов будут содержать только имена файлов без указания пути.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getSaveFormat()

public int getSaveFormat()

Указывает формат, в котором будет сохранен документ, если используется этот объект параметров сохранения. Может бытьSaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB или жеSaveFormat.AZW_3.

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изSaveFormat константы.

getScaleImageToShapeSize()

public boolean getScaleImageToShapeSize()

Указывает, масштабируются ли изображения с помощью Aspose.Words до размера ограничивающей фигуры при экспорте в HTML, MHTML или EPUB. Значение по умолчанию — true.

Изображение в документе Microsoft Word представляет собой фигуру. Форма имеет размер, а изображение имеет собственный размер. Размеры напрямую не связаны. Например, изображение может иметь размер 1024x786 пикселей, а форма, отображающая это изображение, может иметь размер 400x300 точек.

Чтобы изображение отображалось в браузере, оно должно быть масштабировано до размера фигуры.getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) Свойство управляет тем, где происходит масштабирование изображения: в Aspose.Words при экспорте в HTML или в браузере при отображении документа.

КогдаgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) true , Aspose.Words масштабирует изображение с использованием высококачественного масштабирования при экспорте в HTML. КогдаgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) false , изображение выводится с исходным размером, и браузер должен масштабировать его.

Как правило, браузеры делают быстрое и некачественное масштабирование. В результате вы обычно получаете лучшее качество отображения в браузере и меньший размер файла приgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) верно, но лучшее качество печати и более быстрое преобразование приgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) является ложным.

Возвращает: boolean - соответствующее логическое значение.

getTableWidthOutputMode()

public int getTableWidthOutputMode()

Определяет, как ширина таблицы, строки и ячейки экспортируется в HTML, MHTML или EPUB. Значение по умолчаниюHtmlElementSizeOutputMode.ALL.

В формате HTML элементы таблицы, строки и ячейки (

| -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ,  | ) can have their widths specified either in relative (percentage) or in absolute units. In a document in Aspose.Words, tables, rows and cells can have their widths specified using either relative or absolute units too.

Когда вы конвертируете документ в HTML с помощью Aspose.Words, вы можете захотеть контролировать, как экспортируется ширина таблицы, строки и ячейки, чтобы влиять на то, как результирующий документ отображается в визуальном агенте (например, в браузере или средстве просмотра).

Используйте это свойство в качестве фильтра, чтобы указать, какие значения ширины таблицы экспортируются в целевой документ. Например, если вы конвертируете документ в формат EPUB и собираетесь просматривать его на мобильном устройстве для чтения, вам, вероятно, следует избегать экспорта абсолютных значений ширины. Для этого нужно указать режим выводаHtmlElementSizeOutputMode.RELATIVE_ONLY или жеHtmlElementSizeOutputMode.NONE Таким образом, зритель на мобильном устройстве может расположить таблицу так, чтобы она соответствовала ширине экрана, насколько это возможно.|

Возвращает: int - соответствующее значение int. Возвращаемое значение является одним изHtmlElementSizeOutputMode константы.

getTempFolder()

public String getTempFolder()

Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойство имеет значение null, и временные файлы не используются.

Когда Aspose.Words сохраняет документ, ему необходимо создать временные внутренние структуры. По умолчанию эти внутренние структуры создаются в памяти, и использование памяти резко возрастает в течение короткого периода времени, пока документ сохраняется. Когда сохранение завершено, память освобождается и утилизируется сборщиком мусора.

Если вы сохраняете очень большой документ (тысячи страниц) и/или обрабатываете много документов одновременно, скачок памяти во время сохранения может быть достаточно значительным, чтобы система выдала исключение java.lang.IndexOutOfBoundsException. Указание временной папки с помощьюgetTempFolder() / setTempFolder(java.lang.String)приведет к тому, что Aspose.Words будет хранить внутренние структуры во временных файлах, а не в памяти. Это уменьшает использование памяти во время сохранения, но снижает производительность сохранения.

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

Aspose.Words автоматически удаляет все временные файлы после завершения сохранения.

Возвращает: java.lang.String — соответствующее значение java.lang.String.

getUpdateCreatedTimeProperty()

public boolean getUpdateCreatedTimeProperty()

Получает значение, определяющее, является лиBuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date) свойство обновляется перед сохранением. Значение по умолчанию — ложь;

Возвращает: boolean - Значение, определяющее, является лиBuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date) свойство обновляется перед сохранением.

getUpdateFields()

public boolean getUpdateFields()

Получает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы. Значение по умолчанию для этого свойстваtrue. Позволяет указать, следует ли имитировать поведение MS Word.

Возвращает: boolean — значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы.

getUpdateLastPrintedProperty()

public boolean getUpdateLastPrintedProperty()

Получает значение, определяющее, является лиBuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date) свойство обновляется перед сохранением.

Возвращает: boolean - Значение, определяющее, является лиBuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date) свойство обновляется перед сохранением.

getUpdateLastSavedTimeProperty()

public boolean getUpdateLastSavedTimeProperty()

Получает значение, определяющее, является лиBuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date) свойство обновляется перед сохранением.

Возвращает: boolean - Значение, определяющее, является лиBuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date) свойство обновляется перед сохранением.

getUpdateSdtContent()

public boolean getUpdateSdtContent()

Получает значение, определяющее, будет ли содержимоеStructuredDocumentTag обновляется перед сохранением. Значение по умолчанию неверно .

Возвращает: boolean — значение, определяющее, будет ли содержимоеStructuredDocumentTag обновляется перед сохранением.

getUseAntiAliasing()

public boolean getUseAntiAliasing()

Получает значение, определяющее, следует ли использовать сглаживание для рендеринга.

Значение по умолчанию неверно . Когда для этого значения установлено значение true, для рендеринга используется сглаживание.

Это свойство используется, когда документ экспортируется в следующие форматы:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF . Когда документ экспортируется вSaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB а такжеSaveFormat.AZW_3 форматы эта опция используется для растровых изображений.

Возвращает: логическое значение — значение, определяющее, следует ли использовать сглаживание для рендеринга.

getUseHighQualityRendering()

public boolean getUseHighQualityRendering()

Получает значение, определяющее, следует ли использовать высококачественные (то есть медленные) алгоритмы рендеринга. Значение по умолчанию неверно .

Это свойство используется, когда документ экспортируется в форматы изображений:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF.

Возвращает: логическое значение — значение, определяющее, следует ли использовать высокое качество (т.е.

hashCode()

public native int hashCode()

Возвращает: инт

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

setAllowEmbeddingPostScriptFonts(boolean value)

public void setAllowEmbeddingPostScriptFonts(boolean value)

Задает логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ после его сохранения. Значение по умолчаниюfalse.

Обратите внимание: Word не встраивает шрифты PostScript, но может открывать документы со встроенными шрифтами этого типа.

Этот вариант работает только тогда, когдаFontInfoCollection.getEmbedTrueTypeFonts() / FontInfoCollection.setEmbedTrueTypeFonts(boolean) принадлежащийDocumentBase.getFontInfos() свойство имеет значение true .

Параметры:

ПараметрТипОписание
valuebooleanЛогическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ после его сохранения.

setAllowNegativeIndent(boolean value)

public void setAllowNegativeIndent(boolean value)

Указывает, нормализуются ли отрицательные левый и правый отступы абзацев при сохранении в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Если отрицательный отступ не разрешен, он экспортируется как нулевое поле в HTML. Если разрешен отрицательный отступ, абзац может частично отображаться за пределами окна браузера.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setCssClassNamePrefix(String value)

public void setCssClassNamePrefix(String value)

Указывает префикс, который добавляется ко всем именам классов CSS. Значение по умолчанию — пустая строка, а сгенерированные имена классов CSS не имеют общего префикса.

Если это значение не пустое, все классы CSS, сгенерированные Aspose.Words, будут начинаться с указанного префикса. Это может быть полезно, например, если вы добавляете пользовательский CSS в сгенерированные документы и хотите предотвратить конфликты имен классов.

Если значение не является нулевым или пустым, оно должно быть допустимым идентификатором CSS.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setCssSavingCallback(ICssSavingCallback value)

public void setCssSavingCallback(ICssSavingCallback value)

Позволяет управлять сохранением стилей CSS при сохранении документа в формате HTML, MHTML или EPUB.

Параметры:

ПараметрТипОписание
valueICssSavingCallbackСоответствующийICssSavingCallback ценность.

setCssStyleSheetFileName(String value)

public void setCssStyleSheetFileName(String value)

Указывает путь и имя файла каскадной таблицы стилей (CSS), записываемого при экспорте документа в HTML. По умолчанию это пустая строка.

Это свойство действует только при сохранении документа в формате HTML и запросе внешней таблицы стилей CSS с помощьюgetCssStyleSheetType() / setCssStyleSheetType(int).

Если это свойство пусто, файл CSS будет сохранен в той же папке и с тем же именем, что и документ HTML, но с расширением «.css».

Если в этом свойстве указан только путь, но не имя файла, файл CSS будет сохранен в указанную папку и будет иметь то же имя, что и документ HTML, но с расширением «.css».

Если папка, указанная этим свойством, не существует, она будет создана автоматически перед сохранением файла CSS.

Другой способ указать папку, в которой сохраняется внешний файл CSS, — использоватьgetResourceFolder() / setResourceFolder(java.lang.String).

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setCssStyleSheetType(int value)

public void setCssStyleSheetType(int value)

Указывает, как стили CSS (каскадные таблицы стилей) экспортируются в HTML, MHTML или EPUB. Значение по умолчаниюCssStyleSheetType.INLINE для HTML/MHTML иCssStyleSheetType.EXTERNAL для EPUB.

Сохранение таблицы стилей CSS во внешний файл поддерживается только при сохранении в формате HTML. При экспорте в один из форматов контейнера (EPUB или MHTML) и указанииCssStyleSheetType.EXTERNAL, файл CSS будет инкапсулирован в выходной пакет.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изCssStyleSheetType константы.

setDefaultTemplate(String value)

public void setDefaultTemplate(String value)

Устанавливает путь к шаблону по умолчанию (включая имя файла). Значение по умолчанию для этого свойстваempty string . Если указано, этот путь используется для загрузки шаблона, когдаDocument.getAutomaticallyUpdateStyles() / Document.setAutomaticallyUpdateStyles(boolean) правда, ноDocument.getAttachedTemplate() / Document.setAttachedTemplate(java.lang.String) пустой.

Параметры:

ПараметрТипОписание
valuejava.lang.StringПуть к шаблону по умолчанию (включая имя файла).

setDml3DEffectsRenderingMode(int value)

public void setDml3DEffectsRenderingMode(int value)

Задает значение, определяющее способ визуализации 3D-эффектов. Значение по умолчаниюDml3DEffectsRenderingMode.BASIC.

Параметры:

ПараметрТипОписание
valueintЗначение, определяющее способ визуализации 3D-эффектов. Значение должно быть одним изDml3DEffectsRenderingMode константы.

setDmlEffectsRenderingMode(int value)

public void setDmlEffectsRenderingMode(int value)

Задает значение, определяющее, как визуализируются эффекты DrawingML. Значение по умолчаниюDmlEffectsRenderingMode.SIMPLIFIED.

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

Параметры:

ПараметрТипОписание
valueintЗначение, определяющее, как визуализируются эффекты DrawingML. Значение должно быть одним изDmlEffectsRenderingMode константы.

setDmlRenderingMode(int value)

public void setDmlRenderingMode(int value)

Задает значение, определяющее, как отображаются фигуры DrawingML. Значение по умолчаниюDmlRenderingMode.FALLBACK.

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

Параметры:

ПараметрТипОписание
valueintЗначение, определяющее, как отображаются фигуры DrawingML. Значение должно быть одним изDmlRenderingMode константы.

setDocumentPartSavingCallback(IDocumentPartSavingCallback value)

public void setDocumentPartSavingCallback(IDocumentPartSavingCallback value)

Позволяет управлять сохранением частей документа при сохранении документа в формате HTML или EPUB.

Параметры:

ПараметрТипОписание
valueIDocumentPartSavingCallbackСоответствующийIDocumentPartSavingCallback ценность.

setDocumentSplitCriteria(int value)

public void setDocumentSplitCriteria(int value)

Указывает, как документ должен быть разделен при сохранении вSaveFormat.HTML, SaveFormat.EPUB или жеSaveFormat.AZW_3 формат. По умолчаниюDocumentSplitCriteria.NONE для HTML иDocumentSplitCriteria.HEADING_PARAGRAPH для EPUB и AZW3.

Обычно вы хотите, чтобы документ был сохранен в HTML как один файл. Но в некоторых случаях предпочтительнее разделить вывод на несколько меньших HTML-страниц. При сохранении в формате HTML эти страницы будут выводиться в отдельные файлы или потоки. При сохранении в формате EPUB они будут объединены в соответствующие пакеты.

Документ нельзя разделить при сохранении в формате MHTML.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть побитовой комбинациейDocumentSplitCriteria константы.

setDocumentSplitHeadingLevel(int value)

public void setDocumentSplitHeadingLevel(int value)

Указывает максимальный уровень заголовков, на котором можно разделить документ. Значение по умолчанию — 2.

КогдаgetDocumentSplitCriteria() / setDocumentSplitCriteria(int) включаетDocumentSplitCriteria.HEADING_PARAGRAPH и этому свойству присвоено значение от 1 до 9, документ будет разбит на абзацы, отформатированные с использованиемHeading 1, Heading 2 , Heading 3 и т. д. стили до указанного уровня заголовка.

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

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение.

setEncoding(Charset value)

public void setEncoding(Charset value)

Параметры:

ПараметрТипОписание
valuejava.nio.charset.Charset

setEpubNavigationMapLevel(int value)

public void setEpubNavigationMapLevel(int value)

Определяет максимальный уровень заголовков, заполняемых навигационной картой при экспорте в формат IDPF EPUB. Значение по умолчанию — 3.

Карта навигации в формате IDPF EPUB позволяет агентам пользователя обеспечивать простой способ навигации по структуре документа. Обычно точки навигации соответствуют заголовкам в документе. Чтобы заполнить заголовки до уровняN присвоить это значениеgetEpubNavigationMapLevel() / setEpubNavigationMapLevel(int).

По умолчанию заполняются три уровня заголовков: абзацы стилейHeading 1, Heading 2 а такжеHeading 3. Вы можете установить для этого свойства значение от 1 до 9, чтобы запросить соответствующий максимальный уровень. Установка его на ноль уменьшит карту навигации только до корня документа или корней частей документа.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение.

setExportCidUrlsForMhtmlResources(boolean value)

public void setExportCidUrlsForMhtmlResources(boolean value)

Указывает, следует ли использовать URL-адреса CID (Content-ID) для ссылки на ресурсы (изображения, шрифты, CSS), включенные в документы MHTML. Значение по умолчанию — ложь.

Этот параметр влияет только на документы, сохраняемые в формате MHTML.

По умолчанию на ресурсы в документах MHTML ссылаются по имени файла (например, «image.png»), которое сопоставляется с заголовками «Content-Location» частей MIME.

Этот параметр включает альтернативный метод, при котором ссылки на файлы ресурсов записываются как URL-адреса CID (Content-ID) (например, «cid:image.png») и сопоставляются с заголовками «Content-ID».

Теоретически не должно быть никакой разницы между двумя способами ссылки, и любой из них должен нормально работать в любом браузере или почтовом агенте. Однако на практике некоторым агентам не удается получить ресурсы по имени файла. Если ваш браузер или почтовый агент отказывается загружать ресурсы, включенные в документ MTHML (не показывает изображения или не загружает стили CSS), попробуйте экспортировать документ с URL-адресами CID.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportDocumentProperties(boolean value)

public void setExportDocumentProperties(boolean value)

Указывает, следует ли экспортировать встроенные и настраиваемые свойства документа в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportDropDownFormFieldAsText(boolean value)

public void setExportDropDownFormFieldAsText(boolean value)

Определяет, как поля раскрывающихся форм сохраняются в HTML или MHTML. Значение по умолчанию — ложь.

Если установлено значение true , поля раскрывающейся формы экспортируются как обычный текст. При значении false экспортирует раскрывающиеся поля формы как элемент SELECT в HTML.

При экспорте в EPUB текстовые поля выпадающей формы всегда сохраняются как текст из-за требований этого формата.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportFontResources(boolean value)

public void setExportFontResources(boolean value)

Указывает, следует ли экспортировать ресурсы шрифта в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Экспорт ресурсов шрифтов обеспечивает согласованную визуализацию документов независимо от шрифтов, доступных в среде данного пользователя.

ЕслиgetExportFontResources() / setExportFontResources(boolean) установлено значение true , основной HTML-документ будет ссылаться на каждый шрифт через CSS 3**@font-face** at-rule и шрифты будут выводиться отдельными файлами. При экспорте в форматы IDPF EPUB или MHTML шрифты будут встроены в соответствующий пакет вместе с другими вспомогательными файлами.

ЕслиgetExportFontsAsBase64() / setExportFontsAsBase64(boolean) установлено значение true , шрифты не будут сохраняться в отдельные файлы. Вместо этого они будут встроены в**@font-face** at-правила в кодировке Base64.

Important!При экспорте ресурсов шрифтов следует учитывать вопросы лицензирования шрифтов. Авторы, которые хотят использовать определенные шрифты с помощью загружаемого механизма шрифтов, должны всегда тщательно проверять, что их предполагаемое использование находится в рамках лицензии на шрифт. Многие коммерческие шрифты в настоящее время не позволяют загружать свои шрифты из Интернета в любой форме. В лицензионных соглашениях, распространяющихся на некоторые шрифты, особо отмечается, что использование через@font-face правила в таблицах стилей CSS не разрешены. Подмножество шрифтов также может нарушать условия лицензии.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportFontsAsBase64(boolean value)

public void setExportFontsAsBase64(boolean value)

Указывает, следует ли встраивать ресурсы шрифтов в HTML в кодировке Base64. Значение по умолчанию — ложь.

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

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportGeneratorName(boolean value)

public void setExportGeneratorName(boolean value)

При значении true имя и версия Aspose.Words встраиваются в создаваемые файлы. Значение по умолчаниюtrue.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportHeadersFootersMode(int value)

public void setExportHeadersFootersMode(int value)

Указывает, как верхние и нижние колонтитулы выводятся в HTML, MHTML или EPUB. Значение по умолчаниюExportHeadersFootersMode.PER_SECTION для HTML/MHTML иExportHeadersFootersMode.NONE для EPUB.

Трудно осмысленно выводить верхние и нижние колонтитулы в HTML, потому что HTML не разбит на страницы.

Когда это свойствоExportHeadersFootersMode.PER_SECTIONAspose.Words экспортирует только основные верхние и нижние колонтитулы в начале и в конце каждого раздела.

Когда он являетсяExportHeadersFootersMode.FIRST_SECTION_HEADER_LAST_SECTION_FOOTER экспортируются только первый основной заголовок и последний основной нижний колонтитул (включая ссылку на предыдущий).

Вы можете полностью отключить экспорт верхних и нижних колонтитулов, установив для этого свойства значениеExportHeadersFootersMode.NONE.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изExportHeadersFootersMode константы.

setExportImagesAsBase64(boolean value)

public void setExportImagesAsBase64(boolean value)

Указывает, сохраняются ли изображения в формате Base64 в выходной HTML, MHTML или EPUB. Значение по умолчанию — ложь.

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

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportLanguageInformation(boolean value)

public void setExportLanguageInformation(boolean value)

Указывает, экспортируется ли языковая информация в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Когда для этого свойства установлено значение true, выходные данные Aspose.Wordslang Атрибут HTML в элементах документа, указывающий язык. Это может быть необходимо для сохранения семантики, связанной с языком.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportListLabels(int value)

public void setExportListLabels(int value)

Управляет выводом меток списков в HTML, MHTML или EPUB. Значение по умолчаниюExportListLabels.AUTO.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изExportListLabels константы.

setExportOriginalUrlForLinkedImages(boolean value)

public void setExportOriginalUrlForLinkedImages(boolean value)

Указывает, следует ли использовать исходный URL-адрес в качестве URL-адреса связанных изображений. Значение по умолчанию — ложь.

Если установлено значение trueImageData.getSourceFullName() / ImageData.setSourceFullName(java.lang.String) значение используется в качестве URL-адреса связанных изображений, а связанные изображения не загружаются в папку документа илиgetImagesFolder() / setImagesFolder(java.lang.String).

Если установлено значение false, связанные изображения загружаются в папку документа илиgetImagesFolder() / setImagesFolder(java.lang.String) и URL каждого связанного изображения строится в зависимости от папки документа,getImagesFolder() / setImagesFolder(java.lang.String) а такжеgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) характеристики.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportPageMargins(boolean value)

public void setExportPageMargins(boolean value)

Указывает, экспортируются ли поля страницы в HTML, MHTML или EPUB. Значение по умолчанию — ложь. По умолчанию Aspose.Words не показывает область полей страницы. Если какие-либо элементы полностью или частично обрезаны краем документа, с помощью этой опции можно расширить отображаемую область.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportPageSetup(boolean value)

public void setExportPageSetup(boolean value)

Указывает, экспортируются ли настройки страницы в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

КаждыйSection в модели документа Aspose.Words предоставляет информацию о настройках страницы черезPageSetupучебный класс. При экспорте документа в формат HTML может потребоваться сохранить эту информацию для дальнейшего использования. В частности, настройка страницы может быть важна для рендеринга на постраничный носитель (печать) или последующего преобразования в исходные форматы файлов Microsoft Word (DOCX, DOC, RTF, WML).

В большинстве случаев HTML предназначен для просмотра в браузерах, где не выполняется пагинация. Так что эта функция неактивна по умолчанию.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportRelativeFontSize(boolean value)

public void setExportRelativeFontSize(boolean value)

Указывает, должны ли размеры шрифта выводиться в относительных единицах при сохранении в HTML, MHTML или EPUB. Значение по умолчанию — ложь.

Во многих существующих документах (HTML, IDPF EPUB) размеры шрифтов указаны в относительных единицах. Это позволяет приложениям настраивать размер текста при просмотре/обработке документов. Например, в Microsoft Internet Explorer есть подменю «Вид->Размер текста», в Adobe Digital Editions есть две кнопки: Увеличить/Уменьшить размер текста. Если вы ожидаете, что эта функция будет работать, установитеgetExportRelativeFontSize() / setExportRelativeFontSize(boolean) свойство истинное.

Модель документа Aspose Words содержит и работает только с единицами абсолютного размера шрифта. Относительные единицы нуждаются в дополнительной логике для пересчета от некоторого начального (стандартного) размера. Размер шрифтаNormal стиль документа принимается за стандартный. Например, еслиNormal имеет шрифт 12pt, а некоторый текст имеет размер 18pt, тогда он будет выводиться как1.5em. к HTML.

Когда этот параметр включен, элементы документа, кроме текста, по-прежнему будут иметь абсолютные размеры. Также некоторые атрибуты, связанные с текстом, могут быть выражены абсолютно. В частности, межстрочный интервал, указанный с помощью правила «точно», может привести к нежелательным результатам при масштабировании текста. Таким образом, исходные документы должны быть правильно оформлены и протестированы при экспорте с помощьюgetExportRelativeFontSize() / setExportRelativeFontSize(boolean) установить на истину.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportRoundtripInformation(boolean value)

public void setExportRoundtripInformation(boolean value)

Указывает, следует ли записывать информацию о цикле приема-передачи при сохранении в HTML, MHTML или EPUB. Значение по умолчанию — true для HTML и false для MHTML и EPUB.

Сохранение информации об обходе позволяет восстанавливать свойства документа, такие как позиции табуляции, комментарии, верхние и нижние колонтитулы, во время загрузки HTML-документов обратно в формат.Document объект.

Когда true , информация о пути туда и обратно экспортируется как -aw-* Свойства CSS соответствующих элементов HTML.

При значении false информация о циклическом обходе не выводится в создаваемые файлы.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportShapesAsSvg(boolean value)

public void setExportShapesAsSvg(boolean value)

Контролирует лиShape узлы преобразуются в изображения SVG при сохранении в HTML, MHTML, EPUB или AZW3. Значение по умолчанию — ложь.

Если для этой опции установлено значение true ,Shape узлы экспортируются как элементы. В противном случае они преобразуются в растровые изображения и экспортируются как![Изображение 1][] элементы.

[Изображение 1]:

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportTextInputFormFieldAsText(boolean value)

public void setExportTextInputFormFieldAsText(boolean value)

Управляет способом сохранения полей формы ввода текста в формате HTML или MHTML. Значение по умолчанию — ложь.

Если установлено значение true , поля формы ввода текста экспортируются как обычный текст. При значении false экспортирует поля формы ввода текста Word как элементы INPUT в HTML.

При экспорте в EPUB поля формы ввода текста всегда сохраняются как текст из-за требований этого формата.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportTocPageNumbers(boolean value)

public void setExportTocPageNumbers(boolean value)

Указывает, записывать ли номера страниц в оглавление при сохранении HTML, MHTML и EPUB. Значение по умолчанию — ложь.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setExportXhtmlTransitional(boolean value)

public void setExportXhtmlTransitional(boolean value)

Указывает, следует ли записывать объявление DOCTYPE при сохранении в HTML или MHTML. При значении true записывает объявление DOCTYPE в документ перед корневым элементом. Значение по умолчанию — ложь. При сохранении в EPUB или HTML5 (HtmlVersion.HTML_5) всегда записывается объявление DOCTYPE.

Aspose.Words всегда пишет правильно сформированный HTML, независимо от этой настройки.

При значении true начало выходного HTML-документа будет выглядеть так:


 
 
 
 

Aspose.Words стремится выводить XHTML в соответствии со спецификацией XHTML 1.0 Transitional, но вывод не всегда будет проверяться на соответствие DTD. Некоторые структуры внутри документа Microsoft Word трудно или невозможно сопоставить с документом, который будет проверяться на соответствие схеме XHTML. Например, XHTML не допускает вложенных списков (UL не может быть вложен в другой элемент UL), но в документах Microsoft Word довольно часто встречаются многоуровневые списки.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setFontResourcesSubsettingSizeThreshold(int value)

public void setFontResourcesSubsettingSizeThreshold(int value)

Определяет, какие ресурсы шрифтов нуждаются в подразделении при сохранении в HTML, MHTML или EPUB. По умолчанию 0 .

getExportFontResources() / setExportFontResources(boolean) позволяет экспортировать шрифты как вспомогательные файлы или как части выходного пакета. Если в документе используется много шрифтов, особенно с большим количеством глифов, размер вывода может значительно увеличиться. Подмножество шрифтов уменьшает размер экспортируемого ресурса шрифта, отфильтровывая глифы, которые не используются текущим документом.

Подмножество шрифтов работает следующим образом:

  • По умолчанию все экспортируемые шрифты являются подмножествами.
  • ПараметрgetFontResourcesSubsettingSizeThreshold() / setFontResourcesSubsettingSizeThreshold(int)положительное значение указывает Aspose.Words на подмножество шрифтов, размер файла которых превышает указанное значение.
  • Установка свойства подавляет подмножество шрифта.

Important!При экспорте ресурсов шрифтов следует учитывать вопросы лицензирования шрифтов. Авторы, которые хотят использовать определенные шрифты с помощью загружаемого механизма шрифтов, должны всегда тщательно проверять, что их предполагаемое использование находится в рамках лицензии на шрифт. Многие коммерческие шрифты в настоящее время не позволяют загружать свои шрифты из Интернета в любой форме. В лицензионных соглашениях, распространяющихся на некоторые шрифты, особо отмечается, что использование через@font-face правила в таблицах стилей CSS не разрешены. Подмножество шрифтов также может нарушать условия лицензии.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение.

setFontSavingCallback(IFontSavingCallback value)

public void setFontSavingCallback(IFontSavingCallback value)

Позволяет управлять сохранением шрифтов при сохранении документа в формате HTML, MHTML или EPUB.

Параметры:

ПараметрТипОписание
valueIFontSavingCallbackСоответствующийIFontSavingCallback ценность.

setFontsFolder(String value)

public void setFontsFolder(String value)

Указывает физическую папку, в которой сохраняются шрифты при экспорте документа в HTML. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML иgetExportFontResources() / setExportFontResources(boolean) установлено значение true , Aspose.Words необходимо сохранить шрифты, используемые в документе, как отдельные файлы.getFontsFolder() / setFontsFolder(java.lang.String) позволяет указать, где будут сохранены шрифты иgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI шрифта.

Если вы сохраняете документ в файл и указываете имя файла, Aspose.Words по умолчанию сохраняет шрифты в той же папке, где сохранен файл документа. ИспользоватьgetFontsFolder() / setFontsFolder(java.lang.String) переопределить это поведение.

Если вы сохраняете документ в поток, Aspose.Words не имеет папки для сохранения шрифтов, но все равно должен где-то сохранять шрифты. В этом случае необходимо указать доступную папку вgetFontsFolder() / setFontsFolder(java.lang.String) свойство или предоставлять пользовательские потоки черезgetFontSavingCallback() / setFontSavingCallback(com.aspose.words.IFontSavingCallback) обработчик события.

Если папка, указаннаяgetFontsFolder() / setFontsFolder(java.lang.String) не существует, он будет создан автоматически.

getResourceFolder() / setResourceFolder(java.lang.String) — это еще один способ указать папку, в которой следует сохранять шрифты.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setFontsFolderAlias(String value)

public void setFontsFolderAlias(String value)

Указывает имя папки, используемой для создания URI шрифтов, записываемых в HTML-документ. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML иgetExportFontResources() / setExportFontResources(boolean) установлено значение true , Aspose.Words необходимо сохранить шрифты, используемые в документе, как отдельные файлы.getFontsFolder() / setFontsFolder(java.lang.String) позволяет указать, где будут сохранены шрифты иgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI шрифта.

ЕслиgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) не является пустой строкой, тогда URI шрифта, записанный в HTML, будетFontsFolderAlias + .

ЕслиgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) является пустой строкой, тогда URI шрифта, записанный в HTML, будетFontsFolder + .

ЕслиgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) установлен в ‘.’ (точка), то имя файла шрифта будет записано в HTML без указания пути независимо от других параметров.

Альтернативный способ указать имя папки для создания URI шрифта — использоватьgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String).

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setHtmlVersion(int value)

public void setHtmlVersion(int value)

Указывает версию стандарта HTML, которую следует использовать при сохранении документа в формате HTML или MHTML. Значение по умолчаниюHtmlVersion.XHTML.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изHtmlVersion константы.

setImageResolution(int value)

public void setImageResolution(int value)

Указывает выходное разрешение для изображений при экспорте в HTML, MHTML или EPUB. По умолчанию — 96 dpi.

Это свойство влияет на растровые изображения, когдаgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)имеет значение true и влияет на метафайлы, экспортируемые как растровые изображения. Некоторые свойства изображения, такие как обрезка или поворот, требуют сохранения преобразованных изображений, и в этом случае преобразованные изображения создаются в заданном разрешении.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение.

setImageSavingCallback(IImageSavingCallback value)

public void setImageSavingCallback(IImageSavingCallback value)

Позволяет управлять способом сохранения изображений при сохранении документа в формате HTML, MHTML или EPUB.

Параметры:

ПараметрТипОписание
valueIImageSavingCallbackСоответствующийIImageSavingCallback ценность.

setImagesFolder(String value)

public void setImagesFolder(String value)

Указывает физическую папку, в которой сохраняются изображения при экспорте документа в формат HTML. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML Aspose.Words должен сохранять все изображения, встроенные в документ, как отдельные файлы.getImagesFolder() / setImagesFolder(java.lang.String) позволяет указать, где изображения будут сохранены иgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI изображения.

Если вы сохраняете документ в файл и указываете имя файла, Aspose.Words по умолчанию сохраняет изображения в той же папке, где сохранен файл документа. ИспользоватьgetImagesFolder() / setImagesFolder(java.lang.String) переопределить это поведение.

Если вы сохраняете документ в потоке, Aspose.Words не имеет папки для сохранения изображений, но все же необходимо где-то сохранять изображения. В этом случае необходимо указать доступную папку вgetImagesFolder() / setImagesFolder(java.lang.String) свойство или предоставлять пользовательские потоки черезgetImageSavingCallback() / setImageSavingCallback(com.aspose.words.IImageSavingCallback) обработчик события.

Если папка, указаннаяgetImagesFolder() / setImagesFolder(java.lang.String) не существует, он будет создан автоматически.

getResourceFolder() / setResourceFolder(java.lang.String) — это еще один способ указать папку, в которую следует сохранять изображения.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setImagesFolderAlias(String value)

public void setImagesFolderAlias(String value)

Указывает имя папки, используемой для создания URI изображений, записываемых в HTML-документ. По умолчанию это пустая строка.

Когда вы сохраняетеDocument в формате HTML Aspose.Words должен сохранять все изображения, встроенные в документ, как отдельные файлы.getImagesFolder() / setImagesFolder(java.lang.String) позволяет указать, где изображения будут сохранены иgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) позволяет указать, как будут создаваться URI изображения.

ЕслиgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) не является пустой строкой, тогда URI изображения, записанный в HTML, будетImagesFolderAlias + ![Image 1][].

ЕслиgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) является пустой строкой, тогда URI изображения, записанный в HTML, будетImagesFolder + ![Image 1][].

ЕслиgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String)установлен в ‘.’ (точка), то имя файла изображения будет записано в HTML без указания пути независимо от других параметров.

Альтернативный способ указать имя папки для создания URI изображений — использоватьgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String).

[Изображение 1]:

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setImlRenderingMode(int value)

public void setImlRenderingMode(int value)

Задает значение, определяющее способ визуализации объектов рукописного ввода (InkML). Значение по умолчаниюImlRenderingMode.INK_ML.

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

Параметры:

ПараметрТипОписание
valueintЗначение, определяющее способ визуализации объектов рукописного ввода (InkML). Значение должно быть одним изImlRenderingMode константы.

setMemoryOptimization(boolean value)

public void setMemoryOptimization(boolean value)

Задает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойстваfalse. Установка для этого параметра значения true может значительно снизить потребление памяти при сохранении больших документов за счет замедления времени сохранения.

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа.

setMetafileFormat(int value)

public void setMetafileFormat(int value)

Указывает, в каком формате сохраняются метафайлы при экспорте в HTML, MHTML или EPUB. Значение по умолчаниюHtmlMetafileFormat.PNG, что означает, что метафайлы преобразуются в растровые изображения PNG.

Метафайлы изначально не отображаются браузерами HTML. По умолчанию Aspose.Words конвертирует изображения WMF и EMF в файлы PNG при экспорте в HTML. Другие варианты — преобразовать метафайлы в изображения SVG или экспортировать их как есть без преобразования.

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

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изHtmlMetafileFormat константы.

setOfficeMathOutputMode(int value)

public void setOfficeMathOutputMode(int value)

Управляет экспортом объектов OfficeMath в HTML, MHTML или EPUB. Значение по умолчанию — HtmlOfficeMathOutputMode.Image .

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изHtmlOfficeMathOutputMode константы.

setPrettyFormat(boolean value)

public void setPrettyFormat(boolean value)

Когда true , красивые форматы выводятся там, где это применимо. Значение по умолчаниюfalse.

Установлен вtrue чтобы сделать вывод HTML, MHTML, EPUB, WordML, RTF, DOCX и ODT удобочитаемым для человека. Полезно для тестирования или отладки.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setProgressCallback(IDocumentSavingCallback value)

public void setProgressCallback(IDocumentSavingCallback value)

Вызывается при сохранении документа и принимает данные о ходе сохранения.

Прогресс сообщается при сохранении вSaveFormat.DOCX, SaveFormat.FLAT_OPC, SaveFormat.DOCM, SaveFormat.DOTM, SaveFormat.DOTX, SaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB, SaveFormat.XAML_FLOW , или жеSaveFormat.XAML_FLOW_PACK.

Параметры:

ПараметрТипОписание
valueIDocumentSavingCallbackСоответствующийIDocumentSavingCallback ценность.

setResolveFontNames(boolean value)

public void setResolveFontNames(boolean value)

Указывает, разрешаются ли имена семейств шрифтов, используемые в документе, и заменяются ли они в соответствии сDocument.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) при записи в форматы на основе HTML.

По умолчанию для этого параметра установлено значение false, и имена семейств шрифтов записываются в HTML, как указано в исходных документах. То есть,Document.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) игнорируются, и разрешение или замена имен семейств шрифтов не выполняются.

Если для этого параметра установлено значение true , Aspose.Words используетDocument.getFontSettings() / Document.setFontSettings(com.aspose.words.FontSettings) преобразовать каждое имя семейства шрифтов, указанное в исходном документе, в имя доступного семейства шрифтов, выполняя замену шрифта по мере необходимости.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setResourceFolder(String value)

public void setResourceFolder(String value)

Указывает физическую папку, в которой сохраняются все ресурсы, такие как изображения, шрифты и внешний CSS, при экспорте документа в HTML. По умолчанию это пустая строка.

getResourceFolder() / setResourceFolder(java.lang.String) это самый простой способ указать папку, в которую должны быть записаны все ресурсы. Другой способ — использовать отдельные свойстваgetFontsFolder() / setFontsFolder(java.lang.String), getImagesFolder() / setImagesFolder(java.lang.String) , а такжеgetCssStyleSheetFileName() / setCssStyleSheetFileName(java.lang.String).

getResourceFolder() / setResourceFolder(java.lang.String) имеет более низкий приоритет, чем папки, указанные черезgetFontsFolder() / setFontsFolder(java.lang.String), getImagesFolder() / setImagesFolder(java.lang.String) , а такжеgetCssStyleSheetFileName() / setCssStyleSheetFileName(java.lang.String) . Например, если обаgetResourceFolder() / setResourceFolder(java.lang.String) а такжеgetFontsFolder() / setFontsFolder(java.lang.String) указаны, шрифты будут сохранены вgetFontsFolder() / setFontsFolder(java.lang.String) , а изображения и CSS будут сохранены вgetResourceFolder() / setResourceFolder(java.lang.String).

Если папка, указаннаяgetResourceFolder() / setResourceFolder(java.lang.String) не существует, он будет создан автоматически.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setResourceFolderAlias(String value)

public void setResourceFolderAlias(String value)

Задает имя папки, используемой для создания URI всех ресурсов, записываемых в HTML-документ. По умолчанию это пустая строка.

getResourceFolderAlias() / setResourceFolderAlias(java.lang.String) — это самый простой способ указать, как должны быть созданы URI для всех файлов ресурсов. Та же информация может быть указана для изображений и шрифтов отдельно черезgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) а такжеgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) свойства соответственно. Однако для CSS нет отдельного свойства.

getResourceFolderAlias() / setResourceFolderAlias(java.lang.String) имеет более низкий приоритет, чемgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) а такжеgetImagesFolderAlias() / setImagesFolderAlias(java.lang.String) . Например, если обаgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String) а такжеgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) указаны, URI шрифтов будут построены с использованиемgetFontsFolderAlias() / setFontsFolderAlias(java.lang.String) , а URI изображений и CSS будут создаваться с использованиемgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String).

ЕслиgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String) пусто, т.getResourceFolder() / setResourceFolder(java.lang.String) значение свойства будет использоваться для создания URI ресурсов.

ЕслиgetResourceFolderAlias() / setResourceFolderAlias(java.lang.String) установлен в ‘.’ (точка), URI ресурсов будут содержать только имена файлов без указания пути.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setSaveFormat(int value)

public void setSaveFormat(int value)

Указывает формат, в котором будет сохранен документ, если используется этот объект параметров сохранения. Может бытьSaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB или жеSaveFormat.AZW_3.

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изSaveFormat константы.

setScaleImageToShapeSize(boolean value)

public void setScaleImageToShapeSize(boolean value)

Указывает, масштабируются ли изображения с помощью Aspose.Words до размера ограничивающей фигуры при экспорте в HTML, MHTML или EPUB. Значение по умолчанию — true.

Изображение в документе Microsoft Word представляет собой фигуру. Форма имеет размер, а изображение имеет собственный размер. Размеры напрямую не связаны. Например, изображение может иметь размер 1024x786 пикселей, а форма, отображающая это изображение, может иметь размер 400x300 точек.

Чтобы изображение отображалось в браузере, оно должно быть масштабировано до размера фигуры.getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) Свойство управляет тем, где происходит масштабирование изображения: в Aspose.Words при экспорте в HTML или в браузере при отображении документа.

КогдаgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) true , Aspose.Words масштабирует изображение с использованием высококачественного масштабирования при экспорте в HTML. КогдаgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) false , изображение выводится с исходным размером, и браузер должен масштабировать его.

Как правило, браузеры делают быстрое и некачественное масштабирование. В результате вы обычно получаете лучшее качество отображения в браузере и меньший размер файла приgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) верно, но лучшее качество печати и более быстрое преобразование приgetScaleImageToShapeSize() / setScaleImageToShapeSize(boolean) является ложным.

Параметры:

ПараметрТипОписание
valuebooleanСоответствующее логическое значение.

setTableWidthOutputMode(int value)

public void setTableWidthOutputMode(int value)

Определяет, как ширина таблицы, строки и ячейки экспортируется в HTML, MHTML или EPUB. Значение по умолчаниюHtmlElementSizeOutputMode.ALL.

В формате HTML элементы таблицы, строки и ячейки (

| -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ,  | ) can have their widths specified either in relative (percentage) or in absolute units. In a document in Aspose.Words, tables, rows and cells can have their widths specified using either relative or absolute units too.

Когда вы конвертируете документ в HTML с помощью Aspose.Words, вы можете захотеть контролировать, как экспортируется ширина таблицы, строки и ячейки, чтобы влиять на то, как результирующий документ отображается в визуальном агенте (например, в браузере или средстве просмотра).

Используйте это свойство в качестве фильтра, чтобы указать, какие значения ширины таблицы экспортируются в целевой документ. Например, если вы конвертируете документ в формат EPUB и собираетесь просматривать его на мобильном устройстве для чтения, вам, вероятно, следует избегать экспорта абсолютных значений ширины. Для этого нужно указать режим выводаHtmlElementSizeOutputMode.RELATIVE_ONLY или жеHtmlElementSizeOutputMode.NONE Таким образом, зритель на мобильном устройстве может расположить таблицу так, чтобы она соответствовала ширине экрана, насколько это возможно.|

Параметры:

ПараметрТипОписание
valueintСоответствующее целочисленное значение. Значение должно быть одним изHtmlElementSizeOutputMode константы.

setTempFolder(String value)

public void setTempFolder(String value)

Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойство имеет значение null, и временные файлы не используются.

Когда Aspose.Words сохраняет документ, ему необходимо создать временные внутренние структуры. По умолчанию эти внутренние структуры создаются в памяти, и использование памяти резко возрастает в течение короткого периода времени, пока документ сохраняется. Когда сохранение завершено, память освобождается и утилизируется сборщиком мусора.

Если вы сохраняете очень большой документ (тысячи страниц) и/или обрабатываете много документов одновременно, скачок памяти во время сохранения может быть достаточно значительным, чтобы система выдала исключение java.lang.IndexOutOfBoundsException. Указание временной папки с помощьюgetTempFolder() / setTempFolder(java.lang.String)приведет к тому, что Aspose.Words будет хранить внутренние структуры во временных файлах, а не в памяти. Это уменьшает использование памяти во время сохранения, но снижает производительность сохранения.

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

Aspose.Words автоматически удаляет все временные файлы после завершения сохранения.

Параметры:

ПараметрТипОписание
valuejava.lang.StringСоответствующее значение java.lang.String.

setUpdateCreatedTimeProperty(boolean value)

public void setUpdateCreatedTimeProperty(boolean value)

Устанавливает значение, определяющее, будет лиBuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date) свойство обновляется перед сохранением. Значение по умолчанию — ложь;

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, является лиBuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date) свойство обновляется перед сохранением.

setUpdateFields(boolean value)

public void setUpdateFields(boolean value)

Задает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы. Значение по умолчанию для этого свойстваtrue. Позволяет указать, следует ли имитировать поведение MS Word.

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы.

setUpdateLastPrintedProperty(boolean value)

public void setUpdateLastPrintedProperty(boolean value)

Устанавливает значение, определяющее, будет лиBuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date) свойство обновляется перед сохранением.

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, является лиBuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date) свойство обновляется перед сохранением.

setUpdateLastSavedTimeProperty(boolean value)

public void setUpdateLastSavedTimeProperty(boolean value)

Устанавливает значение, определяющее, будет лиBuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date) свойство обновляется перед сохранением.

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, является лиBuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date) свойство обновляется перед сохранением.

setUpdateSdtContent(boolean value)

public void setUpdateSdtContent(boolean value)

Устанавливает значение, определяющее, будет ли содержимоеStructuredDocumentTag обновляется перед сохранением. Значение по умолчанию неверно .

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, является ли содержаниеStructuredDocumentTag обновляется перед сохранением.

setUseAntiAliasing(boolean value)

public void setUseAntiAliasing(boolean value)

Задает значение, определяющее, следует ли использовать сглаживание для рендеринга.

Значение по умолчанию неверно . Когда для этого значения установлено значение true, для рендеринга используется сглаживание.

Это свойство используется, когда документ экспортируется в следующие форматы:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF . Когда документ экспортируется вSaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB а такжеSaveFormat.AZW_3 форматы эта опция используется для растровых изображений.

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, следует ли использовать сглаживание для рендеринга.

setUseHighQualityRendering(boolean value)

public void setUseHighQualityRendering(boolean value)

Устанавливает значение, определяющее, следует ли использовать высококачественные (т.е. медленные) алгоритмы рендеринга. Значение по умолчанию неверно .

Это свойство используется, когда документ экспортируется в форматы изображений:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF.

Параметры:

ПараметрТипОписание
valuebooleanЗначение, определяющее, следует ли использовать высокое качество (т.е.

toString()

public String toString()

Возвращает: java.lang.String

wait()

public final void wait()

wait(long arg0)

public final native void wait(long arg0)

Параметры:

ПараметрТипОписание
arg0long

wait(long arg0, int arg1)

public final void wait(long arg0, int arg1)

Параметры:

ПараметрТипОписание
arg0long
arg1int