public class

DesktopProperty

extends Object
implements UIDefaults.ActiveValue
java.lang.Object
   ↳ com.sun.java.swing.plaf.windows.DesktopProperty

Class Overview

Wrapper for a value from the desktop. The value is lazily looked up, and can be accessed using the UIManager.ActiveValue method createValue. If the underlying desktop property changes this will force the UIs to update all known Frames. You can invoke invalidate to force the value to be fetched again.

Summary

Public Constructors
DesktopProperty(String key, Object fallback, Toolkit toolkit)
Creates a DesktopProperty.
Public Methods
Object createValue(UIDefaults table)
UIManager.LazyValue method, returns the value from the desktop or the fallback value if the desktop value is null.
void invalidate(LookAndFeel laf)
Invalidates the current value.
void invalidate()
Invalides the current value so that the next invocation of createValue will ask for the property again.
Protected Methods
Object configureValue(Object value)
Configures the value as appropriate for a defaults property in the UIDefaults table.
Object getDefaultValue()
Returns the value to use if the desktop property is null.
String getKey()
Returns the key used to lookup the desktop properties value.
Object getValueFromDesktop()
Returns the value from the desktop.
void updateUI()
Requests that all components in the GUI hierarchy be updated to reflect dynamic changes in this look&feel.
[Expand]
Inherited Methods
From class java.lang.Object
From interface javax.swing.UIDefaults.ActiveValue

Public Constructors

public DesktopProperty (String key, Object fallback, Toolkit toolkit)

Creates a DesktopProperty.

Parameters
key Key used in looking up desktop value.
fallback Value used if desktop property is null.
toolkit Toolkit used to fetch property from, can be null in which default will be used.

Public Methods

public Object createValue (UIDefaults table)

UIManager.LazyValue method, returns the value from the desktop or the fallback value if the desktop value is null.

Parameters
table a UIDefaults table
Returns
  • the created Object

public void invalidate (LookAndFeel laf)

Invalidates the current value.

Parameters
laf the LookAndFeel this DesktopProperty was created with

public void invalidate ()

Invalides the current value so that the next invocation of createValue will ask for the property again.

Protected Methods

protected Object configureValue (Object value)

Configures the value as appropriate for a defaults property in the UIDefaults table.

protected Object getDefaultValue ()

Returns the value to use if the desktop property is null.

protected String getKey ()

Returns the key used to lookup the desktop properties value.

protected Object getValueFromDesktop ()

Returns the value from the desktop.

protected void updateUI ()

Requests that all components in the GUI hierarchy be updated to reflect dynamic changes in this look&feel. This update occurs by uninstalling and re-installing the UI objects. Requests are batched and collapsed into a single update pass because often many desktop properties will change at once.