JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 GradientPaint

java.lang.Object
  继承者 java.awt.GradientPaint
所有已实现的接口:
Paint, Transparency

public class GradientPaint
extends Object
implements Paint

GradientPaint 类提供了使用线性颜色渐变模式填充 Shape 的方法。如果在用户空间指定了 Point P1 的 Color 为 C1,Point P2 的 Color 为 C2,则 P1、P2 连接线上的 Color 是逐渐地从 C1 变化到 C2 的。任何不在 P1、P2 延长线上的点 P 都具有点 P' 的颜色,P' 是 P1、P2 延长线上点 P 的垂直投影。P1、P2 段以外的延长线上的点可以按以下两种方式之一进行着色。

另请参见:
Paint, Graphics2D.setPaint(java.awt.Paint)

字段摘要
 
从接口 java.awt.Transparency 继承的字段
BITMASK, OPAQUE, TRANSLUCENT
 
构造方法摘要
GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2)
          构造一个简单的非周期性 GradientPaint 对象。
GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2, boolean cyclic)
          根据 boolean 参数构造一个周期性或非周期性的 GradientPaint 对象。
GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2)
          构造一个简单的非周期性 GradientPaint 对象。
GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2, boolean cyclic)
          根据 boolean 参数构造一个周期性或非周期性的 GradientPaint 对象。
 
方法摘要
 PaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
          创建并返回用来生成颜色模式的上下文。
 Color getColor1()
          返回点 P1 的颜色 C1。
 Color getColor2()
          返回点 P2 的颜色 C2。
 Point2D getPoint1()
          返回着第一种颜色的点 P1 的副本。
 Point2D getPoint2()
          返回着第二种颜色的点 P2 的副本。
 int getTransparency()
          返回此 GradientPaint 的透明度模式。
 boolean isCyclic()
          如果渐变在两种颜色 C1 和 C2 之间重复循环,则返回 true
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

GradientPaint

public GradientPaint(float x1,
                     float y1,
                     Color color1,
                     float x2,
                     float y2,
                     Color color2)
构造一个简单的非周期性 GradientPaint 对象。

参数:
x1 - 用户空间中第一个指定 Point 的 x 坐标
y1 - 用户空间中第一个指定 Point 的 y 坐标
color1 - 第一个指定 Point 处的 Color
x2 - 用户空间中第二个指定 Point 的 x 坐标
y2 - 用户空间中第二个指定 Point 的 y 坐标
color2 - 第二个指定 Point 处的 Color
抛出:
NullPointerException - 如果任何一个 color 为 null

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2)
构造一个简单的非周期性 GradientPaint 对象。

参数:
pt1 - 用户空间中第一个指定的 Point
color1 - 第一个指定 Point 处的 Color
pt2 - 用户空间中第二个指定的 Point
color2 - 第二个指定 Point 处的 Color
抛出:
NullPointerException - 如果任何一个 color 或 point 为 null

GradientPaint

public GradientPaint(float x1,
                     float y1,
                     Color color1,
                     float x2,
                     float y2,
                     Color color2,
                     boolean cyclic)
根据 boolean 参数构造一个周期性或非周期性的 GradientPaint 对象。

参数:
x1 - 用户空间中第一个指定 Point 的 x 坐标
y1 - 用户空间中第一个指定 Point 的 y 坐标
color1 - 第一个指定 Point 处的 Color
x2 - 用户空间中第二个指定 Point 的 x 坐标
y2 - 用户空间中第二个指定 Point 的 y 坐标
color2 - 第二个指定 Point 处的 Color
cyclic - 如果渐变模式在两种颜色之间重复循环,则为 true;否则为 false

GradientPaint

public GradientPaint(Point2D pt1,
                     Color color1,
                     Point2D pt2,
                     Color color2,
                     boolean cyclic)
根据 boolean 参数构造一个周期性或非周期性的 GradientPaint 对象。

参数:
pt1 - 用户空间中第一个指定的 Point
color1 - 第一个指定 Point 处的 Color
pt2 - 用户空间中第二个指定的 Point
color2 - 第二个指定 Point 处的 Color
cyclic - 如果渐变模式在两种颜色之间重复循环,则为 true;否则为 false
方法详细信息

getPoint1

public Point2D getPoint1()
返回着第一种颜色的点 P1 的副本。

返回:
Point2D 对象,它是着 GradientPaint 的第一种颜色的点的副本。

getColor1

public Color getColor1()
返回点 P1 的颜色 C1。

返回:
Color 对象,P1 的颜色。

getPoint2

public Point2D getPoint2()
返回着第二种颜色的点 P2 的副本。

返回:
Point2D 对象,它是着 GradientPaint 的第二种颜色的点的副本。

getColor2

public Color getColor2()
返回点 P2 的颜色 C2。

返回:
Color 对象,P2 的颜色。

isCyclic

public boolean isCyclic()
如果渐变在两种颜色 C1 和 C2 之间重复循环,则返回 true

返回:
如果渐变在两种颜色之间重复循环,则返回 true;否则返回 false

createContext

public PaintContext createContext(ColorModel cm,
                                  Rectangle deviceBounds,
                                  Rectangle2D userBounds,
                                  AffineTransform xform,
                                  RenderingHints hints)
创建并返回用来生成颜色模式的上下文。

指定者:
接口 Paint 中的 createContext
参数:
cm - 接收 Paint 数据的 ColorModel。这仅作为提示使用。
deviceBounds - 正在呈现的图形图元的设备空间边界框
userBounds - 正在呈现的图形图元的用户空间边界框
xform - 从用户空间到设备空间的 AffineTransform
hints - context 对象用于选择所呈现内容的提示
返回:
生成颜色模式的 PaintContext
另请参见:
PaintContext

getTransparency

public int getTransparency()
返回此 GradientPaint 的透明度模式。

指定者:
接口 Transparency 中的 getTransparency
返回:
一个整数值,表示此 GradientPaint 对象的透明度模式。
另请参见:
Transparency

JavaTM 2 Platform
Standard Ed. 5.0

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

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