guiutils.java

eq跨平台查询工具源码 eq跨平台查询工具源码

/*
 * GUIUtils.java
 *
 * Copyright (C) 2002, 2003, 2004, 2005, 2006 Takis Diakoumis
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or any later version.
 *
 * This program 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 this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 *
 */


package org.underworldlabs.swing;

import java.awt.Color;
import java.awt.Component;
import java.awt.Cursor;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.Frame;
import java.awt.GraphicsEnvironment;
import java.awt.Point;
import java.awt.Rectangle;
import java.awt.Toolkit;
import java.lang.reflect.InvocationTargetException;
import java.util.Collections;
import java.util.Vector;
import javax.swing.JComponent;
import javax.swing.JDialog;
import javax.swing.JOptionPane;
import javax.swing.SwingUtilities;
import javax.swing.UIManager;
import org.underworldlabs.swing.plaf.UIUtils;
import org.underworldlabs.swing.util.SwingWorker;

/* ----------------------------------------------------------
 * CVS NOTE: Changes to the CVS repository prior to the 
 *           release of version 3.0.0beta1 has meant a 
 *           resetting of CVS revision numbers.
 * ----------------------------------------------------------
 */

/**
 * Simple of collection of GUI utility methods.
 *
 * @author   Takis Diakoumis
 * @version  $Revision: 1.7 $
 * @date     $Date: 2006/06/12 11:21:47 $
 */
public class GUIUtils {
    
    /** Prevent instantiation */
    private GUIUtils() {}

    /**
     * Convenience method for consistent border colour.
     * Actually aims to return the value from <code>
     * UIManager.getColor("controlShadow")</code>.
     *
     * @return the system default border colour
     */
    public static Color getDefaultBorderColour() {
        return UIManager.getColor("controlShadow");
    }

    /**
     * Displays the error dialog displaying the stack trace from a
     * throws/caught exception.
     *
     * @param owner - the owner of the dialog
     * @param message - the error message to display
     * @param e - the throwable
     */
    public static void displayExceptionErrorDialog(Frame owner, String message, Throwable e) {
        new ExceptionErrorDialog(owner, message, e);
    }

    /** 
     * Returns the specified component's visible bounds within the screen.
     *
     *  @return the component's visible bounds as a <code>Rectangle</code>
     */
    public static Rectangle getVisibleBoundsOnScreen(JComponent component) {
        Rectangle visibleRect = component.getVisibleRect();
        Point onScreen = visibleRect.getLocation();
        SwingUtilities.convertPointToScreen(onScreen, component);
        visibleRect.setLocation(onScreen);
        return visibleRect;
    }

    /** 
     * Calculates and returns the centered position of a dialog with 
     * the specified size to be added to the desktop area.
     *
     * @param the component to center to
     * @param the size of the dialog to be added as a
     *        <code>Dimension</code> object
     * @return the <code>Point</code> at which to add the dialog
     */
    public static Point getLocationForDialog(Component component, Dimension dialogDim) {
        
        if (component == null) {
            
            Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize();
            
            if (dialogDim.height > screenSize.height) {
                dialogDim.height = screenSize.height;
            }
            
            if (dialogDim.width > screenSize.width) {
                dialogDim.width = screenSize.width;
            }
            
            return new Point((screenSize.width - dialogDim.width) / 2,
                             (screenSize.height - dialogDim.height) / 2);
        } 
        
        //Rectangle dRec = getVisibleBoundsOnScreen(desktop.getDesktopPane());
        Dimension frameDim = component.getSize();
        Rectangle dRec = new Rectangle(component.getX(), 
                                       component.getY(), 
                                       (int)frameDim.getWidth(), 
                                       (int)frameDim.getHeight());
        
        int dialogX = dRec.x + ((dRec.width - dialogDim.width) / 2);
        int dialogY = dRec.y + ((dRec.height - dialogDim.height) / 2);
        
        if (dialogX < 0 || dialogY < 0) {
            Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize();
            
            if (dialogDim.height > screenSize.height) {
                dialogDim.height = screenSize.height;
            }
            
            if (dialogDim.width > screenSize.width) {
                dialogDim.width = screenSize.width;
            }
            
            dialogX = (screenSize.width - dialogDim.width) / 2;
            dialogY = (screenSize.height - dialogDim.height) / 2;
        } 
        
        return new Point(dialogX, dialogY);
    }

    /**
     * Returns the system font names within a collection.
     *
     * @return the system fonts names within a <code>Vector</code> object
     */
    public static Vector getSystemFonts() {
        GraphicsEnvironment gEnv = GraphicsEnvironment.getLocalGraphicsEnvironment();
        Font[] tempFonts = gEnv.getAllFonts();
        
        char dot = '.';
        int dotIndex = 0;
        
        char[] fontNameChars = null;
        String fontName = null;
        Vector fontNames = new Vector();
        
        for (int i = 0; i < tempFonts.length; i++) {
            
            fontName = tempFonts[i].getFontName();
            dotIndex = fontName.indexOf(dot);
            
            if (dotIndex == -1) {
                fontNames.add(fontName);
            }
            else {
                fontNameChars = fontName.substring(0, dotIndex).toCharArray();
                fontNameChars[0] = Character.toUpperCase(fontNameChars[0]);
                
                fontName = new String(fontNameChars);
                
                if (!fontNames.contains(fontName)) {
                    fontNames.add(fontName);
                }
                
            } 
            
        } 
        
        Collections.sort(fontNames);
        return fontNames;
    }

    /**
     * Executes requestFocusInWindow on the specified component
     * using invokeLater.
     *
     * @param c - the component
     */
    public static void requestFocusInWindow(final Component c) {
        invokeAndWait(new Runnable() {
            public void run() {
                c.requestFocusInWindow();
            }
        });
    }
    
    /** 
     * Sets the specified cursor on the primary frame.
     *
     * @param the cursor to set
     */
    private static void setCursor(Cursor cursor, Component component) {
        if (component != null) {
            component.setCursor(cursor);
        }
    }

    /** 
     * Sets the application cursor to the system normal cursor
     * the specified component.
     *
     * @param component - the component to set the cursor onto 
     */
    public static void showNormalCursor(Component component) {
        setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR), component);
    }
    
    /**
     * Executes the specified runnable using the 
     * <code>SwingWorker</code>.
     *
     * @param runnable - the runnable to be executed
     */
     public static void startWorker(final Runnable runnable) {
         SwingWorker worker = new SwingWorker() {
             public Object construct() {
                 try {
                     runnable.run();
                 }
                 catch (final Exception e) {
                     invokeAndWait(new Runnable() {
                         public void run() {
                            displayExceptionErrorDialog(null,