Gridarta Editor
GUIPreferences.java
Go to the documentation of this file.
1 /*
2  * Gridarta MMORPG map editor for Crossfire, Daimonin and similar games.
3  * Copyright (C) 2000-2023 The Gridarta Developers.
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License along
16  * with this program; if not, write to the Free Software Foundation, Inc.,
17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18  */
19 
20 package net.sf.gridarta.gui.dialog.prefs;
21 
22 import java.awt.Component;
23 import java.awt.Container;
24 import java.awt.GridBagLayout;
25 import java.util.Arrays;
26 import java.util.Comparator;
27 import java.util.Locale;
28 import java.util.Objects;
29 import java.util.prefs.Preferences;
30 import javax.swing.AbstractButton;
31 import javax.swing.Box;
32 import javax.swing.JCheckBox;
33 import javax.swing.JComboBox;
34 import javax.swing.JComponent;
35 import javax.swing.JPanel;
36 import javax.swing.border.Border;
37 import javax.swing.border.CompoundBorder;
38 import javax.swing.border.TitledBorder;
39 import net.sf.gridarta.MainControl;
44 import net.sf.japi.swing.action.ActionBuilder;
45 import net.sf.japi.swing.action.ActionBuilderFactory;
46 import net.sf.japi.swing.misc.LocaleListCellRenderer;
47 import net.sf.japi.swing.prefs.AbstractPrefs;
48 import net.sf.japi.util.LocaleComparator;
49 import org.jetbrains.annotations.NotNull;
50 
56 public class GUIPreferences extends AbstractPrefs {
57 
61  public static final String PREFERENCES_LANGUAGE = "language";
62 
66  private static final long serialVersionUID = 1L;
67 
71  @NotNull
72  private static final ActionBuilder ACTION_BUILDER = ActionBuilderFactory.getInstance().getActionBuilder("net.sf.gridarta");
73 
77  @NotNull
78  private static final Preferences PREFERENCES = Preferences.userNodeForPackage(MainControl.class);
79 
83  @NotNull
84  private static final String @NotNull [] EMPTY_STRING_ARRAY = new String[0];
85 
89  @NotNull
91 
95  @NotNull
96  private JComboBox<Locale> localeBox;
97 
101  @NotNull
102  private AbstractButton showMainToolbar;
103 
107  @NotNull
108  private Locale @NotNull [] locales;
109 
113  @NotNull
114  private final Comparator<Locale> comp = new LocaleComparator();
115 
121  this.editorSettings = editorSettings;
122 
123  setListLabelText(ActionBuilderUtils.getString(ACTION_BUILDER, "prefsGUI.title"));
124  setListLabelIcon(ACTION_BUILDER.getIcon("prefsGUI.icon"));
125 
126  add(createGlobalPanel());
127  add(createLayoutPanel());
128  add(Box.createVerticalGlue());
129  }
130 
136  @NotNull
137  private static Border createTitledBorder(@NotNull final String titleKey) {
138  return new CompoundBorder(new TitledBorder(ActionBuilderUtils.getString(ACTION_BUILDER, titleKey)), GUIConstants.DIALOG_BORDER);
139  }
140 
141  @Override
142  public void apply() {
143  final Locale loc = (Locale) localeBox.getSelectedItem();
144  if (loc == null) {
146  } else {
147  PREFERENCES.put(PREFERENCES_LANGUAGE, loc.getLanguage());
148  }
150  }
151 
152  @Override
153  public void revert() {
154  final String current = PREFERENCES.get(PREFERENCES_LANGUAGE, null);
155  localeBox.setSelectedIndex(Arrays.binarySearch(locales, current == null ? null : new Locale(current), comp));
157  }
158 
159  @Override
160  public void defaults() {
161  localeBox.setSelectedIndex(Arrays.binarySearch(locales, null, comp));
163  }
164 
165  @Override
166  public boolean isChanged() {
167  final Locale loc = (Locale) localeBox.getSelectedItem();
168  final String currentName = PREFERENCES.get(PREFERENCES_LANGUAGE, null);
169  final Locale current = currentName == null ? null : new Locale(currentName);
170  return !Objects.equals(loc, current) || showMainToolbar.isSelected() != editorSettings.isShowMainToolbar();
171  }
172 
177  @NotNull
178  private Component buildLocaleBox() {
179  final Container lineLayout = Box.createHorizontalBox();
180 
181  final CharSequence availableLocales = ACTION_BUILDER.getString("availableLocales");
182  final String[] locNames = availableLocales == null ? EMPTY_STRING_ARRAY : StringUtils.PATTERN_WHITESPACE.split(availableLocales, 0);
183  locales = new Locale[locNames.length + 1];
184  // locales[0] is intentionally null. It will be displayed as default and always get sorted to the top.
185  for (int i = 0; i < locNames.length; i++) {
186  locales[i + 1] = new Locale(locNames[i]);
187  }
188  Arrays.sort(locales, comp);
189 
190  lineLayout.add(ActionBuilderUtils.newLabel(ACTION_BUILDER, "optionsLanguage")); // create label
191 
192  localeBox = new JComboBox<>(locales); // set "content"
193  localeBox.setRenderer(new LocaleListCellRenderer());
194  //localeBox.setPreferredSize(new Dimension(150, 25));
195  final String current = PREFERENCES.get(PREFERENCES_LANGUAGE, null);
196  localeBox.setSelectedIndex(Arrays.binarySearch(locales, current == null ? null : new Locale(current), comp));
197 
198  lineLayout.add(localeBox);
199  return lineLayout;
200  }
201 
206  @NotNull
207  private Component createGlobalPanel() {
208  final JComponent panel = new JPanel(new GridBagLayout());
209  final PreferencesHelper preferencesHelper = new PreferencesHelper(panel);
210  panel.setBorder(createTitledBorder("optionsGlobal"));
211 
212  preferencesHelper.addComponent(buildLocaleBox());
213 
214  return panel;
215  }
216 
221  @NotNull
222  private Component createLayoutPanel() {
223  final JComponent panel = new JPanel(new GridBagLayout());
224  final PreferencesHelper preferencesHelper = new PreferencesHelper(panel);
225  panel.setBorder(createTitledBorder("optionsLayout"));
226 
227  showMainToolbar = new JCheckBox(ACTION_BUILDER.createAction(false, "optionsShowMainToolbar"));
229  preferencesHelper.addComponent(showMainToolbar);
230 
231  return panel;
232  }
233 
234 }
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.editorSettings
final EditorSettings editorSettings
The EditorSettings to use.
Definition: GUIPreferences.java:90
net.sf.gridarta.model.settings.EditorSettings.SHOW_MAIN_TOOLBAR_DEFAULT
boolean SHOW_MAIN_TOOLBAR_DEFAULT
Default value for whether the main window's toolbar is shown.
Definition: EditorSettings.java:34
net.sf.gridarta.gui.dialog.prefs.PreferencesHelper
Helper class for preference panes.
Definition: PreferencesHelper.java:31
net.sf.gridarta.gui.dialog.prefs.GUIPreferences
Preferences Module for user interface preferences.
Definition: GUIPreferences.java:56
net.sf.gridarta
Base package of all Gridarta classes.
net.sf.gridarta.gui.utils.GUIConstants
Defines common UI constants used in different dialogs.
Definition: GUIConstants.java:33
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.showMainToolbar
AbstractButton showMainToolbar
Whether to show the main window's toolbar.
Definition: GUIPreferences.java:102
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.PREFERENCES
static final Preferences PREFERENCES
Preferences.
Definition: GUIPreferences.java:78
net.sf
net.sf.gridarta.model.settings.EditorSettings.isShowMainToolbar
boolean isShowMainToolbar()
Returns whether the main toolbar should be shown.
net.sf.gridarta.utils.ActionBuilderUtils.newLabel
static JLabel newLabel(@NotNull final ActionBuilder actionBuilder, @NotNull final String key)
Creates a new JLabel from a resource key.
Definition: ActionBuilderUtils.java:117
net.sf.gridarta.utils.StringUtils.PATTERN_WHITESPACE
static final Pattern PATTERN_WHITESPACE
Pattern to match whitespace excluding NL and CR.
Definition: StringUtils.java:37
net.sf.gridarta.gui
Graphical User Interface of Gridarta.
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.apply
void apply()
Definition: GUIPreferences.java:142
net.sf.gridarta.model.settings.EditorSettings.setShowMainToolbar
void setShowMainToolbar(boolean selected)
Sets whether the main toolbar should be shown.
net.sf.gridarta.model.settings.EditorSettings
Settings that apply to the editor.
Definition: EditorSettings.java:29
net
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.ACTION_BUILDER
static final ActionBuilder ACTION_BUILDER
Action Builder.
Definition: GUIPreferences.java:72
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.serialVersionUID
static final long serialVersionUID
The serial version UID.
Definition: GUIPreferences.java:66
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.locales
Locale[] locales
Locale[].
Definition: GUIPreferences.java:108
net.sf.gridarta.utils.ActionBuilderUtils.getString
static String getString(@NotNull final ActionBuilder actionBuilder, @NotNull final String key, @NotNull final String defaultValue)
Returns the value of a key.
Definition: ActionBuilderUtils.java:71
net.sf.gridarta.utils.StringUtils
Utility class for string manipulation.
Definition: StringUtils.java:31
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.EMPTY_STRING_ARRAY
static final String[] EMPTY_STRING_ARRAY
An empty.
Definition: GUIPreferences.java:84
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.buildLocaleBox
Component buildLocaleBox()
Constructs the combo box for the selection of locales.
Definition: GUIPreferences.java:178
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.GUIPreferences
GUIPreferences(@NotNull final EditorSettings editorSettings)
Creates a new instance.
Definition: GUIPreferences.java:120
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.localeBox
JComboBox< Locale > localeBox
/** ComboBox for choosing the locale.
Definition: GUIPreferences.java:96
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.isChanged
boolean isChanged()
Definition: GUIPreferences.java:166
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.createLayoutPanel
Component createLayoutPanel()
Creates the sub-panel with the layout settings.
Definition: GUIPreferences.java:222
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.revert
void revert()
Definition: GUIPreferences.java:153
net.sf.gridarta.model
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.comp
final Comparator< Locale > comp
LocaleComparator.
Definition: GUIPreferences.java:114
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.defaults
void defaults()
Definition: GUIPreferences.java:160
net.sf.gridarta.utils.ActionBuilderUtils
Utility class for ActionBuilder related functions.
Definition: ActionBuilderUtils.java:31
net.sf.gridarta.gui.utils
Definition: AnimationComponent.java:20
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.PREFERENCES_LANGUAGE
static final String PREFERENCES_LANGUAGE
Preferences key for language.
Definition: GUIPreferences.java:61
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.createTitledBorder
static Border createTitledBorder(@NotNull final String titleKey)
Creates a titled border.
Definition: GUIPreferences.java:137
net.sf.gridarta.utils
Definition: ActionBuilderUtils.java:20
net.sf.gridarta.model.settings
Definition: AbstractDefaultProjectSettings.java:20
net.sf.gridarta.gui.utils.GUIConstants.DIALOG_BORDER
Border DIALOG_BORDER
The Border object to be used when creating dialogs.
Definition: GUIConstants.java:38
net.sf.gridarta.gui.dialog.prefs.PreferencesHelper.addComponent
void addComponent(@NotNull final Component component)
Adds a component to the container.
Definition: PreferencesHelper.java:61
net.sf.gridarta.gui.dialog.prefs.GUIPreferences.createGlobalPanel
Component createGlobalPanel()
Creates the sub-panel with the editor settings.
Definition: GUIPreferences.java:207
net.sf.gridarta.MainControl
Interface used as preferences location.
Definition: MainControl.java:27