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) | 初始化此类的新实例。 |
方法
HtmlSaveOptions()
public HtmlSaveOptions()
初始化此类的一个新实例,该实例可用于将文档保存在SaveFormat.HTML格式。
HtmlSaveOptions(int saveFormat)
public HtmlSaveOptions(int saveFormat)
初始化此类的新实例。
参数:
范围 | 类型 | 描述 |
---|---|---|
saveFormat | int |
createSaveOptions(int saveFormat)
public static SaveOptions createSaveOptions(int saveFormat)
参数:
范围 | 类型 | 描述 |
---|---|---|
saveFormat | int |
退货: SaveOptions
createSaveOptions(String fileName)
public static SaveOptions createSaveOptions(String fileName)
创建适合给定文件名中指定的文件扩展名的类的保存选项对象。
参数:
范围 | 类型 | 描述 |
---|---|---|
fileName | java.lang.String | 此文件名的扩展名决定了要创建的保存选项对象的类。 |
退货: SaveOptions - 派生自的类的对象SaveOptions.
equals(Object arg0)
public boolean equals(Object arg0)
参数:
范围 | 类型 | 描述 |
---|---|---|
arg0 | java.lang.Object |
退货: 布尔值
getAllowEmbeddingPostScriptFonts()
public boolean getAllowEmbeddingPostScriptFonts()
获取一个布尔值,指示在保存文档时在文档中嵌入 TrueType 字体时是否允许嵌入带有 PostScript 轮廓的字体。默认值为false.
请注意,Word 不嵌入 PostScript 字体,但可以打开带有此类嵌入字体的文档。
此选项仅在FontInfoCollection.getEmbedTrueTypeFonts() / FontInfoCollection.setEmbedTrueTypeFonts(boolean)的DocumentBase.getFontInfos()属性设置为 true 。
退货: boolean - 一个布尔值,指示在保存文档时是否允许在文档中嵌入 TrueType 字体时嵌入具有 PostScript 轮廓的字体。
getAllowNegativeIndent()
public boolean getAllowNegativeIndent()
指定在保存为 HTML、MHTML 或 EPUB 时是否标准化段落的负左缩进和右缩进。默认值为 false 。
当不允许负缩进时,它会作为零边距导出到 HTML。当允许负缩进时,一个段落可能会部分出现在浏览器窗口之外。
退货: boolean - 相应的布尔值。
getClass()
public final native Class<?> getClass()
退货: java.lang.Class
getCssClassNamePrefix()
public String getCssClassNamePrefix()
指定添加到所有 CSS 类名称的前缀。默认值为空字符串,生成的 CSS 类名称没有公共前缀。
如果这个值不为空,Aspose.Words 生成的所有 CSS 类都将以指定的前缀开头。这可能很有用,例如,如果您将自定义 CSS 添加到生成的文档并希望防止类名冲突。
如果该值不为 null 或空,则它必须是有效的 CSS 标识符。
退货: java.lang.String - 相应的 java.lang.String 值。
getCssSavingCallback()
public ICssSavingCallback getCssSavingCallback()
允许控制在将文档保存为 HTML、MHTML 或 EPUB 时如何保存 CSS 样式。
退货: ICssSavingCallback - 相应的ICssSavingCallback价值。
getCssStyleSheetFileName()
public String getCssStyleSheetFileName()
指定将文档导出为 HTML 时写入的层叠样式表 (CSS) 文件的路径和名称。默认为空字符串。
此属性仅在将文档保存为 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。
仅当保存为 HTML 时才支持将 CSS 样式表保存到外部文件中。当您导出为其中一种容器格式(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.字符集
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()
指定是否使用 CID(内容 ID)URL 来引用 MHTML 文档中包含的资源(图像、字体、CSS)。默认值为 false 。
此选项仅影响保存为 MHTML 的文档。
默认情况下,MHTML 文档中的资源通过文件名引用(例如,“image.png”),这些文件与 MIME 部分的“Content-Location”标头相匹配。
此选项启用另一种方法,其中对资源文件的引用被写为 CID (Content-ID) URL(例如,“cid:image.png”)并与“Content-ID”标头匹配。
从理论上讲,这两种引用方法应该没有区别,并且它们中的任何一种都可以在任何浏览器或邮件代理中正常工作。然而,在实践中,一些代理无法通过文件名获取资源。如果您的浏览器或邮件代理拒绝加载 MTHML 文档中包含的资源(不显示图像或不加载 CSS 样式),请尝试使用 CID URL 导出文档。
退货: boolean - 相应的布尔值。
getExportDocumentProperties()
public boolean getExportDocumentProperties()
指定是否将内置和自定义文档属性导出为 HTML、MHTML 或 EPUB。默认值为 false 。
退货: boolean - 相应的布尔值。
getExportDropDownFormFieldAsText()
public boolean getExportDropDownFormFieldAsText()
控制下拉表单字段如何保存为 HTML 或 MHTML。默认值为 false 。
设置为 true 时,将下拉表单字段导出为普通文本。当为 false 时,将下拉表单字段导出为 HTML 中的 SELECT 元素。
导出为 EPUB 时,由于此格式的要求,文本下拉表单字段始终保存为文本。
退货: boolean - 相应的布尔值。
getExportFontResources()
public boolean getExportFontResources()
指定字体资源是否应导出为 HTML、MHTML 或 EPUB。默认为假。
导出字体资源允许独立于给定用户环境中可用字体的一致文档呈现。
如果getExportFontResources() / setExportFontResources(boolean)设置为 true ,主 HTML 文档将通过 CSS 3 引用每种字体**@font-face**规则和字体将作为单独的文件输出。当导出为 IDPF EPUB 或 MHTML 格式时,字体将与其他附属文件一起嵌入到相应的包中。
如果getExportFontsAsBase64() / setExportFontsAsBase64(boolean)设置为 true ,字体将不会保存到单独的文件中。相反,它们将被嵌入到**@font-face**Base64 编码中的 at 规则。
Important!导出字体资源时,应考虑字体许可问题。希望通过可下载字体机制使用特定字体的作者必须始终仔细验证其预期用途是否在字体许可的范围内。许多商业字体目前不允许以任何形式从网络下载其字体。涵盖某些字体的许可协议特别指出,使用@font-faceCSS 样式表中的规则是不允许的。字体子集也可能违反许可条款。
退货: boolean - 相应的布尔值。
getExportFontsAsBase64()
public boolean getExportFontsAsBase64()
指定字体资源是否应以 Base64 编码嵌入到 HTML 中。默认为假。
默认情况下,字体被写入单独的文件。如果此选项设置为 true ,字体将以 Base64 编码嵌入到文档的 CSS 中。
退货: boolean - 相应的布尔值。
getExportGeneratorName()
public boolean getExportGeneratorName()
当为真时,导致 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.Words 输出lang指定语言的文档元素上的 HTML 属性。这可能是保留语言相关语义所必需的。
退货: boolean - 相应的布尔值。
getExportListLabels()
public int getExportListLabels()
控制列表标签如何输出到 HTML、MHTML 或 EPUB。默认值为ExportListLabels.AUTO.
退货: int - 相应的 int 值。返回值是其中之一ExportListLabels常数。
getExportOriginalUrlForLinkedImages()
public boolean getExportOriginalUrlForLinkedImages()
指定是否应将原始 URL 用作链接图像的 URL。默认值为 false 。
如果值设置为 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 有“View->Text Size”子菜单,Adobe Digital Editions 有两个按钮:Increase/Decrease Text Size。如果您希望此功能起作用,请设置getExportRelativeFontSize() / setExportRelativeFontSize(boolean)属性为 true 。
Aspose Words 文档模型包含并且仅使用绝对字体大小单位进行操作。相对单位需要从一些初始(标准)大小重新计算的额外逻辑。字体大小Normal文档样式作为标准。例如,如果Normal有 12pt 字体和一些文本是 18pt 那么它将被输出为**1.5em.**到 HTML。
启用此选项后,文本以外的文档元素仍将具有绝对大小。一些与文本相关的属性也可能被绝对表达。特别是,使用“精确”规则指定的行距可能会在缩放文本时产生不需要的结果。因此,在导出时应正确设计和测试源文档getExportRelativeFontSize() / setExportRelativeFontSize(boolean)设置为 true 。
退货: boolean - 相应的布尔值。
getExportRoundtripInformation()
public boolean getExportRoundtripInformation()
指定保存为 HTML、MHTML 或 EPUB 时是否写入往返信息。对于 HTML,默认值为 true,对于 MHTML 和 EPUB,默认值为 false。
保存往返信息允许在将 HTML 文档加载回Document目的。
当 true 时,往返信息导出为 -aw-* 对应 HTML 元素的 CSS 属性。
如果为 false ,则不会将往返信息输出到生成的文件中。
退货: boolean - 相应的布尔值。
getExportShapesAsSvg()
public boolean getExportShapesAsSvg()
控制是否Shape保存为 HTML、MHTML、EPUB 或 AZW3 时,节点将转换为 SVG 图像。默认值为 false 。
如果此选项设置为 true ,Shape节点作为元素导出。否则,它们将呈现为位图并导出为![图1][] 元素。
[图1]:
退货: boolean - 相应的布尔值。
getExportTextInputFormFieldAsText()
public boolean getExportTextInputFormFieldAsText()
控制文本输入表单字段如何保存为 HTML 或 MHTML。默认值为 false 。
当设置为 true 时,将文本输入表单字段导出为普通文本。当为 false 时,将 Word 文本输入表单字段导出为 HTML 中的 INPUT 元素。
导出到 EPUB 时,由于此格式的要求,文本输入表单字段始终保存为文本。
退货: boolean - 相应的布尔值。
getExportTocPageNumbers()
public boolean getExportTocPageNumbers()
指定在保存 HTML、MHTML 和 EPUB 时是否将页码写入目录。默认值为 false 。
退货: boolean - 相应的布尔值。
getExportXhtmlTransitional()
public boolean getExportXhtmlTransitional()
指定保存为 HTML 或 MHTML 时是否编写 DOCTYPE 声明。当为 true 时,在根元素之前的文档中写入 DOCTYPE 声明。默认值为 false 。保存到 EPUB 或 HTML5 时(HtmlVersion.HTML_5) DOCTYPE 声明总是被写入。
无论此设置如何,Aspose.Words 始终编写格式良好的 HTML。
当为 true 时,HTML 输出文档的开头将如下所示:
Aspose.Words 旨在根据 XHTML 1.0 Transitional 规范输出 XHTML,但输出并不总是根据 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-faceCSS 样式表中的规则是不允许的。字体子集也可能违反许可条款。
退货: 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()
指定用于构造写入 HTML 文档的字体 URI 的文件夹的名称。默认为空字符串。
当你保存一个Document以 HTML 格式和getExportFontResources() / setExportFontResources(boolean)设置为 true ,Aspose.Words 需要将文档中使用的字体保存为独立文件。getFontsFolder() / setFontsFolder(java.lang.String)允许您指定字体的保存位置和getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)允许指定如何构造字体 URI。
如果getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)不是空字符串,那么写入 HTML 的字体 URI 将是FontsFolderAlias + .
如果getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)是一个空字符串,那么写入 HTML 的字体 URI 将是FontsFolder + .
如果getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)被设定为 ‘。’ (点),那么无论其他选项如何,字体文件名都将写入没有路径的 HTML。
指定文件夹名称以构造字体 URI 的另一种方法是使用getResourceFolderAlias() / setResourceFolderAlias(java.lang.String).
退货: java.lang.String - 相应的 java.lang.String 值。
getHtmlVersion()
public int getHtmlVersion()
指定将文档保存为 HTML 或 MHTML 时应使用的 HTML 标准版本。默认值为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()
指定用于构造写入 HTML 文档的图像 URI 的文件夹的名称。默认为空字符串。
当你保存一个Document在 HTML 格式中,Aspose.Words 需要将文档中嵌入的所有图像保存为独立文件。getImagesFolder() / setImagesFolder(java.lang.String)允许您指定图像的保存位置和getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)允许指定图像 URI 的构建方式。
如果getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)不是空字符串,则写入 HTML 的图像 URI 将是ImagesFolderAlias + ![Image 1][].
如果getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)是一个空字符串,那么写入 HTML 的图像 URI 将是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 可以显着减少内存消耗,同时以较慢的保存时间为代价保存大型文档。
退货: 布尔值 - 确定在保存文档之前是否应执行内存优化的值。
getMetafileFormat()
public int getMetafileFormat()
指定导出为 HTML、MHTML 或 EPUB 时元文件的保存格式。默认值为HtmlMetafileFormat.PNG,这意味着元文件被渲染为光栅 PNG 图像。
HTML 浏览器本身不会显示元文件。默认情况下,Aspose.Words 在导出为 HTML 时会将 WMF 和 EMF 图像转换为 PNG 文件。其他选项是将元文件转换为 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()
指定将文档导出为 HTML 时保存所有资源(如图像、字体和外部 CSS)的物理文件夹。默认为空字符串。
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()
指定用于构造写入 HTML 文档的所有资源的 URI 的文件夹的名称。默认为空字符串。
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),而图像和 CSS 的 URI 将使用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()
指定在导出为 HTML、MHTML 或 EPUB 时图像是否由 Aspose.Words 缩放到边界形状大小。默认值为 true 。
Microsoft Word 文档中的图像是一种形状。形状有大小,图像有自己的大小。大小没有直接关联。例如,图像可以是 1024x786 像素,但显示此图像的形状可以是 400x300 点。
为了在浏览器中显示图像,必须将其缩放到形状大小。这getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)属性控制图像缩放发生的位置:在导出为 HTML 期间在 Aspose.Words 中或在显示文档时在浏览器中。
什么时候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.
当您使用 Aspose.Words 将文档转换为 HTML 时,您可能希望控制表格、行和单元格宽度的导出方式,以影响生成的文档在可视化代理(例如浏览器或查看器)中的显示方式。
使用此属性作为过滤器来指定将哪些表格宽度值导出到目标文档中。例如,如果您正在将文档转换为 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在保存之前更新。默认值为 false 。
退货: boolean - 确定内容是否为StructuredDocumentTag在保存之前更新。
getUseAntiAliasing()
public boolean getUseAntiAliasing()
获取一个值,该值确定是否对渲染使用抗锯齿。
默认值为 false 。当此值设置为 true 时,将使用抗锯齿进行渲染。
当文档导出为以下格式时使用此属性:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF .当文档导出到SaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB和SaveFormat.AZW_3格式 此选项用于光栅图像。
退货: 布尔值 - 确定是否使用抗锯齿进行渲染的值。
getUseHighQualityRendering()
public boolean getUseHighQualityRendering()
获取一个值,该值确定是否使用高质量(即慢速)渲染算法。默认值为 false 。
当文档导出为图像格式时使用此属性: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)
设置一个布尔值,指示在保存文档时在文档中嵌入 TrueType 字体时是否允许嵌入带有 PostScript 轮廓的字体。默认值为false.
请注意,Word 不嵌入 PostScript 字体,但可以打开带有此类嵌入字体的文档。
此选项仅在FontInfoCollection.getEmbedTrueTypeFonts() / FontInfoCollection.setEmbedTrueTypeFonts(boolean)的DocumentBase.getFontInfos()属性设置为 true 。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 保存一个布尔值,指示在文档中嵌入 TrueType 字体时是否允许嵌入带有 PostScript 轮廓的字体。 |
setAllowNegativeIndent(boolean value)
public void setAllowNegativeIndent(boolean value)
指定在保存为 HTML、MHTML 或 EPUB 时是否标准化段落的负左缩进和右缩进。默认值为 false 。
当不允许负缩进时,它会作为零边距导出到 HTML。当允许负缩进时,一个段落可能会部分出现在浏览器窗口之外。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setCssClassNamePrefix(String value)
public void setCssClassNamePrefix(String value)
指定添加到所有 CSS 类名称的前缀。默认值为空字符串,生成的 CSS 类名称没有公共前缀。
如果这个值不为空,Aspose.Words 生成的所有 CSS 类都将以指定的前缀开头。这可能很有用,例如,如果您将自定义 CSS 添加到生成的文档并希望防止类名冲突。
如果该值不为 null 或空,则它必须是有效的 CSS 标识符。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setCssSavingCallback(ICssSavingCallback value)
public void setCssSavingCallback(ICssSavingCallback value)
允许控制在将文档保存为 HTML、MHTML 或 EPUB 时如何保存 CSS 样式。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | ICssSavingCallback | 相应的ICssSavingCallback价值。 |
setCssStyleSheetFileName(String value)
public void setCssStyleSheetFileName(String value)
指定将文档导出为 HTML 时写入的层叠样式表 (CSS) 文件的路径和名称。默认为空字符串。
此属性仅在将文档保存为 HTML 格式并且使用请求外部 CSS 样式表时有效getCssStyleSheetType() / setCssStyleSheetType(int).
如果此属性为空,则 CSS 文件将保存在与 HTML 文档相同的文件夹中,并具有相同的名称,但扩展名为“.css”。
如果该属性只指定路径,不指定文件名,CSS 文件将保存到指定的文件夹中,并与 HTML 文档同名,但扩展名为“.css”。
如果此属性指定的文件夹不存在,则会在保存 CSS 文件之前自动创建该文件夹。
指定保存外部 CSS 文件的文件夹的另一种方法是使用getResourceFolder() / setResourceFolder(java.lang.String).
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setCssStyleSheetType(int value)
public void setCssStyleSheetType(int value)
指定如何将 CSS(层叠样式表)样式导出到 HTML、MHTML 或 EPUB。默认值为CssStyleSheetType.INLINE用于 HTML/MHTML 和CssStyleSheetType.EXTERNAL对于 EPUB。
仅当保存为 HTML 时才支持将 CSS 样式表保存到外部文件中。当您导出为其中一种容器格式(EPUB 或 MHTML)并指定CssStyleSheetType.EXTERNAL,CSS文件将被封装到输出包中。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一CssStyleSheetType常数。 |
setDefaultTemplate(String value)
public void setDefaultTemplate(String value)
将路径设置为默认模板(包括文件名)。此属性的默认值为empty string.如果指定,此路径用于加载模板时Document.getAutomaticallyUpdateStyles() / Document.setAutomaticallyUpdateStyles(boolean)是真的,但是Document.getAttachedTemplate() / Document.setAttachedTemplate(java.lang.String)是空的。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 默认模板的路径(包括文件名)。 |
setDml3DEffectsRenderingMode(int value)
public void setDml3DEffectsRenderingMode(int value)
设置确定 3D 效果呈现方式的值。默认值为Dml3DEffectsRenderingMode.BASIC.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 确定如何呈现 3D 效果的值。该值必须是其中之一Dml3DEffectsRenderingMode常数。 |
setDmlEffectsRenderingMode(int value)
public void setDmlEffectsRenderingMode(int value)
设置一个值,确定如何呈现 DrawingML 效果。默认值为DmlEffectsRenderingMode.SIMPLIFIED.
当文档导出为固定页面格式时使用此属性。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 确定如何呈现 DrawingML 效果的值。该值必须是其中之一DmlEffectsRenderingMode常数。 |
setDmlRenderingMode(int value)
public void setDmlRenderingMode(int value)
设置一个值,确定如何呈现 DrawingML 形状。默认值为DmlRenderingMode.FALLBACK.
当文档导出为固定页面格式时使用此属性。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 确定如何呈现 DrawingML 形状的值。该值必须是其中之一DmlRenderingMode常数。 |
setDocumentPartSavingCallback(IDocumentPartSavingCallback value)
public void setDocumentPartSavingCallback(IDocumentPartSavingCallback value)
允许控制在将文档保存为 HTML 或 EPUB 时如何保存文档部分。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | IDocumentPartSavingCallback | 相应的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 格式保存时无法拆分文档。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是按位组合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段落导致文档被拆分。将此属性设置为零将导致文档根本不会在标题段落处拆分。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。 |
setEncoding(Charset value)
public void setEncoding(Charset value)
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.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 之间的值以请求相应的最大级别。将其设置为零会将导航映射减少到仅文档根或文档部分的根。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。 |
setExportCidUrlsForMhtmlResources(boolean value)
public void setExportCidUrlsForMhtmlResources(boolean value)
指定是否使用 CID(内容 ID)URL 来引用 MHTML 文档中包含的资源(图像、字体、CSS)。默认值为 false 。
此选项仅影响保存为 MHTML 的文档。
默认情况下,MHTML 文档中的资源通过文件名引用(例如,“image.png”),这些文件与 MIME 部分的“Content-Location”标头相匹配。
此选项启用另一种方法,其中对资源文件的引用被写为 CID (Content-ID) URL(例如,“cid:image.png”)并与“Content-ID”标头匹配。
从理论上讲,这两种引用方法应该没有区别,并且它们中的任何一种都可以在任何浏览器或邮件代理中正常工作。然而,在实践中,一些代理无法通过文件名获取资源。如果您的浏览器或邮件代理拒绝加载 MTHML 文档中包含的资源(不显示图像或不加载 CSS 样式),请尝试使用 CID URL 导出文档。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportDocumentProperties(boolean value)
public void setExportDocumentProperties(boolean value)
指定是否将内置和自定义文档属性导出为 HTML、MHTML 或 EPUB。默认值为 false 。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportDropDownFormFieldAsText(boolean value)
public void setExportDropDownFormFieldAsText(boolean value)
控制下拉表单字段如何保存为 HTML 或 MHTML。默认值为 false 。
设置为 true 时,将下拉表单字段导出为普通文本。当为 false 时,将下拉表单字段导出为 HTML 中的 SELECT 元素。
导出为 EPUB 时,由于此格式的要求,文本下拉表单字段始终保存为文本。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportFontResources(boolean value)
public void setExportFontResources(boolean value)
指定字体资源是否应导出为 HTML、MHTML 或 EPUB。默认为假。
导出字体资源允许独立于给定用户环境中可用字体的一致文档呈现。
如果getExportFontResources() / setExportFontResources(boolean)设置为 true ,主 HTML 文档将通过 CSS 3 引用每种字体**@font-face**规则和字体将作为单独的文件输出。当导出为 IDPF EPUB 或 MHTML 格式时,字体将与其他附属文件一起嵌入到相应的包中。
如果getExportFontsAsBase64() / setExportFontsAsBase64(boolean)设置为 true ,字体将不会保存到单独的文件中。相反,它们将被嵌入到**@font-face**Base64 编码中的 at 规则。
Important!导出字体资源时,应考虑字体许可问题。希望通过可下载字体机制使用特定字体的作者必须始终仔细验证其预期用途是否在字体许可的范围内。许多商业字体目前不允许以任何形式从网络下载其字体。涵盖某些字体的许可协议特别指出,使用@font-faceCSS 样式表中的规则是不允许的。字体子集也可能违反许可条款。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportFontsAsBase64(boolean value)
public void setExportFontsAsBase64(boolean value)
指定字体资源是否应以 Base64 编码嵌入到 HTML 中。默认为假。
默认情况下,字体被写入单独的文件。如果此选项设置为 true ,字体将以 Base64 编码嵌入到文档的 CSS 中。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportGeneratorName(boolean value)
public void setExportGeneratorName(boolean value)
当为真时,导致 Aspose.Words 的名称和版本被嵌入到生成的文件中。默认值为true.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
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.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一ExportHeadersFootersMode常数。 |
setExportImagesAsBase64(boolean value)
public void setExportImagesAsBase64(boolean value)
指定图像是否以 Base64 格式保存到输出 HTML、MHTML 或 EPUB。默认为假。
当此属性设置为 true 时,图像数据将直接导出到img不会创建元素和单独的文件。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportLanguageInformation(boolean value)
public void setExportLanguageInformation(boolean value)
指定是否将语言信息导出为 HTML、MHTML 或 EPUB。默认为假。
当此属性设置为 true 时,Aspose.Words 输出lang指定语言的文档元素上的 HTML 属性。这可能是保留语言相关语义所必需的。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportListLabels(int value)
public void setExportListLabels(int value)
控制列表标签如何输出到 HTML、MHTML 或 EPUB。默认值为ExportListLabels.AUTO.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一ExportListLabels常数。 |
setExportOriginalUrlForLinkedImages(boolean value)
public void setExportOriginalUrlForLinkedImages(boolean value)
指定是否应将原始 URL 用作链接图像的 URL。默认值为 false 。
如果值设置为 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)特性。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportPageMargins(boolean value)
public void setExportPageMargins(boolean value)
指定页边距是否导出为 HTML、MHTML 或 EPUB。默认为假。 Aspose.Words 默认不显示页边距区域。如果任何元素被文档边缘完全或部分剪裁,则可以使用此选项扩展显示区域。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportPageSetup(boolean value)
public void setExportPageSetup(boolean value)
指定是否将页面设置导出为 HTML、MHTML 或 EPUB。默认为假。
每个Section在 Aspose.Words 文档模型中通过以下方式提供页面设置信息PageSetup班级。当您将文档导出为 HTML 格式时,您可能需要保留此信息以供进一步使用。特别是,页面设置对于呈现为分页媒体(打印)或随后转换为本机 Microsoft Word 文件格式(DOCX、DOC、RTF、WML)可能很重要。
在大多数情况下,HTML 用于在不执行分页的浏览器中查看。所以默认情况下此功能处于非活动状态。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportRelativeFontSize(boolean value)
public void setExportRelativeFontSize(boolean value)
指定在保存为 HTML、MHTML 或 EPUB 时是否应以相对单位输出字体大小。默认为假。
在许多现有文档(HTML、IDPF EPUB)中,字体大小以相对单位指定。这允许应用程序在查看/处理文档时调整文本大小。例如,Microsoft Internet Explorer 有“View->Text Size”子菜单,Adobe Digital Editions 有两个按钮:Increase/Decrease Text Size。如果您希望此功能起作用,请设置getExportRelativeFontSize() / setExportRelativeFontSize(boolean)属性为 true 。
Aspose Words 文档模型包含并且仅使用绝对字体大小单位进行操作。相对单位需要从一些初始(标准)大小重新计算的额外逻辑。字体大小Normal文档样式作为标准。例如,如果Normal有 12pt 字体和一些文本是 18pt 那么它将被输出为**1.5em.**到 HTML。
启用此选项后,文本以外的文档元素仍将具有绝对大小。一些与文本相关的属性也可能被绝对表达。特别是,使用“精确”规则指定的行距可能会在缩放文本时产生不需要的结果。因此,在导出时应正确设计和测试源文档getExportRelativeFontSize() / setExportRelativeFontSize(boolean)设置为 true 。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportRoundtripInformation(boolean value)
public void setExportRoundtripInformation(boolean value)
指定保存为 HTML、MHTML 或 EPUB 时是否写入往返信息。对于 HTML,默认值为 true,对于 MHTML 和 EPUB,默认值为 false。
保存往返信息允许在将 HTML 文档加载回Document目的。
当 true 时,往返信息导出为 -aw-* 对应 HTML 元素的 CSS 属性。
如果为 false ,则不会将往返信息输出到生成的文件中。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportShapesAsSvg(boolean value)
public void setExportShapesAsSvg(boolean value)
控制是否Shape保存为 HTML、MHTML、EPUB 或 AZW3 时,节点将转换为 SVG 图像。默认值为 false 。
如果此选项设置为 true ,Shape节点作为元素导出。否则,它们将呈现为位图并导出为![图1][] 元素。
[图1]:
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportTextInputFormFieldAsText(boolean value)
public void setExportTextInputFormFieldAsText(boolean value)
控制文本输入表单字段如何保存为 HTML 或 MHTML。默认值为 false 。
当设置为 true 时,将文本输入表单字段导出为普通文本。当为 false 时,将 Word 文本输入表单字段导出为 HTML 中的 INPUT 元素。
导出到 EPUB 时,由于此格式的要求,文本输入表单字段始终保存为文本。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportTocPageNumbers(boolean value)
public void setExportTocPageNumbers(boolean value)
指定在保存 HTML、MHTML 和 EPUB 时是否将页码写入目录。默认值为 false 。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setExportXhtmlTransitional(boolean value)
public void setExportXhtmlTransitional(boolean value)
指定保存为 HTML 或 MHTML 时是否编写 DOCTYPE 声明。当为 true 时,在根元素之前的文档中写入 DOCTYPE 声明。默认值为 false 。保存到 EPUB 或 HTML5 时(HtmlVersion.HTML_5) DOCTYPE 声明总是被写入。
无论此设置如何,Aspose.Words 始终编写格式良好的 HTML。
当为 true 时,HTML 输出文档的开头将如下所示:
Aspose.Words 旨在根据 XHTML 1.0 Transitional 规范输出 XHTML,但输出并不总是根据 DTD 进行验证。 Microsoft Word 文档中的某些结构很难或不可能映射到将根据 XHTML 模式进行验证的文档。例如,XHTML 不允许嵌套列表(UL 不能嵌套在另一个 UL 元素中),但在 Microsoft Word 文档中,多级列表经常出现。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setFontResourcesSubsettingSizeThreshold(int value)
public void setFontResourcesSubsettingSizeThreshold(int value)
控制在保存为 HTML、MHTML 或 EPUB 时哪些字体资源需要子集化。默认为 0 。
getExportFontResources() / setExportFontResources(boolean)允许将字体导出为附属文件或作为输出包的一部分。如果文档使用多种字体,尤其是带有大量字形的字体,则输出大小会显着增加。字体子集通过过滤掉当前文档未使用的字形来减少导出字体资源的大小。
字体子集化工作如下:
- 默认情况下,所有导出的字体都是子集化的。
- 环境getFontResourcesSubsettingSizeThreshold() / setFontResourcesSubsettingSizeThreshold(int)为正值指示 Aspose.Words 对文件大小大于指定值的字体进行子集化。
- 将属性设置为禁止字体子集化。
Important!导出字体资源时,应考虑字体许可问题。希望通过可下载字体机制使用特定字体的作者必须始终仔细验证其预期用途是否在字体许可的范围内。许多商业字体目前不允许以任何形式从网络下载其字体。涵盖某些字体的许可协议特别指出,使用@font-faceCSS 样式表中的规则是不允许的。字体子集也可能违反许可条款。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。 |
setFontSavingCallback(IFontSavingCallback value)
public void setFontSavingCallback(IFontSavingCallback value)
允许控制在将文档保存为 HTML、MHTML 或 EPUB 时如何保存字体。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | IFontSavingCallback | 相应的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)是另一种指定应保存字体的文件夹的方法。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setFontsFolderAlias(String value)
public void setFontsFolderAlias(String value)
指定用于构造写入 HTML 文档的字体 URI 的文件夹的名称。默认为空字符串。
当你保存一个Document以 HTML 格式和getExportFontResources() / setExportFontResources(boolean)设置为 true ,Aspose.Words 需要将文档中使用的字体保存为独立文件。getFontsFolder() / setFontsFolder(java.lang.String)允许您指定字体的保存位置和getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)允许指定如何构造字体 URI。
如果getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)不是空字符串,那么写入 HTML 的字体 URI 将是FontsFolderAlias + .
如果getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)是一个空字符串,那么写入 HTML 的字体 URI 将是FontsFolder + .
如果getFontsFolderAlias() / setFontsFolderAlias(java.lang.String)被设定为 ‘。’ (点),那么无论其他选项如何,字体文件名都将写入没有路径的 HTML。
指定文件夹名称以构造字体 URI 的另一种方法是使用getResourceFolderAlias() / setResourceFolderAlias(java.lang.String).
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setHtmlVersion(int value)
public void setHtmlVersion(int value)
指定将文档保存为 HTML 或 MHTML 时应使用的 HTML 标准版本。默认值为HtmlVersion.XHTML.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一HtmlVersion常数。 |
setImageResolution(int value)
public void setImageResolution(int value)
指定导出为 HTML、MHTML 或 EPUB 时图像的输出分辨率。默认为 96 dpi。
此属性会在以下情况下影响光栅图像getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)是 true 并且效果图元文件导出为光栅图像。某些图像属性(例如裁剪或旋转)需要保存转换后的图像,在这种情况下,转换后的图像以给定的分辨率创建。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。 |
setImageSavingCallback(IImageSavingCallback value)
public void setImageSavingCallback(IImageSavingCallback value)
允许控制将文档保存为 HTML、MHTML 或 EPUB 时图像的保存方式。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | IImageSavingCallback | 相应的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)是另一种指定应保存图像的文件夹的方法。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setImagesFolderAlias(String value)
public void setImagesFolderAlias(String value)
指定用于构造写入 HTML 文档的图像 URI 的文件夹的名称。默认为空字符串。
当你保存一个Document在 HTML 格式中,Aspose.Words 需要将文档中嵌入的所有图像保存为独立文件。getImagesFolder() / setImagesFolder(java.lang.String)允许您指定图像的保存位置和getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)允许指定图像 URI 的构建方式。
如果getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)不是空字符串,则写入 HTML 的图像 URI 将是ImagesFolderAlias + ![Image 1][].
如果getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)是一个空字符串,那么写入 HTML 的图像 URI 将是ImagesFolder + ![Image 1][].
如果getImagesFolderAlias() / setImagesFolderAlias(java.lang.String)被设定为 ‘。’ (点),则无论其他选项如何,图像文件名都将写入没有路径的 HTML。
指定文件夹名称以构造图像 URI 的另一种方法是使用getResourceFolderAlias() / setResourceFolderAlias(java.lang.String).
[图1]:
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setImlRenderingMode(int value)
public void setImlRenderingMode(int value)
设置一个值,确定如何呈现墨迹 (InkML) 对象。默认值为ImlRenderingMode.INK_ML.
当文档导出为固定页面格式时使用此属性。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 确定如何呈现墨迹 (InkML) 对象的值。该值必须是其中之一ImlRenderingMode常数。 |
setMemoryOptimization(boolean value)
public void setMemoryOptimization(boolean value)
设置确定在保存文档之前是否应执行内存优化的值。此属性的默认值为false.将此选项设置为 true 可以显着减少内存消耗,同时以较慢的保存时间为代价保存大型文档。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 确定在保存文档之前是否应执行内存优化的值。 |
setMetafileFormat(int value)
public void setMetafileFormat(int value)
指定导出为 HTML、MHTML 或 EPUB 时元文件的保存格式。默认值为HtmlMetafileFormat.PNG,这意味着元文件被渲染为光栅 PNG 图像。
HTML 浏览器本身不会显示元文件。默认情况下,Aspose.Words 在导出为 HTML 时会将 WMF 和 EMF 图像转换为 PNG 文件。其他选项是将元文件转换为 SVG 图像或按原样导出它们而不进行转换。
如果将元文件图像导出为未经转换的 HTML,则某些图像转换(尤其是图像裁剪)将不会应用于这些图像。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一HtmlMetafileFormat常数。 |
setOfficeMathOutputMode(int value)
public void setOfficeMathOutputMode(int value)
控制如何将 OfficeMath 对象导出为 HTML、MHTML 或 EPUB。默认值为 HtmlOfficeMathOutputMode.Image 。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一HtmlOfficeMathOutputMode常数。 |
setPrettyFormat(boolean value)
public void setPrettyFormat(boolean value)
当 true 时,漂亮的格式输出适用。默认值为false.
调成true使 HTML、MHTML、EPUB、WordML、RTF、DOCX 和 ODT 输出人类可读。用于测试或调试。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
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.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | IDocumentSavingCallback | 相应的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)将源文档中指定的每个字体系列名称解析为可用字体系列的名称,根据需要执行字体替换。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
setResourceFolder(String value)
public void setResourceFolder(String value)
指定将文档导出为 HTML 时保存所有资源(如图像、字体和外部 CSS)的物理文件夹。默认为空字符串。
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)不存在,会自动创建。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setResourceFolderAlias(String value)
public void setResourceFolderAlias(String value)
指定用于构造写入 HTML 文档的所有资源的 URI 的文件夹的名称。默认为空字符串。
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),而图像和 CSS 的 URI 将使用getResourceFolderAlias() / setResourceFolderAlias(java.lang.String).
如果getResourceFolderAlias() / setResourceFolderAlias(java.lang.String)是空的,getResourceFolder() / setResourceFolder(java.lang.String)属性值将用于构造资源 URI。
如果getResourceFolderAlias() / setResourceFolderAlias(java.lang.String)被设定为 ‘。’ (点),资源 URI 将只包含文件名,没有任何路径。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setSaveFormat(int value)
public void setSaveFormat(int value)
如果使用此保存选项对象,则指定保存文档的格式。可SaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB或者SaveFormat.AZW_3.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一SaveFormat常数。 |
setScaleImageToShapeSize(boolean value)
public void setScaleImageToShapeSize(boolean value)
指定在导出为 HTML、MHTML 或 EPUB 时图像是否由 Aspose.Words 缩放到边界形状大小。默认值为 true 。
Microsoft Word 文档中的图像是一种形状。形状有大小,图像有自己的大小。大小没有直接关联。例如,图像可以是 1024x786 像素,但显示此图像的形状可以是 400x300 点。
为了在浏览器中显示图像,必须将其缩放到形状大小。这getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)属性控制图像缩放发生的位置:在导出为 HTML 期间在 Aspose.Words 中或在显示文档时在浏览器中。
什么时候getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)为 true 时,图像由 Aspose.Words 在导出为 HTML 期间使用高质量缩放进行缩放。什么时候getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)为 false ,图像以其原始大小输出,浏览器必须对其进行缩放。
一般来说,浏览器的缩放速度很快但质量很差。因此,您通常会在浏览器中获得更好的显示质量和更小的文件大小getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)是的,但更好的打印质量和更快的转换getScaleImageToShapeSize() / setScaleImageToShapeSize(boolean)是假的。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 对应的布尔值。 |
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.
当您使用 Aspose.Words 将文档转换为 HTML 时,您可能希望控制表格、行和单元格宽度的导出方式,以影响生成的文档在可视化代理(例如浏览器或查看器)中的显示方式。
使用此属性作为过滤器来指定将哪些表格宽度值导出到目标文档中。例如,如果您正在将文档转换为 EPUB 并打算在移动阅读设备上查看该文档,那么您可能希望避免导出绝对宽度值。为此,您需要指定输出模式HtmlElementSizeOutputMode.RELATIVE_ONLY或者HtmlElementSizeOutputMode.NONE因此移动设备上的查看者可以对表格进行布局以尽可能适应屏幕的宽度。|
参数:
范围 | 类型 | 描述 |
---|---|---|
value | int | 对应的int值。该值必须是其中之一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 会自动删除所有临时文件。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 对应的java.lang.String值。 |
setUpdateCreatedTimeProperty(boolean value)
public void setUpdateCreatedTimeProperty(boolean value)
设置一个值,确定是否BuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date)属性在保存前更新。默认值为假;
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 一个值决定是否BuiltInDocumentProperties.getCreatedTime() / BuiltInDocumentProperties.setCreatedTime(java.util.Date)属性在保存前更新。 |
setUpdateFields(boolean value)
public void setUpdateFields(boolean value)
设置一个值,确定在将文档保存为固定页面格式之前是否应更新某些类型的字段。此属性的默认值为true.允许指定是否模仿 MS Word 行为。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 确定在将文档保存为固定页面格式之前是否应更新某些类型的字段的值。 |
setUpdateLastPrintedProperty(boolean value)
public void setUpdateLastPrintedProperty(boolean value)
设置一个值,确定是否BuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date)属性在保存前更新。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 一个值决定是否BuiltInDocumentProperties.getLastPrinted() / BuiltInDocumentProperties.setLastPrinted(java.util.Date)属性在保存前更新。 |
setUpdateLastSavedTimeProperty(boolean value)
public void setUpdateLastSavedTimeProperty(boolean value)
设置一个值,确定是否BuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date)属性在保存前更新。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 一个值决定是否BuiltInDocumentProperties.getLastSavedTime() / BuiltInDocumentProperties.setLastSavedTime(java.util.Date)属性在保存前更新。 |
setUpdateSdtContent(boolean value)
public void setUpdateSdtContent(boolean value)
设置值确定内容是否StructuredDocumentTag在保存之前更新。默认值为 false 。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 值决定是否内容StructuredDocumentTag在保存之前更新。 |
setUseAntiAliasing(boolean value)
public void setUseAntiAliasing(boolean value)
设置一个值,确定是否使用抗锯齿进行渲染。
默认值为 false 。当此值设置为 true 时,将使用抗锯齿进行渲染。
当文档导出为以下格式时使用此属性:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF .当文档导出到SaveFormat.HTML, SaveFormat.MHTML, SaveFormat.EPUB和SaveFormat.AZW_3格式 此选项用于光栅图像。
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 确定是否使用抗锯齿进行渲染的值。 |
setUseHighQualityRendering(boolean value)
public void setUseHighQualityRendering(boolean value)
设置一个值以确定是否使用高质量(即慢速)渲染算法。默认值为 false 。
当文档导出为图像格式时使用此属性:SaveFormat.TIFF, SaveFormat.PNG, SaveFormat.BMP, SaveFormat.JPEG, SaveFormat.EMF.
参数:
范围 | 类型 | 描述 |
---|---|---|
value | boolean | 确定是否使用高质量的值(即 |
toString()
public String toString()
退货: java.lang.字符串
wait()
public final void wait()
wait(long arg0)
public final native void wait(long arg0)
参数:
范围 | 类型 | 描述 |
---|---|---|
arg0 | long |
wait(long arg0, int arg1)
public final void wait(long arg0, int arg1)
参数:
范围 | 类型 | 描述 |
---|---|---|
arg0 | long | |
arg1 | int |