setApplicationSkin

setApplicationSkin(skinapp: JadeSkinApplication);

The setApplicationSkin method of the Form class sets the skin for a specific form and its controls.

When you call this method to set a skin for a form and all of its controls, the skins used to draw the form and its controls are from the application skin specified in the skinapp parameter and any skin set by calling the Application class setApplicationSkin is ignored for this form and its controls.

If the application skin of the form does not include an appropriate skin for a control type, that control is not drawn with a skin.

Any control that has had a specific skin set by calling the Control class setSkin method continues to use that specific skin. The form application skin is used only if setSkin(null) is subsequently called on that control.

When the setApplicationSkin method is first called, the collected skin data is stored as a blob on the JadeSkinApplication instance. Subsequent calls use this stored information and do not need to retrieve the skin information.

In addition, a presentation client caches the skin information. As a result, subsequent calls of the setApplicationSkin method only need to request the creation of the skin from the presentation client cache file without having to transmit the skin data.

When you change a skin definition using the JadeSkinMaintence form or by loading a form and data definition (.ddb or .ddx) file, the timestamp of all JadeSkinApplication instances is updated, which requires a rebuild of the skin information the first time each skin is set for an application or form. If you change JADE skin information by any other means, you must call the updateSkinTimeStamp method on the JadeSkinApplication instance, to reset the instance timestamp and cause the skin build data to be rebuilt.