|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.awt
类 Graphics
java.lang.Object java.awt.Graphics
- 直接已知子类:
- DebugGraphics, Graphics2D
-
public abstract class Graphics
- extends Object
Graphics
类是所有图形上下文的抽象基类,允许应用程序可以在组件(已经在各种设备上实现),以及闭屏图像上,进行绘制。
Graphics
对象封装了 Java 支持的基本呈现操作所需的状态信息。此状态信息包括以下属性:
- 要在其上绘制的
Component
对象。 - 呈现和剪贴坐标的转换原点。
- 当前剪贴区。
- 当前颜色。
- 当前字体。
- 当前的逻辑像素操作函数(XOR 或 Paint)。
- 当前 XOR 交替颜色(参见
setXORMode(java.awt.Color)
)。
坐标是无限细分的,并且位于输出设备的像素之间。绘制图形轮廓的操作是通过使用像素大小的画笔遍历像素间无限细分路径的操作,画笔从路径上的锚点向下和向右绘制。填充图形的操作是填充图形内部区域无限细分路径操作。呈现水平文本的操作是呈现字符字形完全位于基线坐标之上的上升部分。
图形画笔从要遍历的路径向下和向右绘制。这有以下含义:
- 如果绘制一个覆盖给定矩形的图形,那么该图形与填充被相同矩形所限定的图形相比,在右侧和底边多占用一行像素。
- 如果沿着与一行文本基线相同的 y 坐标绘制一条水平线,那么除了文字的所有下降部分外,该线完全画在文本的下面。
所有作为此 Graphics
对象方法的参数而出现的坐标,都是相对于调用该方法前的此 Graphics
对象转换原点的。
所有呈现操作仅修改当前剪贴区所限定区域内的像素,此剪贴区是由用户空间中的 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, y)。也就是说,新图形上下文中的点 (
-
- 参数:
-
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 交替颜色