JavaTM 2 Platform
Standard Ed. 6

javax.swing.plaf.metal
类 MetalTheme

java.lang.Object
  继承者 javax.swing.plaf.metal.MetalTheme
直接已知子类:
DefaultMetalTheme

public abstract class MetalTheme
extends Object

MetalTheme 提供 Java 外观所使用的调色板和字体。

MetalTheme 是抽象的,有关具体实现,请参阅 DefaultMetalThemeOceanTheme

MetalLookAndFeel 维护 metal 的 ComponentUI 实现所使用的当前主题。有关更改当前主题的详细信息,请参阅 MetalLookAndFeel.setCurrentTheme(MetalTheme)

MetalTheme 提供获取颜色的多个公共方法。根据几个受保护的抽象方法实现这些方法。子类只需要重写受保护的抽象方法(getPrimary1getPrimary2getPrimary3getSecondary1getSecondary2getSecondary3);虽然子类也可以重写其他公共方法以对使用的颜色集进行更多控制。

MetalTheme 的具体实现必须从所有方法中返回非 null 值。由于没有指定返回 null 的行为,所以返回 null 将导致不正确的行为。

建议子类最好返回完全不透明颜色。否则会导致呈现问题,比如可视化垃圾(visual garbage)。

另请参见:
DefaultMetalTheme, OceanTheme, MetalLookAndFeel.setCurrentTheme(javax.swing.plaf.metal.MetalTheme)

构造方法摘要
MetalTheme()
           
 
方法摘要
 void addCustomEntriesToTable(UIDefaults table)
          将特定于此主题的值添加到默认表。
 ColorUIResource getAcceleratorForeground()
          返回加速器前景色。
 ColorUIResource getAcceleratorSelectedForeground()
          返回加速器选中前景色。
protected  ColorUIResource getBlack()
          返回黑色。
 ColorUIResource getControl()
          返回控件颜色。
 ColorUIResource getControlDarkShadow()
          返回控件加黑阴影颜色。
 ColorUIResource getControlDisabled()
          返回控件禁用的颜色。
 ColorUIResource getControlHighlight()
          返回控件高亮显示颜色。
 ColorUIResource getControlInfo()
          返回控件信息颜色。
 ColorUIResource getControlShadow()
          返回控件阴影颜色。
 ColorUIResource getControlTextColor()
          返回控件文本颜色。
abstract  FontUIResource getControlTextFont()
          返回控件文本字体。
 ColorUIResource getDesktopColor()
          返回桌面颜色。
 ColorUIResource getFocusColor()
          返回焦点颜色。
 ColorUIResource getHighlightedTextColor()
          返回高亮显示的文本颜色。
 ColorUIResource getInactiveControlTextColor()
          返回非活动控件文本颜色。
 ColorUIResource getInactiveSystemTextColor()
          返回非活动系统文本颜色。
 ColorUIResource getMenuBackground()
          返回菜单背景色。
 ColorUIResource getMenuDisabledForeground()
          返回菜单禁用前景色。
 ColorUIResource getMenuForeground()
          返回菜单前景色。
 ColorUIResource getMenuSelectedBackground()
          返回菜单选中背景色。
 ColorUIResource getMenuSelectedForeground()
          返回菜单选中前景色。
abstract  FontUIResource getMenuTextFont()
          返回菜单文本字体。
abstract  String getName()
          返回此主题的名称。
protected abstract  ColorUIResource getPrimary1()
          返回 primary 1 颜色。
protected abstract  ColorUIResource getPrimary2()
          返回 primary 2 颜色。
protected abstract  ColorUIResource getPrimary3()
          返回 primary 3 颜色。
 ColorUIResource getPrimaryControl()
          返回 primary 控件颜色。
 ColorUIResource getPrimaryControlDarkShadow()
          返回 primary 控件加黑阴影颜色。
 ColorUIResource getPrimaryControlHighlight()
          返回 primary 控件高亮显示颜色。
 ColorUIResource getPrimaryControlInfo()
          返回 primary 控件信息颜色。
 ColorUIResource getPrimaryControlShadow()
          返回 primary 控件阴影颜色。
protected abstract  ColorUIResource getSecondary1()
          返回 secondary 1 颜色。
protected abstract  ColorUIResource getSecondary2()
          返回 secondary 2 颜色。
protected abstract  ColorUIResource getSecondary3()
          返回 secondary 3 颜色。
 ColorUIResource getSeparatorBackground()
          返回分隔符背景色。
 ColorUIResource getSeparatorForeground()
          返回分隔符前景色。
abstract  FontUIResource getSubTextFont()
          返回子文本字体。
 ColorUIResource getSystemTextColor()
          返回系统文本颜色。
abstract  FontUIResource getSystemTextFont()
          返回系统文本字体。
 ColorUIResource getTextHighlightColor()
          返回文本高亮显示的颜色。
 ColorUIResource getUserTextColor()
          返回用户文本颜色。
abstract  FontUIResource getUserTextFont()
          返回用户文本字体。
protected  ColorUIResource getWhite()
          返回白色。
 ColorUIResource getWindowBackground()
          返回窗口背景色。
 ColorUIResource getWindowTitleBackground()
          返回窗口标题背景色。
abstract  FontUIResource getWindowTitleFont()
          返回窗口标题字体。
 ColorUIResource getWindowTitleForeground()
          返回窗口标题前景色。
 ColorUIResource getWindowTitleInactiveBackground()
          返回窗口标题非活动背景色。
 ColorUIResource getWindowTitleInactiveForeground()
          返回窗口标题非活动前景色。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

MetalTheme

public MetalTheme()
方法详细信息

getName

public abstract String getName()
返回此主题的名称。

返回:
此主题的名称

getPrimary1

protected abstract ColorUIResource getPrimary1()
返回 primary 1 颜色。

返回:
primary 1 颜色

getPrimary2

protected abstract ColorUIResource getPrimary2()
返回 primary 2 颜色。

返回:
primary 2 颜色

getPrimary3

protected abstract ColorUIResource getPrimary3()
返回 primary 3 颜色。

返回:
primary 3 颜色

getSecondary1

protected abstract ColorUIResource getSecondary1()
返回 secondary 1 颜色。

返回:
secondary 1 颜色

getSecondary2

protected abstract ColorUIResource getSecondary2()
返回 secondary 2 颜色。

返回:
secondary 2 颜色

getSecondary3

protected abstract ColorUIResource getSecondary3()
返回 secondary 3 颜色。

返回:
secondary 3 颜色

getControlTextFont

public abstract FontUIResource getControlTextFont()
返回控件文本字体。

返回:
控件文本字体

getSystemTextFont

public abstract FontUIResource getSystemTextFont()
返回系统文本字体。

返回:
系统文本字体

getUserTextFont

public abstract FontUIResource getUserTextFont()
返回用户文本字体。

返回:
用户文本字体

getMenuTextFont

public abstract FontUIResource getMenuTextFont()
返回菜单文本字体。

返回:
菜单文本字体

getWindowTitleFont

public abstract FontUIResource getWindowTitleFont()
返回窗口标题字体。

返回:
窗口标题字体

getSubTextFont

public abstract FontUIResource getSubTextFont()
返回子文本字体。

返回:
子文本字体

getWhite

protected ColorUIResource getWhite()
返回白色。此方法返回不透明白色(0xFFFFFFFF)。

返回:
白色

getBlack

protected ColorUIResource getBlack()
返回黑色。此方法返回不透明黑色(0xFF000000)。

返回:
黑色

getFocusColor

public ColorUIResource getFocusColor()
返回焦点颜色。此方法返回 getPrimary2() 的值。

返回:
焦点颜色

getDesktopColor

public ColorUIResource getDesktopColor()
返回桌面颜色。此方法返回 getPrimary2() 的值。

返回:
桌面颜色

getControl

public ColorUIResource getControl()
返回控件颜色。此方法返回 getSecondary3() 的值。

返回:
控件颜色

getControlShadow

public ColorUIResource getControlShadow()
返回控件阴影颜色。此方法返回 getSecondary2() 的值。

返回:
控件阴影颜色

getControlDarkShadow

public ColorUIResource getControlDarkShadow()
返回控件加黑阴影颜色。此方法返回 getSecondary1() 的值。

返回:
控件加黑阴影颜色

getControlInfo

public ColorUIResource getControlInfo()
返回控件信息颜色。此方法返回 getBlack() 的值。

返回:
控件信息颜色

getControlHighlight

public ColorUIResource getControlHighlight()
返回控件高亮显示颜色。此方法返回 getWhite() 的值。

返回:
控件高亮显示颜色

getControlDisabled

public ColorUIResource getControlDisabled()
返回控件禁用的颜色。此方法返回 getSecondary2() 的值。

返回:
控件禁用的颜色

getPrimaryControl

public ColorUIResource getPrimaryControl()
返回 primary 控件颜色。此方法返回 getPrimary3() 的值。

返回:
primary 控件颜色

getPrimaryControlShadow

public ColorUIResource getPrimaryControlShadow()
返回 primary 控件阴影颜色。此方法返回 getPrimary2() 的值。

返回:
primary 控件阴影颜色

getPrimaryControlDarkShadow

public ColorUIResource getPrimaryControlDarkShadow()
返回 primary 控件加黑阴影颜色。此方法返回 getPrimary1() 的值。

返回:
primary 控件加黑阴影颜色

getPrimaryControlInfo

public ColorUIResource getPrimaryControlInfo()
返回 primary 控件信息颜色。此方法返回 getBlack() 的值。

返回:
primary 控件信息颜色

getPrimaryControlHighlight

public ColorUIResource getPrimaryControlHighlight()
返回 primary 控件高亮显示颜色。此方法返回 getWhite() 的值。

返回:
primary 控件高亮显示颜色

getSystemTextColor

public ColorUIResource getSystemTextColor()
返回系统文本颜色。此方法返回 getBlack() 的值。

返回:
系统文本颜色

getControlTextColor

public ColorUIResource getControlTextColor()
返回控件文本颜色。此方法返回 getControlInfo() 的值。

返回:
控件文本颜色

getInactiveControlTextColor

public ColorUIResource getInactiveControlTextColor()
返回非活动控件文本颜色。此方法返回 getControlDisabled() 的值。

返回:
非活动控件文本颜色

getInactiveSystemTextColor

public ColorUIResource getInactiveSystemTextColor()
返回非活动系统文本颜色。此方法返回 getSecondary2() 的值。

返回:
非活动系统文本颜色

getUserTextColor

public ColorUIResource getUserTextColor()
返回用户文本颜色。此方法返回 getBlack() 的值。

返回:
用户文本颜色

getTextHighlightColor

public ColorUIResource getTextHighlightColor()
返回文本高亮显示的颜色。此方法返回 getPrimary3() 的值。

返回:
文本高亮显示的颜色

getHighlightedTextColor

public ColorUIResource getHighlightedTextColor()
返回高亮显示的文本颜色。此方法返回 getControlTextColor() 的值。

返回:
高亮显示的文本颜色

getWindowBackground

public ColorUIResource getWindowBackground()
返回窗口背景色。此方法返回 getWhite() 的值。

返回:
窗口背景色

getWindowTitleBackground

public ColorUIResource getWindowTitleBackground()
返回窗口标题背景色。此方法返回 getPrimary3() 的值。

返回:
窗口标题背景色

getWindowTitleForeground

public ColorUIResource getWindowTitleForeground()
返回窗口标题前景色。此方法返回 getBlack() 的值。

返回:
窗口标题前景色

getWindowTitleInactiveBackground

public ColorUIResource getWindowTitleInactiveBackground()
返回窗口标题非活动背景色。此方法返回 getSecondary3() 的值。

返回:
窗口标题非活动背景色

getWindowTitleInactiveForeground

public ColorUIResource getWindowTitleInactiveForeground()
返回窗口标题非活动前景色。此方法返回 getBlack() 的值。

返回:
窗口标题非活动前景色

getMenuBackground

public ColorUIResource getMenuBackground()
返回菜单背景色。此方法返回 getSecondary3() 的值。

返回:
菜单背景色

getMenuForeground

public ColorUIResource getMenuForeground()
返回菜单前景色。此方法返回 getBlack() 的值。

返回:
菜单前景色

getMenuSelectedBackground

public ColorUIResource getMenuSelectedBackground()
返回菜单选中背景色。此方法返回 getPrimary2() 的值。

返回:
菜单选中背景色

getMenuSelectedForeground

public ColorUIResource getMenuSelectedForeground()
返回菜单选中前景色。此方法返回 getBlack() 的值。

返回:
菜单选中前景色

getMenuDisabledForeground

public ColorUIResource getMenuDisabledForeground()
返回菜单禁用前景色。此方法返回 getSecondary2() 的值。

返回:
菜单禁用前景色

getSeparatorBackground

public ColorUIResource getSeparatorBackground()
返回分隔符背景色。此方法返回 getWhite() 的值。

返回:
分隔符背景色

getSeparatorForeground

public ColorUIResource getSeparatorForeground()
返回分隔符前景色。此方法返回 getPrimary1() 的值。

返回:
分隔符前景色

getAcceleratorForeground

public ColorUIResource getAcceleratorForeground()
返回加速器前景色。此方法返回 getPrimary1() 的值。

返回:
加速器前景色

getAcceleratorSelectedForeground

public ColorUIResource getAcceleratorSelectedForeground()
返回加速器选中前景色。此方法返回 getBlack() 的值。

返回:
加速器选中前景色

addCustomEntriesToTable

public void addCustomEntriesToTable(UIDefaults table)
将特定于此主题的值添加到默认表。从 MetalLookAndFeel 获取外观默认值时调用此方法。

此实现不执行任何操作;它用于要定制默认表的子类。

参数:
table - 要向其中添加值的 UIDefaults
另请参见:
MetalLookAndFeel.getDefaults()

JavaTM 2 Platform
Standard Ed. 6

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

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