javax.swing.plaf.nimbus

Class AbstractRegionPainter

java.lang.Object

javax.swing.plaf.nimbus.AbstractRegionPainter

All Implemented Interfaces:

Painter JComponent > <

public abstract class AbstractRegionPainter
extends Object
implements Painter<JComponent>

定义在雨云渲染一个地区或组件的基类实例方便画家。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractRegionPainter.PaintContext 一个在绘画时有用的类封装状态。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AbstractRegionPainter() 创建一个新的abstractregionpainter

方法摘要

Modifier and Type	Method and Description
protected void	configureGraphics(Graphics2D g) 配置了Graphics2D。
protected float	decodeAnchorX(float x, float dx) 解码并返回表示实际像素位置的锚点给出编码的x值的控制点的浮动值，并且偏移距离从控制点锚。
protected float	decodeAnchorY(float y, float dy) 解码并返回表示实际像素位置的锚点给出编码的Y值的控制点的浮动值，并且偏移距离从控制点锚。
protected Color	decodeColor(Color color1, Color color2, float midPoint) 解码并返回一个颜色，这是来自一个偏移的另外两种颜色之间。
protected Color	decodeColor(String key, float hOffset, float sOffset, float bOffset, int aOffset) 解码并返回一个颜色，这是来自一个UI默认底色。
protected LinearGradientPaint	decodeGradient(float x1, float y1, float x2, float y2, float[] midpoints, Color[] colors) 创建一个lineargradientpaint给定参数，此方法将创建并返回一个线性渐变油漆。
protected RadialGradientPaint	decodeRadialGradient(float x, float y, float r, float[] midpoints, Color[] colors) 创建RadialGradientPaint给出的参数，此方法将创建并返回一个径向渐变油漆。
protected float	decodeX(float x) 解码并返回一个表示该编码的X值的实际像素位置的浮点值。
protected float	decodeY(float y) 解码并返回一个表示该编码的Y值的实际像素位置的浮点值。
protected abstract void	doPaint(Graphics2D g, JComponent c, int width, int height, Object[] extendedCacheKeys) 实际执行喷漆操作。
protected Color	getComponentColor(JComponent c, String property, Color defaultColor, float saturationOffset, float brightnessOffset, int alphaOffset) 从给定的组件得到颜色属性。
protected Object[]	getExtendedCacheKeys(JComponent c) 获得额外的属性，画家实现想包括在图像高速缓存查找。
protected abstract AbstractRegionPainter.PaintContext	getPaintContext() 获取此操作的paintcontext。
void	paint(Graphics2D g, JComponent c, int w, int h) 对于给定的 Graphics2D对象。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractRegionPainter

protected AbstractRegionPainter()

创建一个新的abstractregionpainter

方法详细信息

paint

public final void paint(Graphics2D g,
                        JComponent c,
                        int w,
                        int h)

对于给定的Graphics2D对象。此方法的实现可以在Graphics2D修改状态，而不需要恢复的状态完成后。在大多数情况下，建议在一个划痕图形对象中调用调用方。Graphics2D绝不是空的。

对图形对象的状态可能被paint方法，但不得。例如，设置抗锯齿渲染提示图形可能或不可能实现的Painter尊敬。

所提供的对象参数作为一个可选的配置参数。例如，它可以Component型，预期它可以从Component读状态和使用状态的绘画Painter。例如，一个实现可能读的底色和使用。

一般来说，为了提高可重用性，最标准的Painters忽略此参数。因此，他们可以在任何上下文中重用。object可能是空的。实现必须不若对象参数为空抛出一个NullPointerException。

最后，该width和height参数指定的Painter应漆成的宽度和高度。更具体地说，指定的宽度和高度指示画家，它应该画在这个宽度和高度。任何指定的夹在g参数将进一步限制区。

例如，假设我有一个Painter实施使梯度。梯度从白到黑。它“延伸”，以填补画的区域。因此，如果我用这Painter画一个500×500的区域，左边是黑色，右边是白色的，和一个平滑的梯度会画之间。然后我可以，无需修改，使用Painter油漆是20x20大小区。这一区域也将是黑色的左边，白色的右边，和一个光滑的梯度之间画的。

Specified by:

paint 接口 Painter<JComponent>

参数

g - Graphics2D渲染。这不能为空。

c可选配置参数。这可能是空的。

w的宽度画。

h地区的高度画。

getExtendedCacheKeys

protected Object[] getExtendedCacheKeys(JComponent c)

获得额外的属性，画家实现想包括在图像高速缓存查找。这是检查每一个调用的油漆（G，C，W，H）方法。

参数

在目前的涂料 c调用组件

结果

将要包含在高速缓冲存储器中的额外对象数组

getPaintContext

protected abstract AbstractRegionPainter.PaintContext getPaintContext()

获取此操作的paintcontext。这种方法被称为在每一个油漆，所以应该是快速，不会产生垃圾。的paintcontext包含的信息，如缓存提示。它也包含解码点运行的必要数据，如拉伸镶，画布大小的编码点的定义，以及是否拉伸的小图是倒。

这种方法允许子类可能具有不同的画布大小等不同国家的绘画包，到一个abstractregionpainter实施。

结果

与此相关的paintcontext油漆作业。

configureGraphics

protected void configureGraphics(Graphics2D g)

配置了Graphics2D。经常，渲染暗示或合成规则应用到之前画一个Graphics2D对象，将影响所有后续的绘画操作。此方法提供了一个方便的钩子来配置图形对象在渲染之前，无论渲染操作是否执行到中间缓冲区或直接到显示。

参数

g -配置Graphics2D对象。不会是空的。

doPaint

protected abstract void doPaint(Graphics2D g,
                                JComponent c,
                                int width,
                                int height,
                                Object[] extendedCacheKeys)

实际执行喷漆操作。子类必须实现此方法。通过的图形对象可以表示实际的被渲染的表面，或者它可能是一个中间缓冲区。它也被预先翻译。简单的渲染的成分好像是位于0，0和有一个宽度和高度 height width。出于性能原因，你可能想从Graphics2D对象读卡只渲染在空间。

参数

g - Graphics2D表面涂料

c -绘图事件相关的组件。例如，如果该地区呈现 c按钮，然后将一个JButton。如果该区域被画的是ScrollBarSlider，那么组件将使用。此值可能为空。

width区域的油漆宽度。请注意，在画面的前景的情况下，这个值可能不同于getwidth() C.。

height区域的高度画。请注意，在画面的前景的情况下，这个值可能不同于getheight() C.。

extendedCacheKeys -调用的结果getextendedcachekeys()

decodeX

protected final float decodeX(float x)

解码并返回一个表示该编码的X值的实际像素位置的浮点值。

参数

x -编码的x值（0…1，2，或2或1……3）

结果

解码X值

异常

IllegalArgumentException -如果 x < 0或 x > 3

decodeY

protected final float decodeY(float y)

解码并返回一个表示该编码的Y值的实际像素位置的浮点值。

参数

y -编码的Y值（0…1，2，或2或1……3）

结果

解码后的Y值

异常

IllegalArgumentException -如果 y < 0或 y > 3

decodeAnchorX

protected final float decodeAnchorX(float x,
                                    float dx)

解码并返回表示实际像素位置的锚点给出编码的x值的控制点的浮动值，并且偏移距离从控制点锚。

参数

x -编码的X值的Bezier控制点（0…1，2，或2或1……3）

dx -偏移距离的锚从控制点X

结果

控制点的解码X位置

异常

IllegalArgumentException -如果 x < 0或 x > 3

decodeAnchorY

protected final float decodeAnchorY(float y,
                                    float dy)

解码并返回表示实际像素位置的锚点给出编码的Y值的控制点的浮动值，并且偏移距离从控制点锚。

参数

y -编码的Y值的Bezier控制点（0…1，2，或2或1……3）

dy -偏移距离控制点Y锚

结果

控制点的解码Y位置

异常

IllegalArgumentException -如果 y < 0或 y > 3

decodeColor

protected final Color decodeColor(String key,
                                  float hOffset,
                                  float sOffset,
                                  float bOffset,
                                  int aOffset)

解码并返回一个颜色，这是来自一个UI默认底色。

参数

key -一个键所对应的值在UI默认表”在基地的颜色定义

hOffset -色相偏移用于推导。

sOffset -饱和度偏用于推导。

bOffset -亮度偏移用于推导。

aOffset -阿尔法偏移用于推导。在0……255

结果

得出的颜色，其颜色值会发生变化，如果家长uidefault颜色变化。

decodeColor

protected final Color decodeColor(Color color1,
                                  Color color2,
                                  float midPoint)

解码并返回一个颜色，这是来自一个偏移的另外两种颜色之间。

参数

color1 -第一个颜色

color2 -第二颜色

midPoint 1色和色之间的偏移值2，0是1，1是颜色2色；

结果

派生的颜色

decodeGradient

protected final LinearGradientPaint decodeGradient(float x1,
                                                   float y1,
                                                   float x2,
                                                   float y2,
                                                   float[] midpoints,
                                                   Color[] colors)

创建一个lineargradientpaint给定参数，此方法将创建并返回一个线性渐变油漆。这种方法的一个主要目的是避免创建一个lineargradientpaint，起点和终点都是平等的。在这种情况下，结束Y点略有增加，以避免重叠。

参数

x1—

y1—

x2—

y2—

midpoints—

colors—

结果

一个有效的lineargradientpaint。此方法从不返回空值。

异常

NullPointerException -如果 midpoints数组为空，或 colors数组是空的，

IllegalArgumentException如果起点和终点是同一点，或 midpoints.length != colors.length，或 colors小于2的大小，或 midpoints值小于0或大于1，或 midpoints不是严格递增的顺序设置

decodeRadialGradient

protected final RadialGradientPaint decodeRadialGradient(float x,
                                                         float y,
                                                         float r,
                                                         float[] midpoints,
                                                         Color[] colors)

创建RadialGradientPaint给出的参数，此方法将创建并返回一个径向渐变油漆。这种方法的一个主要目的是避免radialgradientpaint当半径为非正。在这种情况下，半径只是略有增加，以避免0。

参数

x—

y—

r—

midpoints—

colors—

结果

一个有效的radialgradientpaint。此方法从不返回空值。

异常

NullPointerException -如果 midpoints数组为空，或 colors数组是空的

IllegalArgumentException -如果 r是非积极的，或 midpoints.length != colors.length，或 colors小于2的大小，或 midpoints值小于0或大于1，或 midpoints不是严格递增的顺序设置

getComponentColor

protected final Color getComponentColor(JComponent c,
                                        String property,
                                        Color defaultColor,
                                        float saturationOffset,
                                        float brightnessOffset,
                                        int alphaOffset)

从给定的组件得到颜色属性。首先检查一 getXXX()方法如果失败，一个关键 property客户端性能检查。如果仍然不能返回一个颜色然后 defaultColor返回。

参数

c -从颜色属性的组件

property -一个bean样式属性或客户财产

defaultColor的颜色如果从组件没有得到返色。

结果

颜色是从组件或defaultcolor获得