ImageData

遗产： java.lang.Object

public class ImageData

定义形状的图像。

要了解更多信息，请访问Working with Images文档文章。

使用Shape.getImageData()属性来访问和修改形状内的图像。您不创建的实例ImageData直接上课。

图像可以存储在形状内，链接到外部文件或两者（链接并存储在文档中）。

无论图像是存储在形状内还是链接在一起，您始终可以使用toByteArray(), toImage()或者save(java.lang.String)方法。如果图像存储在形状内，您也可以使用getImageBytes() / setImageBytes(byte[])财产。

要将图像存储在形状中，请使用setImage(java.lang.String)方法。要将图像链接到形状，请将getSourceFullName() / setSourceFullName(java.lang.String)财产。

方法

方法	描述
equals(Object arg0)
fetchInheritedBorderAttr(int key)
getBiLevel()	确定图像是否将以黑白显示。
getBorders()	获取图片的边框集合。
getBrightness()	获取图片的亮度。
getChromaKey()	定义将被视为透明的图像的颜色值。
getClass()
getContrast()	获取指定图片的对比度。
getCropBottom()	定义从底部移除图片的比例。
getCropLeft()	定义从左侧移除图片的比例。
getCropRight()	定义从右侧移除图片的比例。
getCropTop()	定义从顶部移除图片的比例。
getDirectBorderAttr(int key)
getGrayScale()	确定图片是否以灰度模式显示。
getImageBytes()	获取存储在形状中的图像的原始字节。
getImageSize()	获取有关图像大小和分辨率的信息。
getImageType()	获取图像的类型。
getSourceFullName()	获取链接图像的源文件的路径和名称。
getTitle()	定义图像的标题。
hasImage()	如果形状有图像字节或链接图像，则返回 true。
hashCode()
isLink()	如果图像链接到形状（当getSourceFullName() / setSourceFullName(java.lang.String)已指定）。
isLinkOnly()	如果图像已链接且未存储在文档中，则返回 true。
notify()
notifyAll()
save(OutputStream stream)
save(String fileName)	将图像保存到文件中。
setBiLevel(boolean value)	确定图像是否将以黑白显示。
setBorderAttr(int key, Object value)
setBrightness(double value)	设置图像的亮度。
setChromaKey(Color value)	定义将被视为透明的图像的颜色值。
setContrast(double value)	设置指定图片的对比度。
setCropBottom(double value)	定义从底部移除图片的比例。
setCropLeft(double value)	定义从左侧移除图片的比例。
setCropRight(double value)	定义从右侧移除图片的比例。
setCropTop(double value)	定义从顶部移除图片的比例。
setGrayScale(boolean value)	确定图片是否以灰度模式显示。
setImage(BufferedImage image)	设置形状显示的图像。
setImage(InputStream stream)
setImage(String fileName)	设置形状显示的图像。
setImageBytes(byte[] value)	设置存储在形状中的图像的原始字节。
setSourceFullName(String value)	设置链接图像的源文件的路径和名称。
setTitle(String value)	定义图像的标题。
toByteArray()	返回任何图像的图像字节，无论图像是存储还是链接。
toImage()	获取作为 java BufferedImage 对象存储在形状中的图像。
toStream()	创建并返回包含图像字节的流。
toString()
wait()
wait(long arg0)
wait(long arg0, int arg1)

equals(Object arg0)

public boolean equals(Object arg0)

参数：

范围	类型	描述
arg0	java.lang.Object

退货： 布尔值

fetchInheritedBorderAttr(int key)

public Object fetchInheritedBorderAttr(int key)

参数：

范围	类型	描述
key	int

退货： java.lang.Object

getBiLevel()

public boolean getBiLevel()

确定图像是否将以黑白显示。

默认值为false.

退货： boolean - 相应的布尔值。

getBorders()

public BorderCollection getBorders()

获取图片的边框集合。边框仅对内联图像有效。

退货： BorderCollection - 图像边框的集合。

getBrightness()

public double getBrightness()

获取图片的亮度。此属性的值必须是从 0.0（最暗）到 1.0（最亮）的数字。

默认值为 0.5。

退货： double - 图片的亮度。

getChromaKey()

public Color getChromaKey()

定义将被视为透明的图像的颜色值。

默认值为 0。

退货： java.awt.Color - 相应的 java.awt.Color 值。

getClass()

public final native Class<?> getClass()

退货： java.lang.Class

getContrast()

public double getContrast()

获取指定图片的对比度。此属性的值必须是 0.0（最小对比度）到 1.0（最大对比度）之间的数字。

默认值为 0.5。

退货： double - 指定图片的对比度。

getCropBottom()

public double getCropBottom()

定义从底部移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

退货： double - 相应的双精度值。

getCropLeft()

public double getCropLeft()

定义从左侧移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

退货： double - 相应的双精度值。

getCropRight()

public double getCropRight()

定义从右侧移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

退货： double - 相应的双精度值。

getCropTop()

public double getCropTop()

定义从顶部移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

退货： double - 相应的双精度值。

getDirectBorderAttr(int key)

public Object getDirectBorderAttr(int key)

参数：

范围	类型	描述
key	int

退货： java.lang.Object

getGrayScale()

public boolean getGrayScale()

确定图片是否以灰度模式显示。

默认值为false.

退货： boolean - 相应的布尔值。

getImageBytes()

public byte[] getImageBytes()

获取存储在形状中的图像的原始字节。

将值设置为 null 或空数组将从形状中删除图像。

如果图像未存储在文档中（例如，在这种情况下图像可能已链接），则返回 null。

退货： 字节[] - 存储在形状中的图像的原始字节。

getImageSize()

public ImageSize getImageSize()

获取有关图像大小和分辨率的信息。 (4661,6)

如果图像仅链接而不存储在文档中，则返回零大小。

退货： ImageSize - 有关图像大小和分辨率的信息。

getImageType()

public int getImageType()

获取图像的类型。 (4671,6)

退货： int - 图像的类型。返回值是其中之一ImageType常数。

getSourceFullName()

public String getSourceFullName()

获取链接图像的源文件的路径和名称。

默认值为空字符串。

如果getSourceFullName() / setSourceFullName(java.lang.String)不是空字符串，图像是链接的。

退货： java.lang.String - 链接图像的源文件的路径和名称。

getTitle()

public String getTitle()

定义图像的标题。

默认值为空字符串。

退货： java.lang.String - 相应的 java.lang.String 值。

hasImage()

public boolean hasImage()

如果形状有图像字节或链接图像，则返回 true。 (4654,6)

退货： boolean - 如果形状具有图像字节或链接图像，则为真。

hashCode()

public native int hashCode()

退货： 整数

isLink()

public boolean isLink()

如果图像链接到形状（当getSourceFullName() / setSourceFullName(java.lang.String)已指定）。 (4678,6)

退货： boolean - 如果图像链接到形状则为真（当getSourceFullName() / setSourceFullName(java.lang.String)已指定）。

isLinkOnly()

public boolean isLinkOnly()

如果图像已链接且未存储在文档中，则返回 true。 (4685,6)

退货： boolean - 如果图像已链接且未存储在文档中，则为真。

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

save(OutputStream stream)

public void save(OutputStream stream)

参数：

范围	类型	描述
stream	java.io.OutputStream

save(String fileName)

public void save(String fileName)

将图像保存到文件中。

参数：

范围	类型	描述
fileName	java.lang.String	保存图像的文件名。

setBiLevel(boolean value)

public void setBiLevel(boolean value)

确定图像是否将以黑白显示。

默认值为false.

参数：

范围	类型	描述
value	boolean	对应的布尔值。

setBorderAttr(int key, Object value)

public void setBorderAttr(int key, Object value)

参数：

范围	类型	描述
key	int
value	java.lang.Object

setBrightness(double value)

public void setBrightness(double value)

设置图像的亮度。此属性的值必须是从 0.0（最暗）到 1.0（最亮）的数字。

默认值为 0.5。

参数：

范围	类型	描述
value	double	图片的亮度。

setChromaKey(Color value)

public void setChromaKey(Color value)

定义将被视为透明的图像的颜色值。

默认值为 0。

参数：

范围	类型	描述
value	java.awt.Color	对应的 java.awt.Color 值。

setContrast(double value)

public void setContrast(double value)

设置指定图片的对比度。此属性的值必须是 0.0（最小对比度）到 1.0（最大对比度）之间的数字。

默认值为 0.5。

参数：

范围	类型	描述
value	double	指定图片的对比度。

setCropBottom(double value)

public void setCropBottom(double value)

定义从底部移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

参数：

范围	类型	描述
value	double	对应的双精度值。

setCropLeft(double value)

public void setCropLeft(double value)

定义从左侧移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

参数：

范围	类型	描述
value	double	对应的双精度值。

setCropRight(double value)

public void setCropRight(double value)

定义从右侧移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

参数：

范围	类型	描述
value	double	对应的双精度值。

setCropTop(double value)

public void setCropTop(double value)

定义从顶部移除图片的比例。

裁剪量的范围可以从 -1.0 到 1.0。默认值为 0。请注意，值为 1 将完全不显示图片。负值将导致图片从被裁剪的边缘向内挤压（图片和裁剪边缘之间的空白区域将由形状的填充颜色填充）。小于 1 的正值将导致剩余图片被拉伸以适合形状。

默认值为 0。

参数：

范围	类型	描述
value	double	对应的双精度值。

setGrayScale(boolean value)

public void setGrayScale(boolean value)

确定图片是否以灰度模式显示。

默认值为false.

参数：

范围	类型	描述
value	boolean	对应的布尔值。

setImage(BufferedImage image)

public void setImage(BufferedImage image)

设置形状显示的图像。

参数：

范围	类型	描述
image	java.awt.image.BufferedImage	图像对象。

setImage(InputStream stream)

public void setImage(InputStream stream)

参数：

范围	类型	描述
stream	java.io.InputStream

setImage(String fileName)

public void setImage(String fileName)

设置形状显示的图像。

参数：

范围	类型	描述
fileName	java.lang.String	图像文件。可以是文件名或 URL。

setImageBytes(byte[] value)

public void setImageBytes(byte[] value)

设置存储在形状中的图像的原始字节。

将值设置为 null 或空数组将从形状中删除图像。

如果图像未存储在文档中（例如，在这种情况下图像可能已链接），则返回 null。

参数：

范围	类型	描述
value	byte[]	存储在形状中的图像的原始字节。

setSourceFullName(String value)

public void setSourceFullName(String value)

设置链接图像的源文件的路径和名称。

默认值为空字符串。

如果getSourceFullName() / setSourceFullName(java.lang.String)不是空字符串，图像是链接的。

参数：

范围	类型	描述
value	java.lang.String	链接图像的源文件的路径和名称。

setTitle(String value)

public void setTitle(String value)

定义图像的标题。

默认值为空字符串。

参数：

范围	类型	描述
value	java.lang.String	对应的java.lang.String值。

toByteArray()

public byte[] toByteArray()

返回任何图像的图像字节，无论图像是存储还是链接。

退货： 字节[] - 如果图像已链接，则每次调用时都会下载图像。

toImage()

public BufferedImage toImage()

获取作为 java BufferedImage 对象存储在形状中的图像。

退货： java.awt.image.BufferedImage - 每次调用此方法时尝试从图像字节创建一个新的 java.awt.image.BufferedImage 对象。如果 javax.imageio.ImageReader 无法读取图像字节（emf、wmf、tiff 等），则该方法返回 null。

调用者负责处理图像对象。

toStream()

public InputStream toStream()

创建并返回包含图像字节的流。

如果图像字节存储在形状中，则创建并返回一个对象。

如果图像已链接并存储在文件中，则打开该文件并返回一个对象。

如果图像链接并存储在外部 URL 中，则打开该 URL 并返回一个对象。

调用者有责任处置流对象。

这还没有移植到 Java。

退货： java.io.InputStream

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