ImageSavingArgs
遗产: java.lang.Object
public class ImageSavingArgs
提供数据IImageSavingCallback.imageSaving(com.aspose.words.ImageSavingArgs)事件。
要了解更多信息,请访问Save a Document文档文章。
默认情况下,当 Aspose.Words 将文档保存为 HTML 时,它会将每个图像保存到单独的文件中。 Aspose.Words 使用文档文件名和唯一编号为文档中找到的每个图像生成唯一文件名。
ImageSavingArgs允许重新定义图像文件名的生成方式或通过提供您自己的流对象来完全避免将图像保存到文件中。
要应用您自己的逻辑来生成图像文件名,请使用getImageFileName() / setImageFileName(java.lang.String), getCurrentShape()和isImageAvailable()特性。
要将图像保存到流而不是文件中,请使用P:Aspose.Words.Saving.ImageSavingArgs.ImageStream财产。
方法
方法 | 描述 |
---|---|
equals(Object arg0) | |
getClass() | |
getCurrentShape() | 获取ShapeBase与即将保存的形状或组形状相对应的对象。 |
getDocument() | 获取当前正在保存的文档对象。 |
getImageFileName() | 获取图像将保存到的文件名(不带路径)。 |
getImageStream() | |
getKeepImageStreamOpen() | 指定 Aspose.Words 应该在保存图像后保持流打开还是关闭它。 |
hashCode() | |
isImageAvailable() | 如果当前图像可用于导出,则返回 true。 |
notify() | |
notifyAll() | |
setImageFileName(String value) | 设置图像将保存到的文件名(不带路径)。 |
setImageStream(OutputStream value) | |
setKeepImageStreamOpen(boolean value) | 指定 Aspose.Words 应该在保存图像后保持流打开还是关闭它。 |
toString() | |
wait() | |
wait(long arg0) | |
wait(long arg0, int arg1) |
equals(Object arg0)
public boolean equals(Object arg0)
参数:
范围 | 类型 | 描述 |
---|---|---|
arg0 | java.lang.Object |
退货: 布尔值
getClass()
public final native Class<?> getClass()
退货: java.lang.Class
getCurrentShape()
public ShapeBase getCurrentShape()
获取ShapeBase与即将保存的形状或组形状相对应的对象。
IImageSavingCallback可以在保存形状或组形状时发射。这就是为什么该物业有ShapeBase类型。你可以检查它是否是一个组形状比较ShapeBase.getShapeType()和ShapeType.GROUP或者将其强制转换为派生类之一:Shape或者GroupShape.
Aspose.Words 使用文档文件名和唯一编号为文档中找到的每个图像生成唯一文件名。您可以使用getCurrentShape()通过检查形状属性来生成“更好”的文件名的属性,例如ImageData.getTitle() / ImageData.setTitle(java.lang.String)(仅限形状),ImageData.getSourceFullName() / ImageData.setSourceFullName(java.lang.String) (仅限形状)和ShapeBase.getName() / ShapeBase.setName(java.lang.String).当然,您可以使用任何其他属性或标准来构建文件名,但请注意,子文件名在导出操作中必须是唯一的。
文档中的某些图像可能不可用。要检查图像可用性,请使用isImageAvailable()财产。
退货: ShapeBase - 这ShapeBase与即将保存的形状或组形状相对应的对象。
getDocument()
public Document getDocument()
获取当前正在保存的文档对象。
退货: Document - 当前正在保存的文档对象。
getImageFileName()
public String getImageFileName()
获取图像将保存到的文件名(不带路径)。
此属性允许您重新定义在导出到 HTML 期间如何生成图像文件名。
触发事件时,此属性包含由 Aspose.Words 生成的文件名。您可以更改此属性的值以将图像保存到不同的文件中。请注意,文件名必须是唯一的。
当导出为 HTML 格式时,Aspose.Words 会自动为每个嵌入的图像生成一个唯一的文件名。图像文件名的生成方式取决于您是将文档保存到文件还是流中。
将文档保存到文件时,生成的图像文件名如下所示*.![Image 1][].*.
将文档保存到流时,生成的图像文件名如下所示Aspose.Words..![Image 1][]..
getImageFileName() / setImageFileName(java.lang.String)必须只包含没有路径的文件名。 Aspose.Words 使用文档文件名确定保存路径和写入 HTML 的 src 属性的值,HtmlSaveOptions.getImagesFolder() / HtmlSaveOptions.setImagesFolder(java.lang.String)和HtmlSaveOptions.getImagesFolderAlias() / HtmlSaveOptions.setImagesFolderAlias(java.lang.String)特性。
[图1]:
退货: java.lang.String - 图像将保存到的文件名(无路径)。
getImageStream()
public OutputStream getImageStream()
退货: java.io.OutputStream
getKeepImageStreamOpen()
public boolean getKeepImageStreamOpen()
指定 Aspose.Words 应该在保存图像后保持流打开还是关闭它。
默认为 false 并且 Aspose.Words 将关闭您在P:Aspose.Words.Saving.ImageSavingArgs.ImageStream将图像写入其中后的属性。指定 true 以保持流打开。
P:Aspose.Words.Saving.ImageSavingArgs.ImageStream
退货: boolean - 相应的布尔值。
hashCode()
public native int hashCode()
退货: 整数
isImageAvailable()
public boolean isImageAvailable()
如果当前图像可用于导出,则返回 true。
文档中的某些图像可能不可用,例如,因为图像已链接并且链接不可访问或未指向有效图像。在这种情况下,Aspose.Words 导出一个带有红十字的图标。如果原始图像可用,则此属性返回 true;如果原始图像不可用,则返回 false 并且将提供“无图像”图标以供保存。
保存组形状或不需要任何图像的形状时,此属性始终为 true 。
退货: 布尔值 -{ 如果当前图像可用于导出,则为 true。
notify()
public final native void notify()
notifyAll()
public final native void notifyAll()
setImageFileName(String value)
public void setImageFileName(String value)
设置图像将保存到的文件名(不带路径)。
此属性允许您重新定义在导出到 HTML 期间如何生成图像文件名。
触发事件时,此属性包含由 Aspose.Words 生成的文件名。您可以更改此属性的值以将图像保存到不同的文件中。请注意,文件名必须是唯一的。
当导出为 HTML 格式时,Aspose.Words 会自动为每个嵌入的图像生成一个唯一的文件名。图像文件名的生成方式取决于您是将文档保存到文件还是流中。
将文档保存到文件时,生成的图像文件名如下所示*.![Image 1][].*.
将文档保存到流时,生成的图像文件名如下所示Aspose.Words..![Image 1][]..
getImageFileName() / setImageFileName(java.lang.String)必须只包含没有路径的文件名。 Aspose.Words 使用文档文件名确定保存路径和写入 HTML 的 src 属性的值,HtmlSaveOptions.getImagesFolder() / HtmlSaveOptions.setImagesFolder(java.lang.String)和HtmlSaveOptions.getImagesFolderAlias() / HtmlSaveOptions.setImagesFolderAlias(java.lang.String)特性。
[图1]:
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.lang.String | 图像将保存到的文件名(无路径)。 |
setImageStream(OutputStream value)
public void setImageStream(OutputStream value)
参数:
范围 | 类型 | 描述 |
---|---|---|
value | java.io.OutputStream |
setKeepImageStreamOpen(boolean value)
public void setKeepImageStreamOpen(boolean value)
指定 Aspose.Words 应该在保存图像后保持流打开还是关闭它。
默认为 false 并且 Aspose.Words 将关闭您在P:Aspose.Words.Saving.ImageSavingArgs.ImageStream将图像写入其中后的属性。指定 true 以保持流打开。
P:Aspose.Words.Saving.ImageSavingArgs.ImageStream
参数:
范围 | 类型 | 描述 |
---|---|---|
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 |