org.jfree.ui

## Class RefineryUtilities

- java.lang.Object
- - org.jfree.ui.RefineryUtilities

-     public class RefineryUtilities
      extends java.lang.Object

  A collection of utility methods relating to user interfaces.
  Author:
    David Gilbert

- - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `static void` | `centerDialogInParent(java.awt.Dialog dialog)` Positions the specified dialog within its parent.
    `static void` | `centerFrameOnScreen(java.awt.Window frame)` Positions the specified frame in the middle of the screen.
    `static javax.swing.JButton` | `createJButton(java.lang.String label, java.awt.Font font)` Creates a `JButton`.
    `static javax.swing.JLabel` | `createJLabel(java.lang.String text, java.awt.Font font)` Creates a label with a specific font.
    `static javax.swing.JLabel` | `createJLabel(java.lang.String text, java.awt.Font font, java.awt.Color color)` Creates a label with a specific font and color.
    `static javax.swing.JPanel` | `createTablePanel(javax.swing.table.TableModel model)` Creates a panel that contains a table based on the specified table model.
    `static java.awt.Point` | `getCenterPoint()` Deprecated. this method is not useful in multi-screen environments.
    `static java.awt.Rectangle` | `getMaximumWindowBounds()` Deprecated. this method is not useful in multi-screen environments.
    `static void` | `positionDialogRelativeToParent(java.awt.Dialog dialog, double horizontalPercent, double verticalPercent)` Positions the specified dialog at a position relative to its parent.
    `static void` | `positionFrameOnScreen(java.awt.Window frame, double horizontalPercent, double verticalPercent)` Positions the specified frame at a relative position in the screen, where 50% is considered to be the center of the screen.
    `static void` | `positionFrameRandomly(java.awt.Window frame)` Positions the specified frame at a random location on the screen while ensuring that the entire frame is visible (provided that the frame is smaller than the screen).

    - ### Methods inherited from class java.lang.Object

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

- - ### Method Detail

    - #### getCenterPoint

          public static java.awt.Point getCenterPoint()

      Deprecated. this method is not useful in multi-screen environments.
      Computes the center point of the current screen device. If this method is called on JDK 1.4, Xinerama-aware results are returned. (See Sun-Bug-ID 4463949 for details).
      Returns:
        the center point of the current screen.

    - #### getMaximumWindowBounds

          public static java.awt.Rectangle getMaximumWindowBounds()

      Deprecated. this method is not useful in multi-screen environments.
      Computes the maximum bounds of the current screen device. If this method is called on JDK 1.4, Xinerama-aware results are returned. (See Sun-Bug-ID 4463949 for details).
      Returns:
        the maximum bounds of the current screen.

    - #### centerFrameOnScreen

          public static void centerFrameOnScreen(java.awt.Window frame)

      Positions the specified frame in the middle of the screen.
      Parameters:
        `frame` - the frame to be centered on the screen.

    - #### positionFrameOnScreen

          public static void positionFrameOnScreen(java.awt.Window frame,
                                   double horizontalPercent,
                                   double verticalPercent)

      Positions the specified frame at a relative position in the screen, where 50% is considered to be the center of the screen.
      Parameters:
        `frame` - the frame.
        `horizontalPercent` - the relative horizontal position of the frame (0.0 to 1.0, where 0.5 is the center of the screen).
        `verticalPercent` - the relative vertical position of the frame (0.0 to 1.0, where 0.5 is the center of the screen).

    - #### positionFrameRandomly

          public static void positionFrameRandomly(java.awt.Window frame)

      Positions the specified frame at a random location on the screen while ensuring that the entire frame is visible (provided that the frame is smaller than the screen).
      Parameters:
        `frame` - the frame.

    - #### centerDialogInParent

          public static void centerDialogInParent(java.awt.Dialog dialog)

      Positions the specified dialog within its parent.
      Parameters:
        `dialog` - the dialog to be positioned on the screen.

    - #### positionDialogRelativeToParent

          public static void positionDialogRelativeToParent(java.awt.Dialog dialog,
                                            double horizontalPercent,
                                            double verticalPercent)

      Positions the specified dialog at a position relative to its parent.
      Parameters:
        `dialog` - the dialog to be positioned.
        `horizontalPercent` - the relative location.
        `verticalPercent` - the relative location.

    - #### createTablePanel

          public static javax.swing.JPanel createTablePanel(javax.swing.table.TableModel model)

      Creates a panel that contains a table based on the specified table model.
      Parameters:
        `model` - the table model to use when constructing the table.
      Returns:
        The panel.

    - #### createJLabel

          public static javax.swing.JLabel createJLabel(java.lang.String text,
                                        java.awt.Font font)

      Creates a label with a specific font.
      Parameters:
        `text` - the text for the label.
        `font` - the font.
      Returns:
        The label.

    - #### createJLabel

          public static javax.swing.JLabel createJLabel(java.lang.String text,
                                        java.awt.Font font,
                                        java.awt.Color color)

      Creates a label with a specific font and color.
      Parameters:
        `text` - the text for the label.
        `font` - the font.
        `color` - the color.
      Returns:
        The label.

    - #### createJButton

          public static javax.swing.JButton createJButton(java.lang.String label,
                                          java.awt.Font font)

      Creates a `JButton`.
      Parameters:
        `label` - the label.
        `font` - the font.
      Returns:
        The button.