src/jexer/TLabel.java

   1 /*
   2  * Jexer - Java Text User Interface
   3  *
   4  * The MIT License (MIT)
   5  *
   6  * Copyright (C) 2019 Kevin Lamonte
   7  *
   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:
  14  *
  15  * The above copyright notice and this permission notice shall be included in
  16  * all copies or substantial portions of the Software.
  17  *
  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.
  25  *
  26  * @author Kevin Lamonte [kevin.lamonte@gmail.com]
  27  * @version 1
  28  */
  29 package jexer;
  30
  31 import jexer.bits.CellAttributes;
  32 import jexer.bits.MnemonicString;
  33 import jexer.bits.StringUtils;
  34
  35 /**
  36  * TLabel implements a simple label, with an optional mnemonic hotkey action
  37  * associated with it.
  38  */
  39 public class TLabel extends TWidget {
  40
  41     // ------------------------------------------------------------------------
  42     // Variables --------------------------------------------------------------
  43     // ------------------------------------------------------------------------
  44
  45     /**
  46      * The shortcut and label.
  47      */
  48     private MnemonicString mnemonic;
  49
  50     /**
  51      * The action to perform when the mnemonic shortcut is pressed.
  52      */
  53     private TAction action;
  54
  55     /**
  56      * Label color.
  57      */
  58     private String colorKey;
  59
  60     /**
  61      * If true, use the window's background color.
  62      */
  63     private boolean useWindowBackground = true;
  64
  65     // ------------------------------------------------------------------------
  66     // Constructors -----------------------------------------------------------
  67     // ------------------------------------------------------------------------
  68
  69     /**
  70      * Public constructor, using the default "tlabel" for colorKey.
  71      *
  72      * @param parent parent widget
  73      * @param text label on the screen
  74      * @param x column relative to parent
  75      * @param y row relative to parent
  76      */
  77     public TLabel(final TWidget parent, final String text, final int x,
  78         final int y) {
  79
  80         this(parent, text, x, y, "tlabel");
  81     }
  82
  83     /**
  84      * Public constructor, using the default "tlabel" for colorKey.
  85      *
  86      * @param parent parent widget
  87      * @param text label on the screen
  88      * @param x column relative to parent
  89      * @param y row relative to parent
  90      * @param action to call when shortcut is pressed
  91      */
  92     public TLabel(final TWidget parent, final String text, final int x,
  93         final int y, final TAction action) {
  94
  95         this(parent, text, x, y, "tlabel", action);
  96     }
  97
  98     /**
  99      * Public constructor.
 100      *
 101      * @param parent parent widget
 102      * @param text label on the screen
 103      * @param x column relative to parent
 104      * @param y row relative to parent
 105      * @param colorKey ColorTheme key color to use for foreground text
 106      */
 107     public TLabel(final TWidget parent, final String text, final int x,
 108         final int y, final String colorKey) {
 109
 110         this(parent, text, x, y, colorKey, true);
 111     }
 112
 113     /**
 114      * Public constructor.
 115      *
 116      * @param parent parent widget
 117      * @param text label on the screen
 118      * @param x column relative to parent
 119      * @param y row relative to parent
 120      * @param colorKey ColorTheme key color to use for foreground text
 121      * @param action to call when shortcut is pressed
 122      */
 123     public TLabel(final TWidget parent, final String text, final int x,
 124         final int y, final String colorKey, final TAction action) {
 125
 126         this(parent, text, x, y, colorKey, true, action);
 127     }
 128
 129     /**
 130      * Public constructor.
 131      *
 132      * @param parent parent widget
 133      * @param text label on the screen
 134      * @param x column relative to parent
 135      * @param y row relative to parent
 136      * @param colorKey ColorTheme key color to use for foreground text
 137      * @param useWindowBackground if true, use the window's background color
 138      */
 139     public TLabel(final TWidget parent, final String text, final int x,
 140         final int y, final String colorKey, final boolean useWindowBackground) {
 141
 142         this(parent, text, x, y, colorKey, useWindowBackground, null);
 143     }
 144
 145     /**
 146      * Public constructor.
 147      *
 148      * @param parent parent widget
 149      * @param text label on the screen
 150      * @param x column relative to parent
 151      * @param y row relative to parent
 152      * @param colorKey ColorTheme key color to use for foreground text
 153      * @param useWindowBackground if true, use the window's background color
 154      * @param action to call when shortcut is pressed
 155      */
 156     public TLabel(final TWidget parent, final String text, final int x,
 157         final int y, final String colorKey, final boolean useWindowBackground,
 158         final TAction action) {
 159
 160         // Set parent and window
 161         super(parent, false, x, y, 0, 1);
 162
 163         setLabel(text);
 164         this.colorKey = colorKey;
 165         this.useWindowBackground = useWindowBackground;
 166         this.action = action;
 167     }
 168
 169     // ------------------------------------------------------------------------
 170     // TWidget ----------------------------------------------------------------
 171     // ------------------------------------------------------------------------
 172
 173     /**
 174      * Override TWidget's width: we can only set width at construction time.
 175      *
 176      * @param width new widget width (ignored)
 177      */
 178     @Override
 179     public void setWidth(final int width) {
 180         // Do nothing
 181     }
 182
 183     /**
 184      * Override TWidget's height: we can only set height at construction
 185      * time.
 186      *
 187      * @param height new widget height (ignored)
 188      */
 189     @Override
 190     public void setHeight(final int height) {
 191         // Do nothing
 192     }
 193
 194     /**
 195      * Draw a static label.
 196      */
 197     @Override
 198     public void draw() {
 199         // Setup my color
 200         CellAttributes color = new CellAttributes();
 201         CellAttributes mnemonicColor = new CellAttributes();
 202         color.setTo(getTheme().getColor(colorKey));
 203         mnemonicColor.setTo(getTheme().getColor("tlabel.mnemonic"));
 204         if (useWindowBackground) {
 205             CellAttributes background = getWindow().getBackground();
 206             color.setBackColor(background.getBackColor());
 207             mnemonicColor.setBackColor(background.getBackColor());
 208         }
 209         putStringXY(0, 0, mnemonic.getRawLabel(), color);
 210         if (mnemonic.getScreenShortcutIdx() >= 0) {
 211             putCharXY(mnemonic.getScreenShortcutIdx(), 0,
 212                 mnemonic.getShortcut(), mnemonicColor);
 213         }
 214     }
 215
 216     // ------------------------------------------------------------------------
 217     // TLabel -----------------------------------------------------------------
 218     // ------------------------------------------------------------------------
 219
 220     /**
 221      * Get label raw text.
 222      *
 223      * @return label text
 224      */
 225     public String getLabel() {
 226         return mnemonic.getRawLabel();
 227     }
 228
 229     /**
 230      * Get the mnemonic string for this label.
 231      *
 232      * @return mnemonic string
 233      */
 234     public MnemonicString getMnemonic() {
 235         return mnemonic;
 236     }
 237
 238     /**
 239      * Set label text.
 240      *
 241      * @param label new label text
 242      */
 243     public void setLabel(final String label) {
 244         mnemonic = new MnemonicString(label);
 245         super.setWidth(StringUtils.width(mnemonic.getRawLabel()));
 246     }
 247
 248     /**
 249      * Get the label color.
 250      *
 251      * @return the ColorTheme key color to use for foreground text
 252      */
 253     public String getColorKey() {
 254         return colorKey;
 255     }
 256
 257     /**
 258      * Set the label color.
 259      *
 260      * @param colorKey ColorTheme key color to use for foreground text
 261      */
 262     public void setColorKey(final String colorKey) {
 263         this.colorKey = colorKey;
 264     }
 265
 266     /**
 267      * Act as though the mnemonic shortcut was pressed.
 268      */
 269     public void dispatch() {
 270         if (action != null) {
 271             action.DO(this);
 272         }
 273     }
 274
 275 }