org/jsampler/HF.java

/*
 *   JSampler - a java front-end for LinuxSampler
 *
 *   Copyright (C) 2005 Grigor Kirilov Iliev
 *
 *   This file is part of JSampler.
 *
 *   JSampler is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License version 2
 *   as published by the Free Software Foundation.
 *
 *   JSampler is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with JSampler; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *   MA  02111-1307  USA
 */

package org.jsampler;

import java.awt.Component;
import java.awt.Dialog;
import java.awt.Font;
import java.awt.Frame;

import java.util.logging.Level;

import javax.swing.JOptionPane;
import javax.swing.UIManager;
import javax.swing.plaf.FontUIResource;

import org.linuxsampler.lscp.LSException;
import org.linuxsampler.lscp.LscpException;

import static org.jsampler.JSI18n.i18n;


/**
 * This class contains some helper function.
 * @author Grigor Iliev
 */
public class HF {
// GUI HELPER FUNCIONS
        
        /**
         * Returns more meaningful, non-<code>null</code> message.
         * @return More meaningful, non-<code>null</code> message.
         */
        public static String
        getErrorMessage(Exception e) {
                String msg = e.getMessage();
                
                if(e instanceof LSException) {
                        LSException x = (LSException)e;
                } else if(e instanceof LscpException) {
                        
                } else { msg = (msg != null ? msg : i18n.getError("unknownError")); }
                
                return msg;
        }
        
        /**
         * Shows a dialog with the specified error message.
         * @param msg The error message to be shown.
         */
        public static void
        showErrorMessage(String msg) { showErrorMessage(msg, CC.getMainFrame()); }
        
        /**
         * Shows a dialog with the specified error message.
         * @param frame The parent <code>Frame</code> for the dialog.
         * @param msg The error message to be shown.
         */
        public static void
        showErrorMessage(String msg, Frame frame) {
                JOptionPane.showMessageDialog (
                        frame, msg,
                        i18n.getError("error"),
                        JOptionPane.ERROR_MESSAGE
                );
        }
        
        /**
         * Shows a dialog with the specified error message.
         * @param dlg The parent <code>Dialog</code> from which the dialog is displayed.
         * @param msg The error message to be shown.
         */
        public static void
        showErrorMessage(String msg, Dialog dlg) {
                JOptionPane.showMessageDialog (
                        dlg, msg,
                        i18n.getError("error"),
                        JOptionPane.ERROR_MESSAGE
                );
        }
        
        /**
         * Shows a dialog with error message obtained by {@link #getErrorMessage} method.
         * @param e The <code>Exception</code> from which the error message is obtained.
         */
        public static void
        showErrorMessage(Exception e) { showErrorMessage(e, CC.getMainFrame()); }
        
        /**
         * Shows a dialog with error message obtained by {@link #getErrorMessage} method.
         * @param e The <code>Exception</code> from which the error message is obtained.
         * @param prefix The prefix to be added to the error message.
         */
        public static void
        showErrorMessage(Exception e, String prefix) {
                showErrorMessage(e, CC.getMainFrame(), prefix);
        }
        
        /**
         * Shows a dialog with error message obtained by {@link #getErrorMessage} method.
         * @param e The <code>Exception</code> from which the error message is obtained.
         * @param frame The parent <code>Frame</code> for the dialog.
         */
        public static void
        showErrorMessage(Exception e, Frame frame) {
                showErrorMessage(e, frame, "");
        }
        
        /**
         * Shows a dialog with error message obtained by {@link #getErrorMessage} method.
         * @param e The <code>Exception</code> from which the error message is obtained.
         * @param frame The parent <code>Frame</code> for the dialog.
         * @param prefix The prefix to be added to the error message.
         */
        public static void
        showErrorMessage(Exception e, Frame frame, String prefix) {
                String msg = prefix + getErrorMessage(e);
                
                CC.getLogger().log(Level.INFO, msg, e);
                        
                JOptionPane.showMessageDialog (
                        frame, msg,
                        i18n.getError("error"),
                        JOptionPane.ERROR_MESSAGE
                );
        }
        
        /**
         * Shows a dialog with error message obtained by {@link #getErrorMessage} method.
         * @param e The <code>Exception</code> from which the error message is obtained.
         * @param dlg The parent <code>Dialog</code> from which the dialog is displayed.
         */
        public static void
        showErrorMessage(Exception e, Dialog dlg) {
                String msg = getErrorMessage(e);
                
                CC.getLogger().log(Level.INFO, msg, e);
                        
                JOptionPane.showMessageDialog (
                        dlg, msg,
                        i18n.getError("error"),
                        JOptionPane.ERROR_MESSAGE
                );
        }
        
        /**
         * Brings up a question dialog with Yes, No options, empty title and the specified message.
         * @param parent The parent <code>Component</code> for the dialog.
         * @param message The message to display.
         */
        public static boolean
        showYesNoDialog(Component parent, String message) {
                return showYesNoDialog(parent, message, "");
        }
        
        /**
         * Brings up a question dialog with Yes, No options, empty title and the specified message.
         * @param parent The parent <code>Component</code> for the dialog.
         * @param message The message to display.
         * @param title The dialog's title.
         */
        public static boolean
        showYesNoDialog(Component parent, String message, String title) {
                Object[] options = { i18n.getButtonLabel("yes"), i18n.getButtonLabel("no") };
                int n = JOptionPane.showOptionDialog (
                        parent,
                        message, title,
                        JOptionPane.YES_NO_OPTION,
                        JOptionPane.QUESTION_MESSAGE,
                        null,
                        options, options[0]
                );
                
                return n == 0;
        }
        
        /**
         * Sets the default font to be used in the GUI.
         * @param fontName The name of the font to be used as default.
         */
        public static void
        setUIDefaultFont(String fontName) {
                if(fontName == null) return;
                
                java.util.Enumeration keys = UIManager.getDefaults().keys();
                while(keys.hasMoreElements()) {
                        Object key = keys.nextElement();
                        Object value = UIManager.get(key);
                        if(value instanceof FontUIResource) {
                                Font f = (FontUIResource)value;
                                FontUIResource fr =
                                        new FontUIResource(fontName, f.getStyle(), f.getSize());
                                UIManager.put(key, fr);
                        }
                }
        }
///////
}
1	iliev	787	/*
2			* JSampler - a java front-end for LinuxSampler
3			*
4			* Copyright (C) 2005 Grigor Kirilov Iliev
5			*
6			* This file is part of JSampler.
7			*
8			* JSampler is free software; you can redistribute it and/or modify
9			* it under the terms of the GNU General Public License version 2
10			* as published by the Free Software Foundation.
11			*
12			* JSampler is distributed in the hope that it will be useful,
13			* but WITHOUT ANY WARRANTY; without even the implied warranty of
14			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15			* GNU General Public License for more details.
16			*
17			* You should have received a copy of the GNU General Public License
18			* along with JSampler; if not, write to the Free Software
19			* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
20			* MA 02111-1307 USA
21			*/
22
23			package org.jsampler;
24
25			import java.awt.Component;
26			import java.awt.Dialog;
27			import java.awt.Font;
28			import java.awt.Frame;
29
30			import java.util.logging.Level;
31
32			import javax.swing.JOptionPane;
33			import javax.swing.UIManager;
34			import javax.swing.plaf.FontUIResource;
35
36			import org.linuxsampler.lscp.LSException;
37			import org.linuxsampler.lscp.LscpException;
38
39			import static org.jsampler.JSI18n.i18n;
40
41
42			/**
43	iliev	911	* This class contains some helper function.
44	iliev	787	* @author Grigor Iliev
45			*/
46			public class HF {
47			// GUI HELPER FUNCIONS
48	iliev	911
49			/**
50			* Returns more meaningful, non-<code>null</code> message.
51			* @return More meaningful, non-<code>null</code> message.
52			*/
53	iliev	787	public static String
54			getErrorMessage(Exception e) {
55			String msg = e.getMessage();
56
57			if(e instanceof LSException) {
58			LSException x = (LSException)e;
59			} else if(e instanceof LscpException) {
60
61			} else { msg = (msg != null ? msg : i18n.getError("unknownError")); }
62
63			return msg;
64			}
65
66	iliev	911	/**
67			* Shows a dialog with the specified error message.
68			* @param msg The error message to be shown.
69			*/
70	iliev	787	public static void
71			showErrorMessage(String msg) { showErrorMessage(msg, CC.getMainFrame()); }
72
73	iliev	911	/**
74			* Shows a dialog with the specified error message.
75			* @param frame The parent <code>Frame</code> for the dialog.
76			* @param msg The error message to be shown.
77			*/
78	iliev	787	public static void
79			showErrorMessage(String msg, Frame frame) {
80			JOptionPane.showMessageDialog (
81			frame, msg,
82			i18n.getError("error"),
83			JOptionPane.ERROR_MESSAGE
84			);
85			}
86
87	iliev	911	/**
88			* Shows a dialog with the specified error message.
89			* @param dlg The parent <code>Dialog</code> from which the dialog is displayed.
90			* @param msg The error message to be shown.
91			*/
92	iliev	787	public static void
93			showErrorMessage(String msg, Dialog dlg) {
94			JOptionPane.showMessageDialog (
95			dlg, msg,
96			i18n.getError("error"),
97			JOptionPane.ERROR_MESSAGE
98			);
99			}
100
101	iliev	911	/**
102			* Shows a dialog with error message obtained by {@link #getErrorMessage} method.
103			* @param e The <code>Exception</code> from which the error message is obtained.
104			*/
105	iliev	787	public static void
106			showErrorMessage(Exception e) { showErrorMessage(e, CC.getMainFrame()); }
107
108	iliev	911	/**
109			* Shows a dialog with error message obtained by {@link #getErrorMessage} method.
110			* @param e The <code>Exception</code> from which the error message is obtained.
111			* @param prefix The prefix to be added to the error message.
112			*/
113	iliev	787	public static void
114	iliev	911	showErrorMessage(Exception e, String prefix) {
115			showErrorMessage(e, CC.getMainFrame(), prefix);
116			}
117
118			/**
119			* Shows a dialog with error message obtained by {@link #getErrorMessage} method.
120			* @param e The <code>Exception</code> from which the error message is obtained.
121			* @param frame The parent <code>Frame</code> for the dialog.
122			*/
123			public static void
124	iliev	787	showErrorMessage(Exception e, Frame frame) {
125	iliev	911	showErrorMessage(e, frame, "");
126			}
127
128			/**
129			* Shows a dialog with error message obtained by {@link #getErrorMessage} method.
130			* @param e The <code>Exception</code> from which the error message is obtained.
131			* @param frame The parent <code>Frame</code> for the dialog.
132			* @param prefix The prefix to be added to the error message.
133			*/
134			public static void
135			showErrorMessage(Exception e, Frame frame, String prefix) {
136			String msg = prefix + getErrorMessage(e);
137	iliev	787
138			CC.getLogger().log(Level.INFO, msg, e);
139
140			JOptionPane.showMessageDialog (
141			frame, msg,
142			i18n.getError("error"),
143			JOptionPane.ERROR_MESSAGE
144			);
145			}
146
147	iliev	911	/**
148			* Shows a dialog with error message obtained by {@link #getErrorMessage} method.
149			* @param e The <code>Exception</code> from which the error message is obtained.
150			* @param dlg The parent <code>Dialog</code> from which the dialog is displayed.
151			*/
152	iliev	787	public static void
153			showErrorMessage(Exception e, Dialog dlg) {
154			String msg = getErrorMessage(e);
155
156			CC.getLogger().log(Level.INFO, msg, e);
157
158			JOptionPane.showMessageDialog (
159			dlg, msg,
160			i18n.getError("error"),
161			JOptionPane.ERROR_MESSAGE
162			);
163			}
164
165			/**
166			* Brings up a question dialog with Yes, No options, empty title and the specified message.
167	iliev	911	* @param parent The parent <code>Component</code> for the dialog.
168			* @param message The message to display.
169	iliev	787	*/
170			public static boolean
171			showYesNoDialog(Component parent, String message) {
172			return showYesNoDialog(parent, message, "");
173			}
174
175	iliev	911	/**
176			* Brings up a question dialog with Yes, No options, empty title and the specified message.
177			* @param parent The parent <code>Component</code> for the dialog.
178			* @param message The message to display.
179			* @param title The dialog's title.
180			*/
181	iliev	787	public static boolean
182			showYesNoDialog(Component parent, String message, String title) {
183			Object[] options = { i18n.getButtonLabel("yes"), i18n.getButtonLabel("no") };
184			int n = JOptionPane.showOptionDialog (
185			parent,
186			message, title,
187			JOptionPane.YES_NO_OPTION,
188			JOptionPane.QUESTION_MESSAGE,
189			null,
190			options, options[0]
191			);
192
193			return n == 0;
194			}
195
196	iliev	911	/**
197			* Sets the default font to be used in the GUI.
198			* @param fontName The name of the font to be used as default.
199			*/
200	iliev	787	public static void
201			setUIDefaultFont(String fontName) {
202			if(fontName == null) return;
203
204			java.util.Enumeration keys = UIManager.getDefaults().keys();
205			while(keys.hasMoreElements()) {
206			Object key = keys.nextElement();
207			Object value = UIManager.get(key);
208			if(value instanceof FontUIResource) {
209			Font f = (FontUIResource)value;
210			FontUIResource fr =
211			new FontUIResource(fontName, f.getStyle(), f.getSize());
212			UIManager.put(key, fr);
213			}
214			}
215			}
216			///////
217			}