public final class

SystemColor

extends Color
implements Serializable
java.lang.Object
   ↳ java.awt.Color
     ↳ java.awt.SystemColor

Class Overview

A class to encapsulate symbolic colors representing the color of native GUI objects on a system. For systems which support the dynamic update of the system colors (when the user changes the colors) the actual RGB values of these symbolic colors will also change dynamically. In order to compare the "current" RGB value of a SystemColor object with a non-symbolic Color object, getRGB should be used rather than equals.

Note that the way in which these system colors are applied to GUI objects may vary slightly from platform to platform since GUI objects may be rendered differently on each platform.

System color values may also be available through the getDesktopProperty method on java.awt.Toolkit.

See Also

Summary

Constants
int ACTIVE_CAPTION The array index for the activeCaption system color.
int ACTIVE_CAPTION_BORDER The array index for the activeCaptionBorder system color.
int ACTIVE_CAPTION_TEXT The array index for the activeCaptionText system color.
int CONTROL The array index for the control system color.
int CONTROL_DK_SHADOW The array index for the controlDkShadow system color.
int CONTROL_HIGHLIGHT The array index for the controlHighlight system color.
int CONTROL_LT_HIGHLIGHT The array index for the controlLtHighlight system color.
int CONTROL_SHADOW The array index for the controlShadow system color.
int CONTROL_TEXT The array index for the controlText system color.
int DESKTOP The array index for the desktop system color.
int INACTIVE_CAPTION The array index for the inactiveCaption system color.
int INACTIVE_CAPTION_BORDER The array index for the inactiveCaptionBorder system color.
int INACTIVE_CAPTION_TEXT The array index for the inactiveCaptionText system color.
int INFO The array index for the info system color.
int INFO_TEXT The array index for the infoText system color.
int MENU The array index for the menu system color.
int MENU_TEXT The array index for the menuText system color.
int NUM_COLORS The number of system colors in the array.
int SCROLLBAR The array index for the scrollbar system color.
int TEXT The array index for the text system color.
int TEXT_HIGHLIGHT The array index for the textHighlight system color.
int TEXT_HIGHLIGHT_TEXT The array index for the textHighlightText system color.
int TEXT_INACTIVE_TEXT The array index for the textInactiveText system color.
int TEXT_TEXT The array index for the textText system color.
int WINDOW The array index for the window system color.
int WINDOW_BORDER The array index for the windowBorder system color.
int WINDOW_TEXT The array index for the windowText system color.
[Expand]
Inherited Constants
From interface java.awt.Transparency
Fields
public static final SystemColor activeCaption The color rendered for the window-title background of the currently active window.
public static final SystemColor activeCaptionBorder The color rendered for the border around the currently active window.
public static final SystemColor activeCaptionText The color rendered for the window-title text of the currently active window.
public static final SystemColor control The color rendered for the background of control panels and control objects, such as pushbuttons.
public static final SystemColor controlDkShadow The color rendered for dark shadow areas on 3D control objects, such as pushbuttons.
public static final SystemColor controlHighlight The color rendered for light areas of 3D control objects, such as pushbuttons.
public static final SystemColor controlLtHighlight The color rendered for highlight areas of 3D control objects, such as pushbuttons.
public static final SystemColor controlShadow The color rendered for shadow areas of 3D control objects, such as pushbuttons.
public static final SystemColor controlText The color rendered for the text of control panels and control objects, such as pushbuttons.
public static final SystemColor desktop The color rendered for the background of the desktop.
public static final SystemColor inactiveCaption The color rendered for the window-title background of inactive windows.
public static final SystemColor inactiveCaptionBorder The color rendered for the border around inactive windows.
public static final SystemColor inactiveCaptionText The color rendered for the window-title text of inactive windows.
public static final SystemColor info The color rendered for the background of tooltips or spot help.
public static final SystemColor infoText The color rendered for the text of tooltips or spot help.
public static final SystemColor menu The color rendered for the background of menus.
public static final SystemColor menuText The color rendered for the text of menus.
public static final SystemColor scrollbar The color rendered for the background of scrollbars.
public static final SystemColor text The color rendered for the background of text control objects, such as textfields and comboboxes.
public static final SystemColor textHighlight The color rendered for the background of selected items, such as in menus, comboboxes, and text.
public static final SystemColor textHighlightText The color rendered for the text of selected items, such as in menus, comboboxes, and text.
public static final SystemColor textInactiveText The color rendered for the text of inactive items, such as in menus.
public static final SystemColor textText The color rendered for the text of text control objects, such as textfields and comboboxes.
public static final SystemColor window The color rendered for the background of interior regions inside windows.
public static final SystemColor windowBorder The color rendered for the border around interior regions inside windows.
public static final SystemColor windowText The color rendered for text of interior regions inside windows.
[Expand]
Inherited Fields
From class java.awt.Color
Public Methods
String toString()
Returns a string representation of this Color's values.
[Expand]
Inherited Methods
From class java.awt.Color
From class java.lang.Object
From interface java.awt.Paint
From interface java.awt.Transparency

Constants

public static final int ACTIVE_CAPTION

The array index for the activeCaption system color.

See Also
Constant Value: 1 (0x00000001)

public static final int ACTIVE_CAPTION_BORDER

The array index for the activeCaptionBorder system color.

See Also
Constant Value: 3 (0x00000003)

public static final int ACTIVE_CAPTION_TEXT

The array index for the activeCaptionText system color.

See Also
Constant Value: 2 (0x00000002)

public static final int CONTROL

The array index for the control system color.

See Also
Constant Value: 17 (0x00000011)

public static final int CONTROL_DK_SHADOW

The array index for the controlDkShadow system color.

See Also
Constant Value: 22 (0x00000016)

public static final int CONTROL_HIGHLIGHT

The array index for the controlHighlight system color.

See Also
Constant Value: 19 (0x00000013)

public static final int CONTROL_LT_HIGHLIGHT

The array index for the controlLtHighlight system color.

See Also
Constant Value: 20 (0x00000014)

public static final int CONTROL_SHADOW

The array index for the controlShadow system color.

See Also
Constant Value: 21 (0x00000015)

public static final int CONTROL_TEXT

The array index for the controlText system color.

See Also
Constant Value: 18 (0x00000012)

public static final int DESKTOP

The array index for the desktop system color.

See Also
Constant Value: 0 (0x00000000)

public static final int INACTIVE_CAPTION

The array index for the inactiveCaption system color.

See Also
Constant Value: 4 (0x00000004)

public static final int INACTIVE_CAPTION_BORDER

The array index for the inactiveCaptionBorder system color.

See Also
Constant Value: 6 (0x00000006)

public static final int INACTIVE_CAPTION_TEXT

The array index for the inactiveCaptionText system color.

See Also
Constant Value: 5 (0x00000005)

public static final int INFO

The array index for the info system color.

See Also
Constant Value: 24 (0x00000018)

public static final int INFO_TEXT

The array index for the infoText system color.

See Also
Constant Value: 25 (0x00000019)

public static final int MENU

The array index for the menu system color.

See Also
Constant Value: 10 (0x0000000a)

public static final int MENU_TEXT

The array index for the menuText system color.

See Also
Constant Value: 11 (0x0000000b)

public static final int NUM_COLORS

The number of system colors in the array.

Constant Value: 26 (0x0000001a)

public static final int SCROLLBAR

The array index for the scrollbar system color.

See Also
Constant Value: 23 (0x00000017)

public static final int TEXT

The array index for the text system color.

See Also
Constant Value: 12 (0x0000000c)

public static final int TEXT_HIGHLIGHT

The array index for the textHighlight system color.

See Also
Constant Value: 14 (0x0000000e)

public static final int TEXT_HIGHLIGHT_TEXT

The array index for the textHighlightText system color.

See Also
Constant Value: 15 (0x0000000f)

public static final int TEXT_INACTIVE_TEXT

The array index for the textInactiveText system color.

See Also
Constant Value: 16 (0x00000010)

public static final int TEXT_TEXT

The array index for the textText system color.

See Also
Constant Value: 13 (0x0000000d)

public static final int WINDOW

The array index for the window system color.

See Also
Constant Value: 7 (0x00000007)

public static final int WINDOW_BORDER

The array index for the windowBorder system color.

See Also
Constant Value: 8 (0x00000008)

public static final int WINDOW_TEXT

The array index for the windowText system color.

See Also
Constant Value: 9 (0x00000009)

Fields

public static final SystemColor activeCaption

The color rendered for the window-title background of the currently active window.

public static final SystemColor activeCaptionBorder

The color rendered for the border around the currently active window.

public static final SystemColor activeCaptionText

The color rendered for the window-title text of the currently active window.

public static final SystemColor control

The color rendered for the background of control panels and control objects, such as pushbuttons.

public static final SystemColor controlDkShadow

The color rendered for dark shadow areas on 3D control objects, such as pushbuttons. This color is typically derived from the control background color to provide a 3D effect.

public static final SystemColor controlHighlight

The color rendered for light areas of 3D control objects, such as pushbuttons. This color is typically derived from the control background color to provide a 3D effect.

public static final SystemColor controlLtHighlight

The color rendered for highlight areas of 3D control objects, such as pushbuttons. This color is typically derived from the control background color to provide a 3D effect.

public static final SystemColor controlShadow

The color rendered for shadow areas of 3D control objects, such as pushbuttons. This color is typically derived from the control background color to provide a 3D effect.

public static final SystemColor controlText

The color rendered for the text of control panels and control objects, such as pushbuttons.

public static final SystemColor desktop

The color rendered for the background of the desktop.

public static final SystemColor inactiveCaption

The color rendered for the window-title background of inactive windows.

public static final SystemColor inactiveCaptionBorder

The color rendered for the border around inactive windows.

public static final SystemColor inactiveCaptionText

The color rendered for the window-title text of inactive windows.

public static final SystemColor info

The color rendered for the background of tooltips or spot help.

public static final SystemColor infoText

The color rendered for the text of tooltips or spot help.

public static final SystemColor menu

The color rendered for the background of menus.

public static final SystemColor menuText

The color rendered for the text of menus.

public static final SystemColor scrollbar

The color rendered for the background of scrollbars.

public static final SystemColor text

The color rendered for the background of text control objects, such as textfields and comboboxes.

public static final SystemColor textHighlight

The color rendered for the background of selected items, such as in menus, comboboxes, and text.

public static final SystemColor textHighlightText

The color rendered for the text of selected items, such as in menus, comboboxes, and text.

public static final SystemColor textInactiveText

The color rendered for the text of inactive items, such as in menus.

public static final SystemColor textText

The color rendered for the text of text control objects, such as textfields and comboboxes.

public static final SystemColor window

The color rendered for the background of interior regions inside windows.

public static final SystemColor windowBorder

The color rendered for the border around interior regions inside windows.

public static final SystemColor windowText

The color rendered for text of interior regions inside windows.

Public Methods

public String toString ()

Returns a string representation of this Color's values. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Returns
  • a string representation of this Color