Index (Frames) | Index (No Frames) | Package | Package Tree | Tree
java.awt

Class SystemColor

java.lang.Object
|
+--java.awt.Color
   |
   +--java.awt.SystemColor

All Implemented Interfaces:

Serializable, Paint, Serializable


public final class SystemColor

extends Color

implements Serializable

This class contains the various "system colors" in use by the native windowing system. The getRGB() method is dynamic on systems which support dynamic system color changes, and most methods in the superclass are written to use this dynamic value when reporting colors. However, the equals() method is not dynamic, and does not track the actual color of instances in this class. This means that equals may give surprising results; you are better off relying on getRGB.

Since:Authors:

Field Summary

static intACTIVE_CAPTION

Array index of the active caption color.
static intACTIVE_CAPTION_BORDER

Array index of the active caption border color.
static intACTIVE_CAPTION_TEXT

Array index of the active caption text color.
static intCONTROL

Array index of the control background color.
static intCONTROL_DK_SHADOW

Array index of the darkly shadowed control background color.
static intCONTROL_HIGHLIGHT

Array index of the highlighted control background color.
static intCONTROL_LT_HIGHLIGHT

Array index of the lightly highlighted control background color.
static intCONTROL_SHADOW

Array index of the shadowed control background color.
static intCONTROL_TEXT

Array index of the control text color.
static intDESKTOP

Array index of the desktop color.
static intINACTIVE_CAPTION

Array index of the inactive caption color.
static intINACTIVE_CAPTION_BORDER

Array index of the inactive caption border color.
static intINACTIVE_CAPTION_TEXT

Array index of the inactive caption text color.
static intINFO

Array index of the info background color.
static intINFO_TEXT

Array index of the info text color.
static intMENU

Array index of the menu background color.
static intMENU_TEXT

Array index of the menu text color.
static intNUM_COLORS

The number of system colors.
static intSCROLLBAR

Array index of the scrollbar background color.
static intTEXT

Array index of the text background color.
static intTEXT_HIGHLIGHT

Array index of the highlighted text background color.
static intTEXT_HIGHLIGHT_TEXT

Array index of the highlighted text foreground color.
static intTEXT_INACTIVE_TEXT

Array index of the inactive text foreground color.
static intTEXT_TEXT

Array index of the text foreground color.
static intWINDOW

Array index of the window background color.
static intWINDOW_BORDER

Array index of the window border color.
static intWINDOW_TEXT

Array index of the window text color.
static java.awt.SystemColoractiveCaption

The active caption background color.
static java.awt.SystemColoractiveCaptionBorder

The active caption border color.
static java.awt.SystemColoractiveCaptionText

The active caption text color.
static java.awt.SystemColorcontrol

The control background color.
static java.awt.SystemColorcontrolDkShadow

The control dark shadow color.
static java.awt.SystemColorcontrolHighlight

The control highlight color.
static java.awt.SystemColorcontrolLtHighlight

The control light highlight color.
static java.awt.SystemColorcontrolShadow

The control shadow color.
static java.awt.SystemColorcontrolText

The control text color.
static java.awt.SystemColordesktop

The desktop color.
static java.awt.SystemColorinactiveCaption

The inactive caption background color.
static java.awt.SystemColorinactiveCaptionBorder

The inactive caption border color.
static java.awt.SystemColorinactiveCaptionText

The inactive caption text color.
static java.awt.SystemColorinfo

The info text background color.
static java.awt.SystemColorinfoText

The info text foreground color.
static java.awt.SystemColormenu

The menu background color.
static java.awt.SystemColormenuText

The menu text color.
static java.awt.SystemColorscrollbar

The scrollbar color.
static java.awt.SystemColortext

The text background color.
static java.awt.SystemColortextHighlight

The highlighted text background color.
static java.awt.SystemColortextHighlightText

The highlighted text foreground color.
static java.awt.SystemColortextInactiveText

The inactive text color.
static java.awt.SystemColortextText

The text foreground color.
static java.awt.SystemColorwindow

The window background color.
static java.awt.SystemColorwindowBorder

The window border color.
static java.awt.SystemColorwindowText

The window text color.

Method Summary

java.awt.PaintContextcreateContext(java.awt.image.ColorModel cm, java.awt.Rectangle deviceBounds, java.awt.geom.Rectangle2D userBounds, java.awt.geom.AffineTransform xform, java.awt.RenderingHints hints)

Returns a paint context, used for filling areas of a raster scan with the current value of this system color.
intgetRGB()

Returns the RGB value for this color, in the sRGB color space.
java.lang.StringtoString()

Returns a string describing this color.

Field Details

ACTIVE_CAPTION

public static final int ACTIVE_CAPTION

Array index of the active caption color. Used by Toolkit#loadSystemColors().

See Also:


ACTIVE_CAPTION_BORDER

public static final int ACTIVE_CAPTION_BORDER

Array index of the active caption border color. Used by Toolkit#loadSystemColors().

See Also:


ACTIVE_CAPTION_TEXT

public static final int ACTIVE_CAPTION_TEXT

Array index of the active caption text color. Used by Toolkit#loadSystemColors().

See Also:


CONTROL

public static final int CONTROL

Array index of the control background color. Used by Toolkit#loadSystemColors().

See Also:


CONTROL_DK_SHADOW

public static final int CONTROL_DK_SHADOW

Array index of the darkly shadowed control background color. Used by Toolkit#loadSystemColors().

See Also:


CONTROL_HIGHLIGHT

public static final int CONTROL_HIGHLIGHT

Array index of the highlighted control background color. Used by Toolkit#loadSystemColors().

See Also:


CONTROL_LT_HIGHLIGHT

public static final int CONTROL_LT_HIGHLIGHT

Array index of the lightly highlighted control background color. Used by Toolkit#loadSystemColors().

See Also:


CONTROL_SHADOW

public static final int CONTROL_SHADOW

Array index of the shadowed control background color. Used by Toolkit#loadSystemColors().

See Also:


CONTROL_TEXT

public static final int CONTROL_TEXT

Array index of the control text color. Used by Toolkit#loadSystemColors().

See Also:


DESKTOP

public static final int DESKTOP

Array index of the desktop color. Used by Toolkit#loadSystemColors().

See Also:


INACTIVE_CAPTION

public static final int INACTIVE_CAPTION

Array index of the inactive caption color. Used by Toolkit#loadSystemColors().

See Also:


INACTIVE_CAPTION_BORDER

public static final int INACTIVE_CAPTION_BORDER

Array index of the inactive caption border color. Used by Toolkit#loadSystemColors().

See Also:


INACTIVE_CAPTION_TEXT

public static final int INACTIVE_CAPTION_TEXT

Array index of the inactive caption text color. Used by Toolkit#loadSystemColors().

See Also:


INFO

public static final int INFO

Array index of the info background color. Used by Toolkit#loadSystemColors().

See Also:


INFO_TEXT

public static final int INFO_TEXT

Array index of the info text color. Used by Toolkit#loadSystemColors().

See Also:


MENU

public static final int MENU

Array index of the menu background color. Used by Toolkit#loadSystemColors().

See Also:


MENU_TEXT

public static final int MENU_TEXT

Array index of the menu text color. Used by Toolkit#loadSystemColors().

See Also:


NUM_COLORS

public static final int NUM_COLORS

The number of system colors. Used by Toolkit#loadSystemColors().


SCROLLBAR

public static final int SCROLLBAR

Array index of the scrollbar background color. Used by Toolkit#loadSystemColors().

See Also:


TEXT

public static final int TEXT

Array index of the text background color. Used by Toolkit#loadSystemColors().

See Also:


TEXT_HIGHLIGHT

public static final int TEXT_HIGHLIGHT

Array index of the highlighted text background color. Used by Toolkit#loadSystemColors().

See Also:


TEXT_HIGHLIGHT_TEXT

public static final int TEXT_HIGHLIGHT_TEXT

Array index of the highlighted text foreground color. Used by Toolkit#loadSystemColors().

See Also:


TEXT_INACTIVE_TEXT

public static final int TEXT_INACTIVE_TEXT

Array index of the inactive text foreground color. Used by Toolkit#loadSystemColors().

See Also:


TEXT_TEXT

public static final int TEXT_TEXT

Array index of the text foreground color. Used by Toolkit#loadSystemColors().

See Also:


WINDOW

public static final int WINDOW

Array index of the window background color. Used by Toolkit#loadSystemColors().

See Also:


WINDOW_BORDER

public static final int WINDOW_BORDER

Array index of the window border color. Used by Toolkit#loadSystemColors().

See Also:


WINDOW_TEXT

public static final int WINDOW_TEXT

Array index of the window text color. Used by Toolkit#loadSystemColors().

See Also:


activeCaption

public static final SystemColor activeCaption

The active caption background color.


activeCaptionBorder

public static final SystemColor activeCaptionBorder

The active caption border color.


activeCaptionText

public static final SystemColor activeCaptionText

The active caption text color.


control

public static final SystemColor control

The control background color.


controlDkShadow

public static final SystemColor controlDkShadow

The control dark shadow color.


controlHighlight

public static final SystemColor controlHighlight

The control highlight color.


controlLtHighlight

public static final SystemColor controlLtHighlight

The control light highlight color.


controlShadow

public static final SystemColor controlShadow

The control shadow color.


controlText

public static final SystemColor controlText

The control text color.


desktop

public static final SystemColor desktop

The desktop color.


inactiveCaption

public static final SystemColor inactiveCaption

The inactive caption background color.


inactiveCaptionBorder

public static final SystemColor inactiveCaptionBorder

The inactive caption border color.


inactiveCaptionText

public static final SystemColor inactiveCaptionText

The inactive caption text color.


info

public static final SystemColor info

The info text background color.


infoText

public static final SystemColor infoText

The info text foreground color.


menu

public static final SystemColor menu

The menu background color.


menuText

public static final SystemColor menuText

The menu text color.


scrollbar

public static final SystemColor scrollbar

The scrollbar color.


text

public static final SystemColor text

The text background color.


textHighlight

public static final SystemColor textHighlight

The highlighted text background color.


textHighlightText

public static final SystemColor textHighlightText

The highlighted text foreground color.


textInactiveText

public static final SystemColor textInactiveText

The inactive text color.


textText

public static final SystemColor textText

The text foreground color.


window

public static final SystemColor window

The window background color.


windowBorder

public static final SystemColor windowBorder

The window border color.


windowText

public static final SystemColor windowText

The window text color.


Method Details

createContext

public PaintContext createContext(java.awt.image.ColorModel cm, java.awt.Rectangle deviceBounds, java.awt.geom.Rectangle2D userBounds, java.awt.geom.AffineTransform xform, java.awt.RenderingHints hints)

Returns a paint context, used for filling areas of a raster scan with the current value of this system color. Since the system colors may be dynamically updated, the returned value may not always be the same; but as the system color is solid, the context does not need any of the passed parameters to do its job.

Parameters:

Returns:


getRGB

public int getRGB()

Returns the RGB value for this color, in the sRGB color space. The blue value will be in bits 0-7, green in 8-15, red in 6-23, and the alpha value (bits 24-31) is 0xff. This is dynamically updated, so it may not match the results of getRed(), getGreen(), or getBlue().

Returns:


toString

public String toString()

Returns a string describing this color. This is in the format "java.awt.SystemColor[i=" + index + ']', where index is one of the integer constants of this class. Unfortunately, this description does not describe the current value of the color; for that you should use new Color(syscolor.getRGB()).toString().

Returns: