Selecting a Skin to Use in Runtime Applications

You can enable users of runtime applications to select the skin that they want to use during the current runtime work session, test an application skin, or cancel the use of a skin, by using the Select or Cancel a Skin dialog, shown in the following example.

For details about defining and maintaining skins, see "Maintaining Skins Using Extended Functionality".

Your user application needs only to create and modally show the JadeSkinSelection form. The following example shows the creation and use of the JadeSkinSelection form from a click event method in user application logic.

selectSkin_click(menuItem: MenuItem input) updating;
vars
    form : JadeSkinSelection;
begin
    create form;
    form.showModal;
epilog
    delete form;
end;

Alternatively, you can define a JadeScript class selectSkin method like that shown in the following example.

selectSkin() updating;
/*
Date created: 14 November 2016
Created by:   Wilbur
*/
vars
    form : JadeSkinSelection;
begin
    create form;
    form.showModal;
epilog
    delete form;
end;

To select a skin for use in the current work session

Select the skin from the list that is displayed in the Choose Skin combo box.

As the Select or Cancel a Skin dialog itself is displayed using the skin selected in the Choose Skin combo box, the presentation offered by the selected skin shows examples of the controls that are skinned in the Control Examples group box, as shown in the previous image.
Click the Show Menu? check box to view the effects of a skin without a menu. By default, a check mark symbol (✓) is displayed in this control, indicating that the menu line is displayed on the Select or Cancel a Skin dialog.
To apply the selected skin to all forms in the current application during the current work session, click the Apply button.

Alternatively, perform one of the following actions.
- To cancel the use of a skin in the current work session, select the <None> value in Choose Skin combo box and then click the Apply button.
- Click the Close button to abandon your selections and leave the skin usage unchanged.

Programmatically, if the user:

Selects a skin, modalResult = JadeSkinSelection.Skin_Changed(1) and the userObject property contains the selected skin.
Clicks the Close button, modalResult = JadeSkinSelection.Skin_Cancel(0).
Selects the <None> value in Choose Skin combo box and then clicks the Apply button, modalResult = JadeSkinSelection.Skin_Changed(1).

Use the app.getApplicationSkin method to retrieve the currently selected skin.