Package com.explodingpixels.macwidgets
Class SourceListControlBar
java.lang.Object
com.explodingpixels.macwidgets.SourceListControlBar
A bar that can contain buttons and pop-down buttons that act on a given SourceList
. This
control bar is displayed at the base of the SourceList
. The control bar also has a
draggable widget that can control the divider location of a given JSplitPane
.
Heres how to create and install an empty SourceListControlBar
:
SourceList sourceList = DSourceListITunes.createSourceList(); SourceListControlBar controlBar = new SourceListControlBar(); sourceList.installSourceListControlBar(controlBar);The above code creates a control bar that looks like this:

The following code adds two push buttons and a drop-down button to the control bar:
controlBar.createAndAddPopdownButton(MacIcons.GEAR, new PopupMenuCustomizer() { public void customizePopup(JPopupMenu popup) { popup.removeAll(); popup.add(new JMenuItem("Item One")); popup.add(new JMenuItem("Item Two")); popup.add(new JMenuItem("Item Three")); } });The above code creates a control bar that looks like this:

-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
createAndAddButton
(Icon icon, ActionListener actionListener) Adds a new button with the given icon.void
createAndAddPopdownButton
(Icon icon, PopupMenuCustomizer popupMenuCustomizer) Add a new pop-down style button.Gets the user interface component representing thisSourceListControlBar
.void
Hides the resize handle.void
installDraggableWidgetOnSplitPane
(JSplitPane splitPane) Connects the draggable widget in thisSourceListControlBar
to the divider of the givenJSplitPane
.
-
Constructor Details
-
SourceListControlBar
public SourceListControlBar()Creates aSourceListControlBar
.
-
-
Method Details
-
installDraggableWidgetOnSplitPane
Connects the draggable widget in thisSourceListControlBar
to the divider of the givenJSplitPane
. Thus when the user drags theSourceListControlBar
draggable widget, the givenJSplitPane
s divider location will be adjusted.- Parameters:
splitPane
- theJSplitPane
to connect the draggable widget to.
-
getComponent
Gets the user interface component representing thisSourceListControlBar
. The returnedJComponent
should be added to a container that will be displayed.- Returns:
- the user interface component representing this
SourceListControlBar
.
-
createAndAddPopdownButton
Add a new pop-down style button. The givenPopupMenuCustomizer
will be called just prior to each showing of the menu.- Parameters:
icon
- the icon to use in the pop-down menu.popupMenuCustomizer
- thePopupMenuCustomizer
to be called just prior to showing the menu.
-
createAndAddButton
Adds a new button with the given icon. The givenActionListener
will be called when the button is pressed.- Parameters:
icon
- the icon to use for the button.actionListener
- theActionListener
to call when the button is pressed.
-
hideResizeHandle
public void hideResizeHandle()Hides the resize handle.
-