Profile-Specific Properties

An implementation of Personal Basis Profile provides values for the following keys via the system properties :

Key
 Value
java.awt.AlphaComposite.SRC_OVER.isRestricted
 "true" if and only if AlphaComposite.SRC_OVER is restricted
java.awt.Graphics2D.setStroke.BasicStroke.isRestricted
 "true" if and only if the use of BasicStroke is restricted in Graphics2D.setStroke().
java.awt.event.MouseEvent.isRestricted
 "true" if and only if MouseEvent is restricted
java.awt.event.MouseEvent.supportLevel
 Level of support for MouseEvent, if restricted; undefined otherwise
java.awt.event.KeyEvent.isRestricted "true" if and only if KeyEvent is restricted
java.awt.event.KeyEvent.supportMask
 Mask describing KeyEvent support, if restricted; undefined otherwise

Notes:
  1. Access to the above keys via the system properities is never security constrained.
  2. The term undefined as used above means that the key is not present in the system properties.
  3. Applications are encouraged to use Boolean.getBoolean() in accessing the above properties for upward-compatibility to J2SE.  Any property value other than "true", including undefined, shall therefore be interpreted as the boolean false.

MouseEvent Support

If the property java.awt.MouseEvent.isRestricted is true , then the property java.awt.event.MouseEvent.supportLevel reports the level of mouse events generated by the implementation, as described below:

Support Level 
 Mouse Events Generated
0
 No mouse events generated
1
 MOUSE_CLICKED, MOUSE_PRESSED, MOUSE_RELEASED,
MOUSE_ENTERED, MOUSE_EXITED
2
 All the events of level 1, plus MOUSE_MOVED

Note that mouse events of type MOUSE_WHEEL may be generated by the implementation irrespective of the value of java.awt.event.MouseEvent.supportLevel.

KeyEvent Support

If the property java.awt.event.KeyEvent.isRestricted is true, then the property java.awt.event.KeyEvent.supportMask is a mask value that reports the type of key events generated by the implementation, as described below:

Support Mask
 Key Events Generated
1
 VK_LEFT and VK_RIGHT
2
 VK_UP and VK_DOWN
4
 VK_0 through VK_9
8
 VK_A through VK_Z, VK_SPACE and VK_BACK_SPACE

If the support mask is 0, then no key events are generated.  If the support mask > 0, then VK_ENTER is supported in addition to the other key events.  Note that other key events may be generated in addition to those described by the support mask.

Optional Properties

The following system properties are optional, but may be used as "hints" to applications concerning the behavior of the Profile implementation.

Key
 Value
java.awt.Component.setCursor.isRestricted
 "true" if the cursor image cannot be changed for any Component
java.awt.Frame.setLocation.isRestricted
 "true" if Frame location is limited to a single value
java.awt.Frame.setResizable.isRestricted
 "true" if Frame resizability may not be changed
java.awt.Frame.setSize.isRestricted
 "true" if Frame size is limited to a single value
java.awt.Frame.setTitle.isRestricted
 "true" if Frame titles may not be changed
java.awt.Frame.setUndecorated.isRestricted
 "true" if Frame decorations may not be changed