SystemColor (ocap 1.2 API)

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

All Implemented Interfaces:

Transparency, Serializable
```
public final class SystemColor
extends Color
implements Serializable
```
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: Because this profile may be used with tookits that lack AWT UI concepts, implementations are free to assign arbitrary values to the system colors.

Version:

1.23, 01/23/03

Author:

Carl Quinn, Amy Fowler

See Also:
Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ACTIVE_CAPTION` The array index for the `activeCaption` system color.
`static int`	`ACTIVE_CAPTION_BORDER` The array index for the `activeCaptionBorder` system color.
`static int`	`ACTIVE_CAPTION_TEXT` The array index for the `activeCaptionText` system color.
`static SystemColor`	`activeCaption` The color rendered for the window-title background of the currently active window.
`static SystemColor`	`activeCaptionBorder` The color rendered for the border around the currently active window.
`static SystemColor`	`activeCaptionText` The color rendered for the window-title text of the currently active window.
`static SystemColor`	`control` The color rendered for the background of control panels and control objects, such as pushbuttons.
`static int`	`CONTROL` The array index for the `control` system color.
`static int`	`CONTROL_DK_SHADOW` The array index for the `controlDkShadow` system color.
`static int`	`CONTROL_HIGHLIGHT` The array index for the `controlHighlight` system color.
`static int`	`CONTROL_LT_HIGHLIGHT` The array index for the `controlLtHighlight` system color.
`static int`	`CONTROL_SHADOW` The array index for the `controlShadow` system color.
`static int`	`CONTROL_TEXT` The array index for the `controlText` system color.
`static SystemColor`	`controlDkShadow` The color rendered for dark shadow areas on 3D control objects, such as pushbuttons.
`static SystemColor`	`controlHighlight` The color rendered for light areas of 3D control objects, such as pushbuttons.
`static SystemColor`	`controlLtHighlight` The color rendered for highlight areas of 3D control objects, such as pushbuttons.
`static SystemColor`	`controlShadow` The color rendered for shadow areas of 3D control objects, such as pushbuttons.
`static SystemColor`	`controlText` The color rendered for the text of control panels and control objects, such as pushbuttons.
`static SystemColor`	`desktop` The color rendered for the background of the desktop.
`static int`	`DESKTOP` The array index for the `desktop` system color.
`static int`	`INACTIVE_CAPTION` The array index for the `inactiveCaption` system color.
`static int`	`INACTIVE_CAPTION_BORDER` The array index for the `inactiveCaptionBorder` system color.
`static int`	`INACTIVE_CAPTION_TEXT` The array index for the `inactiveCaptionText` system color.
`static SystemColor`	`inactiveCaption` The color rendered for the window-title background of inactive windows.
`static SystemColor`	`inactiveCaptionBorder` The color rendered for the border around inactive windows.
`static SystemColor`	`inactiveCaptionText` The color rendered for the window-title text of inactive windows.
`static SystemColor`	`info` The color rendered for the background of tooltips or spot help.
`static int`	`INFO` The array index for the `info` system color.
`static int`	`INFO_TEXT` The array index for the `infoText` system color.
`static SystemColor`	`infoText` The color rendered for the text of tooltips or spot help.
`static SystemColor`	`menu` The color rendered for the background of menus.
`static int`	`MENU` The array index for the `menu` system color.
`static int`	`MENU_TEXT` The array index for the `menuText` system color.
`static SystemColor`	`menuText` The color rendered for the text of menus.
`static int`	`NUM_COLORS` The number of system colors in the array.
`static SystemColor`	`scrollbar` The color rendered for the background of scrollbars.
`static int`	`SCROLLBAR` The array index for the `scrollbar` system color.
`static SystemColor`	`text` The color rendered for the background of text control objects, such as textfields and comboboxes.
`static int`	`TEXT` The array index for the `text` system color.
`static int`	`TEXT_HIGHLIGHT` The array index for the `textHighlight` system color.
`static int`	`TEXT_HIGHLIGHT_TEXT` The array index for the `textHighlightText` system color.
`static int`	`TEXT_INACTIVE_TEXT` The array index for the `textInactiveText` system color.
`static int`	`TEXT_TEXT` The array index for the `textText` system color.
`static SystemColor`	`textHighlight` The color rendered for the background of selected items, such as in menus, comboboxes, and text.
`static SystemColor`	`textHighlightText` The color rendered for the text of selected items, such as in menus, comboboxes, and text.
`static SystemColor`	`textInactiveText` The color rendered for the text of inactive items, such as in menus.
`static SystemColor`	`textText` The color rendered for the text of text control objects, such as textfields and comboboxes.
`static SystemColor`	`window` The color rendered for the background of interior regions inside windows.
`static int`	`WINDOW` The array index for the `window` system color.
`static int`	`WINDOW_BORDER` The array index for the `windowBorder` system color.
`static int`	`WINDOW_TEXT` The array index for the `windowText` system color.
`static SystemColor`	`windowBorder` The color rendered for the border around interior regions inside windows.
`static SystemColor`	`windowText` The color rendered for text of interior regions inside windows.

Fields inherited from class java.awt.Color
black, BLACK, blue, BLUE, cyan, CYAN, DARK_GRAY, darkGray, gray, GRAY, green, GREEN, LIGHT_GRAY, lightGray, magenta, MAGENTA, orange, ORANGE, pink, PINK, red, RED, white, WHITE, yellow, YELLOW

Fields inherited from interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT

Method Summary

Methods
Modifier and Type	Method and Description
`int`	`getRGB()` Gets the "current" RGB value representing the symbolic color.
`String`	`toString()` Returns a string representation of this `Color`'s values.

Methods inherited from class java.awt.Color
brighter, darker, decode, equals, getAlpha, getBlue, getColor, getColor, getColor, getColorComponents, getColorSpace, getComponents, getGreen, getHSBColor, getRed, getRGBColorComponents, getRGBComponents, getTransparency, hashCode, HSBtoRGB, RGBtoHSB

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - DESKTOP
```
public static final int DESKTOP
```
    The array index for the desktop system color.
    
    See Also:
    desktop, Constant Field Values
  - ACTIVE_CAPTION
```
public static final int ACTIVE_CAPTION
```
    The array index for the activeCaption system color.
    
    See Also:
    activeCaption, Constant Field Values
  - ACTIVE_CAPTION_TEXT
```
public static final int ACTIVE_CAPTION_TEXT
```
    The array index for the activeCaptionText system color.
    
    See Also:
    activeCaptionText, Constant Field Values
  - ACTIVE_CAPTION_BORDER
```
public static final int ACTIVE_CAPTION_BORDER
```
    The array index for the activeCaptionBorder system color.
    
    See Also:
    activeCaptionBorder, Constant Field Values
  - INACTIVE_CAPTION
```
public static final int INACTIVE_CAPTION
```
    The array index for the inactiveCaption system color.
    
    See Also:
    inactiveCaption, Constant Field Values
  - INACTIVE_CAPTION_TEXT
```
public static final int INACTIVE_CAPTION_TEXT
```
    The array index for the inactiveCaptionText system color.
    
    See Also:
    inactiveCaptionText, Constant Field Values
  - INACTIVE_CAPTION_BORDER
```
public static final int INACTIVE_CAPTION_BORDER
```
    The array index for the inactiveCaptionBorder system color.
    
    See Also:
    inactiveCaptionBorder, Constant Field Values
  - WINDOW
```
public static final int WINDOW
```
    The array index for the window system color.
    
    See Also:
    window, Constant Field Values
  - WINDOW_BORDER
```
public static final int WINDOW_BORDER
```
    The array index for the windowBorder system color.
    
    See Also:
    windowBorder, Constant Field Values
  - WINDOW_TEXT
```
public static final int WINDOW_TEXT
```
    The array index for the windowText system color.
    
    See Also:
    windowText, Constant Field Values
  - MENU
```
public static final int MENU
```
    The array index for the menu system color.
    
    See Also:
    menu, Constant Field Values
  - MENU_TEXT
```
public static final int MENU_TEXT
```
    The array index for the menuText system color.
    
    See Also:
    menuText, Constant Field Values
  - TEXT
```
public static final int TEXT
```
    The array index for the text system color.
    
    See Also:
    text, Constant Field Values
  - TEXT_TEXT
```
public static final int TEXT_TEXT
```
    The array index for the textText system color.
    
    See Also:
    textText, Constant Field Values
  - TEXT_HIGHLIGHT
```
public static final int TEXT_HIGHLIGHT
```
    The array index for the textHighlight system color.
    
    See Also:
    textHighlight, Constant Field Values
  - TEXT_HIGHLIGHT_TEXT
```
public static final int TEXT_HIGHLIGHT_TEXT
```
    The array index for the textHighlightText system color.
    
    See Also:
    textHighlightText, Constant Field Values
  - TEXT_INACTIVE_TEXT
```
public static final int TEXT_INACTIVE_TEXT
```
    The array index for the textInactiveText system color.
    
    See Also:
    textInactiveText, Constant Field Values
  - CONTROL
```
public static final int CONTROL
```
    The array index for the control system color.
    
    See Also:
    control, Constant Field Values
  - CONTROL_TEXT
```
public static final int CONTROL_TEXT
```
    The array index for the controlText system color.
    
    See Also:
    controlText, Constant Field Values
  - CONTROL_HIGHLIGHT
```
public static final int CONTROL_HIGHLIGHT
```
    The array index for the controlHighlight system color.
    
    See Also:
    controlHighlight, Constant Field Values
  - CONTROL_LT_HIGHLIGHT
```
public static final int CONTROL_LT_HIGHLIGHT
```
    The array index for the controlLtHighlight system color.
    
    See Also:
    controlLtHighlight, Constant Field Values
  - CONTROL_SHADOW
```
public static final int CONTROL_SHADOW
```
    The array index for the controlShadow system color.
    
    See Also:
    controlShadow, Constant Field Values
  - CONTROL_DK_SHADOW
```
public static final int CONTROL_DK_SHADOW
```
    The array index for the controlDkShadow system color.
    
    See Also:
    controlDkShadow, Constant Field Values
  - SCROLLBAR
```
public static final int SCROLLBAR
```
    The array index for the scrollbar system color.
    
    See Also:
    scrollbar, Constant Field Values
  - INFO
```
public static final int INFO
```
    The array index for the info system color.
    
    See Also:
    info, Constant Field Values
  - INFO_TEXT
```
public static final int INFO_TEXT
```
    The array index for the infoText system color.
    
    See Also:
    infoText, Constant Field Values
  - NUM_COLORS
```
public static final int NUM_COLORS
```
    The number of system colors in the array.
    
    See Also:
    Constant Field Values
  - desktop
```
public static final SystemColor desktop
```
    The color rendered for the background of the desktop.
  - activeCaption
```
public static final SystemColor activeCaption
```
    The color rendered for the window-title background of the currently active window.
  - activeCaptionText
```
public static final SystemColor activeCaptionText
```
    The color rendered for the window-title text of the currently active window.
  - activeCaptionBorder
```
public static final SystemColor activeCaptionBorder
```
    The color rendered for the border around the currently active window.
  - inactiveCaption
```
public static final SystemColor inactiveCaption
```
    The color rendered for the window-title background of inactive windows.
  - inactiveCaptionText
```
public static final SystemColor inactiveCaptionText
```
    The color rendered for the window-title text of inactive windows.
  - inactiveCaptionBorder
```
public static final SystemColor inactiveCaptionBorder
```
    The color rendered for the border around inactive windows.
  - window
```
public static final SystemColor window
```
    The color rendered for the background of interior regions inside windows.
  - windowBorder
```
public static final SystemColor windowBorder
```
    The color rendered for the border around interior regions inside windows.
  - windowText
```
public static final SystemColor windowText
```
    The color rendered for text of interior regions inside windows.
  - menu
```
public static final SystemColor menu
```
    The color rendered for the background of menus.
  - menuText
```
public static final SystemColor menuText
```
    The color rendered for the text of menus.
  - text
```
public static final SystemColor text
```
    The color rendered for the background of text control objects, such as textfields and comboboxes.
  - textText
```
public static final SystemColor textText
```
    The color rendered for the text of text control objects, such as textfields and comboboxes.
  - textHighlight
```
public static final SystemColor textHighlight
```
    The color rendered for the background of selected items, such as in menus, comboboxes, and text.
  - textHighlightText
```
public static final SystemColor textHighlightText
```
    The color rendered for the text of selected items, such as in menus, comboboxes, and text.
  - textInactiveText
```
public static final SystemColor textInactiveText
```
    The color rendered for the text of inactive items, such as in menus.
  - control
```
public static final SystemColor control
```
    The color rendered for the background of control panels and control objects, such as pushbuttons.
  - controlText
```
public static final SystemColor controlText
```
    The color rendered for the text of control panels and control objects, such as pushbuttons.
  - controlHighlight
```
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.
  - controlLtHighlight
```
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.
  - controlShadow
```
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.
  - controlDkShadow
```
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.
  - scrollbar
```
public static final SystemColor scrollbar
```
    The color rendered for the background of scrollbars.
  - info
```
public static final SystemColor info
```
    The color rendered for the background of tooltips or spot help.
  - infoText
```
public static final SystemColor infoText
```
    The color rendered for the text of tooltips or spot help.
- 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
    
    Returns:
    the RGB value of the color in the default sRGB ColorModel.
    See Also:
    ColorModel.getRGBdefault(), Color.getBlue(), Color.getGreen(), Color.getRed()
  - toString
```
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.
    
    Overrides:
    
    toString in class Color
    
    Returns:
    a string representation of this Color

Class SystemColor

Field Summary

Fields inherited from class java.awt.Color

Fields inherited from interface java.awt.Transparency

Method Summary

Methods inherited from class java.awt.Color

Methods inherited from class java.lang.Object

Field Detail

DESKTOP

ACTIVE_CAPTION

ACTIVE_CAPTION_TEXT

ACTIVE_CAPTION_BORDER

INACTIVE_CAPTION

INACTIVE_CAPTION_TEXT

INACTIVE_CAPTION_BORDER

WINDOW

WINDOW_BORDER

WINDOW_TEXT

MENU

MENU_TEXT

TEXT

TEXT_TEXT

TEXT_HIGHLIGHT

TEXT_HIGHLIGHT_TEXT

TEXT_INACTIVE_TEXT

CONTROL

CONTROL_TEXT

CONTROL_HIGHLIGHT

CONTROL_LT_HIGHLIGHT

CONTROL_SHADOW

CONTROL_DK_SHADOW

SCROLLBAR

INFO

INFO_TEXT

NUM_COLORS

desktop

activeCaption

activeCaptionText

activeCaptionBorder

inactiveCaption

inactiveCaptionText

inactiveCaptionBorder

window

windowBorder

windowText

menu

menuText

text

textText

textHighlight

textHighlightText

textInactiveText

control

controlText

controlHighlight

controlLtHighlight

controlShadow

controlDkShadow

scrollbar

info

infoText

Method Detail

getRGB

toString