Commit | Line | Data |
---|---|---|
daa4106c | 1 | /* |
00d2622b KL |
2 | * Jexer - Java Text User Interface |
3 | * | |
e16dda65 | 4 | * The MIT License (MIT) |
00d2622b | 5 | * |
a69ed767 | 6 | * Copyright (C) 2019 Kevin Lamonte |
00d2622b | 7 | * |
e16dda65 KL |
8 | * Permission is hereby granted, free of charge, to any person obtaining a |
9 | * copy of this software and associated documentation files (the "Software"), | |
10 | * to deal in the Software without restriction, including without limitation | |
11 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
12 | * and/or sell copies of the Software, and to permit persons to whom the | |
13 | * Software is furnished to do so, subject to the following conditions: | |
00d2622b | 14 | * |
e16dda65 KL |
15 | * The above copyright notice and this permission notice shall be included in |
16 | * all copies or substantial portions of the Software. | |
00d2622b | 17 | * |
e16dda65 KL |
18 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
19 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
20 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
21 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
22 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |
23 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER | |
24 | * DEALINGS IN THE SOFTWARE. | |
00d2622b KL |
25 | * |
26 | * @author Kevin Lamonte [kevin.lamonte@gmail.com] | |
27 | * @version 1 | |
28 | */ | |
29 | package jexer; | |
30 | ||
31 | import jexer.bits.CellAttributes; | |
9f613a0c | 32 | import jexer.bits.StringUtils; |
00d2622b KL |
33 | |
34 | /** | |
35 | * TRadioGroup is a collection of TRadioButtons with a box and label. | |
36 | */ | |
051e2913 | 37 | public class TRadioGroup extends TWidget { |
00d2622b | 38 | |
615a0d99 KL |
39 | // ------------------------------------------------------------------------ |
40 | // Variables -------------------------------------------------------------- | |
41 | // ------------------------------------------------------------------------ | |
42 | ||
00d2622b KL |
43 | /** |
44 | * Label for this radio button group. | |
45 | */ | |
46 | private String label; | |
47 | ||
48 | /** | |
49 | * Only one of my children can be selected. | |
50 | */ | |
51 | private TRadioButton selectedButton = null; | |
52 | ||
00691e80 KL |
53 | /** |
54 | * If true, one of the children MUST be selected. Note package private | |
55 | * access. | |
56 | */ | |
57 | boolean requiresSelection = true; | |
58 | ||
615a0d99 KL |
59 | // ------------------------------------------------------------------------ |
60 | // Constructors ----------------------------------------------------------- | |
61 | // ------------------------------------------------------------------------ | |
00d2622b KL |
62 | |
63 | /** | |
64 | * Public constructor. | |
65 | * | |
66 | * @param parent parent widget | |
67 | * @param x column relative to parent | |
68 | * @param y row relative to parent | |
69 | * @param label label to display on the group box | |
70 | */ | |
71 | public TRadioGroup(final TWidget parent, final int x, final int y, | |
72 | final String label) { | |
73 | ||
74 | // Set parent and window | |
9f613a0c | 75 | super(parent, x, y, StringUtils.width(label) + 4, 2); |
00d2622b | 76 | |
00d2622b | 77 | this.label = label; |
00d2622b KL |
78 | } |
79 | ||
615a0d99 KL |
80 | // ------------------------------------------------------------------------ |
81 | // TWidget ---------------------------------------------------------------- | |
82 | // ------------------------------------------------------------------------ | |
83 | ||
d8dc8aea KL |
84 | /** |
85 | * Override TWidget's width: we can only set width at construction time. | |
86 | * | |
87 | * @param width new widget width (ignored) | |
88 | */ | |
89 | @Override | |
90 | public void setWidth(final int width) { | |
91 | // Do nothing | |
92 | } | |
93 | ||
94 | /** | |
95 | * Override TWidget's height: we can only set height at construction | |
96 | * time. | |
97 | * | |
98 | * @param height new widget height (ignored) | |
99 | */ | |
100 | @Override | |
101 | public void setHeight(final int height) { | |
102 | // Do nothing | |
103 | } | |
104 | ||
00d2622b KL |
105 | /** |
106 | * Draw a radio button with label. | |
107 | */ | |
108 | @Override | |
109 | public void draw() { | |
110 | CellAttributes radioGroupColor; | |
111 | ||
7c870d89 | 112 | if (isAbsoluteActive()) { |
00d2622b KL |
113 | radioGroupColor = getTheme().getColor("tradiogroup.active"); |
114 | } else { | |
115 | radioGroupColor = getTheme().getColor("tradiogroup.inactive"); | |
116 | } | |
117 | ||
a69ed767 KL |
118 | drawBox(0, 0, getWidth(), getHeight(), radioGroupColor, radioGroupColor, |
119 | 3, false); | |
00d2622b | 120 | |
9f613a0c | 121 | hLineXY(1, 0, StringUtils.width(label) + 2, ' ', radioGroupColor); |
a69ed767 | 122 | putStringXY(2, 0, label, radioGroupColor); |
00d2622b KL |
123 | } |
124 | ||
615a0d99 KL |
125 | // ------------------------------------------------------------------------ |
126 | // TRadioGroup ------------------------------------------------------------ | |
127 | // ------------------------------------------------------------------------ | |
128 | ||
129 | /** | |
130 | * Get the radio button ID that was selected. | |
131 | * | |
132 | * @return ID of the selected button, or 0 if no button is selected | |
133 | */ | |
134 | public int getSelected() { | |
135 | if (selectedButton == null) { | |
136 | return 0; | |
137 | } | |
138 | return selectedButton.getId(); | |
139 | } | |
140 | ||
141 | /** | |
142 | * Set the new selected radio button. Note package private access. | |
143 | * | |
144 | * @param button new button that became selected | |
145 | */ | |
146 | void setSelected(final TRadioButton button) { | |
147 | assert (button.isSelected()); | |
00691e80 | 148 | if ((selectedButton != null) && (selectedButton != button)) { |
615a0d99 KL |
149 | selectedButton.setSelected(false); |
150 | } | |
151 | selectedButton = button; | |
152 | } | |
153 | ||
00691e80 KL |
154 | /** |
155 | * Set the new selected radio button. 1-based. | |
156 | * | |
157 | * @param id ID of the selected button, or 0 to unselect | |
158 | */ | |
159 | public void setSelected(final int id) { | |
160 | if ((id < 0) || (id > getChildren().size())) { | |
161 | return; | |
162 | } | |
163 | ||
164 | if (id == 0) { | |
165 | for (TWidget widget: getChildren()) { | |
166 | ((TRadioButton) widget).setSelected(false); | |
167 | } | |
168 | selectedButton = null; | |
169 | return; | |
170 | } | |
171 | assert ((id > 0) && (id <= getChildren().size())); | |
172 | TRadioButton button = (TRadioButton) (getChildren().get(id - 1)); | |
173 | button.setSelected(true); | |
174 | selectedButton = button; | |
175 | } | |
176 | ||
00d2622b KL |
177 | /** |
178 | * Convenience function to add a radio button to this group. | |
179 | * | |
180 | * @param label label to display next to (right of) the radiobutton | |
181 | * @return the new radio button | |
182 | */ | |
183 | public TRadioButton addRadioButton(final String label) { | |
184 | int buttonX = 1; | |
185 | int buttonY = getChildren().size() + 1; | |
9f613a0c | 186 | if (StringUtils.width(label) + 4 > getWidth()) { |
d8dc8aea | 187 | super.setWidth(StringUtils.width(label) + 7); |
00d2622b | 188 | } |
d8dc8aea | 189 | super.setHeight(getChildren().size() + 3); |
00691e80 | 190 | TRadioButton button = new TRadioButton(this, buttonX, buttonY, label, |
00d2622b | 191 | getChildren().size() + 1); |
00691e80 | 192 | |
8afe8fa7 KL |
193 | if (getParent().getLayoutManager() != null) { |
194 | getParent().getLayoutManager().resetSize(this); | |
195 | } | |
196 | ||
00691e80 KL |
197 | // Default to the first item on the list. |
198 | activate(getChildren().get(0)); | |
199 | ||
200 | return button; | |
00d2622b KL |
201 | } |
202 | ||
203 | } |