com.goldencode.p2j.ui.client.gui.theme

Class ThemeManager

java.lang.Object

com.goldencode.p2j.ui.client.gui.theme.ThemeManager

public class ThemeManager
extends java.lang.Object

This manager is the central point for obtaining and setting the current Theme. The current is defined for the entire client process. This class is client-side only. It will request the configuration from server, but it will use that as a hint only. The class configured in server directory might no contain a proper theme/class name.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ThemeManager.BuiltInTheme Enum for built-in themes

Field Summary

Fields

Modifier and Type	Field and Description
private static Theme	crtTheme Current theme.
private static boolean	DEBUG Flag for debugging GUI.
private static CentralLogger	LOG Logger
private static boolean	oldBrowseSelectionBar true if the selected browse row is drawn in the "old" mode, which is drawing it opaque using the highlight colors, rather than drawing it translucent.

Constructor Summary

Constructors

Constructor and Description
ThemeManager()

Method Summary

Modifier and Type	Method and Description
static void	debug(java.lang.Runnable debugCode) Execute some debug code if debug is enabled.
static Theme	getCurrentTheme() Obtain the current Theme.
static boolean	init(ServerExports server, java.lang.String preferredTheme) Initialize the ThemeManager using negotiation with the server.
private static boolean	setTheme(java.lang.Class<? extends Theme> newThemeClass) Sets a new Theme.
private static boolean	setTheme(java.lang.String name) Sets a new Theme.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

private static final CentralLogger LOG

Logger

crtTheme

private static Theme crtTheme

Current theme. May remain null after calls to setTheme(String). Any call to getCurrentTheme() will make sure this field is initialized with the default value before returning it.

oldBrowseSelectionBar

private static boolean oldBrowseSelectionBar

true if the selected browse row is drawn in the "old" mode, which is drawing it opaque using the highlight colors, rather than drawing it translucent.

DEBUG

private static boolean DEBUG

Flag for debugging GUI. Set this to true to enable debug code.

Constructor Detail

ThemeManager

public ThemeManager()

Method Detail

getCurrentTheme

public static Theme getCurrentTheme()

Obtain the current Theme. If not already initialized the default theme is initialized and returned.

Returns:

the current Theme. Always not null.

setTheme

private static boolean setTheme(java.lang.String name)

Sets a new Theme. Before setting the new theme, a check if performed to test if the theme is already active. If already active, the theme is not reloaded.

The old theme is not removed and its resources released until the new Theme was successfully initialized.

TODO: when a new theme is set, all resources need to be re-requested from server (fonts, font-sizes and color palette).

Parameters:

name - The name of the new Theme to be activated. The built-in ClassicTheme and Windows10Theme are recognized by their short names.

Returns:

true if the old Theme was replaced with the new one.

setTheme

private static boolean setTheme(java.lang.Class<? extends Theme> newThemeClass)

Sets a new Theme. The old theme is not removed and its resources released until the new Theme was successfully initialized.

Parameters:

newThemeClass - The new class to be instantiated and the new object to be set as new active theme.

Returns:

true if the old Theme was replaced with the new one.

init

public static boolean init(ServerExports server,
                           java.lang.String preferredTheme)

Initialize the ThemeManager using negotiation with the server. If a theme is not requested in command line (passed in by preferredTheme parameter), it will request the configuration from server directory, but it will use that as a hint only. The class configured in server directory might no contain a proper theme/class name. If no definition is found in directory, or the string obtained does not represent a name or full class of a theme accessible from client path, the theme remains uninitialized. It will be lazily instantiated when accessed the first time.

Parameters:

server - the ServerExports object for communication with server.

preferredTheme - the preferred theme from command-line.

debug

public static void debug(java.lang.Runnable debugCode)

Execute some debug code if debug is enabled.

Parameters:

debugCode - The code to be executed.