libjava/javax/swing/UIManager.java

   1 /* UIManager.java --
   2    Copyright (C) 2002, 2003, 2004  Free Software Foundation, Inc.
   3
   4 This file is part of GNU Classpath.
   5
   6 GNU Classpath is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU Classpath is distributed in the hope that it will be useful, but
  12 WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Classpath; see the file COPYING.  If not, write to the
  18 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  19 02111-1307 USA.
  20
  21 Linking this library statically or dynamically with other modules is
  22 making a combined work based on this library.  Thus, the terms and
  23 conditions of the GNU General Public License cover the whole
  24 combination.
  25
  26 As a special exception, the copyright holders of this library give you
  27 permission to link this library with independent modules to produce an
  28 executable, regardless of the license terms of these independent
  29 modules, and to copy and distribute the resulting executable under
  30 terms of your choice, provided that you also meet, for each linked
  31 independent module, the terms and conditions of the license of that
  32 module.  An independent module is a module which is not derived from
  33 or based on this library.  If you modify this library, you may extend
  34 this exception to your version of the library, but you are not
  35 obligated to do so.  If you do not wish to do so, delete this
  36 exception statement from your version. */
  37
  38
  39 package javax.swing;
  40
  41 import java.awt.Color;
  42 import java.awt.Dimension;
  43 import java.awt.Font;
  44 import java.awt.Insets;
  45 import java.beans.PropertyChangeListener;
  46 import java.io.Serializable;
  47 import java.util.Locale;
  48
  49 import javax.swing.border.Border;
  50 import javax.swing.plaf.ComponentUI;
  51 import javax.swing.plaf.metal.MetalLookAndFeel;
  52
  53 public class UIManager implements Serializable
  54 {
  55   public static class LookAndFeelInfo
  56   {
  57     String name, clazz;
  58
  59     public LookAndFeelInfo(String name,
  60                            String clazz)
  61     {
  62       this.name  = name;
  63       this.clazz = clazz;
  64     }
  65
  66     public String getName()
  67     {
  68       return name;
  69     }
  70
  71     public String getClassName()
  72     {
  73       return clazz;
  74     }
  75   }
  76
  77   private static final long serialVersionUID = -5547433830339189365L;
  78
  79   static LookAndFeelInfo [] installed = {
  80     new LookAndFeelInfo ("Metal", "javax.swing.plaf.metal.MetalLookAndFeel")
  81   };
  82
  83   static LookAndFeel[] aux_installed;
  84
  85   static LookAndFeel look_and_feel = new MetalLookAndFeel();
  86
  87   public UIManager()
  88   {
  89     // Do nothing here.
  90   }
  91
  92   /**
  93    * Add a <code>PropertyChangeListener</code> to the listener list.
  94    *
  95    * @param listener the listener to add
  96    */
  97   public static void addPropertyChangeListener(PropertyChangeListener listener)
  98   {
  99     // FIXME
 100   }
 101
 102   /**
 103    * Remove a <code>PropertyChangeListener</code> from the listener list.
 104    *
 105    * @param listener the listener to remove
 106    */
 107   public static void removePropertyChangeListener(PropertyChangeListener listener)
 108   {
 109     // FIXME
 110   }
 111
 112   /**
 113    * Returns an array of all added <code>PropertyChangeListener</code> objects.
 114    *
 115    * @return an array of listeners
 116    *
 117    * @since 1.4
 118    */
 119   public static PropertyChangeListener[] getPropertyChangeListeners()
 120   {
 121     // FIXME
 122     throw new Error ("Not implemented");
 123   }
 124
 125   /**
 126    * Add a LookAndFeel to the list of auxiliary look and feels.
 127    */
 128   public static void addAuxiliaryLookAndFeel (LookAndFeel l)
 129   {
 130     if (aux_installed == null)
 131       {
 132         aux_installed = new LookAndFeel[1];
 133         aux_installed[0] = l;
 134         return;
 135       }
 136
 137     LookAndFeel[] T = new LookAndFeel[ aux_installed.length+1 ];
 138     System.arraycopy(aux_installed, 0, T, 0, aux_installed.length);
 139     aux_installed = T;
 140     aux_installed[aux_installed.length-1] = l;
 141   }
 142
 143   public static boolean removeAuxiliaryLookAndFeel(LookAndFeel laf)
 144   {
 145     if (aux_installed == null)
 146       return false;
 147
 148     for (int i=0;i<aux_installed.length;i++)
 149       {
 150         if (aux_installed[i] == laf)
 151           {
 152             aux_installed[ i ] = aux_installed[aux_installed.length-1];
 153             LookAndFeel[] T = new LookAndFeel[ aux_installed.length-1 ];
 154             System.arraycopy (aux_installed, 0, T, 0, aux_installed.length-1);
 155             aux_installed = T;
 156             return true;
 157           }
 158       }
 159     return false;
 160   }
 161
 162   public static  LookAndFeel[] getAuxiliaryLookAndFeels()
 163   {
 164     return aux_installed;
 165   }
 166
 167   public static  Object get(Object key)
 168   {
 169     return getLookAndFeel().getDefaults().get(key);
 170   }
 171
 172   public static  Object get(Object key, Locale locale)
 173   {
 174     return getLookAndFeel().getDefaults().get(key ,locale);
 175   }
 176
 177   /**
 178    * Returns a boolean value from the defaults table,
 179    * <code>false</code> if key is not present.
 180    *
 181    * @since 1.4
 182    */
 183   public static boolean getBoolean(Object key)
 184   {
 185     Boolean value = (Boolean) getLookAndFeel().getDefaults().get(key);
 186     return value != null ? value.booleanValue() : false;
 187   }
 188
 189   /**
 190    * Returns a boolean value from the defaults table,
 191    * <code>false</code> if key is not present.
 192    *
 193    * @since 1.4
 194    */
 195   public static boolean getBoolean(Object key, Locale locale)
 196   {
 197     Boolean value = (Boolean) getLookAndFeel().getDefaults().get(key, locale);
 198     return value != null ? value.booleanValue() : false;
 199   }
 200
 201   /**
 202    * Returns a border from the defaults table.
 203    */
 204   public static Border getBorder(Object key)
 205   {
 206     return (Border) getLookAndFeel().getDefaults().get(key);
 207   }
 208
 209   /**
 210    * Returns a border from the defaults table.
 211    *
 212    * @since 1.4
 213    */
 214   public static Border getBorder(Object key, Locale locale)
 215   {
 216     return (Border) getLookAndFeel().getDefaults().get(key, locale);
 217   }
 218
 219   /**
 220    * Returns a drawing color from the defaults table.
 221    */
 222   public static  Color getColor(Object key)
 223   {
 224     return (Color) getLookAndFeel().getDefaults().get(key);
 225   }
 226
 227   /**
 228    * Returns a drawing color from the defaults table.
 229    */
 230   public static  Color getColor(Object key, Locale locale)
 231   {
 232     return (Color) getLookAndFeel().getDefaults().get(key);
 233   }
 234
 235   /**
 236    * this string can be passed to Class.forName()
 237    */
 238   public static  String getCrossPlatformLookAndFeelClassName()
 239   {
 240     return "javax.swing.plaf.metal.MetalLookAndFeel";
 241   }
 242
 243   /**
 244    * Returns the default values for this look and feel.
 245    */
 246   public static UIDefaults getDefaults()
 247   {
 248     return getLookAndFeel().getDefaults();
 249   }
 250
 251   /**
 252    * Returns a dimension from the defaults table.
 253    */
 254   public static Dimension getDimension(Object key)
 255   {
 256     return (Dimension) getLookAndFeel().getDefaults().get(key);
 257   }
 258
 259   /**
 260    * Returns a dimension from the defaults table.
 261    */
 262   public static Dimension getDimension(Object key, Locale locale)
 263   {
 264     return (Dimension) getLookAndFeel().getDefaults().get(key, locale);
 265   }
 266
 267   /**
 268    * Retrieves a font from the defaults table of the current
 269    * LookAndFeel.
 270    *
 271    * @param key an Object that specifies the font. Typically,
 272    *        this is a String such as
 273    *        <code>TitledBorder.font</code>.
 274    */
 275   public static Font getFont(Object key)
 276   {
 277     return (Font) getLookAndFeel().getDefaults().get(key);
 278   }
 279
 280   /**
 281    * Retrieves a font from the defaults table of the current
 282    * LookAndFeel.
 283    *
 284    * @param key an Object that specifies the font. Typically,
 285    *        this is a String such as
 286    *        <code>TitledBorder.font</code>.
 287    */
 288   public static Font getFont(Object key, Locale locale)
 289   {
 290     return (Font) getLookAndFeel().getDefaults().get(key ,locale);
 291   }
 292
 293   /**
 294    * Returns an Icon from the defaults table.
 295    */
 296   public static Icon getIcon(Object key)
 297   {
 298     return (Icon) getLookAndFeel().getDefaults().get(key);
 299   }
 300
 301   /**
 302    * Returns an Icon from the defaults table.
 303    */
 304   public static Icon getIcon(Object key, Locale locale)
 305   {
 306     return (Icon) getLookAndFeel().getDefaults().get(key, locale);
 307   }
 308
 309   /**
 310    * Returns an Insets object from the defaults table.
 311    */
 312   public static Insets getInsets(Object key)
 313   {
 314     return (Insets) getLookAndFeel().getDefaults().getInsets(key);
 315   }
 316
 317   /**
 318    * Returns an Insets object from the defaults table.
 319    */
 320   public static Insets getInsets(Object key, Locale locale)
 321   {
 322     return (Insets) getLookAndFeel().getDefaults().getInsets(key, locale);
 323   }
 324
 325   public static LookAndFeelInfo[] getInstalledLookAndFeels()
 326   {
 327     return installed;
 328   }
 329
 330   public static int getInt(Object key)
 331   {
 332     Integer x = (Integer) getLookAndFeel().getDefaults().get(key);
 333     if (x == null)
 334       return 0;
 335     return x.intValue();
 336   }
 337
 338   public static int getInt(Object key, Locale locale)
 339   {
 340     Integer x = (Integer) getLookAndFeel().getDefaults().get(key, locale);
 341     if (x == null)
 342       return 0;
 343     return x.intValue();
 344   }
 345
 346   public static LookAndFeel getLookAndFeel()
 347   {
 348     return look_and_feel;
 349   }
 350
 351   /**
 352    * Returns the <code>UIDefaults</code> table of the currently active
 353    * look and feel.
 354    */
 355   public static UIDefaults getLookAndFeelDefaults()
 356   {
 357     return getLookAndFeel().getDefaults();
 358   }
 359
 360   /**
 361    * Returns a string from the defaults table.
 362    */
 363   public static String getString(Object key)
 364   {
 365     return (String) getLookAndFeel().getDefaults().get(key);
 366   }
 367
 368   /**
 369    * Returns a string from the defaults table.
 370    */
 371   public static String getString(Object key, Locale locale)
 372   {
 373     return (String) getLookAndFeel().getDefaults().get(key, locale);
 374   }
 375
 376   /**
 377    * Returns the name of the LookAndFeel class that implements the
 378    * native systems look and feel if there is one, otherwise the name
 379    * of the default cross platform LookAndFeel class.
 380    */
 381   public static String getSystemLookAndFeelClassName()
 382   {
 383     return getCrossPlatformLookAndFeelClassName();
 384   }
 385
 386   /**
 387    * Returns the Look and Feel object that renders the target component.
 388    */
 389   public static ComponentUI getUI(JComponent target)
 390   {
 391     return getDefaults().getUI(target);
 392   }
 393
 394   /**
 395    * Creates a new look and feel and adds it to the current array.
 396    */
 397   public static void installLookAndFeel(String name, String className)
 398   {
 399   }
 400
 401   /**
 402    * Adds the specified look and feel to the current array and then calls
 403    * setInstalledLookAndFeels(javax.swing.UIManager.LookAndFeelInfo[]).
 404    */
 405   public static void installLookAndFeel(LookAndFeelInfo info)
 406   {
 407   }
 408
 409   /**
 410    * Stores an object in the defaults table.
 411    */
 412   public static Object put(Object key, Object value)
 413   {
 414     return getLookAndFeel().getDefaults().put(key,value);
 415   }
 416
 417   /**
 418    * Replaces the current array of installed LookAndFeelInfos.
 419    */
 420   public static void setInstalledLookAndFeels(UIManager.LookAndFeelInfo[] infos)
 421   {
 422   }
 423
 424   /**
 425    * Set the current default look.
 426    */
 427   public static void setLookAndFeel(LookAndFeel newLookAndFeel)
 428     throws UnsupportedLookAndFeelException
 429   {
 430     if (! newLookAndFeel.isSupportedLookAndFeel())
 431       throw new UnsupportedLookAndFeelException(newLookAndFeel.getName());
 432
 433     if (look_and_feel != null)
 434       look_and_feel.uninitialize();
 435
 436     // Set the current default look and feel using a LookAndFeel object.
 437     look_and_feel = newLookAndFeel;
 438     look_and_feel.initialize();
 439
 440     //revalidate();
 441     //repaint();
 442   }
 443
 444   /**
 445    * Set the current default look and feel using a class name.
 446    */
 447   public static void setLookAndFeel (String className)
 448     throws ClassNotFoundException, InstantiationException, IllegalAccessException,
 449     UnsupportedLookAndFeelException
 450   {
 451     Class c = Class.forName(className);
 452     LookAndFeel a = (LookAndFeel) c.newInstance(); // throws class-cast-exception
 453     setLookAndFeel(a);
 454   }
 455 }