# Substance client properties

View all API methods.

View all client properties.

Client property name | SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION

Description | Client property name for specifying combo popup flyout orientation. This property can be set on either a specific `JComboBox` or globally on `UIManager`. The value should be one of the `Integer`s below:

- The default `SwingConstants.SOUTH` - the popup is displayed directly below the combo aligned to the left.
- `SwingConstants.NORTH` - the popup is displayed directly above the combo aligned to the left.
- `SwingConstants.EAST` - the popup is displayed to the left of the combo aligned to the top.
- `SwingConstants.WEST` - the popup is displayed to the right of the combo aligned to the top.
- `SwingConstants.CENTER` - the popup is displayed centered vertically over the combo aligned to the left.

Note that the combo arrow changes in accordance with the combo popup flyout orientation.

See also |

- COMBO_POPUP_PROTOTYPE client property.

Sample code | `import java.awt.BorderLayout; 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.skin.SubstanceBusinessBlackSteelLookAndFeel;
/**
* Test application that shows the use of the
* {@link SubstanceLookAndFeel#COMBO_BOX_POPUP_FLYOUT_ORIENTATION} client
* property.
*
* @author Kirill Grouchnikov
* @see SubstanceLookAndFeel#COMBO_BOX_POPUP_FLYOUT_ORIENTATION
*/
public class ComboBoxPopupFlyoutOrientation extends JFrame {
/**
* Creates the main frame for <code>this</code> sample.
*/
public ComboBoxPopupFlyoutOrientation() {
super("Combobox popup flyout orientation");
this.setLayout(new BorderLayout());
final JComboBox cb = new JComboBox(new Object[] { "Ester", "Jordi",
"Jordina", "Jorge", "Sergi" });
JPanel main = new JPanel(new FlowLayout(FlowLayout.CENTER));
this.add(main, BorderLayout.CENTER);
main.add(cb);
JPanel controls = new JPanel(new FlowLayout(FlowLayout.RIGHT));
final JComboBox flyoutCombo = new JComboBox(new Object[] { "default",
"center", "north", "east", "west", "south" });
flyoutCombo.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
Object selected = flyoutCombo.getSelectedItem();
// set popup flyout orientation based on the selected
// item
if ("default".equals(selected))
cb
.putClientProperty(
SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION,
null);
if ("center".equals(selected))
cb
.putClientProperty(
SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION,
SwingConstants.CENTER);
if ("north".equals(selected))
cb
.putClientProperty(
SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION,
SwingConstants.NORTH);
if ("east".equals(selected))
cb
.putClientProperty(
SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION,
SwingConstants.EAST);
if ("west".equals(selected))
cb
.putClientProperty(
SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION,
SwingConstants.WEST);
if ("south".equals(selected))
cb
.putClientProperty(
SubstanceLookAndFeel.COMBO_BOX_POPUP_FLYOUT_ORIENTATION,
SwingConstants.SOUTH);
}
});
controls.add(new JLabel("Combo popup flyout orientation"));
controls.add(flyoutCombo);
this.add(controls, BorderLayout.SOUTH);
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.
* @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 ComboBoxPopupFlyoutOrientation().setVisible(true);
}
});
}
}`

The screenshot below shows combobox popup in the default location:

The screenshot below shows combobox popup in the `SwingConstants.EAST` location: