JadeSkinForm Class

The JadeSkinForm class contains the JADE skins defined for forms in your applications and encapsulates the behavior required to define and maintain JADE skins using the JadeSkinMaintenance and JadeSkinSelection forms provided by the JADE RootSchema.

Use the JadeSkinArea class to define the image drawn for the active border and the inner (client area) of the form. If the form has a backdrop picture (set by using the Form class setBackDrop method), this image is drawn.

When drawing an inactive form image, if an image is not provided for a border segment, the equivalent image for the active form is drawn instead.

When erasing the inner area of the form:

1. If the form backBrush property is not null, the inner area is erased using that brush.

2. If the form skin has a JadeSkinArea class imgInner property value that is a brush, the inner area is erased using that brush.

3. If the form backColor property is not Color_3DFace, the inner area is erased using the background color of the form.

4. If the backColor property of the skin area is not Default_Color, erase using the backColor property value of the skin.

5. The Color_3DFace value is used when erasing.

6. If the form was erased using a color and the skin of the form has a JadeSkinArea class imgInner property value that is not a brush, that image is drawn centered in the inner area of the form skin.

The set of skin images used by JADE is provided with the product release so that you can use these skins in your applications, if required. (By default, skins are not used.)

The form border for a skin is made up of 11 images, as shown in the following image.

The following is a description of the form border areas.

• Images 1, 3, 4, 6, 9, and 11 are shown at actual size.

• Images 2, 5, 7, 8, and 10 are stretched to fit the width or height of the form.

• Images 1, 2, and 3 must have the same height to enable the form to display correctly.

• Images 4, 5, and 6 must have the same height to enable the form to display correctly.

• Images 9, 10, and 11 must have the same height to enable the form to display correctly.

• The whole of image 1 is treated as the control menu area for the form.

  If the menu does not fit on the menu line, the menu is extended to include additional lines, as required. Each line is drawn with the same skin images as the first menu line.

• When an MDI child is maximized, the whole of image 4 is treated as the system menu area for the MDI child.

• Form icons are placed adjacently at the top right hand edge of the area defined by image 3.

• MDI child form icons are placed adjacently at the top right hand edge of the area defined by image 6.

• Form icons that are disabled are not displayed if there is no disabled image.

The following areas are not affected by using a skin.

• Only JADE forms adopt the skin presentation. Windows forms such as message boxes, common dialogs, and the JADE exception dialogs are unchanged.

• When a form is resized, Windows draws the standard form image while the resize is occurring.

• A minimized MDI form displays the standard image, as there is normally insufficient room to display the skinned image for that short caption line.

• Windows-drawn menu items are unchanged by the skin. This includes the system menus.

• Any changes made to the skin do not affect any current users of that skin.

• Windows sounds do not occur when forms are minimized, maximized, and so on, as the form buttons are not in the Windows standard positions and their actions must be performed programmatically by JADE. (Windows does not issue those sounds when such actions are performed programmatically.)

For details about defining and maintaining skins, see "Defining and Maintaining JADE Skins at Run Time", in Chapter 2 of the JADE Runtime Application Guide. For details about using JADE skins in your JADE development environment, see "Specifying Your JADE Installation Preferences", in Chapter 2 of the JADE Installation and Configuration Guide. For details about the properties defined in the JadeSkinForm class, see "JadeSkinForm Properties", in the following subsection.

JadeSkinWindow

(None)