Java Reference
In-Depth Information
• Possible limits on the behavior of containers requiring corresponding top-level
windows
• Additional support for input constraints and device-specific keys
• Restrictions on subclassing drawing behavior for components
In addition, several class methods have some optional restrictions depending on the
AGUI implementation; your application can query the system by means of a system
property to determine the actual behavior. Table 10-1 shows a list of the system proper-
ties you can query and their meaning; the subsequent sections describe the AGUI
limitations in more detail.
Table 10-1.
The AGUI System Properties and Their Values
Property
Value
javax.swing.JComponent.setBackground.
true
if and only if
isRestricted
JComponent.setBackground
is restricted
by the native window toolkit
javax.swing.JComponent.setBorder.
true
if and only if
isRestricted
JComponent.setBorder
is restricted by
the native window toolkit
javax.swing.JComponent.setForeground.
true
if and only if
isRestricted
JComponent.setForeground
is restricted
javax.swing.JComponent.setToolTipText.
true
if and only if calls to
isRestricted
JComponent.setToolTipText
fail silently
because tool tips are not supported
javax.swing.JList.setCellRenderer.isRestricted
true
if and only if
JList.setCellRenderer
cannot set
custom cell renderers
javax.swing.setMnemonic.isRestricted
true
if and only if calls to
setMnemonic
fail silently
javax.swing.text.JTextComponent.
true
if and only if calls to
setFocusAccelerator.isRestricted
JTextComponent.setFocusAccelerator
fail silently
javax.swing.JMenuBar.clientPropertiesSupported
true
if and only if
JMenuBar
supports
client properties
javax.swing.JMenuBar.NUM_SOFT_KEYS
The number of soft keys available on the
device, if
JMenuBar
client properties are
supported; undefined otherwise
javax.swing.JMenuBar.NUM_SOFT_MENUS
The number of soft menus available on
the device, if
JMenuBar
client properties
are supported; undefined otherwise
javax.swing.JTabbedPane.setToolTipTextAt.
true
if and only if calls to
isRestricted
JTabbedPane.setToolTipTextAt
fail
silently
