X-Git-Url: http://git.nikiroo.be/?p=fanfix.git;a=blobdiff_plain;f=src%2Fjexer%2FTLabel.java;h=cc341cfa862964ed9097c425ea4d10b55627ac0c;hp=2eeea915793e0568db485f82cccc89efb9f2ae8a;hb=HEAD;hpb=d6ee0801333ff93dffd851f4c1a44519c96c371d diff --git a/src/jexer/TLabel.java b/src/jexer/TLabel.java index 2eeea91..cc341cf 100644 --- a/src/jexer/TLabel.java +++ b/src/jexer/TLabel.java @@ -3,7 +3,7 @@ * * 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"), @@ -29,26 +29,39 @@ package jexer; import jexer.bits.CellAttributes; +import jexer.bits.MnemonicString; +import jexer.bits.StringUtils; /** - * TLabel implements a simple label. + * TLabel implements a simple label, with an optional mnemonic hotkey action + * associated with it. */ -public final class TLabel extends TWidget { +public class TLabel extends TWidget { // ------------------------------------------------------------------------ // Variables -------------------------------------------------------------- // ------------------------------------------------------------------------ /** - * Label text. + * The shortcut and label. */ - private String label = ""; + private MnemonicString mnemonic; + + /** + * The action to perform when the mnemonic shortcut is pressed. + */ + private TAction action; /** * Label color. */ private String colorKey; + /** + * If true, use the window's background color. + */ + private boolean useWindowBackground = true; + // ------------------------------------------------------------------------ // Constructors ----------------------------------------------------------- // ------------------------------------------------------------------------ @@ -67,6 +80,21 @@ public final class TLabel extends TWidget { this(parent, text, x, y, "tlabel"); } + /** + * Public constructor, using the default "tlabel" for colorKey. + * + * @param parent parent widget + * @param text label on the screen + * @param x column relative to parent + * @param y row relative to parent + * @param action to call when shortcut is pressed + */ + public TLabel(final TWidget parent, final String text, final int x, + final int y, final TAction action) { + + this(parent, text, x, y, "tlabel", action); + } + /** * Public constructor. * @@ -79,17 +107,90 @@ public final class TLabel extends TWidget { public TLabel(final TWidget parent, final String text, final int x, final int y, final String colorKey) { + this(parent, text, x, y, colorKey, true); + } + + /** + * Public constructor. + * + * @param parent parent widget + * @param text label on the screen + * @param x column relative to parent + * @param y row relative to parent + * @param colorKey ColorTheme key color to use for foreground text + * @param action to call when shortcut is pressed + */ + public TLabel(final TWidget parent, final String text, final int x, + final int y, final String colorKey, final TAction action) { + + this(parent, text, x, y, colorKey, true, action); + } + + /** + * Public constructor. + * + * @param parent parent widget + * @param text label on the screen + * @param x column relative to parent + * @param y row relative to parent + * @param colorKey ColorTheme key color to use for foreground text + * @param useWindowBackground if true, use the window's background color + */ + public TLabel(final TWidget parent, final String text, final int x, + final int y, final String colorKey, final boolean useWindowBackground) { + + this(parent, text, x, y, colorKey, useWindowBackground, null); + } + + /** + * Public constructor. + * + * @param parent parent widget + * @param text label on the screen + * @param x column relative to parent + * @param y row relative to parent + * @param colorKey ColorTheme key color to use for foreground text + * @param useWindowBackground if true, use the window's background color + * @param action to call when shortcut is pressed + */ + public TLabel(final TWidget parent, final String text, final int x, + final int y, final String colorKey, final boolean useWindowBackground, + final TAction action) { + // Set parent and window - super(parent, false, x, y, text.length(), 1); + super(parent, false, x, y, 0, 1); - this.label = text; + setLabel(text); this.colorKey = colorKey; + this.useWindowBackground = useWindowBackground; + this.action = action; } // ------------------------------------------------------------------------ // TWidget ---------------------------------------------------------------- // ------------------------------------------------------------------------ + /** + * Override TWidget's width: we can only set width at construction time. + * + * @param width new widget width (ignored) + */ + @Override + public void setWidth(final int width) { + // Do nothing + } + + /** + * Override TWidget's height: we can only set height at construction + * time. + * + * @param height new widget height (ignored) + */ + @Override + public void setHeight(final int height) { + // Do nothing + } + /** * Draw a static label. */ @@ -97,11 +198,19 @@ public final class TLabel extends TWidget { public void draw() { // Setup my color CellAttributes color = new CellAttributes(); + CellAttributes mnemonicColor = new CellAttributes(); color.setTo(getTheme().getColor(colorKey)); - CellAttributes background = getWindow().getBackground(); - color.setBackColor(background.getBackColor()); - - getScreen().putStringXY(0, 0, label, color); + mnemonicColor.setTo(getTheme().getColor("tlabel.mnemonic")); + if (useWindowBackground) { + CellAttributes background = getWindow().getBackground(); + color.setBackColor(background.getBackColor()); + mnemonicColor.setBackColor(background.getBackColor()); + } + putStringXY(0, 0, mnemonic.getRawLabel(), color); + if (mnemonic.getScreenShortcutIdx() >= 0) { + putCharXY(mnemonic.getScreenShortcutIdx(), 0, + mnemonic.getShortcut(), mnemonicColor); + } } // ------------------------------------------------------------------------ @@ -109,12 +218,21 @@ public final class TLabel extends TWidget { // ------------------------------------------------------------------------ /** - * Get label text. + * Get label raw text. * * @return label text */ public String getLabel() { - return label; + return mnemonic.getRawLabel(); + } + + /** + * Get the mnemonic string for this label. + * + * @return mnemonic string + */ + public MnemonicString getMnemonic() { + return mnemonic; } /** @@ -123,7 +241,35 @@ public final class TLabel extends TWidget { * @param label new label text */ public void setLabel(final String label) { - this.label = label; + mnemonic = new MnemonicString(label); + super.setWidth(StringUtils.width(mnemonic.getRawLabel())); + } + + /** + * Get the label color. + * + * @return the ColorTheme key color to use for foreground text + */ + public String getColorKey() { + return colorKey; + } + + /** + * Set the label color. + * + * @param colorKey ColorTheme key color to use for foreground text + */ + public void setColorKey(final String colorKey) { + this.colorKey = colorKey; + } + + /** + * Act as though the mnemonic shortcut was pressed. + */ + public void dispatch() { + if (action != null) { + action.DO(this); + } } }