Substance API

View all API methods.

View all client properties.


API method

public static void registerGradientPainterChangeListener(
      GradientPainterChangeListener gradientPainterChangeListener)

Description

Registers a new listener on gradient painter change.

Parameters:

  • gradientPainterChangeListener - New listener on gradient painter change.

See also


Sample code

import java.awt.BorderLayout;
import java.awt.FlowLayout;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
import java.util.Vector;

import javax.swing.*;

import org.jvnet.substance.SubstanceLookAndFeel;
import org.jvnet.substance.painter.GradientPainterChangeListener;
import org.jvnet.substance.painter.GradientPainterInfo;

/**
 * Test application that shows the use of the
 {@link SubstanceLookAndFeel#registerGradientPainterChangeListener(org.jvnet.substance.painter.GradientPainterChangeListener)}
 * API.
 
 @author Kirill Grouchnikov
 @see SubstanceLookAndFeel#registerGradientPainterChangeListener(org.jvnet.substance.painter.GradientPainterChangeListener)
 */
public class RegisterGradientPainterChangeListener extends JFrame {
  /**
   * Creates the main frame for <code>this</code> sample.
   */
  public RegisterGradientPainterChangeListener() {
    super("Register gradient painter change listener");

    this.setLayout(new BorderLayout());

    JPanel panel = new JPanel(new FlowLayout());

    // Get all gradient painter display names and set the vector as a model
    // for combobox.
    final JComboBox cb = new JComboBox(new Vector<String>(
        SubstanceLookAndFeel.getAllGradientPainters().keySet()));
    cb
        .setSelectedItem(SubstanceLookAndFeel
            .getCurrentGradientPainterName());

    cb.addItemListener(new ItemListener() {
      public void itemStateChanged(ItemEvent evt) {
        // Get the affected item
        final Object item = evt.getItem();

        if (evt.getStateChange() == ItemEvent.SELECTED) {
          SwingUtilities.invokeLater(new Runnable() {
            public void run() {
              try {
                // Get the gradient painter info object based on
                // the selected gradient painter display name
                GradientPainterInfo painterInfo = SubstanceLookAndFeel
                    .getAllGradientPainters().get(
                        (Stringitem);
                // Set the global gradient painter based on the
                // gradient painter class name.
                SubstanceLookAndFeel
                    .setCurrentGradientPainter(painterInfo
                        .getClassName());
                SwingUtilities
                    .updateComponentTreeUI(RegisterGradientPainterChangeListener.this);
              catch (Exception exc) {
              }
            };
          });
        }
      }
    });

    panel.add(new JLabel("All gradient painters:"));
    panel.add(cb);

    this.add(panel, BorderLayout.CENTER);

    // register listener
    SubstanceLookAndFeel
        .registerGradientPainterChangeListener(new GradientPainterChangeListener() {
          public void gradientPainterChanged() {
            // show dialog with the painter name
            SwingUtilities.invokeLater(new Runnable() {
              public void run() {
                JOptionPane
                    .showMessageDialog(
                        RegisterGradientPainterChangeListener.this,
                        "New gradient painter is "
                            + SubstanceLookAndFeel
                                .getCurrentGradientPainterName());
              }
            });
          }

        });

    this.setSize(400200);
    this.setLocationRelativeTo(null);
    this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
  }

  /**
   * 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[] argsthrows Exception {
    UIManager.setLookAndFeel(new SubstanceLookAndFeel());
    JFrame.setDefaultLookAndFeelDecorated(true);
    JDialog.setDefaultLookAndFeelDecorated(true);
    SwingUtilities.invokeLater(new Runnable() {
      public void run() {
        new RegisterGradientPainterChangeListener().setVisible(true);
      }
    });
  }
}

The screenshot below shows an option pane that pops up from the registered gradient painter listener. Note that the button is painted with the new gradient painter (Specular):