JavaTM Platform
Standard Ed. 6

类 java.awt.Image
的使用

使用 Image 的软件包
java.applet 提供创建 applet 所必需的类和 applet 用来与其 applet 上下文通信的类。 
java.awt 包含用于创建用户界面和绘制图形图像的所有类。 
java.awt.dnd Drag 和 Drop 是一种直接操作动作,在许多图形用户界面系统中都会遇到它,它提供了一种机制,能够在两个与 GUI 中显示元素逻辑相关的实体之间传输信息。 
java.awt.font 提供与字体相关的类和接口。 
java.awt.im.spi 提供启用可以与 Java 运行时环境一起使用的输入方法开发的接口。 
java.awt.image 提供创建和修改图像的各种类。 
java.beans 包含与开发 beans 有关的类,即基于 JavaBeansTM 架构的组件。 
javax.swing 提供一组“轻量级”(全部是 Java 语言)组件,尽量让这些组件在所有平台上的工作方式都相同。 
javax.swing.text.html 提供类 HTMLEditorKit 和创建 HTML 文本编辑器的支持类。 
 

java.appletImage 的使用
 

返回 Imagejava.applet 中的方法
 Image AppletContext.getImage(URL url)
          返回能被绘制到屏幕上的 Image 对象。
 Image Applet.getImage(URL url)
          返回能被绘制到屏幕上的 Image 对象。
 Image Applet.getImage(URL url, String name)
          返回能被绘制到屏幕上的 Image 对象。
 

java.awtImage 的使用
 

声明为 Imagejava.awt 中的字段
protected  Image Component.FlipBufferStrategy.drawBuffer
          绘制缓冲区。
 

返回 Imagejava.awt 中的方法
 Image Toolkit.createImage(byte[] imagedata)
          创建一幅图像,该图像对存储在指定字节数组中的图像进行解码。
abstract  Image Toolkit.createImage(byte[] imagedata, int imageoffset, int imagelength)
          创建一幅图像,该图像对存储在指定字节数组中指定偏移量和长度处的图像进行解码。
abstract  Image Toolkit.createImage(ImageProducer producer)
          使用指定的图像生成器创建一幅图像。
 Image Component.createImage(ImageProducer producer)
          根据指定的图像生成器创建一幅图像。
 Image Component.createImage(int width, int height)
          创建一幅用于双缓冲的、可在屏幕外绘制的图像。
abstract  Image Toolkit.createImage(String filename)
          返回从指定文件获取像素数据的图像。
abstract  Image Toolkit.createImage(URL url)
          返回一幅图像,该图像从指定 URL 获取像素数据。
protected  Image Component.FlipBufferStrategy.getBackBuffer()
           
 Image Frame.getIconImage()
          返回要作为此窗体图标显示的图像。
 Image TrayIcon.getImage()
          返回用于此 TrayIcon 的当前图像。
abstract  Image Toolkit.getImage(String filename)
          返回一幅图像,该图像从指定文件中获取像素数据,图像格式可以是 GIF、JPEG 或 PNG。
abstract  Image Toolkit.getImage(URL url)
          返回一幅图像,该图像从指定 URL 获取像素数据。
 Image Image.getScaledInstance(int width, int height, int hints)
          创建此图像的缩放版本。
 

返回变量类型为 Image 的类型的 java.awt 中的方法
 List<Image> Window.getIconImages()
          返回要作为此窗口的图标显示的图像序列。
 

参数类型为 Imagejava.awt 中的方法
 void MediaTracker.addImage(Image image, int id)
          向此媒体跟踪器正在跟踪的图像列表添加一个图像。
 void MediaTracker.addImage(Image image, int id, int w, int h)
          向此媒体跟踪器正在跟踪的图像列表添加一个经过缩放的图像。
 int Component.checkImage(Image image, ImageObserver observer)
          返回指定图像屏幕表示的构造状态。
abstract  int Toolkit.checkImage(Image image, int width, int height, ImageObserver observer)
          指示正准备显示的指定图像的构造状态。
 int Component.checkImage(Image image, int width, int height, ImageObserver observer)
          返回指定图像屏幕表示的构造状态。
 Cursor Toolkit.createCustomCursor(Image cursor, Point hotSpot, String name)
          创建一个新的自定义光标对象。
abstract  boolean Graphics2D.drawImage(Image img, AffineTransform xform, ImageObserver obs)
          呈现一个图像,在绘制前进行从图像空间到用户空间的转换。
abstract  boolean Graphics.drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer)
          绘制指定图像中当前可用的图像。
abstract  boolean Graphics.drawImage(Image img, int x, int y, ImageObserver observer)
          绘制指定图像中当前可用的图像。
abstract  boolean Graphics.drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer)
          绘制指定图像中已缩放到适合指定矩形内部的图像。
abstract  boolean Graphics.drawImage(Image img, int x, int y, int width, int height, ImageObserver observer)
          绘制指定图像中已缩放到适合指定矩形内部的图像。
abstract  boolean Graphics.drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer)
          绘制当前可用的指定图像的指定区域,动态地缩放图像使其符合目标绘制表面的指定区域。
abstract  boolean Graphics.drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer)
          绘制当前可用的指定图像的指定区域,动态地缩放图像使其符合目标绘制表面的指定区域。
 boolean Component.imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
          图像已改变时重绘组件。
 boolean Component.prepareImage(Image image, ImageObserver observer)
          准备一幅在此组件上呈现的图像。
abstract  boolean Toolkit.prepareImage(Image image, int width, int height, ImageObserver observer)
          准备一个用于呈现的图像。
 boolean Component.prepareImage(Image image, int width, int height, ImageObserver observer)
          以指定的宽度和高度准备一幅在此组件上呈现的图像。
 void MediaTracker.removeImage(Image image)
          从此媒体跟踪器移除指定的图像。
 void MediaTracker.removeImage(Image image, int id)
          从此媒体跟踪器的指定跟踪 ID 中移除指定的图像。
 void MediaTracker.removeImage(Image image, int id, int width, int height)
          从此媒体跟踪器移除具有指定宽度、高度和 ID 的指定图像。
 void Frame.setIconImage(Image image)
          设置要作为此窗口图标显示的图像。
 void Window.setIconImage(Image image)
          设置要作为此窗口图标显示的图像。
 void TrayIcon.setImage(Image image)
          设置此 TrayIcon 的图像。
 

类型变量类型为 Imagejava.awt 中的方法参数
 void Window.setIconImages(List<? extends Image> icons)
          设置要作为此窗口的图标显示的图像序列。
 

参数类型为 Imagejava.awt 中的构造方法
TrayIcon(Image image)
          创建带有指定图像的 TrayIcon
TrayIcon(Image image, String tooltip)
          创建带有指定图像和工具提示文本的 TrayIcon
TrayIcon(Image image, String tooltip, PopupMenu popup)
          创建带指定图像、工具提示和弹出菜单的 TrayIcon
 

java.awt.dndImage 的使用
 

参数类型为 Imagejava.awt.dnd 中的方法
protected  DragSourceContext DragSource.createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent dgl, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable t, DragSourceListener dsl)
          创建处理此拖动的 DragSourceContext
 void DragGestureEvent.startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl)
          在给定要显示的初始 Cursor、拖动 ImageImage 的偏移量、Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。
 void DragSource.startDrag(DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point dragOffset, Transferable transferable, DragSourceListener dsl)
          在给定发起拖动的 DragGestureEvent、使用的初始 Cursor、要拖动的 ImageImage 原点距离触发时 Cursor 热点的偏移量、拖动的目标数据和 DragSourceListener 的情况下开始拖动。
 void DragSource.startDrag(DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap)
          在给定发起拖动的 DragGestureEvent、使用的初始 Cursor、要拖动的 ImageImage 原点距离触发时 Cursor 热点的偏移量、拖动的 Transferable 目标数据、DragSourceListenerFlavorMap 的情况下开始拖动。
 

参数类型为 Imagejava.awt.dnd 中的构造方法
DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
          从 DragSource 调用,此构造方法创建一个新 DragSourceContext,使其具有为此 Drag 指定的 DragSourceContextPeer、触发该 Drag 的 DragGestureEvent、用于该 Drag 的初始 Cursor、进行 Drag 时显示的 Image(可选)、Image 原点与触发事件时距离热点的偏移量、Transferable 目标数据、Drag 和 Drop 操作期间使用的 DragSourceListener
 

java.awt.fontImage 的使用
 

参数类型为 Imagejava.awt.font 中的构造方法
ImageGraphicAttribute(Image image, int alignment)
          根据指定的 Image 构造一个 ImageGraphicAttribute
ImageGraphicAttribute(Image image, int alignment, float originX, float originY)
          根据指定的 Image 构造一个 ImageGraphicAttribute
 

java.awt.im.spiImage 的使用
 

返回 Imagejava.awt.im.spi 中的方法
 Image InputMethodDescriptor.getInputMethodIcon(Locale inputLocale)
          返回相应输入方法的图标。
 

java.awt.imageImage 的使用
 

java.awt.imageImage 的子类
 class BufferedImage
          BufferedImage 子类描述具有可访问图像数据缓冲区的 Image
 class VolatileImage
          VolatileImage 是一种图像,它可以在不受应用程序控制的情形下(例如,由操作系统或其他应用程序引起的情况)随时丢失其内容。
 

参数类型为 Imagejava.awt.image 中的方法
 boolean ImageObserver.imageUpdate(Image img, int infoflags, int x, int y, int width, int height)
          当以前使用异步接口所请求的图像的信息变得可用时就调用此方法。
 

参数类型为 Imagejava.awt.image 中的构造方法
PixelGrabber(Image img, int x, int y, int w, int h, boolean forceRGB)
          创建一个 PixelGrabber 对象,以从指定的图像中抓取像素矩形部分 (x, y, w, h)。
PixelGrabber(Image img, int x, int y, int w, int h, int[] pix, int off, int scansize)
          创建一个 PixelGrabber 对象,以从指定图像将像素矩形部分 (x, y, w, h) 抓取到给定的数组中。
 

java.beansImage 的使用
 

返回 Imagejava.beans 中的方法
 Image BeanInfo.getIcon(int iconKind)
          此方法返回一个图像对象,可用该对象表示工具框、工具栏等中的 bean。
 Image SimpleBeanInfo.getIcon(int iconKind)
          声明没有可用的图标。
 Image SimpleBeanInfo.loadImage(String resourceName)
          这是帮助加载图标图像的实用工具方法。
 

javax.swingImage 的使用
 

声明为 Imagejavax.swing 中的字段
protected  Image JViewport.backingStoreImage
          用于后备存储的视图图像。
 

返回 Imagejavax.swing 中的方法
static Image GrayFilter.createDisabledImage(Image i)
          创建一个禁用图像
 Image ImageIcon.getImage()
          返回此图标的 Image
 Image RepaintManager.getOffscreenBuffer(Component c, int proposedWidth, int proposedHeight)
          返回屏幕外缓冲区,它应用作带有组件 c 的双缓冲区。
 Image RepaintManager.getVolatileOffscreenBuffer(Component c, int proposedWidth, int proposedHeight)
          返回可变屏幕外缓冲区,它应用作带有指定组件 c 的双缓冲区。
 

参数类型为 Imagejavax.swing 中的方法
static Image GrayFilter.createDisabledImage(Image i)
          创建一个禁用图像
 boolean DebugGraphics.drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer)
          重写 Graphics.drawImage
 boolean DebugGraphics.drawImage(Image img, int x, int y, ImageObserver observer)
          重写 Graphics.drawImage
 boolean DebugGraphics.drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer)
          重写 Graphics.drawImage
 boolean DebugGraphics.drawImage(Image img, int x, int y, int width, int height, ImageObserver observer)
          重写 Graphics.drawImage
 boolean DebugGraphics.drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer)
          重写 Graphics.drawImage
 boolean DebugGraphics.drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer)
          重写 Graphics.drawImage
 boolean AbstractButton.imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
          重写的此方法在当前 IconImage 不等于传入的 Image img 时返回 false。
 boolean JLabel.imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
          如果当前图标的图像不等于传入的图像 img,则重写此方法以返回 false。
protected  void ImageIcon.loadImage(Image image)
          加载图像,并且只在图像已加载时返回。
 void JFrame.setIconImage(Image image)
          设置要作为此窗口图标显示的图像。
 void ImageIcon.setImage(Image image)
          设置由此图标显示的图像。
 

参数类型为 Imagejavax.swing 中的构造方法
ImageIcon(Image image)
          根据图像对象创建一个 ImageIcon。
ImageIcon(Image image, String description)
          根据图像创建一个 ImageIcon。
 

javax.swing.text.htmlImage 的使用
 

返回 Imagejavax.swing.text.html 中的方法
 Image ImageView.getImage()
          返回要呈现的图像。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策