code cleanup
[fanfix.git] / src / jexer / TRadioButton.java
CommitLineData
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 */
29package jexer;
30
31import jexer.bits.CellAttributes;
32import jexer.bits.GraphicsChars;
00691e80 33import jexer.bits.MnemonicString;
9f613a0c 34import jexer.bits.StringUtils;
00d2622b
KL
35import jexer.event.TKeypressEvent;
36import jexer.event.TMouseEvent;
37import static jexer.TKeypress.*;
38
39/**
40 * TRadioButton implements a selectable radio button.
00691e80
KL
41 *
42 * If the user clicks or presses space on this button, it is selected.
43 *
44 * If the user presses escape on this button, it is unselected.
00d2622b 45 */
051e2913 46public class TRadioButton extends TWidget {
00d2622b 47
d36057df
KL
48 // ------------------------------------------------------------------------
49 // Variables --------------------------------------------------------------
50 // ------------------------------------------------------------------------
51
00d2622b 52 /**
b2efac6e 53 * RadioButton state, true means selected. Note package private access.
00d2622b 54 */
b2efac6e 55 boolean selected = false;
00d2622b 56
00d2622b 57 /**
00691e80 58 * The shortcut and radio button label.
00d2622b 59 */
00691e80 60 private MnemonicString mnemonic;
00d2622b
KL
61
62 /**
63 * ID for this radio button. Buttons start counting at 1 in the
b2efac6e 64 * RadioGroup. Note package private access.
00d2622b 65 */
b2efac6e 66 int id;
00d2622b 67
d36057df
KL
68 // ------------------------------------------------------------------------
69 // Constructors -----------------------------------------------------------
70 // ------------------------------------------------------------------------
00d2622b
KL
71
72 /**
b2efac6e 73 * Package private constructor.
00d2622b
KL
74 *
75 * @param parent parent widget
76 * @param x column relative to parent
77 * @param y row relative to parent
78 * @param label label to display next to (right of) the radiobutton
79 * @param id ID for this radio button
80 */
b2efac6e 81 TRadioButton(final TRadioGroup parent, final int x, final int y,
00d2622b
KL
82 final String label, final int id) {
83
84 // Set parent and window
9f613a0c 85 super(parent, x, y, StringUtils.width(label) + 4, 1);
00d2622b 86
00691e80 87 mnemonic = new MnemonicString(label);
00d2622b
KL
88 this.id = id;
89
7c870d89 90 setCursorVisible(true);
00d2622b 91 setCursorX(1);
b2efac6e
KL
92
93 parent.addRadioButton(this);
00d2622b
KL
94 }
95
d36057df
KL
96 // ------------------------------------------------------------------------
97 // Event handlers ---------------------------------------------------------
98 // ------------------------------------------------------------------------
99
00d2622b
KL
100 /**
101 * Returns true if the mouse is currently on the radio button.
102 *
103 * @param mouse mouse event
104 * @return if true the mouse is currently on the radio button
105 */
106 private boolean mouseOnRadioButton(final TMouseEvent mouse) {
107 if ((mouse.getY() == 0)
108 && (mouse.getX() >= 0)
109 && (mouse.getX() <= 2)
110 ) {
111 return true;
112 }
113 return false;
114 }
115
00d2622b
KL
116 /**
117 * Handle mouse button presses.
118 *
119 * @param mouse mouse button press event
120 */
121 @Override
122 public void onMouseDown(final TMouseEvent mouse) {
7c870d89 123 if ((mouseOnRadioButton(mouse)) && (mouse.isMouse1())) {
00d2622b 124 // Switch state
b2efac6e 125 ((TRadioGroup) getParent()).setSelected(id);
00d2622b
KL
126 }
127 }
128
129 /**
130 * Handle keystrokes.
131 *
132 * @param keypress keystroke event
133 */
134 @Override
135 public void onKeypress(final TKeypressEvent keypress) {
136
137 if (keypress.equals(kbSpace)) {
b2efac6e 138 ((TRadioGroup) getParent()).setSelected(id);
00691e80
KL
139 return;
140 }
141
142 if (keypress.equals(kbEsc)) {
143 TRadioGroup parent = (TRadioGroup) getParent();
144 if (parent.requiresSelection == false) {
145 selected = false;
146 parent.setSelected(0);
00d2622b
KL
147 }
148 return;
149 }
150
151 // Pass to parent for the things we don't care about.
152 super.onKeypress(keypress);
153 }
154
d36057df
KL
155 // ------------------------------------------------------------------------
156 // TWidget ----------------------------------------------------------------
157 // ------------------------------------------------------------------------
158
d8dc8aea
KL
159 /**
160 * Override TWidget's width: we can only set width at construction time.
161 *
162 * @param width new widget width (ignored)
163 */
164 @Override
165 public void setWidth(final int width) {
166 // Do nothing
167 }
168
169 /**
170 * Override TWidget's height: we can only set height at construction
171 * time.
172 *
173 * @param height new widget height (ignored)
174 */
175 @Override
176 public void setHeight(final int height) {
177 // Do nothing
178 }
179
d36057df
KL
180 /**
181 * Draw a radio button with label.
182 */
183 @Override
184 public void draw() {
185 CellAttributes radioButtonColor;
00691e80 186 CellAttributes mnemonicColor;
d36057df
KL
187
188 if (isAbsoluteActive()) {
189 radioButtonColor = getTheme().getColor("tradiobutton.active");
00691e80 190 mnemonicColor = getTheme().getColor("tradiobutton.mnemonic.highlighted");
d36057df
KL
191 } else {
192 radioButtonColor = getTheme().getColor("tradiobutton.inactive");
00691e80 193 mnemonicColor = getTheme().getColor("tradiobutton.mnemonic");
d36057df
KL
194 }
195
a69ed767 196 putCharXY(0, 0, '(', radioButtonColor);
d36057df 197 if (selected) {
a69ed767 198 putCharXY(1, 0, GraphicsChars.CP437[0x07], radioButtonColor);
d36057df 199 } else {
a69ed767 200 putCharXY(1, 0, ' ', radioButtonColor);
d36057df 201 }
a69ed767 202 putCharXY(2, 0, ')', radioButtonColor);
00691e80 203 putStringXY(4, 0, mnemonic.getRawLabel(), radioButtonColor);
9f613a0c
KL
204 if (mnemonic.getScreenShortcutIdx() >= 0) {
205 putCharXY(4 + mnemonic.getScreenShortcutIdx(), 0,
00691e80
KL
206 mnemonic.getShortcut(), mnemonicColor);
207 }
d36057df
KL
208 }
209
210 // ------------------------------------------------------------------------
211 // TRadioButton -----------------------------------------------------------
212 // ------------------------------------------------------------------------
213
214 /**
215 * Get RadioButton state, true means selected.
216 *
217 * @return if true then this is the one button in the group that is
218 * selected
219 */
220 public boolean isSelected() {
221 return selected;
222 }
223
224 /**
b2efac6e 225 * Set RadioButton state, true means selected.
d36057df
KL
226 *
227 * @param selected if true then this is the one button in the group that
228 * is selected
229 */
b2efac6e
KL
230 public void setSelected(final boolean selected) {
231 if (selected == true) {
232 ((TRadioGroup) getParent()).setSelected(id);
233 } else {
234 ((TRadioGroup) getParent()).setSelected(0);
235 }
d36057df
KL
236 }
237
238 /**
239 * Get ID for this radio button. Buttons start counting at 1 in the
240 * RadioGroup.
241 *
242 * @return the ID
243 */
244 public int getId() {
245 return id;
246 }
247
00691e80
KL
248 /**
249 * Get the mnemonic string for this button.
250 *
251 * @return mnemonic string
252 */
253 public MnemonicString getMnemonic() {
254 return mnemonic;
255 }
256
00d2622b 257}