Java Swing 皮肤定制 之 Synth DTD 用法

 

本文参考自：Java Synth用法

synth DTD下载：synth.dtd

1．   Synth概述

Synth是Sun提供的一种新的Look And Feel，与以往的Look And Feel不同，这是个通过配置文件进行定义的，插入式的Look And Feel。在不修改代码的情况下，用户可以仅通过修改配置文件，即可对控件的字体，颜色等属性进行修改。
2．   Synth配置文件
a)        说明：Synth配置文件是一个XML文件，她是整个Synth配置的关键，而要掌握Synth，最主要的就是要熟悉该文件的DTD，因为他规定了什么可以配置，而什么是不可配置的。
3．   Synth元素
a)        说明：synth元素是整个Synth配置文件的根元素，可以在该元素下通过font，color，imagePainter等标签，直接定义全局可用的风格，然后在某个style或者state内部，通过他们的子font，color标记上的idref属性，即可引用这些全局定义好的属性。。

b)        DTD：
<!ELEMENT synth ((%beansPersistance;) | style | bind | font | color | imagePainter | imageIcon)*>

4．   Style元素

a)        说明：style标签的用途就是把font，color等标签归到一起，作为一个完整的风格，她需要通过后续的bind标签，来绑定到具体的控件上。另外clone属性提供了一种继承机制，通过该属性你可以从某个已定义的style当中把内容继承过来，然后修改某个需要改变的部分即可。

b)        DTD：
<!ELEMENT style (property | defaultsProperty | state | font | painter | imagePainter | backgroundImage | opaque | (%beansPersistance;) | imageIcon)*>

c)        例子：
<style id="button">

  <opaque value="true"/>
  <insets top="4" left="4" right="4" bottom="4"/>
  <font name="Dialog" size="12"/>

</style>

 5．   State元素
a)        说明：State标签用于指定控件在某个特定状态时的风格。state标签中的value值在SynthConstants类中定义。
b)        DTD：
<!ELEMENT state (color | font | painter | imagePainter | (%beansPersistance;))*>
c)        例子：
<state value="SELECTED and PRESSED" id="one">
    <color value="RED" type="BACKGROUND"/>
</state>

6．   Font元素

a)        说明：定义某种字体风格。
b)        例子：<font name="DIALOG" size="12" style="ITALIC"/>

7．   Color元素：

a)        说明：定义某种颜色。
b)        例子：<color value="RED" type="BACKGROUND"/>

8．   Property元素：

a)        说明：通过键值对的方式定义某些控件特定的属性，属性值将存入类SynthStyle类中，这样做的一个好处就是不用为每个特定属性都定义一个标签，而且以后要扩展也比较方便。可以设置的控件属性，参考最后的表格。
b)        DTD：<!ELEMENT property EMPTY>
c)        例子：
<property key="ScrollBar.allowsAbsolutePositioning" type="boolean" value="false"/>

9．   DefaultsProperty元素

a)        说明：将特定于控件的属性值存入类UIDefaults当中，然后由SynthLookAndFeel传入UIManager当中。通过UIManager.get()方法可以获取到该值。
b)        DTD：<!ELEMENT defaultsProperty EMPTY>
c)        例子：

<object class="javax.swing.plaf.ColorUIResource" id="color">
    <int>255</int>
    <int>0</int>
    <int>0</int>
</object>
<defaultsProperty key="Table.focusCellForeground" type="idref" value="color"/>

10．GraphicsUtils元素

a)        说明：用于定义当前Style所使用的SynthGraphicsUtils实例。
b)        DTD：<!ELEMENT graphicsUtils EMPTY>
c)        例子：
<object class="CustomGraphicsUtils" id="graphics"/>
<graphicsUtils idref="graphics"/>

11．Insets元素：

a)        说明：定义某种间距。
b)        例子：<insets top="1" bottom="2" left="3"/>

12．Bind元素

a)        说明：将属性与一类或者某一特定的控件进行绑定。当type的值为region时，她处理的是一系列的控件。当需要处理某个特定的组件时，需要把type设定为name，然后在组件上调用setName()方法设定名字，这样在程序执行时Synth，将会根据组件的getName()的返回值进行匹配。Key部分是使用正则表达式的方式进行匹配。当一个控件有多个style可匹配，那么这些style将被合并，如果style之间有同名部分，则后定义的style将覆盖之前定义的style。
b)        DTD：<!ELEMENT bind EMPTY>
c)        例子：
<style id="b">
  <font name="DIALOG" size="12" style="BOLD"/>
</style>
<bind style="b" type="region" key="button"/>

13．Painter元素

a)        说明：为当前的Style或者State定义一个用于绘画文本的SynthPainter实例。
b)        DTD：<!ELEMENT painter EMPTY>
c)        例子：
<object class="MyPainter" id="MyPainter"/>
<painter idref="MyPainter"/>

14．ImagePainter元素

a)        说明：为当前的Style或者State定义一个用于绘画图形的SynthPainter实例。可以用该属性来绘制控件的背景。
b)        DTD：<!ELEMENT imagePainter EMPTY>
c)        例子：
<imagePainter path="bg.jpg" method="panelBackground" sourceInsets="2 2 2 2"
paintCenter="true"/>

15．ImageIcon元素

a)        说明：为支持Icon属性的控件绑定一个图标。
b)        例子：
<imageIcon id="icon" path="resources/myImage.png"/>
<property key="RadioButton.icon" value="icon"/>

16．Opaque元素

a)        说明：用于设置一个控件的Opaque属性。
b)        例子：<opaque value="FALSE">

17．BeansPersistence属性

a)        说明：该属性可以为其他标签（imagePainter等）引入一些自定义的类。

18．完整的例子：

a)        配置文件：

<synth>
   <style id="emulator">
      <imagePainter path="images/phone.png" method="panelBackground"   sourceInsets="2 2 2 2" paintCenter="true"/>
   </style>
   <bind style="emulator" type="name" key="Emulator.*"/>
</synth>

b)        Java代码：

public class Emulator extends JPanel {
     public static void main(String[] args) throws Exception {
         Runnable runner = new Runnable() {
              public void run() {
                   try {
                       SynthLookAndFeel synth = new SynthLookAndFeel();
                       Class aClass = Emulator.class;
                       InputStream is = aClass.getResourceAsStream("demo.xml");
                       synth.load(is, aClass);
                       UIManager.addAuxiliaryLookAndFeel(synth);
                       JFrame frame = new JFrame("SIP Client");
                       frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
                       frame.setLayout(new BorderLayout());
                       Emulator emulator = new Emulator();
                       emulator.setName("Emulator");
                       frame.add(emulator, BorderLayout.CENTER);
                       frame.setSize(360, 674);
                       frame.setResizable(false);
                       frame.setVisible(true);
                   } catch (Exception e) {
                       e.printStackTrace();
                   }
              }
         };
         EventQueue.invokeLater(runner);
     }
     public Emulator() {}
}

 

c)        说明：文件的路径，及下文当中路径相关的操作，都是相对于load()方法中的class参数的位置。当使用SynthLookAndFeel时，需要为每个控件都指定风格，这显然是很累的，一个解决办法就是，不调用UIManager.setLookAndFeel(laf)，而是使用UIManager.addAuxiliaryLookAndFeel(laf)，即将Synth作为扩展的LookAndFell，这就能继续使用默认的LookAndFeel和定制的SynthLookAndFeel。