A REPLACECLASS element specifies a Workplace Shell class to be replaced with another class when a package is selected for installation.

This can only be specified in a PCK block and defines that if the package in which the REPLACECLASS element appears is selected for installation, the specified WPS class should be replaced.

This element is optional, but can appear more than once per PCK block. If several REPLACECLASS elements appear, they are processed in the order in which they are specified. Also, all REGISTERCLASS elements are processed before the REPLACECLASS elements. This allows you to register and replace classes with the same package.

If any package with a REPLACECLASS element has been selected for installation, WarpIN will display a corresponding checkbox on the "System Configuration" page (see the PAGE element for more on that).

Syntax:

<REPLACECLASS
    OLDCLASSNAME="classname"
    NEWCLASSNAME="classname"
/>

This is an empty element and must therefore be terminated with a "/" character.

Attributes:

OLDCLASSNAME="classname"
The name of the WPS class to be replaced (the "replacee").
NEWCLASSNAME="classname"
The name of of the WPS class which replaces the class specified with OLDCLASSNAME.

Both classes must already be registered. Note that WPS class names are case-sensitive: WPFOLDER is not the same as WPFolder.

Example:

<PCK INDEX="2" ...>
<REGISTERCLASS
    CLASSNAME="XFolder"
    DLLNAME="$(1)\bin\xfldr.dll" />
<REPLACECLASS
    OLDCLASSNAME="WPFolder"
    NEWCLASSNAME="XFolder" />
...
</PCK>