Пакет javax.swing.plaf.synth

Synth — это настраиваемый вид и ощущения, в котором вся отрисовка делегируется. Synth не предоставляет стандартного вида. Для использования Synth необходимо указать файл файла или предоставить SynthStyleFactory. Оба варианта конфигурации требуют понимания архитектуры synth, которая описана ниже, а также архитектуры Swing.

Если не указано иное, null не является допустимым значением для каких-либо методов, определённых в пакете synth, и если он будет передан, это приведёт к NullPointerException.

Synth

Каждая реализация ComponentUI в Synth ассоциируется с одним SynthStyle на каждый Region, большинство Components имеют только один Region и, следовательно, только один SynthStyle. SynthStyle используется для доступа ко всем свойствам стиля: шрифтам, цветам и другим Component свойствам. Кроме того, SynthStyle используются для получения SynthPainter для отрисовки фона, рамки, фокуса и других частей Component. ComponentUI получают SynthStyle из SynthStyleFactory. SynthStyleFactory можно предоставить непосредственно через SynthLookAndFeel.setStyleFactory(javax.swing.plaf.synth.SynthStyleFactory) или косвенно через SynthLookAndFeel.load(java.io.InputStream, java.lang.Class<?>). Следующий пример использует метод SynthLookAndFeel.load() для конфигурации SynthLookAndFeel и устанавливает его в качестве текущего вида:

SynthLookAndFeel laf = new SynthLookAndFeel();
  laf.load(MyClass.class.getResourceAsStream("laf.xml"), MyClass.class);
  UIManager.setLookAndFeel(laf);

Многие JComponent разбиты на более мелкие части и идентифицируются с помощью безопасного по типу перечисления в Region. Например, JTabbedPane состоит из Region для JTabbedPane (Region.TABBED_PANE), области содержимого (Region.TABBED_PANE_CONTENT), области позади вкладок (Region.TABBED_PANE_TAB_AREA) и самих вкладок (Region.TABBED_PANE_TAB). Каждая Region каждой JComponent будет иметь SynthStyle. Это позволяет настраивать отдельные части каждой области каждого JComponent.

Многие методы Synth принимают SynthContext. Это используется для предоставления информации о текущем Component и включает в себя: SynthStyle, связанную с текущей Region, состояние Component в виде битовой маски (см. SynthConstants для допустимых состояний) и Region, определяющую часть Component, которая отрисовывается.

Вся отрисовка текста не-JTextComponent делегируется SynthGraphicsUtils, который получается с помощью метода SynthStyle SynthStyle.getGraphicsUtils(javax.swing.plaf.synth.SynthContext). Вы можете настроить отрисовку текста, предоставив свой собственный SynthGraphicsUtils.

Примечания по конкретным компонентам

JTree

Synth предоставляет область для ячеек дерева: Region.TREE_CELL. Чтобы указать цвета рендерера, вам нужно предоставить стиль для области TREE_CELL. Следующее иллюстрирует это:

<style id="treeCellStyle">
    <opaque value="TRUE"/>
    <state>
      <color value="WHITE" type="TEXT_FOREGROUND"/>
      <color value="RED" type="TEXT_BACKGROUND"/>
    </state>
    <state value="SELECTED">
      <color value="RED" type="TEXT_FOREGROUND"/>
      <color value="WHITE" type="BACKGROUND"/>
    </state>
  </style>
  <bind style="treeCellStyle" type="region" key="TreeCell"/>

Это задаёт сочетание красного на белом, когда выделен, и белого на красном, когда не выделен. Чтобы увидеть фон, необходимо указать, что метки не непрозрачны. Следующий фрагмент XML это делает:

<style id="labelStyle">
    <opaque value="FALSE"/>
  </style>
  <bind style="labelStyle" type="region" key="Label"/>

JList и JTable

Цвета, которые используют рендеры JList и JTable, задаются с помощью областей списка и таблицы. Следующий фрагмент XML иллюстрирует, как указать красный на белом, когда выделен, и белый на красном, когда не выделен:

<style id="style">
    <opaque value="TRUE"/>
    <state>
      <color value="WHITE" type="TEXT_FOREGROUND"/>
      <color value="RED" type="TEXT_BACKGROUND"/>
      <color value="RED" type="BACKGROUND"/>
    </state>
    <state value="SELECTED">
      <color value="RED" type="TEXT_FOREGROUND"/>
      <color value="WHITE" type="TEXT_BACKGROUND"/>
    </state>
  </style>
  <bind style="style" type="region" key="Table"/>
  <bind style="style" type="region" key="List"/>