Substance client properties

Client property name

Description

Client property name for specifying that a single button / all application buttons should never paint the background. This property can be set as a client property on a specific button, its parent or as a global setting on UIManager. The value should be either Boolean.TRUE or Boolean.FALSE. Note that unlike the FLAT_PROPERTY, a button marked with this property will never show the background (will always be painted flat).

See also

• FLAT_PROPERTY client property.

Sample code

import java.awt.FlowLayout;

import javax.swing.*;

import org.pushingpixels.substance.api.SubstanceLookAndFeel;
import org.pushingpixels.substance.api.skin.BusinessBlackSteelSkin;

/**
 * Test application that shows the use of the
 * {@link SubstanceLookAndFeel#BUTTON_PAINT_NEVER_PROPERTY} client property.
 * 
 * @author Kirill Grouchnikov
 * @see SubstanceLookAndFeel#BUTTON_PAINT_NEVER_PROPERTY
 */
public class ButtonPaintNeverProperty extends JFrame {
  /**
   * Creates the main frame for <code>this</code> sample.
   */
  public ButtonPaintNeverProperty() {
    super("Middle button never paints background");

    this.setLayout(new FlowLayout());

    JButton buttonA = new JButton("a");
    JButton buttonB = new JButton("b");
    // Mark button to never paint its background
    buttonB.putClientProperty(
        SubstanceLookAndFeel.BUTTON_PAINT_NEVER_PROPERTY, Boolean.TRUE);
    JButton buttonC = new JButton("c");

    this.add(buttonA);
    this.add(buttonB);
    this.add(buttonC);

    this.setSize(400, 200);
    this.setLocationRelativeTo(null);
    this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
  }

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

The screenshot below shows the application frame in which the middle button has been marked with this property set to Boolean.TRUE.