1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
package com.explodingpixels.macwidgets;
import java.awt.Window;
import javax.swing.BorderFactory;
import javax.swing.JComponent;
import com.explodingpixels.border.FocusStateMatteBorder;
import com.explodingpixels.widgets.WindowDragger;
import com.explodingpixels.widgets.WindowUtils;
import com.jgoodies.forms.factories.Borders;
/**
* A Mac style Unified Tool Bar. For a full description of what a Unified Tool
* Bar is, see the <a href=
* "http://developer.apple.com/documentation/UserExperience/Conceptual/AppleHIGuidelines/XHIGWindows/chapter_18_section_4.html#//apple_ref/doc/uid/20000961-BABIFCFJ"
* >Toolbars</a> section of Apple's Human Interface Guidelines. Here's an
* example of the what this method creates: <br>
* <img src="../../../../graphics/UnifiedToolBar.png"> <br>
* Here's a simple example that creates a Unified Tool Bar with a single button:
*
* <pre>
* UnifiedToolBar toolBar = new UnifiedToolBar();
* JButton button = new JButton("My Button");
* button.putClientProperty("JButton.buttonType", "textured");
* toolBar.addComponentToLeft(button);
* </pre>
*/
public class UnifiedToolBar {
private final TriAreaComponent fUnifiedToolBar;
/**
* Creates a {@code UnifiedToolBar} with balanced ends.
*/
public UnifiedToolBar() {
this(true);
}
/**
* Creates a {@code UnifiedToolBar}.
*
* @param forceSameWidth
* whether the two ends should have the same width to keep the center balanced.
*/
public UnifiedToolBar(boolean forceSameWidth) {
fUnifiedToolBar = new TriAreaComponent(4, forceSameWidth);
// TODO remove below call when Apple fixes bug in Java that doesn't
// correctly paint the
// TODO textured window.
fixUnifiedToolBarOnMacIfNeccessary(fUnifiedToolBar);
fUnifiedToolBar.getComponent().setBorder(
Borders.createEmptyBorder("3dlu, 4dlu, 3dlu, 4dlu"));
installUnifiedToolBarBorder(fUnifiedToolBar.getComponent());
WindowUtils
.installJComponentRepainterOnWindowFocusChanged(fUnifiedToolBar
.getComponent());
}
/**
* Adds the given component to the left side of this {@code UnifiedToolbar}.
*
* @param toolToAdd
* the tool to add to this {@code UnifiedToolbar}.
*/
public void addComponentToLeft(JComponent toolToAdd) {
fUnifiedToolBar.addComponentToLeft(toolToAdd);
}
/**
* Adds the given component to the side of this {@code UnifiedToolbar}.
*
* @param toolToAdd
* the tool to add to this {@code UnifiedToolbar}.
*/
public void addComponentToCenter(JComponent toolToAdd) {
fUnifiedToolBar.addComponentToCenter(toolToAdd);
}
/**
* Adds the given component to the right side of this {@code UnifiedToolBar}
* .
*
* @param toolToAdd
* the tool to add to this {@code UnifiedToolBar}.
*/
public void addComponentToRight(JComponent toolToAdd) {
fUnifiedToolBar.addComponentToRight(toolToAdd);
}
/**
* Installs a drag listener on this {@code UnifiedToolBar} such that if it
* is dragged, it will move the given {@link Window}.
*
* @param window
* the {@code Window} to move when the this
* {@code UnifiedToolbar} is dragged.
*/
public void installWindowDraggerOnWindow(Window window) {
new WindowDragger(window, getComponent());
}
/**
* Gets the user interface component representing this
* {@code UnifiedToolBar}. The returned {@link JComponent} should be added
* to a container that will be displayed.
*
* @return the user interface component representing this
* {@code UnifiedToolBar}.
*/
public JComponent getComponent() {
return fUnifiedToolBar.getComponent();
}
/**
* Disables any custom background painter that may be installed.
*/
public void disableBackgroundPainter() {
fUnifiedToolBar.setBackgroundPainter(null);
}
/**
* Installs a custom painter on the given {@link TriAreaComponent} that
* paints the Mac style unified toolbar gradient on non-Mac platforms as
* well as Mac platforms running using Java 6.
*
* @param unifiedToolBar
* the {@link TriAreaComponent} to install the custom painter on
* if necessary.
*/
private static void fixUnifiedToolBarOnMacIfNeccessary(
TriAreaComponent unifiedToolBar) {
// install the custom painter if on non-Mac platforms or in other
// various Mac cases.
if (MacUtils.shouldManuallyPaintTexturedWindowBackground()) {
unifiedToolBar.setBackgroundPainter(MacPainterFactory
.createTexturedWindowWorkaroundPainter());
}
}
static void installUnifiedToolBarBorder(final JComponent component) {
FocusStateMatteBorder border = new FocusStateMatteBorder(0, 0, 1, 0,
MacColorUtils.getTexturedWindowToolbarBorderFocusedColor(),
MacColorUtils.getTexturedWindowToolbarBorderUnfocusedColor(),
component);
component.setBorder(BorderFactory.createCompoundBorder(border,
component.getBorder()));
}
}
|
