2 * Jexer - Java Text User Interface
4 * The MIT License (MIT)
6 * Copyright (C) 2019 Kevin Lamonte
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:
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
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.
26 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
31 import jexer
.bits
.CellAttributes
;
32 import jexer
.bits
.GraphicsChars
;
33 import jexer
.bits
.MnemonicString
;
34 import jexer
.bits
.StringUtils
;
35 import jexer
.event
.TKeypressEvent
;
36 import jexer
.event
.TMouseEvent
;
37 import static jexer
.TKeypress
.*;
40 * TRadioButton implements a selectable radio button.
42 * If the user clicks or presses space on this button, it is selected.
44 * If the user presses escape on this button, it is unselected.
46 public class TRadioButton
extends TWidget
{
48 // ------------------------------------------------------------------------
49 // Variables --------------------------------------------------------------
50 // ------------------------------------------------------------------------
53 * RadioButton state, true means selected.
55 private boolean selected
= false;
58 * The shortcut and radio button label.
60 private MnemonicString mnemonic
;
63 * ID for this radio button. Buttons start counting at 1 in the
68 // ------------------------------------------------------------------------
69 // Constructors -----------------------------------------------------------
70 // ------------------------------------------------------------------------
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
81 public TRadioButton(final TRadioGroup parent
, final int x
, final int y
,
82 final String label
, final int id
) {
84 // Set parent and window
85 super(parent
, x
, y
, StringUtils
.width(label
) + 4, 1);
87 mnemonic
= new MnemonicString(label
);
90 setCursorVisible(true);
94 // ------------------------------------------------------------------------
95 // Event handlers ---------------------------------------------------------
96 // ------------------------------------------------------------------------
99 * Returns true if the mouse is currently on the radio button.
101 * @param mouse mouse event
102 * @return if true the mouse is currently on the radio button
104 private boolean mouseOnRadioButton(final TMouseEvent mouse
) {
105 if ((mouse
.getY() == 0)
106 && (mouse
.getX() >= 0)
107 && (mouse
.getX() <= 2)
115 * Handle mouse button presses.
117 * @param mouse mouse button press event
120 public void onMouseDown(final TMouseEvent mouse
) {
121 if ((mouseOnRadioButton(mouse
)) && (mouse
.isMouse1())) {
124 ((TRadioGroup
) getParent()).setSelected(this);
131 * @param keypress keystroke event
134 public void onKeypress(final TKeypressEvent keypress
) {
136 if (keypress
.equals(kbSpace
)) {
138 ((TRadioGroup
) getParent()).setSelected(this);
142 if (keypress
.equals(kbEsc
)) {
143 TRadioGroup parent
= (TRadioGroup
) getParent();
144 if (parent
.requiresSelection
== false) {
146 parent
.setSelected(0);
151 // Pass to parent for the things we don't care about.
152 super.onKeypress(keypress
);
155 // ------------------------------------------------------------------------
156 // TWidget ----------------------------------------------------------------
157 // ------------------------------------------------------------------------
160 * Draw a radio button with label.
164 CellAttributes radioButtonColor
;
165 CellAttributes mnemonicColor
;
167 if (isAbsoluteActive()) {
168 radioButtonColor
= getTheme().getColor("tradiobutton.active");
169 mnemonicColor
= getTheme().getColor("tradiobutton.mnemonic.highlighted");
171 radioButtonColor
= getTheme().getColor("tradiobutton.inactive");
172 mnemonicColor
= getTheme().getColor("tradiobutton.mnemonic");
175 putCharXY(0, 0, '(', radioButtonColor
);
177 putCharXY(1, 0, GraphicsChars
.CP437
[0x07], radioButtonColor
);
179 putCharXY(1, 0, ' ', radioButtonColor
);
181 putCharXY(2, 0, ')', radioButtonColor
);
182 putStringXY(4, 0, mnemonic
.getRawLabel(), radioButtonColor
);
183 if (mnemonic
.getScreenShortcutIdx() >= 0) {
184 putCharXY(4 + mnemonic
.getScreenShortcutIdx(), 0,
185 mnemonic
.getShortcut(), mnemonicColor
);
189 // ------------------------------------------------------------------------
190 // TRadioButton -----------------------------------------------------------
191 // ------------------------------------------------------------------------
194 * Get RadioButton state, true means selected.
196 * @return if true then this is the one button in the group that is
199 public boolean isSelected() {
204 * Set RadioButton state, true means selected. Note package private
207 * @param selected if true then this is the one button in the group that
210 void setSelected(final boolean selected
) {
211 this.selected
= selected
;
215 * Get ID for this radio button. Buttons start counting at 1 in the
225 * Get the mnemonic string for this button.
227 * @return mnemonic string
229 public MnemonicString
getMnemonic() {