2 * Jexer - Java Text User Interface
4 * License: LGPLv3 or later
6 * This module is licensed under the GNU Lesser General Public License
7 * Version 3. Please see the file "COPYING" in this directory for more
8 * information about the GNU Lesser General Public License Version 3.
10 * Copyright (C) 2015 Kevin Lamonte
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU Lesser General Public License
14 * as published by the Free Software Foundation; either version 3 of
15 * the License, or (at your option) any later version.
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * General Public License for more details.
22 * You should have received a copy of the GNU Lesser General Public
23 * License along with this program; if not, see
24 * http://www.gnu.org/licenses/, or write to the Free Software
25 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
28 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
33 import jexer
.bits
.Cell
;
34 import jexer
.bits
.CellAttributes
;
35 import jexer
.bits
.GraphicsChars
;
36 import jexer
.event
.TCommandEvent
;
37 import jexer
.event
.TKeypressEvent
;
38 import jexer
.event
.TMenuEvent
;
39 import jexer
.event
.TMouseEvent
;
40 import jexer
.event
.TResizeEvent
;
41 import jexer
.io
.Screen
;
42 import jexer
.menu
.TMenu
;
43 import static jexer
.TCommand
.*;
44 import static jexer
.TKeypress
.*;
47 * TWindow is the top-level container and drawing surface for other widgets.
49 public class TWindow
extends TWidget
{
52 * Window's parent TApplication.
54 private TApplication application
;
57 * Get this TWindow's parent TApplication.
59 * @return this TWindow's parent TApplication
62 public final TApplication
getApplication() {
72 public final Screen
getScreen() {
73 return application
.getScreen();
79 private String title
= "";
84 * @return window title
86 public final String
getTitle() {
93 * @param title new window title
95 public final void setTitle(final String title
) {
100 * Window is resizable (default yes).
102 public static final int RESIZABLE
= 0x01;
105 * Window is modal (default no).
107 public static final int MODAL
= 0x02;
110 * Window is centered (default no).
112 public static final int CENTERED
= 0x04;
117 private int flags
= RESIZABLE
;
120 * Z order. Lower number means more in-front.
125 * Get Z order. Lower number means more in-front.
127 * @return Z value. Lower number means more in-front.
129 public final int getZ() {
134 * Set Z order. Lower number means more in-front.
136 * @param z the new Z value. Lower number means more in-front.
138 public final void setZ(final int z
) {
143 * If true, then the user clicked on the title bar and is moving the
146 protected boolean inWindowMove
= false;
149 * If true, then the user clicked on the bottom right corner and is
150 * resizing the window.
152 protected boolean inWindowResize
= false;
155 * If true, then the user selected "Size/Move" (or hit Ctrl-F5) and is
156 * resizing/moving the window via the keyboard.
158 private boolean inKeyboardResize
= false;
161 * If true, this window is maximized.
163 private boolean maximized
= false;
166 * Remember mouse state.
168 protected TMouseEvent mouse
;
170 // For moving the window. resizing also uses moveWindowMouseX/Y
171 private int moveWindowMouseX
;
172 private int moveWindowMouseY
;
173 private int oldWindowX
;
174 private int oldWindowY
;
177 private int resizeWindowWidth
;
178 private int resizeWindowHeight
;
179 private int minimumWindowWidth
= 10;
180 private int minimumWindowHeight
= 2;
181 private int maximumWindowWidth
= -1;
182 private int maximumWindowHeight
= -1;
184 // For maximize/restore
185 private int restoreWindowWidth
;
186 private int restoreWindowHeight
;
187 private int restoreWindowX
;
188 private int restoreWindowY
;
191 * Set the maximum width for this window.
193 * @param maximumWindowWidth new maximum width
195 public final void setMaximumWindowWidth(final int maximumWindowWidth
) {
196 this.maximumWindowWidth
= maximumWindowWidth
;
200 * Public constructor. Window will be located at (0, 0).
202 * @param application TApplication that manages this window
203 * @param title window title, will be centered along the top border
204 * @param width width of window
205 * @param height height of window
207 public TWindow(final TApplication application
, final String title
,
208 final int width
, final int height
) {
210 this(application
, title
, 0, 0, width
, height
, RESIZABLE
);
214 * Public constructor. Window will be located at (0, 0).
216 * @param application TApplication that manages this window
217 * @param title window title, will be centered along the top border
218 * @param width width of window
219 * @param height height of window
220 * @param flags bitmask of RESIZABLE, CENTERED, or MODAL
222 public TWindow(final TApplication application
, final String title
,
223 final int width
, final int height
, final int flags
) {
225 this(application
, title
, 0, 0, width
, height
, flags
);
229 * Public constructor.
231 * @param application TApplication that manages this window
232 * @param title window title, will be centered along the top border
233 * @param x column relative to parent
234 * @param y row relative to parent
235 * @param width width of window
236 * @param height height of window
238 public TWindow(final TApplication application
, final String title
,
239 final int x
, final int y
, final int width
, final int height
) {
241 this(application
, title
, x
, y
, width
, height
, RESIZABLE
);
245 * Public constructor.
247 * @param application TApplication that manages this window
248 * @param title window title, will be centered along the top border
249 * @param x column relative to parent
250 * @param y row relative to parent
251 * @param width width of window
252 * @param height height of window
253 * @param flags mask of RESIZABLE, CENTERED, or MODAL
255 public TWindow(final TApplication application
, final String title
,
256 final int x
, final int y
, final int width
, final int height
,
261 // I am my own window and parent
262 setupForTWindow(this, x
, y
+ application
.getDesktopTop(),
267 this.application
= application
;
270 // Minimum width/height are 10 and 2
271 assert (width
>= 10);
272 assert (getHeight() >= 2);
274 // MODAL implies CENTERED
276 this.flags
|= CENTERED
;
279 // Center window if specified
282 // Add me to the application
283 application
.addWindow(this);
287 * Recenter the window on-screen.
289 public final void center() {
290 if ((flags
& CENTERED
) != 0) {
291 if (getWidth() < getScreen().getWidth()) {
292 setX((getScreen().getWidth() - getWidth()) / 2);
296 setY(((application
.getDesktopBottom()
297 - application
.getDesktopTop()) - getHeight()) / 2);
301 setY(getY() + application
.getDesktopTop());
306 * Returns true if this window is modal.
308 * @return true if this window is modal
310 public final boolean isModal() {
311 if ((flags
& MODAL
) == 0) {
318 * Returns true if the mouse is currently on the close button.
320 * @return true if mouse is currently on the close button
322 private boolean mouseOnClose() {
324 && (mouse
.getAbsoluteY() == getY())
325 && (mouse
.getAbsoluteX() == getX() + 3)
333 * Returns true if the mouse is currently on the maximize/restore button.
335 * @return true if the mouse is currently on the maximize/restore button
337 private boolean mouseOnMaximize() {
340 && (mouse
.getAbsoluteY() == getY())
341 && (mouse
.getAbsoluteX() == getX() + getWidth() - 4)
349 * Returns true if the mouse is currently on the resizable lower right
352 * @return true if the mouse is currently on the resizable lower right
355 private boolean mouseOnResize() {
356 if (((flags
& RESIZABLE
) != 0)
359 && (mouse
.getAbsoluteY() == getY() + getHeight() - 1)
360 && ((mouse
.getAbsoluteX() == getX() + getWidth() - 1)
361 || (mouse
.getAbsoluteX() == getX() + getWidth() - 2))
369 * Retrieve the background color.
371 * @return the background color
373 public final CellAttributes
getBackground() {
375 && (inWindowMove
|| inWindowResize
|| inKeyboardResize
)
378 return getTheme().getColor("twindow.background.windowmove");
379 } else if (isModal() && inWindowMove
) {
381 return getTheme().getColor("twindow.background.modal");
382 } else if (isModal()) {
384 return getTheme().getColor("twindow.background.modal");
386 return getTheme().getColor("twindow.background.modal.inactive");
387 } else if (isActive()) {
389 return getTheme().getColor("twindow.background");
392 return getTheme().getColor("twindow.background.inactive");
397 * Retrieve the border color.
399 * @return the border color
401 private CellAttributes
getBorder() {
403 && (inWindowMove
|| inWindowResize
|| inKeyboardResize
)
406 return getTheme().getColor("twindow.border.windowmove");
407 } else if (isModal() && inWindowMove
) {
409 return getTheme().getColor("twindow.border.modal.windowmove");
410 } else if (isModal()) {
412 return getTheme().getColor("twindow.border.modal");
414 return getTheme().getColor("twindow.border.modal.inactive");
416 } else if (isActive()) {
418 return getTheme().getColor("twindow.border");
421 return getTheme().getColor("twindow.border.inactive");
426 * Retrieve the border line type.
428 * @return the border line type
430 private int getBorderType() {
432 && (inWindowMove
|| inWindowResize
|| inKeyboardResize
)
436 } else if (isModal() && inWindowMove
) {
439 } else if (isModal()) {
445 } else if (isActive()) {
453 * Subclasses should override this method to cleanup resources. This is
454 * called by application.closeWindow().
456 public void onClose() {
457 // Default: do nothing
461 * Called by application.switchWindow() when this window gets the
462 * focus, and also by application.addWindow().
464 public void onFocus() {
465 // Default: do nothing
469 * Called by application.switchWindow() when another window gets the
472 public void onUnfocus() {
473 // Default: do nothing
477 * Called by TApplication.drawChildren() to render on screen.
481 // Draw the box and background first.
482 CellAttributes border
= getBorder();
483 CellAttributes background
= getBackground();
484 int borderType
= getBorderType();
486 getScreen().drawBox(0, 0, getWidth(), getHeight(), border
,
487 background
, borderType
, true);
490 int titleLeft
= (getWidth() - title
.length() - 2) / 2;
491 putCharXY(titleLeft
, 0, ' ', border
);
492 putStringXY(titleLeft
+ 1, 0, title
);
493 putCharXY(titleLeft
+ title
.length() + 1, 0, ' ', border
);
497 // Draw the close button
498 putCharXY(2, 0, '[', border
);
499 putCharXY(4, 0, ']', border
);
500 if (mouseOnClose() && mouse
.isMouse1()) {
501 putCharXY(3, 0, GraphicsChars
.CP437
[0x0F],
503 ?
getTheme().getColor("twindow.border.windowmove")
504 : getTheme().getColor("twindow.border.modal.windowmove"));
506 putCharXY(3, 0, GraphicsChars
.CP437
[0xFE],
508 ?
getTheme().getColor("twindow.border.windowmove")
509 : getTheme().getColor("twindow.border.modal.windowmove"));
512 // Draw the maximize button
515 putCharXY(getWidth() - 5, 0, '[', border
);
516 putCharXY(getWidth() - 3, 0, ']', border
);
517 if (mouseOnMaximize() && mouse
.isMouse1()) {
518 putCharXY(getWidth() - 4, 0, GraphicsChars
.CP437
[0x0F],
519 getTheme().getColor("twindow.border.windowmove"));
522 putCharXY(getWidth() - 4, 0, GraphicsChars
.CP437
[0x12],
523 getTheme().getColor("twindow.border.windowmove"));
525 putCharXY(getWidth() - 4, 0, GraphicsChars
.UPARROW
,
526 getTheme().getColor("twindow.border.windowmove"));
530 // Draw the resize corner
531 if ((flags
& RESIZABLE
) != 0) {
532 putCharXY(getWidth() - 2, getHeight() - 1,
533 GraphicsChars
.SINGLE_BAR
,
534 getTheme().getColor("twindow.border.windowmove"));
535 putCharXY(getWidth() - 1, getHeight() - 1,
536 GraphicsChars
.LRCORNER
,
537 getTheme().getColor("twindow.border.windowmove"));
544 * Handle mouse button presses.
546 * @param mouse mouse button event
549 public void onMouseDown(final TMouseEvent mouse
) {
552 inKeyboardResize
= false;
554 if ((mouse
.getAbsoluteY() == getY())
556 && (getX() <= mouse
.getAbsoluteX())
557 && (mouse
.getAbsoluteX() < getX() + getWidth())
559 && !mouseOnMaximize()
561 // Begin moving window
563 moveWindowMouseX
= mouse
.getAbsoluteX();
564 moveWindowMouseY
= mouse
.getAbsoluteY();
572 if (mouseOnResize()) {
573 // Begin window resize
574 inWindowResize
= true;
575 moveWindowMouseX
= mouse
.getAbsoluteX();
576 moveWindowMouseY
= mouse
.getAbsoluteY();
577 resizeWindowWidth
= getWidth();
578 resizeWindowHeight
= getHeight();
585 // I didn't take it, pass it on to my children
586 super.onMouseDown(mouse
);
592 private void maximize() {
593 restoreWindowWidth
= getWidth();
594 restoreWindowHeight
= getHeight();
595 restoreWindowX
= getX();
596 restoreWindowY
= getY();
597 setWidth(getScreen().getWidth());
598 setHeight(application
.getDesktopBottom() - 1);
605 * Restote (unmaximize) window.
607 private void restore() {
608 setWidth(restoreWindowWidth
);
609 setHeight(restoreWindowHeight
);
610 setX(restoreWindowX
);
611 setY(restoreWindowY
);
616 * Handle mouse button releases.
618 * @param mouse mouse button release event
621 public void onMouseUp(final TMouseEvent mouse
) {
624 if ((inWindowMove
) && (mouse
.isMouse1())) {
625 // Stop moving window
626 inWindowMove
= false;
630 if ((inWindowResize
) && (mouse
.isMouse1())) {
631 // Stop resizing window
632 inWindowResize
= false;
636 if (mouse
.isMouse1() && mouseOnClose()) {
638 application
.closeWindow(this);
642 if ((mouse
.getAbsoluteY() == getY())
644 && mouseOnMaximize()) {
652 // Pass a resize event to my children
653 onResize(new TResizeEvent(TResizeEvent
.Type
.WIDGET
,
654 getWidth(), getHeight()));
658 // I didn't take it, pass it on to my children
659 super.onMouseUp(mouse
);
663 * Handle mouse movements.
665 * @param mouse mouse motion event
668 public void onMouseMotion(final TMouseEvent mouse
) {
673 setX(oldWindowX
+ (mouse
.getAbsoluteX() - moveWindowMouseX
));
674 setY(oldWindowY
+ (mouse
.getAbsoluteY() - moveWindowMouseY
));
675 // Don't cover up the menu bar
676 if (getY() < application
.getDesktopTop()) {
677 setY(application
.getDesktopTop());
682 if (inWindowResize
) {
684 setWidth(resizeWindowWidth
+ (mouse
.getAbsoluteX()
685 - moveWindowMouseX
));
686 setHeight(resizeWindowHeight
+ (mouse
.getAbsoluteY()
687 - moveWindowMouseY
));
688 if (getX() + getWidth() > getScreen().getWidth()) {
689 setWidth(getScreen().getWidth() - getX());
691 if (getY() + getHeight() > application
.getDesktopBottom()) {
692 setY(application
.getDesktopBottom() - getHeight() + 1);
694 // Don't cover up the menu bar
695 if (getY() < application
.getDesktopTop()) {
696 setY(application
.getDesktopTop());
699 // Keep within min/max bounds
700 if (getWidth() < minimumWindowWidth
) {
701 setWidth(minimumWindowWidth
);
702 inWindowResize
= false;
704 if (getHeight() < minimumWindowHeight
) {
705 setHeight(minimumWindowHeight
);
706 inWindowResize
= false;
708 if ((maximumWindowWidth
> 0)
709 && (getWidth() > maximumWindowWidth
)
711 setWidth(maximumWindowWidth
);
712 inWindowResize
= false;
714 if ((maximumWindowHeight
> 0)
715 && (getHeight() > maximumWindowHeight
)
717 setHeight(maximumWindowHeight
);
718 inWindowResize
= false;
721 // Pass a resize event to my children
722 onResize(new TResizeEvent(TResizeEvent
.Type
.WIDGET
,
723 getWidth(), getHeight()));
727 // I didn't take it, pass it on to my children
728 super.onMouseMotion(mouse
);
734 * @param keypress keystroke event
737 public void onKeypress(final TKeypressEvent keypress
) {
739 if (inKeyboardResize
) {
741 // ESC - Exit size/move
742 if (keypress
.equals(kbEsc
)) {
743 inKeyboardResize
= false;
746 if (keypress
.equals(kbLeft
)) {
751 if (keypress
.equals(kbRight
)) {
752 if (getX() < getScreen().getWidth() - 1) {
756 if (keypress
.equals(kbDown
)) {
757 if (getY() < application
.getDesktopBottom() - 1) {
761 if (keypress
.equals(kbUp
)) {
766 if (keypress
.equals(kbShiftLeft
)) {
767 if ((getWidth() > minimumWindowWidth
)
768 || (minimumWindowWidth
<= 0)
770 setWidth(getWidth() - 1);
773 if (keypress
.equals(kbShiftRight
)) {
774 if ((getWidth() < maximumWindowWidth
)
775 || (maximumWindowWidth
<= 0)
777 setWidth(getWidth() + 1);
780 if (keypress
.equals(kbShiftUp
)) {
781 if ((getHeight() > minimumWindowHeight
)
782 || (minimumWindowHeight
<= 0)
784 setHeight(getHeight() - 1);
787 if (keypress
.equals(kbShiftDown
)) {
788 if ((getHeight() < maximumWindowHeight
)
789 || (maximumWindowHeight
<= 0)
791 setHeight(getHeight() + 1);
795 // Pass a resize event to my children
796 onResize(new TResizeEvent(TResizeEvent
.Type
.WIDGET
,
797 getWidth(), getHeight()));
802 // These keystrokes will typically not be seen unless a subclass
803 // overrides onMenu() due to how TApplication dispatches
806 // Ctrl-W - close window
807 if (keypress
.equals(kbCtrlW
)) {
808 application
.closeWindow(this);
812 // F6 - behave like Alt-TAB
813 if (keypress
.equals(kbF6
)) {
814 application
.switchWindow(true);
818 // Shift-F6 - behave like Shift-Alt-TAB
819 if (keypress
.equals(kbShiftF6
)) {
820 application
.switchWindow(false);
825 if (keypress
.equals(kbF5
)) {
833 // Ctrl-F5 - size/move
834 if (keypress
.equals(kbCtrlF5
)) {
835 inKeyboardResize
= !inKeyboardResize
;
838 // I didn't take it, pass it on to my children
839 super.onKeypress(keypress
);
843 * Handle posted command events.
845 * @param command command event
848 public void onCommand(final TCommandEvent command
) {
850 // These commands will typically not be seen unless a subclass
851 // overrides onMenu() due to how TApplication dispatches
854 if (command
.equals(cmWindowClose
)) {
855 application
.closeWindow(this);
859 if (command
.equals(cmWindowNext
)) {
860 application
.switchWindow(true);
864 if (command
.equals(cmWindowPrevious
)) {
865 application
.switchWindow(false);
869 if (command
.equals(cmWindowMove
)) {
870 inKeyboardResize
= true;
874 if (command
.equals(cmWindowZoom
)) {
882 // I didn't take it, pass it on to my children
883 super.onCommand(command
);
887 * Handle posted menu events.
889 * @param menu menu event
892 public void onMenu(final TMenuEvent menu
) {
893 if (menu
.getId() == TMenu
.MID_WINDOW_CLOSE
) {
894 application
.closeWindow(this);
898 if (menu
.getId() == TMenu
.MID_WINDOW_NEXT
) {
899 application
.switchWindow(true);
903 if (menu
.getId() == TMenu
.MID_WINDOW_PREVIOUS
) {
904 application
.switchWindow(false);
908 if (menu
.getId() == TMenu
.MID_WINDOW_MOVE
) {
909 inKeyboardResize
= true;
913 if (menu
.getId() == TMenu
.MID_WINDOW_ZOOM
) {
922 // I didn't take it, pass it on to my children
926 // ------------------------------------------------------------------------
927 // Passthru for Screen functions ------------------------------------------
928 // ------------------------------------------------------------------------
931 * Get the attributes at one location.
933 * @param x column coordinate. 0 is the left-most column.
934 * @param y row coordinate. 0 is the top-most row.
935 * @return attributes at (x, y)
937 public final CellAttributes
getAttrXY(final int x
, final int y
) {
938 return getScreen().getAttrXY(x
, y
);
942 * Set the attributes at one location.
944 * @param x column coordinate. 0 is the left-most column.
945 * @param y row coordinate. 0 is the top-most row.
946 * @param attr attributes to use (bold, foreColor, backColor)
948 public final void putAttrXY(final int x
, final int y
,
949 final CellAttributes attr
) {
951 getScreen().putAttrXY(x
, y
, attr
);
955 * Set the attributes at one location.
957 * @param x column coordinate. 0 is the left-most column.
958 * @param y row coordinate. 0 is the top-most row.
959 * @param attr attributes to use (bold, foreColor, backColor)
960 * @param clip if true, honor clipping/offset
962 public final void putAttrXY(final int x
, final int y
,
963 final CellAttributes attr
, final boolean clip
) {
965 getScreen().putAttrXY(x
, y
, attr
, clip
);
969 * Fill the entire screen with one character with attributes.
971 * @param ch character to draw
972 * @param attr attributes to use (bold, foreColor, backColor)
974 public final void putAll(final char ch
, final CellAttributes attr
) {
975 getScreen().putAll(ch
, attr
);
979 * Render one character with attributes.
981 * @param x column coordinate. 0 is the left-most column.
982 * @param y row coordinate. 0 is the top-most row.
983 * @param ch character + attributes to draw
985 public final void putCharXY(final int x
, final int y
, final Cell ch
) {
986 getScreen().putCharXY(x
, y
, ch
);
990 * Render one character with attributes.
992 * @param x column coordinate. 0 is the left-most column.
993 * @param y row coordinate. 0 is the top-most row.
994 * @param ch character to draw
995 * @param attr attributes to use (bold, foreColor, backColor)
997 public final void putCharXY(final int x
, final int y
, final char ch
,
998 final CellAttributes attr
) {
1000 getScreen().putCharXY(x
, y
, ch
, attr
);
1004 * Render one character without changing the underlying attributes.
1006 * @param x column coordinate. 0 is the left-most column.
1007 * @param y row coordinate. 0 is the top-most row.
1008 * @param ch character to draw
1010 public final void putCharXY(final int x
, final int y
, final char ch
) {
1011 getScreen().putCharXY(x
, y
, ch
);
1015 * Render a string. Does not wrap if the string exceeds the line.
1017 * @param x column coordinate. 0 is the left-most column.
1018 * @param y row coordinate. 0 is the top-most row.
1019 * @param str string to draw
1020 * @param attr attributes to use (bold, foreColor, backColor)
1022 public final void putStringXY(final int x
, final int y
, final String str
,
1023 final CellAttributes attr
) {
1025 getScreen().putStringXY(x
, y
, str
, attr
);
1029 * Render a string without changing the underlying attribute. Does not
1030 * wrap if the string exceeds the line.
1032 * @param x column coordinate. 0 is the left-most column.
1033 * @param y row coordinate. 0 is the top-most row.
1034 * @param str string to draw
1036 public final void putStringXY(final int x
, final int y
, final String str
) {
1037 getScreen().putStringXY(x
, y
, str
);
1041 * Draw a vertical line from (x, y) to (x, y + n).
1043 * @param x column coordinate. 0 is the left-most column.
1044 * @param y row coordinate. 0 is the top-most row.
1045 * @param n number of characters to draw
1046 * @param ch character to draw
1047 * @param attr attributes to use (bold, foreColor, backColor)
1049 public final void vLineXY(final int x
, final int y
, final int n
,
1050 final char ch
, final CellAttributes attr
) {
1052 getScreen().vLineXY(x
, y
, n
, ch
, attr
);
1056 * Draw a horizontal line from (x, y) to (x + n, y).
1058 * @param x column coordinate. 0 is the left-most column.
1059 * @param y row coordinate. 0 is the top-most row.
1060 * @param n number of characters to draw
1061 * @param ch character to draw
1062 * @param attr attributes to use (bold, foreColor, backColor)
1064 public final void hLineXY(final int x
, final int y
, final int n
,
1065 final char ch
, final CellAttributes attr
) {
1067 getScreen().hLineXY(x
, y
, n
, ch
, attr
);