模块 java.desktop

软件包 javax.swing.plaf.synth

Class 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)	在两个端点之间画一条线。
static int	getIconHeight(Icon icon, SynthContext context)	返回图标的高度。
static int	getIconWidth(Icon icon, SynthContext context)	返回图标的宽度。
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)	布置文本和图标，通过引用返回放置图标和文本的位置。
static void	paintIcon(Icon icon, SynthContext context, Graphics g, int x, int y, int width, int height)	绘制图标。
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)	在指定位置绘制文本。
void	paintText(SynthContext ss, Graphics g, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex, int textOffset)	绘制图标和文本。

声明方法的类 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 - 要绘制到的图形对象

x1 - x原产地

y1 - y origin

x2 - x目的地

y2 - 到目的地

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 - 要绘制到的图形对象

x1 - x原产地

y1 - y origin

x2 - x目的地

y2 - 目的地

styleKey - 标识所请求的行样式（例如“虚线”）

从以下版本开始：

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的FontMetrics，这可能会被忽略

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，也不会被组件的插图所抵消。

参数

ss - SynthContext

g - 用于呈现字符串的图形。

text - 要渲染的文本

bounds - 要绘制的文本的边界。

mnemonicIndex - 绘制字符串的索引。

paintText

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

在指定位置绘制文本。 这不会尝试将文本呈现为html，也不会被组件的插图所抵消。

参数

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，并通过组件的插入来偏移位置。

参数

ss - SynthContext

g - 将字符串和图标渲染到的图形

text - 要布局的文本

icon - 布局图标

hAlign - 水平对齐

vAlign - 垂直对齐

hTextPosition - 水平文本位置

vTextPosition - 垂直文本位置

iconTextGap - 图标和文字之间的差距

mnemonicIndex - 索引到文本以呈现助记符，-1表示没有助记符。

textOffset - 绘制时偏移文本的量

getIconWidth

public static int getIconWidth(Icon icon,
                               SynthContext context)

返回图标的宽度。 为SynthIcon调用getIconWidth(context)方法。

参数

icon - 图标

请求图标的 context - SynthContext可能为null。

结果

指定图标宽度的int。

getIconHeight

public static int getIconHeight(Icon icon,
                                SynthContext context)

返回图标的高度。 getIconHeight(context)方法被调用SynthIcon 。

参数

icon - 图标

请求图标的 context - SynthContext可能为null。

结果

指定图标高度的int。

paintIcon

public static void paintIcon(Icon icon,
                             SynthContext context,
                             Graphics g,
                             int x,
                             int y,
                             int width,
                             int height)

绘制图标。 为SynthIcon调用paintIcon(context, g, x, y, width, height)方法。

参数

icon - 图标

context - 标识托管区域，可以为null。

g - 图形上下文

x - 要绘制的x位置

y - 要绘制的y位置

width - 要绘制的区域的宽度，可以是0

height - 要绘制的区域的高度，可能为0