所有呈现操作仅修改当前剪贴区所限定区域内的像素，此剪贴区是由用户空间中的 Shape 指定的，并且通过使用 Graphics 对象的程序来控制。此用户剪贴区 被转换到设备空间中，并且与设备剪贴区 组合，后者是通过窗口可见性和设备范围定义的。用户剪贴区和设备剪贴区的组合定义了复合剪贴区，它确定了最终的剪贴区域。用户剪贴区不能由呈现系统修改，以反映得到的复合剪贴区。用户剪贴区只能通过 setClip 或 clipRect 方法更改。所有的绘制或写入都以当前的颜色、当前绘图模式和当前字体完成的。

从以下版本开始：: JDK1.0
另请参见：: Component, clipRect(int, int, int, int), setColor(java.awt.Color), setPaintMode(), setXORMode(java.awt.Color), setFont(java.awt.Font)

构造方法摘要
`protected`	`Graphics()` 构造一个新的 `Graphics` 对象。

方法摘要
`abstract void`	`clearRect(int x, int y, int width, int height)` 通过使用当前绘图表面的背景色进行填充来清除指定的矩形。
`abstract void`	`clipRect(int x, int y, int width, int height)` 将当前剪贴区与指定的矩形相交。
`abstract void`	`copyArea(int x, int y, int width, int height, int dx, int dy)` 将组件的区域复制到由 `dx` 和 `dy` 指定的距离处。
`abstract Graphics`	`create()` 创建一个新的 `Graphics` 对象，它是此 `Graphics` 对象的副本。
`Graphics`	`create(int x, int y, int width, int height)` 基于此 `Graphics` 对象创建一个新的 `Graphics` 对象，但是使用新的转换和剪贴区域。
`abstract void`	`dispose()` 释放此图形的上下文并释放它所使用的所有系统资源。
`void`	`draw3DRect(int x, int y, int width, int height, boolean raised)` 绘制指定矩形的 3-D 突出显示边框。
`abstract void`	`drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)` 绘制一个覆盖指定矩形的圆弧或椭圆弧边框。
`void`	`drawBytes(byte[] data, int offset, int length, int x, int y)` 使用此图形上下文的当前字体和颜色绘制由指定的 byte 数组给定的文本。
`void`	`drawChars(char[] data, int offset, int length, int x, int y)` 使用此图形上下文的当前字体和颜色绘制由指定字符数组给定的文本。
`abstract boolean`	`drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer)` 绘制指定图像中当前可用的图像。
`abstract boolean`	`drawImage(Image img, int x, int y, ImageObserver observer)` 绘制指定图像中当前可用的图像。
`abstract boolean`	`drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer)` 绘制指定图像中已缩放到适合指定矩形内部的图像。
`abstract boolean`	`drawImage(Image img, int x, int y, int width, int height, ImageObserver observer)` 绘制指定图像中已缩放到适合指定矩形内部的图像。
`abstract boolean`	`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`	`drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer)` 绘制当前可用的指定图像的指定区域，动态地缩放图像使其符合目标绘制表面的指定区域。
`abstract void`	`drawLine(int x1, int y1, int x2, int y2)` 在此图形上下文的坐标系统中，使用当前颜色在点 `(x1, y1)` 和 `(x2, y2)` 之间画一条线。
`abstract void`	`drawOval(int x, int y, int width, int height)` 绘制椭圆的边框。
`abstract void`	`drawPolygon(int[] xPoints, int[] yPoints, int nPoints)` 绘制一个由 x 和 y 坐标数组定义的闭合多边形。
`void`	`drawPolygon(Polygon p)` 绘制由指定的 `Polygon` 对象定义的多边形边框。
`abstract void`	`drawPolyline(int[] xPoints, int[] yPoints, int nPoints)` 绘制由 x 和 y 坐标数组定义的一系列连接线。
`void`	`drawRect(int x, int y, int width, int height)` 绘制指定矩形的边框。
`abstract void`	`drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)` 用此图形上下文的当前颜色绘制圆角矩形的边框。
`abstract void`	`drawString(AttributedCharacterIterator iterator, int x, int y)` 使用此图形上下文的当前颜色绘制由指定迭代器给定的文本。
`abstract void`	`drawString(String str, int x, int y)` 使用此图形上下文的当前字体和颜色绘制由指定 string 给定的文本。
`void`	`fill3DRect(int x, int y, int width, int height, boolean raised)` 绘制一个用当前颜色填充的 3-D 突出显示矩形。
`abstract void`	`fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)` 填充覆盖指定矩形的圆弧或椭圆弧。
`abstract void`	`fillOval(int x, int y, int width, int height)` 使用当前颜色填充外接指定矩形框的椭圆。
`abstract void`	`fillPolygon(int[] xPoints, int[] yPoints, int nPoints)` 填充由 x 和 y 坐标数组定义的闭合多边形。
`void`	`fillPolygon(Polygon p)` 用图形上下文的当前颜色填充由指定的 Polygon 对象定义的多边形。
`abstract void`	`fillRect(int x, int y, int width, int height)` 填充指定的矩形。
`abstract void`	`fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)` 用当前颜色填充指定的圆角矩形。
`void`	`finalize()` 一旦不再引用此图形上下文就释放它。
`abstract Shape`	`getClip()` 获取当前的剪贴区域。
`abstract Rectangle`	`getClipBounds()` 返回当前剪贴区域的边界矩形。
`Rectangle`	`getClipBounds(Rectangle r)` 返回当前剪贴区域的边界矩形。
`Rectangle`	`getClipRect()` 已过时。从 JDK version 1.1 开始，由 `getClipBounds()` 取代。
`abstract Color`	`getColor()` 获取此图形上下文的当前颜色。
`abstract Font`	`getFont()` 获取当前字体。
`FontMetrics`	`getFontMetrics()` 获取当前字体的字体规格。
`abstract FontMetrics`	`getFontMetrics(Font f)` 获取指定字体的字体规格。
`boolean`	`hitClip(int x, int y, int width, int height)` 如果指定的矩形区域与当前的剪贴区域相交，则返回 true。
`abstract void`	`setClip(int x, int y, int width, int height)` 将当前的剪贴区设置为由给定坐标指定的矩形。
`abstract void`	`setClip(Shape clip)` 将当前的剪贴区域设置为任意的剪贴形状。
`abstract void`	`setColor(Color c)` 将此图形上下文的当前颜色设置为指定颜色。
`abstract void`	`setFont(Font font)` 将此图形上下文的字体设置为指定字体。
`abstract void`	`setPaintMode()` 设置将此图形上下文的绘图模式，以便通过此图形上下文中的当前颜色来改写目标。
`abstract void`	`setXORMode(Color c1)` 将此图形下文的绘图模式设置为在此图形上下文的当前颜色和新的指定颜色之间交替。
`String`	`toString()` 返回表示此 `Graphics` 对象值的 `String` 对象。
`abstract void`	`translate(int x, int y)` 将图形上下文的原点平移到当前坐标系统中的点 (x, y)。

从类 java.lang.Object 继承的方法
`clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait`

构造方法详细信息

Graphics

protected Graphics()

构造一个新的 Graphics 对象。此构造方法是用于图形上下文的默认构造方法。

因为 Graphics 是一个抽象类，所以应用程序不能直接调用此构造方法。图形上下文从其他图形上下文获取，或者通过在组件上调用 getGraphics 来创建。

另请参见：: create(), Component.getGraphics()

方法详细信息

create

public abstract Graphics create()

创建一个新的 Graphics 对象，它是此 Graphics 对象的副本。

返回：: 新的图形上下文，它是此图形上下文的副本。

create

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

基于此 Graphics 对象创建一个新的 Graphics 对象，但是使用新的转换和剪贴区域。新 Graphics 对象的原点平移到指定点 (x, y)。其剪贴区域由原始剪贴区域和指定矩形的交集确定。各个参数均在原始 Graphics 对象的坐标系统内进行解释。新图形上下文除以下两方面之外，其他与原始图形上下文相同：

新的图形上下文平移了 (x, y)。也就是说，新图形上下文中的点 (0, 0) 与原始图形上下文中的点 (x, y) 相同。
新图形上下文除了具有一个从原始图形上下文继承的（平移的）剪贴矩形之外，还有一个额外的剪贴矩形，新剪贴矩形的原点为 (0, 0)，其大小由 width 和 height 参数指定。

参数：: x - x 坐标。; y - y 坐标。; width - 剪贴矩形的宽度。; height - 剪贴矩形的高度。
返回：: 新的图形上下文。
另请参见：: translate(int, int), clipRect(int, int, int, int)

translate

public abstract void translate(int x,
                               int y)

将图形上下文的原点平移到当前坐标系统中的点 (x, y)。修改此图形上下文，使其新的原点对应于此图形上下文原始坐标系统中的点 (x, y)。在此图形上下文上执行的后续呈现操作使用的所有坐标均相对于这个新原点。

参数：: x - x 坐标。; y - y 坐标。

getColor

public abstract Color getColor()

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

返回：: 此图形上下文的当前颜色。
另请参见：: Color, setColor(Color)

setColor

public abstract void setColor(Color c)

将此图形上下文的当前颜色设置为指定颜色。使用此图形上下文的所有后续图形操作均使用这个指定的颜色。

参数：: c - 新的呈现颜色。
另请参见：: Color, getColor()

setPaintMode

public abstract void setPaintMode()

设置将此图形上下文的绘图模式，以便通过此图形上下文中的当前颜色来改写目标。这将逻辑像素操作函数设置为绘图模式或改写模式。所有后续呈现操作将使用当前颜色改写目标。

setXORMode

public abstract void setXORMode(Color c1)

将此图形下文的绘图模式设置为在此图形上下文的当前颜色和新的指定颜色之间交替。这指定了逻辑像素操作以 XOR 模式执行，在此模式中像素在当前颜色和指定的 XOR 颜色之间进行交替。

当执行绘制操作时，当前颜色的像素改变为指定的颜色，反之亦然。

颜色为这两种颜色以外的像素以不可预测但可逆的方式改变；如果相同的图形被绘制两次，则所有像素恢复到原始值。

参数：: c1 - XOR 交替颜色

本文分类：JavaAPI
本文标签：JavaAPI JDK5 Java5
浏览次数：171 次浏览
本文链接：/javaapi/3665.html