javax.swing
类 DebugGraphics

java.lang.Object
  java.awt.Graphics
      javax.swing.DebugGraphics

public class DebugGraphics
extends Graphics

支持图形调试的图形子类。重写 Graphics 中的大多数方法。DebugGraphics 对象很少通过手工创建。它们通常在 JComponent 的 debugGraphicsOptions 因使用 setDebugGraphicsOptions() 方法而发生更改时自动创建。

注：必须关闭双缓冲来使用 DebugGraphics：RepaintManager repaintManager = RepaintManager.currentManager(component); repaintManager.setDoubleBufferingEnabled(false);

另请参见：

JComponent.setDebugGraphicsOptions(int), RepaintManager.currentManager(java.awt.Component), RepaintManager.setDoubleBufferingEnabled(boolean)

LOG_OPTION

public static final int LOG_OPTION

记录图形操作。

另请参见：

常量字段值

FLASH_OPTION

public static final int FLASH_OPTION

Flash 图形操作。

另请参见：

常量字段值

BUFFERED_OPTION

public static final int BUFFERED_OPTION

在一个单独的 Frame 中显示已缓冲的操作。

另请参见：

常量字段值

NONE_OPTION

public static final int NONE_OPTION

不要调试图形操作。

另请参见：

常量字段值

DebugGraphics

public DebugGraphics()

构造一个支持减速绘制的新调试图形上下文。

DebugGraphics

public DebugGraphics(Graphics graphics,
                     JComponent component)

根据现有图形上下文构造一个调试图形上下文，该上下文可以减慢指定组件的绘制。

参数：

graphics - 要减慢的 Graphics 上下文

component - 要缓慢绘制的 JComponent

DebugGraphics

public DebugGraphics(Graphics graphics)

根据现有图形上下文构造一个调试图形上下文，该上下文支持减慢绘制。

参数：

graphics - 要减慢的 Graphics 上下文

create

public Graphics create()

重写 Graphics.create 来返回一个 DebugGraphics 对象。

指定者：

类 Graphics 中的 create

返回：

新的图形上下文，它是此图形上下文的副本。

create

public Graphics create(int x,
                       int y,
                       int width,
                       int height)

重写 Graphics.create 来返回一个 DebugGraphics 对象。

覆盖：

类 Graphics 中的 create

参数：

x - x 坐标。

y - y 坐标。

width - 剪贴矩形的宽度。

height - 剪贴矩形的高度。

返回：

新的图形上下文。

另请参见：

Graphics.translate(int, int), Graphics.clipRect(int, int, int, int)

setFlashColor

public static void setFlashColor(Color flashColor)

设置用于 flash 绘制操作的 Color。

flashColor

public static Color flashColor()

返回用于 flash 绘制操作的 Color。

另请参见：

setFlashColor(java.awt.Color)

setFlashTime

public static void setFlashTime(int flashTime)

设置绘制操作 flash 的时间延迟。

flashTime

public static int flashTime()

返回绘制操作 flash 的时间延迟。

另请参见：

setFlashTime(int)

setFlashCount

public static void setFlashCount(int flashCount)

设置绘制操作将要 flash 的次数。

flashCount

public static int flashCount()

绘制操作将要 flash 的次数。

另请参见：

setFlashCount(int)

setLogStream

public static void setLogStream(PrintStream stream)

设置 DebugGraphics 在其中记录绘制操作的流。

logStream

public static PrintStream logStream()

返回 DebugGraphics 在其中记录绘制操作的流。

另请参见：

setLogStream(java.io.PrintStream)

setFont

public void setFont(Font aFont)

设置用于文本绘制操作的 Font。

指定者：

类 Graphics 中的 setFont

参数：

aFont - 字体。

另请参见：

Graphics.getFont(), Graphics.drawString(java.lang.String, int, int), Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

getFont

public Font getFont()

返回用于文本绘制操作的 Font。

指定者：

类 Graphics 中的 getFont

返回：

此图形上下文的当前字体。

另请参见：

setFont(java.awt.Font)

setColor

public void setColor(Color aColor)

设置用于绘制和填充线条和图形的颜色。

指定者：

类 Graphics 中的 setColor

参数：

aColor - 新的呈现颜色。

另请参见：

Color, Graphics.getColor()

getColor

public Color getColor()

返回用于文本绘制操作的 Color。

指定者：

类 Graphics 中的 getColor

返回：

此图形上下文的当前颜色。

另请参见：

setColor(java.awt.Color)

getFontMetrics

public FontMetrics getFontMetrics()

重写 Graphics.getFontMetrics。

覆盖：

类 Graphics 中的 getFontMetrics

返回：

此图形上下文当前字体的字体规格。

另请参见：

Graphics.getFont(), FontMetrics, Graphics.getFontMetrics(Font)

getFontMetrics

public FontMetrics getFontMetrics(Font f)

重写 Graphics.getFontMetrics。

指定者：

类 Graphics 中的 getFontMetrics

参数：

f - 指定的字体

返回：

指定字体的字体规格。

另请参见：

Graphics.getFont(), FontMetrics, Graphics.getFontMetrics()

translate

public void translate(int x,
                      int y)

重写 Graphics.translate。

指定者：

类 Graphics 中的 translate

参数：

x - x 坐标。

y - y 坐标。

setPaintMode

public void setPaintMode()

重写 Graphics.setPaintMode。

指定者：

类 Graphics 中的 setPaintMode

setXORMode

public void setXORMode(Color aColor)

重写 Graphics.setXORMode。

指定者：

类 Graphics 中的 setXORMode

参数：

aColor - XOR 交替颜色

getClipBounds

public Rectangle getClipBounds()

重写 Graphics.getClipBounds。

指定者：

类 Graphics 中的 getClipBounds

返回：

当前剪贴区域的边界矩形；如果未设置剪贴区，则返回 null。

另请参见：

Graphics.getClip(), Graphics.clipRect(int, int, int, int), Graphics.setClip(int, int, int, int), Graphics.setClip(Shape)

clipRect

public void clipRect(int x,
                     int y,
                     int width,
                     int height)

重写 Graphics.clipRect。

指定者：

类 Graphics 中的 clipRect

参数：

x - 要与剪贴区相交的矩形的 x 坐标

y - 要与剪贴区相交的矩形的 y 坐标

width - 要与剪贴区相交的矩形的宽度

height - 要与剪贴区相交的矩形的高度

另请参见：

Graphics.setClip(int, int, int, int), Graphics.setClip(Shape)

setClip

public void setClip(int x,
                    int y,
                    int width,
                    int height)

重写 Graphics.setClip。

指定者：

类 Graphics 中的 setClip

参数：

x - 新剪贴区矩形的 x 坐标。

y - 新剪贴区矩形的 y 坐标。

width - 新剪贴区矩形的宽度。

height - 新剪贴区矩形的高度。

另请参见：

Graphics.clipRect(int, int, int, int), Graphics.setClip(Shape), Graphics.getClip()

getClip

public Shape getClip()

重写 Graphics.getClip。

指定者：

类 Graphics 中的 getClip

返回：

表示当前剪贴区域的 Shape 对象；如果未设置剪贴区，则返回 null。

另请参见：

Graphics.getClipBounds(), Graphics.clipRect(int, int, int, int), Graphics.setClip(int, int, int, int), Graphics.setClip(Shape)

setClip

public void setClip(Shape clip)

重写 Graphics.setClip。

指定者：

类 Graphics 中的 setClip

参数：

clip - 用来设置剪贴形状的 Shape

另请参见：

Graphics.getClip(), Graphics.clipRect(int, int, int, int), Graphics.setClip(int, int, int, int)

drawRect

public void drawRect(int x,
                     int y,
                     int width,
                     int height)

重写 Graphics.drawRect。

覆盖：

类 Graphics 中的 drawRect

参数：

x - 要绘制矩形的 x 坐标。

y - 要绘制矩形的 y 坐标。

width - 要绘制矩形的宽度。

height - 要绘制矩形的高度。

另请参见：

Graphics.fillRect(int, int, int, int), Graphics.clearRect(int, int, int, int)

fillRect

public void fillRect(int x,
                     int y,
                     int width,
                     int height)

重写 Graphics.fillRect。

指定者：

类 Graphics 中的 fillRect

参数：

x - 要填充矩形的 x 坐标。

y - 要填充矩形的 y 坐标。

width - 要填充矩形的宽度。

height - 要填充矩形的高度。

另请参见：

Graphics.clearRect(int, int, int, int), Graphics.drawRect(int, int, int, int)

clearRect

public void clearRect(int x,
                      int y,
                      int width,
                      int height)

重写 Graphics.clearRect。

指定者：

类 Graphics 中的 clearRect

参数：

x - 要清除矩形的 x 坐标。

y - 要清除矩形的 y 坐标。

width - 要清除矩形的宽度。

height - 要清除矩形的高度。

另请参见：

Graphics.fillRect(int, int, int, int), Graphics.drawRect(int, int, int, int), Graphics.setColor(java.awt.Color), Graphics.setPaintMode(), Graphics.setXORMode(java.awt.Color)

drawRoundRect

public void drawRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

重写 Graphics.drawRoundRect。

指定者：

类 Graphics 中的 drawRoundRect

参数：

x - 要绘制矩形的 x 坐标。

y - 要绘制矩形的 y 坐标。

width - 要绘制矩形的宽度。

height - 要绘制矩形的高度。

arcWidth - 4 个角弧度的水平直径。

arcHeight - 4 个角弧度的垂直直径。

另请参见：

Graphics.fillRoundRect(int, int, int, int, int, int)

fillRoundRect

public void fillRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

重写 Graphics.fillRoundRect。

指定者：

类 Graphics 中的 fillRoundRect

参数：

x - 要填充矩形的 x 坐标。

y - 要填充矩形的 y 坐标。

width - 要填充矩形的宽度。

height - 要填充矩形的高度。

arcWidth - 4 个角弧度的水平直径。

arcHeight - 4 个角弧度的垂直直径。

另请参见：

Graphics.drawRoundRect(int, int, int, int, int, int)

drawLine

public void drawLine(int x1,
                     int y1,
                     int x2,
                     int y2)

重写 Graphics.drawLine。

指定者：

类 Graphics 中的 drawLine

参数：

x1 - 第一个点的 x 坐标。

y1 - 第一个点的 y 坐标。

x2 - 第二个点的 x 坐标。

y2 - 第二个点的 y 坐标。

draw3DRect

public void draw3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

重写 Graphics.draw3DRect。

覆盖：

类 Graphics 中的 draw3DRect

参数：

x - 要绘制矩形的 x 坐标。

y - 要绘制矩形的 y 坐标。

width - 要绘制矩形的宽度。

height - 要绘制矩形的高度。

raised - 一个用于确定矩形是凸出平面显示还是凹入平面显示的 boolean 值。

另请参见：

Graphics.fill3DRect(int, int, int, int, boolean)

fill3DRect

public void fill3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

重写 Graphics.fill3DRect。

覆盖：

类 Graphics 中的 fill3DRect

参数：

x - 要填充矩形的 x 坐标。

y - 要填充矩形的 y 坐标。

width - 要填充矩形的宽度。

height - 要填充矩形的高度。

raised - 一个用于确定矩形是凸出平面显示还是凹入平面显示的 boolean 值。

另请参见：

Graphics.draw3DRect(int, int, int, int, boolean)

drawOval

public void drawOval(int x,
                     int y,
                     int width,
                     int height)

重写 Graphics.drawOval。

指定者：

类 Graphics 中的 drawOval

参数：

x - 要绘制椭圆的左上角的 x 坐标。

y - 要绘制椭圆的左上角的 y 坐标。

width - 要绘制椭圆的宽度。

height - 要绘制椭圆的高度。

另请参见：

Graphics.fillOval(int, int, int, int)

fillOval

public void fillOval(int x,
                     int y,
                     int width,
                     int height)

重写 Graphics.fillOval。

指定者：

类 Graphics 中的 fillOval

参数：

x - 要填充椭圆的左上角的 x 坐标。

y - 要填充椭圆的左上角的 y 坐标。

width - 要填充椭圆的宽度。

height - 要填充椭圆的高度。

另请参见：

Graphics.drawOval(int, int, int, int)

drawArc

public void drawArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

重写 Graphics.drawArc。

指定者：

类 Graphics 中的 drawArc

参数：

x - 要绘制弧的左上角的 x 坐标。

y - 要绘制弧的左上角的 y 坐标。

width - 要绘制弧的宽度。

height - 要绘制弧的高度。

startAngle - 开始角度。

arcAngle - 相对于开始角度而言，弧跨越的角度。

另请参见：

Graphics.fillArc(int, int, int, int, int, int)

fillArc

public void fillArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

重写 Graphics.fillArc。

指定者：

类 Graphics 中的 fillArc

参数：

x - 要填充弧的左上角的 x 坐标。

y - 要填充弧的左上角的 y 坐标。

width - 要填充弧的宽度。

height - 要填充弧的高度。

startAngle - 开始角度。

arcAngle - 相对于开始角度而言，弧跨越的角度。

另请参见：

Graphics.drawArc(int, int, int, int, int, int)

drawPolyline

public void drawPolyline(int[] xPoints,
                         int[] yPoints,
                         int nPoints)

重写 Graphics.drawPolyline。

指定者：

类 Graphics 中的 drawPolyline

参数：

xPoints - x 点数组

yPoints - y 点数组

nPoints - 点的总数

另请参见：

Graphics.drawPolygon(int[], int[], int)

drawPolygon

public void drawPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

重写 Graphics.drawPolygon。

指定者：

类 Graphics 中的 drawPolygon

参数：

xPoints - x 坐标数组。

yPoints - y 坐标数组。

nPoints - 点的总数。

另请参见：

Graphics.fillPolygon(int[], int[], int), Graphics.drawPolyline(int[], int[], int)

fillPolygon

public void fillPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

重写 Graphics.fillPolygon。

指定者：

类 Graphics 中的 fillPolygon

参数：

xPoints - x 坐标数组。

yPoints - y 坐标数组。

nPoints - 点的总数。

另请参见：

Graphics.drawPolygon(int[], int[], int)

drawString

public void drawString(String aString,
                       int x,
                       int y)

重写 Graphics.drawString。

指定者：

类 Graphics 中的 drawString

参数：

aString - 要绘制的 string。

x - x 坐标。

y - y 坐标。

另请参见：

Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

drawString

public void drawString(AttributedCharacterIterator iterator,
                       int x,
                       int y)

重写 Graphics.drawString。

指定者：

类 Graphics 中的 drawString

参数：

iterator - 要绘制其文本的迭代器

x - x 坐标。

y - y 坐标。

另请参见：

Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

drawBytes

public void drawBytes(byte[] data,
                      int offset,
                      int length,
                      int x,
                      int y)

重写 Graphics.drawBytes。

覆盖：

类 Graphics 中的 drawBytes

参数：

data - 要绘制的数据

offset - 数据的起始偏移量

length - 要绘制的字节数

x - 文本基线的 x 坐标

y - 文本基线的 y 坐标

另请参见：

Graphics.drawChars(char[], int, int, int, int), Graphics.drawString(java.lang.String, int, int)

drawChars

public void drawChars(char[] data,
                      int offset,
                      int length,
                      int x,
                      int y)

重写 Graphics.drawChars。

覆盖：

类 Graphics 中的 drawChars

参数：

data - 要绘制的字符数组

offset - 数据的初始偏移量

length - 要绘制的字符数

x - 文本基线的 x 坐标

y - 文本基线的 y 坐标

另请参见：

Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawString(java.lang.String, int, int)

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         ImageObserver observer)

重写 Graphics.drawImage。

指定者：

类 Graphics 中的 drawImage

参数：

img - 要绘制的指定图像。如果 img 为 null，则此方法不执行任何操作。

x - x 坐标。

y - y 坐标。

observer - 转换了更多图像时要通知的对象。

返回：

如果图像像素仍在更改，则返回 false；否则返回 true。

另请参见：

Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         ImageObserver observer)

重写 Graphics.drawImage。

指定者：

类 Graphics 中的 drawImage

参数：

img - 要绘制的指定图像。如果 img 为 null，则此方法不执行任何操作。

x - x 坐标。

y - y 坐标。

width - 矩形的宽度。

height - 矩形的高度。

observer - 转换了更多图像时要通知的对象。

返回：

如果图像像素仍在改变，则返回 false；否则返回 true。

另请参见：

Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         Color bgcolor,
                         ImageObserver observer)

重写 Graphics.drawImage。

指定者：

类 Graphics 中的 drawImage

参数：

img - 要绘制的指定图像。如果 img 为 null，则此方法不执行任何操作。

x - x 坐标。

y - y 坐标。

bgcolor - 在图像非透明部分下绘制的背景色。

observer - 当转换了更多图像时要通知的对象。

返回：

如果图像像素仍在改变，则返回 false；否则返回 true。

另请参见：

Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         Color bgcolor,
                         ImageObserver observer)

重写 Graphics.drawImage。

指定者：

类 Graphics 中的 drawImage

参数：

img - 要绘制的指定图像。如果 img 为 null，则此方法不执行任何操作。

x - x 坐标。

y - y 坐标。

width - 矩形的宽度。

height - 矩形的高度。

bgcolor - 在图像非透明部分下绘制的背景色。

observer - 当转换了更多图像时要通知的对象。

返回：

如果图像像素仍在改变，则返回 false；否则返回 true。

另请参见：

Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

drawImage

public boolean drawImage(Image img,
                         int dx1,
                         int dy1,
                         int dx2,
                         int dy2,
                         int sx1,
                         int sy1,
                         int sx2,
                         int sy2,
                         ImageObserver observer)

重写 Graphics.drawImage。

指定者：

类 Graphics 中的 drawImage

参数：

img - 要绘制的指定图像。如果 img 为 null，则此方法不执行任何操作。

dx1 - 目标矩形第一个角的 x 坐标。

dy1 - 目标矩形第一个角的 y 坐标。

dx2 - 目标矩形第二个角的 x 坐标。

dy2 - 目标矩形第二个角的 y 坐标。

sx1 - 源矩形第一个角的 x 坐标。

sy1 - 源矩形第一个角的 y 坐标。

sx2 - 源矩形第二个角的 x 坐标。

sy2 - 源矩形第二个角的 y 坐标。

observer - 当缩放并转换了更多图像时要通知的对象。

返回：

如果图像像素仍在改变，则返回 false；否则返回 true。

另请参见：

Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

drawImage

public boolean 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。

指定者：

类 Graphics 中的 drawImage

参数：

img - 要绘制的指定图像。如果 img 为 null，则此方法不执行任何操作。

dx1 - 目标矩形第一个角的 x 坐标。

dy1 - 目标矩形第一个角的 y 坐标。

dx2 - 目标矩形第二个角的 x 坐标。

dy2 - 目标矩形第二个角的 y 坐标。

sx1 - 源矩形第一个角的 x 坐标。

sy1 - 源矩形第一个角的 y 坐标。

sx2 - 源矩形第二个角的 x 坐标。

sy2 - 源矩形第二个角的 y 坐标。

bgcolor - 在图像非透明部分下绘制的背景色。

observer - 当缩放并转换了更多图像时要通知的对象。

返回：

如果图像像素仍在改变，则返回 false；否则返回 true。

另请参见：

Image, ImageObserver, ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

copyArea

public void copyArea(int x,
                     int y,
                     int width,
                     int height,
                     int destX,
                     int destY)

重写 Graphics.copyArea。

指定者：

类 Graphics 中的 copyArea

参数：

x - 源矩形的 x 坐标。

y - 源矩形的 y 坐标。

width - 源矩形的宽度。

height - 源矩形的高度。

destX - 复制像素的水平距离。

destY - 复制像素的垂直距离。

dispose

public void dispose()

重写 Graphics.dispose。

指定者：

类 Graphics 中的 dispose

另请参见：

Graphics.finalize(), Component.paint(java.awt.Graphics), Component.update(java.awt.Graphics), Component.getGraphics(), Graphics.create()

isDrawingBuffer

public boolean isDrawingBuffer()

返回 drawingBuffer 值。

返回：

如果此对象将从 Buffer 绘制，则返回 true

setDebugOptions

public void setDebugOptions(int options)

启用/禁用有关每个图形操作的诊断信息。options 的值指示应该如何显示此信息。LOG_OPTION 导致打印一条文本消息。FLASH_OPTION 导致绘制被 flash 多次。BUFFERED_OPTION 创建一个新 Frame，该框架显示屏幕外缓冲区中的每个操作。当前值是 options 值的按位或。要禁用调试，请使用 NONE_OPTION。

getDebugOptions

public int getDebugOptions()

返回此 DebugGraphics 的当前调试选项。

另请参见：

setDebugOptions(int)

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