*
* The MIT License (MIT)
*
- * Copyright (C) 2017 Kevin Lamonte
+ * Copyright (C) 2019 Kevin Lamonte
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
/**
* TDesktop is a special-class window that is drawn underneath everything
- * else.
+ * else. Like a TWindow, it can contain widgets and perform "background"
+ * processing via onIdle(). But unlike a TWindow, it cannot be hidden,
+ * moved, or resized.
+ *
+ * <p>
+ * Events are passed to TDesktop as follows:
+ * <ul>
+ * <li>Mouse events are seen if they do not cover any other windows.</li>
+ * <li>Keypress events are seen if no other windows are open.</li>
+ * <li>Menu events are seen if no other windows are open.</li>
+ * <li>Command events are seen if no other windows are open.</li>
+ * </ul>
*/
public class TDesktop extends TWindow {
+ // ------------------------------------------------------------------------
+ // Constructors -----------------------------------------------------------
+ // ------------------------------------------------------------------------
+
/**
* Public constructor.
*
* @param parent parent application
*/
public TDesktop(final TApplication parent) {
-
super(parent, "", 0, 0, parent.getScreen().getWidth(),
- parent.getScreen().getHeight() - 1);
+ parent.getDesktopBottom() - parent.getDesktopTop());
setActive(false);
}
+ // ------------------------------------------------------------------------
+ // Event handlers ---------------------------------------------------------
+ // ------------------------------------------------------------------------
+
/**
- * The default TDesktop draws a hatch character across everything.
+ * Handle window/screen resize events.
+ *
+ * @param resize resize event
*/
@Override
- public void draw() {
- CellAttributes background = getTheme().getColor("tdesktop.background");
- putAll(GraphicsChars.HATCH, background);
+ public void onResize(final TResizeEvent resize) {
+ if (getChildren().size() == 1) {
+ TWidget child = getChildren().get(0);
+ if (!(child instanceof TWindow)) {
+ // Only one child, resize it to match my size.
+ child.onResize(new TResizeEvent(TResizeEvent.Type.WIDGET,
+ getWidth(), getHeight()));
+ }
+ }
+ if (resize.getType() == TResizeEvent.Type.SCREEN) {
+ // Let children see the screen resize
+ for (TWidget widget: getChildren()) {
+ widget.onResize(resize);
+ }
+ }
}
/**
super.onMenu(menu);
}
+ // ------------------------------------------------------------------------
+ // TWindow ----------------------------------------------------------------
+ // ------------------------------------------------------------------------
+
+ /**
+ * The default TDesktop draws a hatch character across everything.
+ */
+ @Override
+ public void draw() {
+ CellAttributes background = getTheme().getColor("tdesktop.background");
+ putAll(GraphicsChars.HATCH, background);
+
+ /*
+ // For debugging, let's see where the desktop bounds really are.
+ putCharXY(0, 0, '0', background);
+ putCharXY(getWidth() - 1, 0, '1', background);
+ putCharXY(0, getHeight() - 1, '2', background);
+ putCharXY(getWidth() - 1, getHeight() - 1, '3', background);
+ */
+ }
+
+ /**
+ * Hide window. This is a NOP for TDesktop.
+ */
+ @Override
+ public final void hide() {}
+
+ /**
+ * Show window. This is a NOP for TDesktop.
+ */
+ @Override
+ public final void show() {}
+
+ /**
+ * Called by hide(). This is a NOP for TDesktop.
+ */
+ @Override
+ public final void onHide() {}
+
+ /**
+ * Called by show(). This is a NOP for TDesktop.
+ */
+ @Override
+ public final void onShow() {}
+
+ /**
+ * Returns true if the mouse is currently on the close button.
+ *
+ * @return true if mouse is currently on the close button
+ */
+ @Override
+ protected final boolean mouseOnClose() {
+ return false;
+ }
+
+ /**
+ * Returns true if the mouse is currently on the maximize/restore button.
+ *
+ * @return true if the mouse is currently on the maximize/restore button
+ */
+ @Override
+ protected final boolean mouseOnMaximize() {
+ return false;
+ }
+
+ /**
+ * Returns true if the mouse is currently on the resizable lower right
+ * corner.
+ *
+ * @return true if the mouse is currently on the resizable lower right
+ * corner
+ */
+ @Override
+ protected final boolean mouseOnResize() {
+ return false;
+ }
+
}