javax.swing.plaf.synth
类 SynthGraphicsUtils

java.lang.Object
  javax.swing.plaf.synth.SynthGraphicsUtils

public class SynthGraphicsUtils
extends Object

用于基本图形调用的包装器。

从以下版本开始：

1.5

构造方法摘要

SynthGraphicsUtils()
创建一个 SynthGraphicsUtils。

方法摘要

int	computeStringWidth(SynthContext ss, Font font, FontMetrics metrics, String text) 返回传入字符串的大小。
void	drawLine(SynthContext context, Object paintKey, Graphics g, int x1, int y1, int x2, int y2) 在两个端点之间绘制一条线。
void	drawLine(SynthContext context, Object paintKey, Graphics g, int x1, int y1, int x2, int y2, Object styleKey) 在两个端点之间绘制一条线。
int	getMaximumCharHeight(SynthContext context) 根据传入的 SynthContext 返回 Font 的最大高度。
Dimension	getMaximumSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex) 返回正确呈现图标和文本所需的最大大小。
Dimension	getMinimumSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex) 返回正确呈现图标和文本所需的最小大小。
Dimension	getPreferredSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex) 返回正确呈现图标和文本所需的首选大小。
String	layoutText(SynthContext ss, FontMetrics fm, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int iconTextGap) 根据通过引用返回的放置图标和文本的位置，布局文本和图标。
void	paintText(SynthContext ss, Graphics g, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex, int textOffset) 绘制图标和文本。
void	paintText(SynthContext ss, Graphics g, String text, int x, int y, int mnemonicIndex) 在指定位置上绘制文本。
void	paintText(SynthContext ss, Graphics g, String text, Rectangle bounds, int mnemonicIndex) 在指定位置上绘制文本。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

SynthGraphicsUtils

public SynthGraphicsUtils()

创建一个 SynthGraphicsUtils。

方法详细信息

drawLine

public void drawLine(SynthContext context,
                     Object paintKey,
                     Graphics g,
                     int x1,
                     int y1,
                     int x2,
                     int y2)

在两个端点之间绘制一条线。

参数：

context - 指示承载区域。

paintKey - 标识请求绘制的组件部分，可以为 null。

g - 要绘制的 Graphics 对象

x1 - x 原点

y1 - y 原点

x2 - x 目标

y2 - y 目标

drawLine

public void drawLine(SynthContext context,
                     Object paintKey,
                     Graphics g,
                     int x1,
                     int y1,
                     int x2,
                     int y2,
                     Object styleKey)

在两个端点之间绘制一条线。

此实现只支持一个线风格键 "dashed"。"dashed" 线风格只应用于垂直和水平的线。

指定 null 或任何 "dashed" 以外的键将绘制出实线。

参数：

context - 指示承载区域

paintKey - 标识请求绘制的组件部分，可以为 null。

g - 要绘制的 Graphics 对象

x1 - x 原点

y1 - y 原点

x2 - x 目标

y2 - y 目标

styleKey - 标识所请求的线风格（例如，"dashed"）

从以下版本开始：

1.6

layoutText

public String layoutText(SynthContext ss,
                         FontMetrics fm,
                         String text,
                         Icon icon,
                         int hAlign,
                         int vAlign,
                         int hTextPosition,
                         int vTextPosition,
                         Rectangle viewR,
                         Rectangle iconR,
                         Rectangle textR,
                         int iconTextGap)

根据通过引用返回的放置图标和文本的位置，布局文本和图标。

参数：

ss - SynthContext

fm - 将使用的 Font 的 FontMetric，该参数可以忽略

text - 要布置的文本

icon - 要布置的图标

hAlign - 水平对齐方式

vAlign - 垂直对齐方式

hTextPosition - 水平文本位置

vTextPosition - 垂直文本位置

viewR - 在其中布置文本和图标的矩形。

iconR - 将图标边界放入其中的矩形

textR - 将文本放入其中的矩形

iconTextGap - 图标和文本之间的间隙

computeStringWidth

public int computeStringWidth(SynthContext ss,
                              Font font,
                              FontMetrics metrics,
                              String text)

返回传入字符串的大小。

参数：

ss - SynthContext

font - 要使用的字体

metrics - FontMetrics，可以忽略

text - 将获得其大小的文本。

getMinimumSize

public Dimension getMinimumSize(SynthContext ss,
                                Font font,
                                String text,
                                Icon icon,
                                int hAlign,
                                int vAlign,
                                int hTextPosition,
                                int vTextPosition,
                                int iconTextGap,
                                int mnemonicIndex)

返回正确呈现图标和文本所需的最小大小。

参数：

ss - SynthContext

font - 要使用的字体

text - 要布置的文本

icon - 要布置的图标

hAlign - 水平对齐方式

vAlign - 垂直对齐方式

hTextPosition - 水平文本位置

vTextPosition - 垂直文本位置

iconTextGap - 图标与文本之间的间隙

mnemonicIndex - 文本中的索引，在该处呈现助记符，-1 表示没有助记符。

getMaximumSize

public Dimension getMaximumSize(SynthContext ss,
                                Font font,
                                String text,
                                Icon icon,
                                int hAlign,
                                int vAlign,
                                int hTextPosition,
                                int vTextPosition,
                                int iconTextGap,
                                int mnemonicIndex)

返回正确呈现图标和文本所需的最大大小。

参数：

ss - SynthContext

font - 要使用的字体

text - 要布置的文本

icon - 要布置的图标

hAlign - 水平对齐方式

vAlign - 垂直对齐方式

hTextPosition - 水平文本位置

vTextPosition - 垂直文本位置

iconTextGap - 图标与文本之间的间隙

mnemonicIndex - 文本中的索引，在该处呈现助记符，-1 表示没有助记符。

getMaximumCharHeight

public int getMaximumCharHeight(SynthContext context)

根据传入的 SynthContext 返回 Font 的最大高度。

参数：

context - 确定字体使用的 SynthContext。

返回：

根据传入的上下文，返回字体中字符的最大高度。

getPreferredSize

public Dimension getPreferredSize(SynthContext ss,
                                  Font font,
                                  String text,
                                  Icon icon,
                                  int hAlign,
                                  int vAlign,
                                  int hTextPosition,
                                  int vTextPosition,
                                  int iconTextGap,
                                  int mnemonicIndex)

返回正确呈现图标和文本所需的首选大小。

参数：

ss - SynthContext

font - 要使用的字体

text - 要布置的文本

icon - 要布置的图标

hAlign - 水平对齐方式

vAlign - 垂直对齐方式

hTextPosition - 水平文本位置

vTextPosition - 垂直文本位置

iconTextGap - 图标与文本之间的间隙

mnemonicIndex - 文本中的索引，在该处呈现助记符，-1 表示没有助记符。

paintText

public void paintText(SynthContext ss,
                      Graphics g,
                      String text,
                      Rectangle bounds,
                      int mnemonicIndex)

在指定位置上绘制文本。此方法不会尝试以 html 形式呈现文本，也不会根据组件的 insets 进行偏移。

参数：

ss - SynthContext

g - 用来在其中呈现字符串的图形。

text - 要呈现的文本

bounds - 文本的绘制边界。

mnemonicIndex - 索引，在该处绘制字符串。

paintText

public void paintText(SynthContext ss,
                      Graphics g,
                      String text,
                      int x,
                      int y,
                      int mnemonicIndex)

在指定位置上绘制文本。此方法不会尝试以 html 形式呈现文本，也不会根据组件的 insets 进行偏移。

参数：

ss - SynthContext

g - 用来在其中呈现字符串的图形。

text - 要呈现的文本

x - 绘制文本的位置的 X 位置。

y - 绘制文本的位置的左上角。

mnemonicIndex - 索引，在该处绘制字符串。

paintText

public void paintText(SynthContext ss,
                      Graphics g,
                      String text,
                      Icon icon,
                      int hAlign,
                      int vAlign,
                      int hTextPosition,
                      int vTextPosition,
                      int iconTextGap,
                      int mnemonicIndex,
                      int textOffset)

绘制图标和文本。如有必要，此方法将以 html 形式呈现文本，并根据组件的 insets 对位置进行偏移。

参数：

ss - SynthContext

g - 在其中呈现字符串和图标的图形

text - 要布置的文本

icon - 要布置的图标

hAlign - 水平对齐方式

vAlign - 垂直对齐方式

hTextPosition - 水平文本位置

vTextPosition - 垂直文本位置

iconTextGap - 图标与文本之间的间隙

mnemonicIndex - 文本中的索引，在该处呈现助记符，-1 表示没有助记符。

textOffset - 进行绘制时文本的偏移量