Laf-Widget client properties

View all client properties.

Client property name



Client property name for specifying the preview painter for a component. This property can be set either on a component or globally on UIManager. The value in both cases should be an instance of PreviewPainter. Default implementation is available in the DefaultPreviewPainter.

See also

Sample code

import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.*;

import org.pushingpixels.lafwidget.LafWidget;
import org.pushingpixels.lafwidget.preview.DefaultPreviewPainter;
import org.pushingpixels.substance.api.SubstanceLookAndFeel;

 * Test application that shows the use of the
 {@link LafWidget#COMPONENT_PREVIEW_PAINTER} client property.
 @author Kirill Grouchnikov
public class ComponentPreviewPainter extends JFrame {
   * Creates the main frame for <code>this</code> sample.
  public ComponentPreviewPainter() {
    super("Component preview painter");

    this.setLayout(new BorderLayout());

    // Create panel with custom painting logic - simple
    // diagonal fill.
    JPanel samplePanel = new JPanel() {
      protected void paintComponent(Graphics g) {
        Graphics2D graphics = (Graphics2Dg.create();
            .setPaint(new GradientPaint(00new Color(100100,
                255), getWidth(), getHeight()new Color(255,
        graphics.fillRect(00, getWidth(), getHeight());
    samplePanel.setPreferredSize(new Dimension(800400));

    final JScrollPane scrollPane = new JScrollPane(samplePanel);
    this.add(scrollPane, BorderLayout.CENTER);

    JPanel controls = new JPanel(new FlowLayout(FlowLayout.RIGHT));
    final JCheckBox hasPreview = new JCheckBox("scroll has preview");
    hasPreview.addActionListener(new ActionListener() {
      public void actionPerformed(ActionEvent e) {
        SwingUtilities.invokeLater(new Runnable() {
          public void run() {
                    hasPreview.isSelected() new DefaultPreviewPainter()
    this.add(controls, BorderLayout.SOUTH);


   * The main method for <code>this</code> sample. The arguments are ignored.
   @param args
   *            Ignored.
  public static void main(String[] args) {
    SwingUtilities.invokeLater(new Runnable() {
      public void run() {
        SubstanceLookAndFeel.setSkin(new BusinessBlackSteelSkin());
        new ComponentPreviewPainter().setVisible(true);

The screenshot below shows an scroll pane when this property is not installed:

After installing this property on the scroll pane, it has a preview button in the bottom right corner:

Clicking on the preview button brings up the scroll pane selector window: