copyTo

Copies the internal state of this object to the
specified copy. If copy is
null, then this method should create a new instance
of this class and proceed to copy the internal state
to the newly created object. Generally, only the persistent
state of the object should be copied, but whether or not it is
appropriate to copy transient properties is at the discretion
of the individual implementor.

Regardless of whether the copy occurs to an existing object or to
a newly created object, the return value is object to which
this object's state was copied.

There is a standard implementation pattern for the
copyTo method that helps avoid problems that arise
when a Copyable object is subclassed. The pattern
is:

The parameter passed into the copyToImpl method is
the same type of this class. The responsibility of
copyToImpl is to copy the state of this
class through direct access of the fields. The
copyToImpl method should not use getters and setters
since these may be overridden, causing the state of
this class to be incompletely copied.

target - The target object to which the state of
this object should be copied. If target
is null, then the copyTo method will
return a new instance of this class.

Returns:

The object to which the state of this
object was copied. If the target was
non-null, then the return value is the same as the
target object that was passed in; otherwise, the
return value is a new instance of this class.

copyToImpl

registerUI

Registers user interface for the Preferences dialog. This mechanism has
been superceded by the <settings-ui-hook> registration mechanism
in extension.xml. This method will likely be deprecated in a future
release.

Parameters:

ui - user interface to register.

deregisterUI

Deregisters user interface from the Preferences dialog. This mechanism
has been superceded by the <settings-ui-hook> registration mechanism
in extension.xml. This method will likely be deprecated in a future
release.

setAskExit

getEnvironNavigable

Deprecated.as of 11.0. No replacement. Extensions should not be directly
accessing the Navigable for the Environment page in preferences;
instead you should

hasData

public boolean hasData(java.lang.String dataKey)

Checks if a data object assiciated with the specifid dataKey
exists. This method does not cause the loading of the settings, therefore
it should be used to check for data existance instead of calling
getData for that purpose.

putLegacyData

Note: This method should only be used by legacy code that is migrating
preferences forward to the Fusion release. Classes newly introduced
in Fusion and later that store their data in Preferences
should not use this method.

Used by extensions to preserve compatibility with previous releases
for settings that have been moved from IdeSettings or ClientSetting
(Object2Dom format) into Preferences (HashStructure format). It is
not advised to use this method if your settings classes did not
undergo such a transition (it will complicate what you have to do to
migrate your settings properly).

Parameters:

dataKey - unique key identifying the data.

data - the data.

removeLegacyData

public void removeLegacyData(java.lang.String dataKey)

Removes the legacy data at the specified key. This is used to reset
the state of IdeSettings for a particular key so that a subsequent
call to putLegacyData will re-trigger its behavior.