PDAP Public Review Draft

java.awt
Class SystemColor

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

public final class SystemColor
extends Color

A class to encapsulate symbolic colors representing the color of 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().


Field Summary
static int ACTIVE_CAPTION
          The array index for the active caption background color.
static int ACTIVE_CAPTION_BORDER
          The array index for the active caption border color.
static int ACTIVE_CAPTION_TEXT
          The array index for the action caption text color.
static SystemColor activeCaption
          The background color for captions in window borders.
static SystemColor activeCaptionBorder
          The border color for captions in window borders.
static SystemColor activeCaptionText
          The text color for captions in window borders.
static SystemColor control
          The background color for control objects.
static int CONTROL
          The array index for the control background color.
static int CONTROL_DK_SHADOW
          The array index for the control dark shadow color.
static int CONTROL_HIGHLIGHT
          The array index for the control highlight color.
static int CONTROL_LT_HIGHLIGHT
          The array index for the control light highlight color.
static int CONTROL_SHADOW
          The array index for the control shadow color.
static int CONTROL_TEXT
          The array index for the control text color.
static SystemColor controlDkShadow
          The dark shadow color for control objects.
static SystemColor controlHighlight
          The regular highlight color for control objects.
static SystemColor controlLtHighlight
          The light highlight color for control objects.
static SystemColor controlShadow
          The regular shadow color for control objects.
static SystemColor controlText
          The text color for control objects.
static SystemColor desktop
          The color of the desktop background.
static int DESKTOP
          The array index for the desktop background color.
static int INACTIVE_CAPTION
          The array index for the inactive caption background color.
static int INACTIVE_CAPTION_BORDER
          The array index for the inactive caption border color.
static int INACTIVE_CAPTION_TEXT
          The array index for the inactive caption text color.
static SystemColor inactiveCaption
          The background color for inactive captions in window borders.
static SystemColor inactiveCaptionBorder
          The border color for inactive captios in window borders.
static SystemColor inactiveCaptionText
          The text color for inactive captions in window borders.
static SystemColor info
          The background color for info(help) text.
static int INFO
          The array index for the info background color.
static int INFO_TEXT
          The array index for the info text color.
static SystemColor infoText
          The text color for info(help) text.
static SystemColor menu
          The background color for menus.
static int MENU
          The array index for the menu background color.
static int MENU_TEXT
          The array index for the menu text color.
static SystemColor menuText
          The text color for menus.
static int NUM_COLORS
          The number of system colors in the array.
static SystemColor scrollbar
          The background color for scrollbars.
static int SCROLLBAR
          The array index for the scrollbar background color.
static SystemColor text
          The background color for text components.
static int TEXT
          The array index for the text background color.
static int TEXT_HIGHLIGHT
          The array index for the text highlight color.
static int TEXT_HIGHLIGHT_TEXT
          The array index for the text highlight text color.
static int TEXT_INACTIVE_TEXT
          The array index for the text inactive text color.
static int TEXT_TEXT
          The array index for the text text color.
static SystemColor textHighlight
          The background color for highlighted text.
static SystemColor textHighlightText
          The text color for highlighted text.
static SystemColor textInactiveText
          The text color for inactive text.
static SystemColor textText
          The text color for text components.
static SystemColor window
          The background color for windows.
static int WINDOW
          The array index for the window background color.
static int WINDOW_BORDER
          The array index for the window border color.
static int WINDOW_TEXT
          The array index for the window text color.
static SystemColor windowBorder
          The border color for windows.
static SystemColor windowText
          The text color for windows.
 
Fields inherited from class java.awt.Color
black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, yellow
 
Method Summary
 int getRGB()
          Gets the "current" RGB value representing the symbolic color.
 java.lang.String toString()
          Returns the String representation of this Color's values.
 
Methods inherited from class java.awt.Color
brighter, darker, decode, equals, getAlpha, getBlue, getColor, getColor, getColor, getColorComponents, getComponents, getGreen, getHSBColor, getRed, getRGBColorComponents, getRGBComponents, hashCode, HSBtoRGB, RGBtoHSB
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

DESKTOP

public static final int DESKTOP
The array index for the desktop background color.

Value 0 is assigned to DESKTOP.


ACTIVE_CAPTION

public static final int ACTIVE_CAPTION
The array index for the active caption background color.

Value 1 is assigned to ACTIVE_CAPTION.


ACTIVE_CAPTION_TEXT

public static final int ACTIVE_CAPTION_TEXT
The array index for the action caption text color.

Value 2 is assigned to ACTIVE_CAPTION_TEXT.


ACTIVE_CAPTION_BORDER

public static final int ACTIVE_CAPTION_BORDER
The array index for the active caption border color.

Value 3 is assigned to ACTIVE_CAPTION_BORDER.


INACTIVE_CAPTION

public static final int INACTIVE_CAPTION
The array index for the inactive caption background color.

Value 4 is assigned to INACTIVE_CAPTION.


INACTIVE_CAPTION_TEXT

public static final int INACTIVE_CAPTION_TEXT
The array index for the inactive caption text color.

Value 5 is assigned to INACTIVE_CAPTION_TEXT.


INACTIVE_CAPTION_BORDER

public static final int INACTIVE_CAPTION_BORDER
The array index for the inactive caption border color.

Value 6 is assigned to INACTIVE_CAPTION_BORDER.


WINDOW

public static final int WINDOW
The array index for the window background color.

Value 7 is assigned to WINDOW.


WINDOW_BORDER

public static final int WINDOW_BORDER
The array index for the window border color.

Value 8 is assigned to WINDOW_BORDER.


WINDOW_TEXT

public static final int WINDOW_TEXT
The array index for the window text color.

Value 9 is assigned to WINDOW_TEXT.


MENU

public static final int MENU
The array index for the menu background color.

Value 10 is assigned to MENU.


MENU_TEXT

public static final int MENU_TEXT
The array index for the menu text color.

Value 11 is assigned to MENU_TEXT.


TEXT

public static final int TEXT
The array index for the text background color.

Value 12 is assigned to TEXT.


TEXT_TEXT

public static final int TEXT_TEXT
The array index for the text text color.

Value 13 is assigned to TEXT_TEXT.


TEXT_HIGHLIGHT

public static final int TEXT_HIGHLIGHT
The array index for the text highlight color.

Value 14 is assigned to TEXT_HIGHLIGHT.


TEXT_HIGHLIGHT_TEXT

public static final int TEXT_HIGHLIGHT_TEXT
The array index for the text highlight text color.

Value 15 is assigned to TEXT_HIGHLIGHT_TEXT.


TEXT_INACTIVE_TEXT

public static final int TEXT_INACTIVE_TEXT
The array index for the text inactive text color.

Value 16 is assigned to TEXT_INACTIVE_TEXT.


CONTROL

public static final int CONTROL
The array index for the control background color.

Value 17 is assigned to CONTROL.


CONTROL_TEXT

public static final int CONTROL_TEXT
The array index for the control text color.

Value 18 is assigned to CONTROL_TEXT.


CONTROL_HIGHLIGHT

public static final int CONTROL_HIGHLIGHT
The array index for the control highlight color.

Value 19 is assigned to CONTROL_HIGHLIGHT.


CONTROL_LT_HIGHLIGHT

public static final int CONTROL_LT_HIGHLIGHT
The array index for the control light highlight color.

Value 20 is assigned to CONTROL_LT_HIGHLIGHT.


CONTROL_SHADOW

public static final int CONTROL_SHADOW
The array index for the control shadow color.

Value 21 is assigned to CONTROL_SHADOW.


CONTROL_DK_SHADOW

public static final int CONTROL_DK_SHADOW
The array index for the control dark shadow color.

Value 22 is assigned to CONTROL_DK_SHADOW.


SCROLLBAR

public static final int SCROLLBAR
The array index for the scrollbar background color.

Value 23 is assigned to SCROLLBAR.


INFO

public static final int INFO
The array index for the info background color.

Value 24 is assigned to INFO.


INFO_TEXT

public static final int INFO_TEXT
The array index for the info text color.

Value 25 is assigned to INFO_TEXT.


NUM_COLORS

public static final int NUM_COLORS
The number of system colors in the array.

Value 26 is assigned to NUM_COLORS.


desktop

public static final SystemColor desktop
The color of the desktop background.

activeCaption

public static final SystemColor activeCaption
The background color for captions in window borders.

activeCaptionText

public static final SystemColor activeCaptionText
The text color for captions in window borders.

activeCaptionBorder

public static final SystemColor activeCaptionBorder
The border color for captions in window borders.

inactiveCaption

public static final SystemColor inactiveCaption
The background color for inactive captions in window borders.

inactiveCaptionText

public static final SystemColor inactiveCaptionText
The text color for inactive captions in window borders.

inactiveCaptionBorder

public static final SystemColor inactiveCaptionBorder
The border color for inactive captios in window borders.

window

public static final SystemColor window
The background color for windows.

windowBorder

public static final SystemColor windowBorder
The border color for windows.

windowText

public static final SystemColor windowText
The text color for windows.

menu

public static final SystemColor menu
The background color for menus.

menuText

public static final SystemColor menuText
The text color for menus.

text

public static final SystemColor text
The background color for text components.

textText

public static final SystemColor textText
The text color for text components.

textHighlight

public static final SystemColor textHighlight
The background color for highlighted text.

textHighlightText

public static final SystemColor textHighlightText
The text color for highlighted text.

textInactiveText

public static final SystemColor textInactiveText
The text color for inactive text.

control

public static final SystemColor control
The background color for control objects.

controlText

public static final SystemColor controlText
The text color for control objects.

controlHighlight

public static final SystemColor controlHighlight
The regular highlight color for control objects.

controlLtHighlight

public static final SystemColor controlLtHighlight
The light highlight color for control objects.

controlShadow

public static final SystemColor controlShadow
The regular shadow color for control objects.

controlDkShadow

public static final SystemColor controlDkShadow
The dark shadow color for control objects.

scrollbar

public static final SystemColor scrollbar
The background color for scrollbars.

info

public static final SystemColor info
The background color for info(help) text.

infoText

public static final SystemColor infoText
The text color for info(help) text.
Method Detail

getRGB

public int getRGB()
Gets the "current" RGB value representing the symbolic color. (Bits 24-31 are 0xff, 16-23 are red, 8-15 are green, 0-7 are blue).
Overrides:
getRGB in class Color
See Also:
ColorModel.getRGBdefault(), Color.getBlue(), Color.getGreen(), Color.getRed()

toString

public java.lang.String toString()
Returns the String representation of this Color's values.
Overrides:
toString in class Color
Following copied from class: java.awt.Color
Returns:
a string representation of this Color.

PDAP 1.0 Spec, Rev. 0.16