Laf-Widget client properties

View all client properties.

Client property name



Client property name for specifying the preview painter for tabbed pane. This property can be set on a single tabbed pane. The value should be an instance of TabPreviewPainter. Default implementation of this DefaultTabPreviewPainter. Tabbed panes that have associated preview painters, have two widgets installed:

  • Tab overview dialog from TabOverviewDialogWidget.
  • Tab hover preview from TabHoverPreviewWidget.

See also

Sample code

import java.awt.BorderLayout;
import java.awt.Color;
import java.awt.FlowLayout;
import java.awt.Graphics;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.ImageIcon;
import javax.swing.JCheckBox;
import javax.swing.JDialog;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JTabbedPane;
import javax.swing.SwingUtilities;

import org.pushingpixels.lafwidget.LafWidget;
import org.pushingpixels.lafwidget.tabbed.DefaultTabPreviewPainter;
import org.pushingpixels.substance.api.SubstanceLookAndFeel;

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

    this.setLayout(new BorderLayout());

    final JTabbedPane jtp = new JTabbedPane();
    String packageName = TabbedPanePreviewPainter.class.getPackage()
    jtp.addTab("First"new ImageIcon(TabbedPanePreviewPainter.class
        new JPanel() {
          protected void paintComponent(Graphics g) {
            g.setColor(new Color(255200200));
            g.fillRect(00, getWidth(), getHeight());
    jtp.addTab("Second"new ImageIcon(TabbedPanePreviewPainter.class
        new JPanel() {
          protected void paintComponent(Graphics g) {
            g.setColor(new Color(200255200));
            g.fillRect(00, getWidth(), getHeight());
        new ImageIcon(TabbedPanePreviewPainter.class.getClassLoader()
        new JPanel() {
          protected void paintComponent(Graphics g) {
            g.setColor(new Color(200200255));
            g.fillRect(00, getWidth(), getHeight());

    this.add(jtp, BorderLayout.CENTER);

    JPanel controls = new JPanel(new FlowLayout(FlowLayout.RIGHT));
    final JCheckBox hasPreview = new JCheckBox("Has preview");
    hasPreview.addActionListener(new ActionListener() {
      public void actionPerformed(ActionEvent e) {
                hasPreview.isSelected() new DefaultTabPreviewPainter()

    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 TabbedPanePreviewPainter().setVisible(true);

The screenshot below shows a tabbed pane when this property is not installed:

After installing this property on the tabbed pane, it has an overview button in the top left corner:

Clicking on the preview button brings up the overview dialog. The mouse is over the preview of the third tab that shows the relevant tooltip: