JavaTM Platform
Standard Ed. 6

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 - 进行绘制时文本的偏移量

JavaTM Platform
Standard Ed. 6

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

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