# Substance client properties

View all API methods.

View all client properties.

Client property name | SubstanceLookAndFeel.SKIN_PROPERTY

Description | Property name for specifying skin to be used on the specific root pane. This property can only be installed on a `JRootPane` and will affect all the controls in that root pane. The value must be an instance of `SubstanceSkin`. After setting this property, call `SwingUtilities#updateComponentTreeUI(Component)` on the matching window.

See also |

Sample code | `import java.awt.FlowLayout; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import javax.swing.*; import org.jvnet.substance.SubstanceLookAndFeel;
import org.jvnet.substance.api.SubstanceSkin;
import org.jvnet.substance.skin.*;
/**
* Test application that shows the use of the {@link
* SubstanceLookAndFeel#SKIN_PROPERTY} client property.
*
* @author Kirill Grouchnikov
* @see SubstanceLookAndFeel#SKIN_PROPERTY
*/
public class SkinProperty extends JFrame {
/**
* Creates the main frame for <code>this</code> sample.
*/
public SkinProperty() {
super("Per-window skins");
this.setLayout(new FlowLayout());
JButton autumnSkin = new JButton("Autumn skin");
autumnSkin.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
SwingUtilities.invokeLater(new Runnable() {
@Override
public void run() {
openSampleFrame(new AutumnSkin());
}
});
}
});
this.add(autumnSkin);
JButton ravenGraphiteSkin = new JButton("Graphite skin");
ravenGraphiteSkin.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
SwingUtilities.invokeLater(new Runnable() {
@Override
public void run() {
openSampleFrame(new RavenGraphiteSkin());
}
});
}
});
this.add(ravenGraphiteSkin);
this.setSize(400, 200);
this.setLocationRelativeTo(null);
this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
}
/**
* Opens a sample frame under the specified skin.
*
* @param skin Skin.
*/
private void openSampleFrame(SubstanceSkin skin) {
JFrame sampleFrame = new JFrame(skin.getDisplayName());
sampleFrame.setLayout(new FlowLayout());
JButton defaultButton = new JButton("active");
JButton button = new JButton("default");
JButton disabledButton = new JButton("disabled");
disabledButton.setEnabled(false);
sampleFrame.getRootPane().setDefaultButton(defaultButton);
sampleFrame.add(defaultButton);
sampleFrame.add(button);
sampleFrame.add(disabledButton);
sampleFrame.setVisible(true);
sampleFrame.pack();
sampleFrame.setLocationRelativeTo(null);
sampleFrame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
sampleFrame.getRootPane().putClientProperty(
SubstanceLookAndFeel.SKIN_PROPERTY, skin);
SwingUtilities.updateComponentTreeUI(sampleFrame);
sampleFrame.repaint();
}
/**
* The main method for <code>this</code> sample. The arguments are ignored.
*
* @param args
* Ignored.
* @throws Exception
* If some exception occured. Note that there is no special treatment
* of exception conditions in <code>this</code> sample code.
*/
public static void main(String[] args) throws Exception {
UIManager.setLookAndFeel(new SubstanceBusinessBlackSteelLookAndFeel());
JFrame.setDefaultLookAndFeelDecorated(true);
SwingUtilities.invokeLater(new Runnable() {
public void run() {
new SkinProperty().setVisible(true);
}
});
}
}`

The screenshot below shows application frame under the Business Black Steel skin:

The screenshot below shows another frame launched in the same application with this client property set to `AutumnSkin`:

The screenshot below shows a third frame launched in the same application with this client property set to `RavenGraphiteSkin`:

And here is a screenshot of all three application frames showing multiple skins being used on different root panes: