2 * Jexer - Java Text User Interface
4 * The MIT License (MIT)
6 * Copyright (C) 2017 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
.event
.TKeypressEvent
;
34 import jexer
.event
.TMenuEvent
;
35 import jexer
.event
.TMouseEvent
;
36 import jexer
.event
.TResizeEvent
;
39 * TDesktop is a special-class window that is drawn underneath everything
40 * else. Like a TWindow, it can contain widgets and perform "background"
41 * processing via onIdle(). But unlike a TWindow, it cannot be hidden,
45 * Events are passed to TDesktop as follows:
47 * <li>Mouse events are seen if they do not cover any other windows.</li>
48 * <li>Keypress events are seen if no other windows are open.</li>
49 * <li>Menu events are seen if no other windows are open.</li>
50 * <li>Command events are seen if no other windows are open.</li>
53 public class TDesktop
extends TWindow
{
58 * @param parent parent application
60 public TDesktop(final TApplication parent
) {
62 super(parent
, "", 0, 0, parent
.getScreen().getWidth(),
63 parent
.getScreen().getHeight() - 1);
69 * The default TDesktop draws a hatch character across everything.
73 CellAttributes background
= getTheme().getColor("tdesktop.background");
74 putAll(GraphicsChars
.HATCH
, background
);
78 * Hide window. This is a NOP for TDesktop.
81 public final void hide() {}
84 * Show window. This is a NOP for TDesktop.
87 public final void show() {}
90 * Called by hide(). This is a NOP for TDesktop.
93 public final void onHide() {}
96 * Called by show(). This is a NOP for TDesktop.
99 public final void onShow() {}
102 * Returns true if the mouse is currently on the close button.
104 * @return true if mouse is currently on the close button
107 protected final boolean mouseOnClose() {
112 * Returns true if the mouse is currently on the maximize/restore button.
114 * @return true if the mouse is currently on the maximize/restore button
117 protected final boolean mouseOnMaximize() {
122 * Returns true if the mouse is currently on the resizable lower right
125 * @return true if the mouse is currently on the resizable lower right
129 protected final boolean mouseOnResize() {
134 * Handle mouse button presses.
136 * @param mouse mouse button event
139 public void onMouseDown(final TMouseEvent mouse
) {
143 for (TWidget widget
: getChildren()) {
144 if (widget
.mouseWouldHit(mouse
)) {
145 // Dispatch to this child, also activate it
148 // Set x and y relative to the child's coordinates
149 mouse
.setX(mouse
.getAbsoluteX() - widget
.getAbsoluteX());
150 mouse
.setY(mouse
.getAbsoluteY() - widget
.getAbsoluteY());
151 widget
.handleEvent(mouse
);
158 * Handle mouse button releases.
160 * @param mouse mouse button release event
163 public void onMouseUp(final TMouseEvent mouse
) {
167 for (TWidget widget
: getChildren()) {
168 if (widget
.mouseWouldHit(mouse
)) {
169 // Dispatch to this child, also activate it
172 // Set x and y relative to the child's coordinates
173 mouse
.setX(mouse
.getAbsoluteX() - widget
.getAbsoluteX());
174 mouse
.setY(mouse
.getAbsoluteY() - widget
.getAbsoluteY());
175 widget
.handleEvent(mouse
);
182 * Handle mouse movements.
184 * @param mouse mouse motion event
187 public void onMouseMotion(final TMouseEvent mouse
) {
190 // Default: do nothing, pass to children instead
191 super.onMouseMotion(mouse
);
197 * @param keypress keystroke event
200 public void onKeypress(final TKeypressEvent keypress
) {
201 // Default: do nothing, pass to children instead
202 super.onKeypress(keypress
);
206 * Handle posted menu events.
208 * @param menu menu event
211 public void onMenu(final TMenuEvent menu
) {
212 // Default: do nothing, pass to children instead