Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
PanelBuilder |
|
| 1.1470588235294117;1.147 |
1 | package org.jtheque.core.utils.ui; | |
2 | ||
3 | import org.jdesktop.swingx.JXTree; | |
4 | import org.jtheque.core.managers.Managers; | |
5 | import org.jtheque.core.managers.view.able.IViewManager; | |
6 | import org.jtheque.core.managers.view.impl.components.JThequeCheckBox; | |
7 | import org.jtheque.core.managers.view.impl.components.JThequeI18nLabel; | |
8 | import org.jtheque.utils.ui.ButtonBarBuilder; | |
9 | import org.jtheque.utils.ui.GridBagUtils; | |
10 | ||
11 | import javax.swing.Action; | |
12 | import javax.swing.DefaultComboBoxModel; | |
13 | import javax.swing.JButton; | |
14 | import javax.swing.JCheckBox; | |
15 | import javax.swing.JComboBox; | |
16 | import javax.swing.JComponent; | |
17 | import javax.swing.JLabel; | |
18 | import javax.swing.JList; | |
19 | import javax.swing.JPanel; | |
20 | import javax.swing.JScrollPane; | |
21 | import javax.swing.JSeparator; | |
22 | import javax.swing.JTextArea; | |
23 | import javax.swing.ListCellRenderer; | |
24 | import javax.swing.ListModel; | |
25 | import javax.swing.ListSelectionModel; | |
26 | import javax.swing.border.Border; | |
27 | import javax.swing.tree.TreeCellRenderer; | |
28 | import javax.swing.tree.TreeModel; | |
29 | import java.awt.Color; | |
30 | import java.awt.Component; | |
31 | import java.awt.Font; | |
32 | import java.awt.GridBagLayout; | |
33 | import java.awt.Insets; | |
34 | import java.awt.LayoutManager; | |
35 | ||
36 | /* | |
37 | * This file is part of JTheque. | |
38 | * | |
39 | * JTheque is free software: you can redistribute it and/or modify | |
40 | * it under the terms of the GNU General Public License as published by | |
41 | * the Free Software Foundation, either version 3 of the License. | |
42 | * | |
43 | * JTheque is distributed in the hope that it will be useful, | |
44 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
45 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
46 | * GNU General Public License for more details. | |
47 | * | |
48 | * You should have received a copy of the GNU General Public License | |
49 | * along with JTheque. If not, see <http://www.gnu.org/licenses/>. | |
50 | */ | |
51 | ||
52 | /** | |
53 | * A panel builder. | |
54 | * | |
55 | * @author Baptiste Wicht | |
56 | */ | |
57 | public class PanelBuilder { | |
58 | private final JPanel panel; | |
59 | ||
60 | private final GridBagUtils gbc; | |
61 | ||
62 | public static final int BOLD = 1; | |
63 | public static final int ITALIC = 2; | |
64 | ||
65 | /** | |
66 | * Construct a new PanelBuilder. | |
67 | */ | |
68 | public PanelBuilder() { | |
69 | 0 | this(new JPanel(), true); |
70 | 0 | } |
71 | ||
72 | /** | |
73 | * Construct a new panel builder. | |
74 | * | |
75 | * @param panel The panel to build. | |
76 | */ | |
77 | public PanelBuilder(JPanel panel) { | |
78 | 0 | this(panel, true); |
79 | 0 | } |
80 | ||
81 | /** | |
82 | * Construct a new PanelBuilder with a specified layout. | |
83 | * | |
84 | * @param layout The layout to set to the builded panel. | |
85 | */ | |
86 | public PanelBuilder(LayoutManager layout){ | |
87 | 0 | this(new JPanel(layout), false); |
88 | 0 | } |
89 | ||
90 | /** | |
91 | * Construct a new PanelBuilder. | |
92 | * | |
93 | * @param panel The panel to build. | |
94 | * @param layout If true set a default layout (GridBagLayout) to the builded panel. | |
95 | */ | |
96 | public PanelBuilder(JPanel panel, boolean layout){ | |
97 | 0 | super(); |
98 | ||
99 | 0 | if(layout){ |
100 | 0 | panel.setLayout(new GridBagLayout()); |
101 | } | |
102 | ||
103 | 0 | this.panel = panel; |
104 | 0 | gbc = new GridBagUtils(); |
105 | ||
106 | 0 | initJThequeDefaults(); |
107 | 0 | } |
108 | ||
109 | /** | |
110 | * Init the panel with the JTheque defaults. | |
111 | */ | |
112 | void initJThequeDefaults() { | |
113 | 0 | panel.setBackground(Managers.getManager(IViewManager.class).getViewDefaults().getBackgroundColor()); |
114 | 0 | panel.setBorder(Borders.DIALOG_BORDER); |
115 | 0 | } |
116 | ||
117 | /** | |
118 | * Add a component to the panel with the specified constraints. | |
119 | * | |
120 | * @param component The component to add. | |
121 | * @param constraints The constraints to use to add to the panel. | |
122 | * @param <T> The type of component. | |
123 | * @return The added component. | |
124 | */ | |
125 | public <T extends Component> T add(T component, Object constraints) { | |
126 | 0 | panel.add(component, constraints); |
127 | ||
128 | 0 | return component; |
129 | } | |
130 | ||
131 | /** | |
132 | * Add a combo box. | |
133 | * | |
134 | * @param model The combo box model. | |
135 | * @param constraints The constraints to use to add to the panel. | |
136 | * @return The added JComboBox. | |
137 | */ | |
138 | public JComboBox addComboBox(DefaultComboBoxModel model, Object constraints) { | |
139 | 0 | JComboBox combo = new JComboBox(model); |
140 | ||
141 | 0 | combo.setBackground(Managers.getManager(IViewManager.class).getViewDefaults().getBackgroundColor()); |
142 | ||
143 | 0 | return add(combo, constraints); |
144 | } | |
145 | ||
146 | /** | |
147 | * Add a combo box with a specific renderer. | |
148 | * | |
149 | * @param model The combo box model. | |
150 | * @param renderer The renderer to use. | |
151 | * @param constraints The constraints to use to add to the panel. | |
152 | * @return The added JComboBox. | |
153 | */ | |
154 | public JComboBox addComboBox(DefaultComboBoxModel model, ListCellRenderer renderer, Object constraints) { | |
155 | 0 | JComboBox combo = addComboBox(model, constraints); |
156 | ||
157 | 0 | combo.setRenderer(renderer); |
158 | ||
159 | 0 | return combo; |
160 | } | |
161 | ||
162 | /** | |
163 | * Add an internationalized check box. | |
164 | * | |
165 | * @param key The internationalization key. | |
166 | * @param constraints The constraints to use to add to the panel. | |
167 | * @return The added JCheckBox. | |
168 | */ | |
169 | public JCheckBox addI18nCheckBox(String key, Object constraints) { | |
170 | 0 | return add(new JThequeCheckBox(key), constraints); |
171 | } | |
172 | ||
173 | /** | |
174 | * Add a <code>Jlist</code> with the specified model. | |
175 | * | |
176 | * @param model The model to use. | |
177 | * @param renderer The list renderer. | |
178 | * @param constraints The constraints to use to add to the panel. | |
179 | * @return The added JList. | |
180 | */ | |
181 | public JList addList(ListModel model, ListCellRenderer renderer, Object constraints) { | |
182 | 0 | JList list = new JList(model); |
183 | 0 | list.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); |
184 | 0 | list.setVisibleRowCount(12); |
185 | 0 | list.setValueIsAdjusting(true); |
186 | ||
187 | 0 | if (renderer != null) { |
188 | 0 | list.setCellRenderer(renderer); |
189 | } | |
190 | ||
191 | 0 | addScrolled(list, constraints); |
192 | ||
193 | 0 | return list; |
194 | } | |
195 | ||
196 | /** | |
197 | * Add a button to the panel. | |
198 | * | |
199 | * @param action The action to use with the button. | |
200 | * @param constraints The constraints to use to add to the panel. | |
201 | * @return The added button. | |
202 | */ | |
203 | public JButton addButton(Action action, Object constraints) { | |
204 | 0 | return add(new JButton(action), constraints); |
205 | } | |
206 | ||
207 | /** | |
208 | * Add a label to the panel. | |
209 | * | |
210 | * @param constraints The constraints to use to add to the panel. | |
211 | * | |
212 | * @return The added label. | |
213 | */ | |
214 | public JLabel addLabel(Object constraints) { | |
215 | 0 | return add(new JLabel(), constraints); |
216 | } | |
217 | ||
218 | /** | |
219 | * Add a label to the panel. | |
220 | * | |
221 | * @param text The text of the label. | |
222 | * @param constraints The constraints to use to add to the panel. | |
223 | * @return The added label. | |
224 | */ | |
225 | public JLabel addLabel(String text, Object constraints) { | |
226 | 0 | return add(new JLabel(text), constraints); |
227 | } | |
228 | ||
229 | /** | |
230 | * Add a label with a specific foreground to the panel. | |
231 | * | |
232 | * @param text The text of the label. | |
233 | * @param foreground The foreground color. | |
234 | * @param constraints The constraints to use to add to the panel. | |
235 | * @return The added label. | |
236 | */ | |
237 | public JLabel addLabel(String text, Color foreground, Object constraints) { | |
238 | 0 | JLabel label = addLabel(text, constraints); |
239 | ||
240 | 0 | label.setForeground(foreground); |
241 | ||
242 | 0 | return label; |
243 | } | |
244 | ||
245 | /** | |
246 | * Add an internationalized label to the panel. | |
247 | * | |
248 | * @param key The i18n key. | |
249 | * @param constraints The constraints to use to add to the panel. | |
250 | * @return The added label. | |
251 | */ | |
252 | public JThequeI18nLabel addI18nLabel(String key, Object constraints) { | |
253 | 0 | return addI18nLabel(key, 0, constraints); |
254 | } | |
255 | ||
256 | /** | |
257 | * Add an internationalized label with a specified style to the panel. | |
258 | * | |
259 | * @param key The i18n key. | |
260 | * @param constraints The constraints to use to add to the panel. | |
261 | * @param style The font style. | |
262 | * @return The added label. | |
263 | */ | |
264 | public JThequeI18nLabel addI18nLabel(String key, int style, Object constraints) { | |
265 | 0 | JThequeI18nLabel label = new JThequeI18nLabel(key); |
266 | ||
267 | 0 | if ((style & BOLD) == BOLD) { |
268 | 0 | label.setFont(label.getFont().deriveFont(Font.BOLD)); |
269 | } | |
270 | ||
271 | 0 | if ((style & ITALIC) == ITALIC) { |
272 | 0 | label.setFont(label.getFont().deriveFont(Font.ITALIC)); |
273 | } | |
274 | ||
275 | 0 | return add(label, constraints); |
276 | } | |
277 | ||
278 | /** | |
279 | * Add a scrolled text area. | |
280 | * | |
281 | * @param text The text of the text area. | |
282 | * @param constraints The constraints to use to add to the panel. | |
283 | */ | |
284 | public void addScrolledTextArea(String text, Object constraints) { | |
285 | 0 | addScrolled(new JTextArea(text), constraints); |
286 | 0 | } |
287 | ||
288 | /** | |
289 | * Add a JTree in a JScrollpane | |
290 | * | |
291 | * @param model The tree model. | |
292 | * @param renderer The tree renderer. | |
293 | * @param constraints The constraints to add the tree with. | |
294 | * | |
295 | * @return The added tree. | |
296 | */ | |
297 | public JXTree addScrolledTree(TreeModel model, TreeCellRenderer renderer, Object constraints){ | |
298 | 0 | JXTree tree = new JXTree(model); |
299 | ||
300 | 0 | if(renderer != null){ |
301 | 0 | tree.setCellRenderer(renderer); |
302 | } | |
303 | ||
304 | 0 | addScrolled(tree, constraints); |
305 | ||
306 | 0 | return tree; |
307 | } | |
308 | ||
309 | /** | |
310 | * Add a scrolled component. | |
311 | * | |
312 | * @param view The view. | |
313 | * @param constraints The constraints to use to add to the panel. | |
314 | */ | |
315 | public void addScrolled(JComponent view, Object constraints) { | |
316 | 0 | JScrollPane scrollPane = new JScrollPane(view); |
317 | ||
318 | 0 | scrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED); |
319 | 0 | scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED); |
320 | ||
321 | 0 | add(scrollPane, constraints); |
322 | 0 | } |
323 | ||
324 | /** | |
325 | * Add an internationalized separator. | |
326 | * | |
327 | * @param key The title key. | |
328 | * @param constraints The constraints to use to add to the panel. | |
329 | */ | |
330 | public void addI18nSeparator(String key, Object constraints) { | |
331 | 0 | PanelBuilder separatorBuilder = addPanel(constraints); |
332 | ||
333 | 0 | separatorBuilder.addI18nLabel(key, gbcSet(0, 0)); |
334 | 0 | separatorBuilder.add(new JSeparator(), gbcSet(1, 0, GridBagUtils.HORIZONTAL)); |
335 | 0 | } |
336 | ||
337 | /** | |
338 | * Add a button bar. | |
339 | * | |
340 | * @param constraints The constraints to use to add to the panel. | |
341 | * @param actions The actions to add to the button bar. | |
342 | */ | |
343 | public void addButtonBar(Object constraints, Action... actions) { | |
344 | 0 | ButtonBarBuilder builder = new ButtonBarBuilder(); |
345 | ||
346 | 0 | builder.addGlue(); |
347 | ||
348 | 0 | builder.addActions(actions); |
349 | ||
350 | 0 | add(builder.getPanel(), constraints); |
351 | 0 | } |
352 | ||
353 | /** | |
354 | * Add a panel to the panel. | |
355 | * | |
356 | * @param constraints The constraints to use to add to the panel. | |
357 | * @return The builder of the intern panel builder. | |
358 | */ | |
359 | public PanelBuilder addPanel(Object constraints) { | |
360 | 0 | PanelBuilder builder = new PanelBuilder(); |
361 | ||
362 | 0 | add(builder.getPanel(), constraints); |
363 | ||
364 | 0 | return builder; |
365 | } | |
366 | ||
367 | /** | |
368 | * Add a panel to the panel. | |
369 | * | |
370 | * @param layout The layout to use. | |
371 | * @param constraints The constraints to use to add to the panel. | |
372 | * | |
373 | * @return The builder of the intern panel builder. | |
374 | */ | |
375 | public PanelBuilder addPanel(LayoutManager layout, Object constraints) { | |
376 | 0 | PanelBuilder builder = new PanelBuilder(layout); |
377 | ||
378 | 0 | add(builder.getPanel(), constraints); |
379 | ||
380 | 0 | return builder; |
381 | } | |
382 | ||
383 | /** | |
384 | * Return the builded panel. | |
385 | * | |
386 | * @return The builded panel. | |
387 | */ | |
388 | public JComponent getPanel() { | |
389 | 0 | return panel; |
390 | } | |
391 | ||
392 | /** | |
393 | * Set the border of the panel. | |
394 | * | |
395 | * @param border The border to set to the panel. | |
396 | */ | |
397 | public void setBorder(Border border){ | |
398 | 0 | panel.setBorder(border); |
399 | 0 | } |
400 | ||
401 | /* GridBagUtils delegate methods */ | |
402 | ||
403 | /** | |
404 | * Set the default insets. | |
405 | * | |
406 | * @param defaultInsets The default insets. | |
407 | */ | |
408 | public void setDefaultInsets(Insets defaultInsets) { | |
409 | 0 | gbc.setDefaultInsets(defaultInsets); |
410 | 0 | } |
411 | ||
412 | /** | |
413 | * Create a new layout constraints. | |
414 | * | |
415 | * @param x The x position on the grid. | |
416 | * @param y The y position on the grid. | |
417 | * @param fill The fill constraint. | |
418 | * @param anchor The anchor constraint. | |
419 | * @param weightx The weight in x axis. | |
420 | * @param weighty The weight in y axis. | |
421 | * @return The layout constraints. | |
422 | */ | |
423 | public Object gbcSet(int x, int y, int fill, int anchor, double weightx, double weighty) { | |
424 | 0 | return gbc.gbcSet(x, y, fill, anchor, weightx, weighty); |
425 | } | |
426 | ||
427 | /** | |
428 | * Create a new layout constraints. | |
429 | * | |
430 | * @param x The x position on the grid. | |
431 | * @param y The y position on the grid. | |
432 | * @param fill The fill constraint. | |
433 | * @param anchor The anchor constraint. | |
434 | * @param width The col span. | |
435 | * @param height The row span. | |
436 | * @param weightx The weight in x axis. | |
437 | * @param weighty The weight in y axis. | |
438 | * @return The layout constraints. | |
439 | */ | |
440 | public Object gbcSet(int x, int y, int fill, int anchor, int width, int height, double weightx, double weighty) { | |
441 | 0 | return gbc.gbcSet(x, y, fill, anchor, width, height, weightx, weighty); |
442 | } | |
443 | ||
444 | /** | |
445 | * Configure and return the GridBagConstraints object. | |
446 | * | |
447 | * @param x The x position of the component. | |
448 | * @param y The y position of the component. | |
449 | * @param fill The fill constraints. | |
450 | * @param anchor The anchor of the component. | |
451 | * @param width The col span. | |
452 | * @param height The row span. | |
453 | * @param weightx The col fill weight. | |
454 | * @param weighty The row fill weight. | |
455 | * @param ipadx The x internal padding width. | |
456 | * @param ipady The y internal padding height. | |
457 | * @return The <code>GridBagConstraints</code> object. | |
458 | */ | |
459 | public Object gbcSet(int x, int y, int fill, int anchor, int width, int height, double weightx, double weighty, int ipadx, int ipady) { | |
460 | 0 | return gbc.gbcSet(x, y, fill, anchor, width, height, weightx, weighty, ipadx, ipady); |
461 | } | |
462 | ||
463 | /** | |
464 | * Create a new layout constraints. | |
465 | * | |
466 | * @param x The x position on the grid. | |
467 | * @param y The y position on the grid. | |
468 | * @param fill The fill constraint. | |
469 | * @param anchor The anchor constraint. | |
470 | * @param width The col span. | |
471 | * @param height The row span. | |
472 | * @return The layout constraints. | |
473 | */ | |
474 | public Object gbcSet(int x, int y, int fill, int anchor, int width, int height) { | |
475 | 0 | return gbc.gbcSet(x, y, fill, anchor, width, height); |
476 | } | |
477 | ||
478 | /** | |
479 | * Create a new layout constraints. | |
480 | * | |
481 | * @param x The x position on the grid. | |
482 | * @param y The y position on the grid. | |
483 | * @param fill The fill constraint. | |
484 | * @param width The col span. | |
485 | * @param height The row span. | |
486 | * @return The layout constraints. | |
487 | */ | |
488 | public Object gbcSet(int x, int y, int fill, int width, int height) { | |
489 | 0 | return gbc.gbcSet(x, y, fill, GridBagUtils.BASELINE_LEADING, width, height); |
490 | } | |
491 | ||
492 | /** | |
493 | * Create a new layout constraints. | |
494 | * | |
495 | * @param x The x position on the grid. | |
496 | * @param y The y position on the grid. | |
497 | * @param fill The fill constraint. | |
498 | * @param anchor The anchor constraint. | |
499 | * @return The layout constraints. | |
500 | */ | |
501 | public Object gbcSet(int x, int y, int fill, int anchor) { | |
502 | 0 | return gbc.gbcSet(x, y, fill, anchor); |
503 | } | |
504 | ||
505 | /** | |
506 | * Create a new layout constraints. | |
507 | * | |
508 | * @param x The x position on the grid. | |
509 | * @param y The y position on the grid. | |
510 | * @param fill The fill constraint. | |
511 | * @return The layout constraints. | |
512 | */ | |
513 | public Object gbcSet(int x, int y, int fill) { | |
514 | 0 | return gbc.gbcSet(x, y, fill); |
515 | } | |
516 | ||
517 | /** | |
518 | * Create a new layout constraints. | |
519 | * | |
520 | * @param x The x position on the grid. | |
521 | * @param y The y position on the grid. | |
522 | * @return The layout constraints. | |
523 | */ | |
524 | public Object gbcSet(int x, int y) { | |
525 | 0 | return gbc.gbcSet(x, y); |
526 | } | |
527 | } |