Module java.desktop

软件包 javax.swing.plaf.synth

Class SynthGraphicsUtils

java.lang.Object

javax.swing.plaf.synth.SynthGraphicsUtils

public class SynthGraphicsUtils
extends Object

原始图形调用的包装器。

从以下版本开始：

1.5

构造方法摘要

构造方法

Constructor	描述
SynthGraphicsUtils()	创建一个 SynthGraphicsUtils 。

方法摘要

Modifier and Type	方法	描述
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)	画一个图标和文字。

Methods inherited from class 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来源

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

x1 - x起源

y1 - y来源

x2 - x目的地

y2 - y目的地

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 - 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)

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

参数

icon - 图标

context - SynthContext请求图标可以为空。

结果

一个int指定图标的宽度。

getIconHeight

public static int getIconHeight(Icon icon,
                                SynthContext context)

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

参数

icon - 图标

context - SynthContext请求图标可以为空。

结果

一个int指定图标的高度。

paintIcon

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

画图标。 paintIcon(context, g, x, y, width, height)方法被称为SynthIcon 。

参数

icon - 图标

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

g - 图形上下文

x - 要绘制的x位置

y - 要绘制的y位置

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

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