The
For details about the JadeSkinWindow class properties summarized in the following table, see
Property | Reference to … |
---|---|
|
A |
|
The skin category that applies to the skin |
To understand the way in which a region is constructed, consider that the image specified by the
The result could be a window with rounded corners, a window with holes in it, and so on.
Because the mask image is built to the same size as the actual window, if border masks are defined, the only reasonable region that could be constructed is one where the corners are shaped. As all other areas are stretched to fit, it is likely that they would not provide a suitable result. You would achieve a better result by defining only an inner image for the mask that is stretched.
If the
In addition, you can define a skin category for a control subclass (for example, each
The
When erasing the inner area of the form:
If the form
If the form skin has a
If the form
If the
The Color_3DFace value is used when erasing.
If the form was erased using a color and the skin of the form has a
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.
For details about using runtime skin facilities provided by JADE methods, see "Run Time Skin Facilities", later in this chapter.
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 diagram.
The following is a description f 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.
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.
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 maintaining and using JADE skins, see "
For details about the
Property | Default Value | Description |
---|---|---|
|
Default_Color | Color used to draw caption text when the form is active. |
|
True | Specifies whether the caption of the form is bold. |
|
False | Specifies whether the caption of the form is italics. |
|
MS Sans Serif | Font with which the form caption is displayed. |
|
8.5 | Size of the font with which the form caption is displayed. |
|
Default_Color | Color used to draw the form’s caption text when the form is inactive. |
|
0 | Starting left position of the form’s caption text. |
|
0 | Starting right position of the form’s caption text. |
|
False | Specifies whether the caption is centered within the top strip area of the form’s skin. |
|
Null | Border area image to be drawn for the bottom left of the inactive form. |
|
Null | Border area image to be drawn for the bottom right of the inactive form. |
|
Null | Border area image to be drawn for the bottom strip of the inactive form. |
|
Null | Border area image to be drawn for the left strip of the inactive form. |
|
Null | Border area image to be drawn for the right strip of the inactive form. |
|
Null | Border area image to be drawn for the top left of the inactive form. |
|
Null | Border area image to be drawn for the top right of the inactive form. |
|
Null | Border area image to be drawn for the top strip of the inactive form. |
|
Null | Image drawn for the left of the form’s menu line. |
|
Null | Image drawn for the right of the form’s menu line. |
|
Null | Image drawn for the strip of the form’s menu line. |
|
Default_Color | Background color for the menu line if the skin has no defined imgMenuStrip property value. |
|
Default_Color | Background color of the selected menu items for drop‑down or popup menus. |
|
False | Specifies whether menu line item, drop-down menu, and popup menu captions are bold. |
|
False | Specifies whether menu line item, drop-down menu, and popup menu captions are italics. |
|
Null ("") | Font with which menu line items, drop-down menus, and popup menus are displayed. |
|
0 | Size of the font with which menu line items, drop-down menus, and popup menus are displayed. |
|
Default_Color | Color to draw the text for non-selected and enabled menu line items. |
|
Default_Color | Color to draw the text for disabled menu line items and the default disabled text color for drop-down and popup menus. |
|
Default_Color | Color to draw text for selected text for drop-down and popup menus. |
|
0 | Starting left position of the form’s menus. |
|
0 | Offset of the top position of the form’s menu drawn on the skin. |
|
Reference to the simple button images drawn for an MDI child minimize button in its four states (up, down, rollover, and disabled). | |
|
Reference to the simple button images drawn for an MDI child restore button in its four states. | |
|
Reference to the simple button images drawn for an MDI child terminate button in its four states. | |
|
Reference to the simple button images drawn for an MDI child maximize button in its four states. | |
|
Reference to the simple button images drawn for an MDI child maximized button in its four states. | |
|
Reference to the menu definition of the form. | |
|
Reference to the simple button images to be drawn for the form minimize button in its four states. | |
|
Reference to the simple button images to be drawn for the form terminate button in its four states. | |
|
False | Specifies whether the menu line of the skin is always drawn, regardless of whether the form has a menu. |
|
Default_Color | Transparent color to be applied to maximize, minimize, and terminate buttons drawn for the form’s skin. |
The
Use the properties of the
If the control
If the control skin has a
If the
If the value of the
Erase using the
If the control was erased using a color and the skin of the control has an inner image defined in the
The constants provided by the
Constant | Integer Value | Constant | Integer Value |
---|---|---|---|
ApplyCondition_3D | 2 | ApplyCondition_All | 0 |
ApplyCondition_Border | 1 |
For details about the JadeSkinControl class properties summarized in the following table, see
Property | Default Value | Description |
---|---|---|
|
Dependent on the control type | Determines whether the border area of a control uses the skin |
|
BorderStyle_Images | Type of border to be drawn |
|
False | Specifies whether the control font is bold when the control uses the default application font |
|
False | Specifies whether the control font is italicized when the control uses the default application font |
|
Null ("") | Font with which the control is drawn (the default value indicates the control uses its own default font) |
|
0 | Specifies the size of the control font when the control uses the default application font |
|
False | Specifies whether the control font is strikethrough when the control uses the default application font |
|
False | Specifies whether the control font is underlined when the control uses the default application font |
|
Default_Color | Color to be used for drawing the text of the control |
|
Default_Color | Color to be used for drawing the text of the control when it is disabled |
The subclasses of the
Subclass | Holds the … |
---|---|
JadeSkinBaseControl | Definition of a skin for BaseControl subclassed controls |
JadeSkinBrowseButtons | Definition of a skin for BrowseButtons controls |
JadeSkinButton | Definition of a skin for Button controls |
JadeSkinCheckBox | Definition of a skin for CheckBox controls |
JadeSkinComboBox | Definition of a skin for ComboBox controls |
JadeSkinFolder | Definition of a skin for Folder controls |
JadeSkinFrame | Definition of a skin for Frame controls |
JadeSkinGroupBox | Definition of a skin for GroupBox controls |
JadeSkinJadeDockBase | Elements of a docking control skin and provides the JadeSkinJadeDockBar and JadeSkinJadeDockContainer subclasses that hold definitions of skins for the JadeDockBar and JadeDockContainer classes |
JadeSkinJadeEditMask | Definition of a skin for JadeEditMask controls |
JadeSkinJadeMask | Definition of a skin for JadeMask controls |
JadeSkinJadeRichText | Definition of a skin for JadeRichText controls |
JadeSkinLabel | Definition of a skin for Label controls |
JadeSkinListBox | Definition of a skin for ListBox controls |
JadeSkinOleControl | Definition of a skin for OleControl controls |
JadeSkinOptionButton | Definition of a skin for OptionButton controls |
JadeSkinPicture | Definition of a skin for Picture controls |
JadeSkinProgressBar | Definition of a skin for ProgressBar controls |
JadeSkinScrollBar | Information common to a vertical and horizontal scroll bar, and provides the JadeSkinHScroll and JadeSkinVScroll subclasses that hold definitions of skins for the HScroll and VScroll classes |
JadeSkinHScroll | Definition of a skin for HScroll horizontal ScrollBar controls |
JadeSkinVScroll | Definition of a skin for VScroll vertical ScrollBar controls |
JadeSkinSheet | Definition of a skin for Sheet controls |
JadeSkinStatusLine | Definition of a skin for StatusLine controls |
JadeSkinTable | Definition of a skin for Table controls |
JadeSkinTextBox | Definition of a skin for TextBox controls |
Skins do not apply to the
The
The
The properties defined in the JadeSkinBrowseButtons class are summarized in the following table.
Property | Reference to the … |
---|---|
|
Full image and up, disabled, down, and rollover states of the First button |
|
Full image and up, disabled, down, and rollover states of the Last button |
|
Full image and up, disabled, down, and rollover states of the Next button |
|
Full image and up, disabled, down, and rollover states of the Prior button |
If a button image is not supplied for a non-up state, the up image is used. For painting to be successful, the skin requires all of the up images to be supplied.
The
The properties defined in the JadeSkinButton class are summarized in the following table.
Property | Description |
---|---|
|
Specifies whether the |
|
Reference to the image drawn for the disabled button state |
|
Reference to the image drawn for the down button state |
|
Reference to the image drawn for the focus button state |
|
Reference to the image drawn for the focus down button state |
|
Reference to the image drawn for the rollover button state |
|
Reference to the image drawn for the roll-under button state |
|
Reference to the image drawn for the up button state (the default state) |
If the
Each state can consist of up to eight border segments and an inner image, an inner image only, or no images (in which case the background color is used to fill the non-border area). These images are drawn inside any defined border area. If you do not define a specific state, the
The following diagram on the left is an example of a button with a raised three-dimensional effect and the diagram on the right is an example of a button with a sunken three-dimensional effect.
The
The properties defined in the JadeSkinCheckBox class are summarized in the following table.
Property | Reference to the … |
---|---|
|
Full image and up, disabled, down, and rollover states of the false value of check boxes |
|
Full image and up, disabled, down, and rollover states of the true value of check boxes |
If you do not supply a specific state, the appropriate up image is used. If you do not supply the appropriate up image, the default check box image is drawn. For example, the following diagram is an example of a
The
The properties defined in the JadeSkinComboBox class are summarized in the following table.
Property | Description |
---|---|
|
Contains the number of pixels from the right-hand edge to position the right-hand edge of the combo box button. The button is centered vertically. |
|
Contains the extra button state image required for the combo box button rollover state in the down position. |
|
Reference to the images for the up (normal), down (list box displayed), rollover (when in the up position), and disabled states. |
|
Reference to the skin used to draw the list box part of the combo box. The list box is not drawn with a skin if the value of this property is null. |
|
Reference to the skin used to draw the text box part of a simple combo box. |
When defining the skin for a
A simple combo box is a text box followed by a list box covering the whole combo area.
A spin box ignores any defined buttons for the combo box skin. The skin of the vertical scroll bar for the application is used to draw the spin box over the top of any defined border.
When the combo box has a text box portion, the text box allows only a solid background color and does not successfully handle any defined brush.
A combo box skin consists of a border definition and a button that is placed on the right side of the border area. The way in which it is painted depends on the defined border, as follows.
If the combo box skin has the
If the combo box skin has the
The
The properties defined in the JadeSkinFolder class are summarized in the following table.
Property | Default Value | Description |
---|---|---|
|
Reference to the skin used to draw the tabs of a folder with the |
|
|
Default_Color | Contains the color used to draw the background area of active tabs. The default value of Default_Color indicates that the normal color of the folder is used. The values of the tabActiveColor property for the skin are ignored for any sheet that has a |
|
0 | Contains the height of the tabs in a folder that uses the default tab height. If the height of the tabs for the folder has been specifically set, the tabHeight property of the skin is ignored. By default, the tabHeight property is set to zero (0), indicating that the default height is the calculated text height using the font of the folder. If the tabHeight property is set to a positive value, each tab is drawn the specified number of pixels high. |
|
Default_Color | Contains the color used to draw the background area of inactive tabs. The default value of Default_Color indicates that the normal color of the folder is used. The values of the tabActiveColor property for the skin are ignored for any sheet that has a |
The
The
The group box skin images are drawn over the entire control area. The drawing of the caption depends on whether the skin definition includes a skin label reference (
The label is sized so that there is a three-pixel gap from the border area of the label to the left, right, top, and bottom of the caption. The caption or the label is drawn at the position indicated by the
The constants provided by the JadeSkinGroupBox class are listed in the following table.
Constant | Integer Value | Description |
---|---|---|
CaptionPosition_Left_Top | 0 | Left-justified at the top |
CaptionPosition_Left_Middle | 1 | Left-justified and centered vertically |
CaptionPosition_Left_Bottom | 2 | Left-justified at the bottom |
CaptionPosition_Right_Top | 3 | Right-justified at the top |
CaptionPosition_Right_Middle | 4 | Right-justified and centered vertically |
CaptionPosition_Right_Bottom | 5 | Right-justified at the bottom |
CaptionPosition_Center_Top | 6 | Centered horizontally at the top |
CaptionPosition_Center_Middle | 7 | Centered horizontally and vertically |
CaptionPosition_Center_Bottom | 8 | Centered horizontally at the bottom |
The properties defined in the
Property | Default Value | Description |
---|---|---|
|
0 | Contains the position of the caption (or the value of the |
|
0 | Contains the value that is added to the calculated left position resulting from the |
|
0 | Contains the value that is added to the calculated top position resulting from the |
|
Reference to the JadeSkinLabel class. If set, this skin is used to draw the text as though it was a label so that the text portion of the group box can have its own border and background color, brush, or image. |
The following diagram is an example of two group boxes. The example at the left has only the top and right border strips set.
The
Property | Contains the image drawn for a … |
---|---|
|
Horizontal grip bar (for a vertically aligned docking control). The image is stretched to fit the width of the docking control. The standard docking control grip is drawn if you do not supply an image. |
|
Horizontal resize bar drawn on the bottom border of a docking control. The image is stretched to fit the width of the docking control. The standard docking control resize bar is drawn if you do not supply an image. |
|
Vertical grip bar (for a horizontally aligned docking control). The image is stretched to fit the height of the docking control. The standard docking control grip is drawn if you do not supply an image. |
|
Vertical resize bar drawn on the right border of a docking control. The image is stretched to fit the height of the docking control. The standard docking control resize bar is drawn if you do not supply an image. |
The first example at the left of the following diagram shows an image drawn horizontally (by using the
The
The JadeSkinJadeDockBar class, a subclass of the
The JadeSkinJadeDockContainer class, a subclass of the
The
The background area of a
The
Property | Reference to the … |
---|---|
|
Skin used to draw any |
The
The
The
Property | Description |
---|---|
|
Closed image that replaces a list box with the |
|
Leaf image that replaces a list box with the |
|
Minus image that replaces a list box with the |
|
Open image that replaces a list box with the |
|
Plus image that replaces a list box with the |
The images defined in these properties replace the equivalent image only if the standard JADE image has not been replaced in the list box.
The following diagram shows an example of a
The
The
Property | Reference to the … |
---|---|
|
Full image and up, disabled, down, and rollover states of the false value of option buttons |
|
Full image and up, disabled, down, and rollover states of the true value of option buttons |
If you do not supply a specific state, the appropriate up image is used. If you do not supply the appropriate up image, the default option button image is drawn.
The
The
Property | Reference to the … |
---|---|
|
Skin used to draw the completed progress part of |
The
Property | Description |
---|---|
|
Contains the image for the brush to be used when the user clicks on the scroll bar stem itself (that is, not the thumb track or the arrows). When the mouse is down in this situation, that portion of the scroll bar is highlighted. If you supply this brush image, highlighting is drawn using this brush or it is drawn with a black brush if you do not supply a highlight brush. |
|
Reference to the JadeSkinWindowStateImage object that defines the thumb track in the up position. If this property has a null value, the thumb track is drawn as normal. |
|
Reference to the JadeSkinWindowStateImage object that defines the disabled thumb track. If this property has a null value, the thumb track is drawn using the myThumbTrack property value. |
|
Reference to the JadeSkinWindowStateImage object that defines the clicked thumb track. If this property has a null value, the thumb track is drawn using the myThumbTrack property value. |
|
Reference to the JadeSkinWindowStateImage object that defines how to draw the thumb track in the rollover state. If this property has a null value, the thumb track is drawn using the myThumbTrack property. |
The JadeSkinScrollBar class provides the JadeSkinHScroll and JadeSkinVScroll control subclasses.
The
This skin is also used for drawing the horizontal scroll bar for any control or form in the application.
The properties defined in the JadeSkinHScroll class are summarized in the following table.
Property | Reference to the image used to draw the … |
---|---|
|
Left button of a horizontal scroll bar in its various states (the button is placed inside the scroll bar borders) |
|
Right button of a horizontal scroll bar in its various states (the button is placed inside the scroll bar borders) |
The height of the border area and the height of the myLeftButton.imgUp image determine the height of the scroll bar. For a scroll bar control, the image is stretched vertically to fit the area inside the borders, as shown in the example in the following diagram.
If you do not supply the image for a specific state, the appropriate up image is used. The default scroll button image is drawn if you do not supply the up image.
The
This skin is also used for drawing the vertical scroll bar for any control or form in the application.
The properties defined in the JadeSkinVScroll class are summarized in the following table.
Property | Reference to the image used to draw the … |
---|---|
|
Top button of a vertical scroll bar in its various states (the button is placed inside the scroll bar borders) |
|
Bottom button of a vertical scroll bar in its various states (the button is placed inside the scroll bar borders) |
The width of the border area and the width of the
If you do not supply the image for a specific state, the appropriate up image is used. The default scroll button image is drawn if you do not supply the up image.
The
For details about the JadeSkinSheet class property summarized in the following table, see
Property | Description |
---|---|
|
Contains a reference to the skin used to draw the tab of a folder. |
The
The following diagram shows an example of a skinned status line.
The
Property | Default Value | Description |
---|---|---|
|
Default_Color | Contains the color used to draw the background area of the active tab. |
|
Default_Color | Contains the color used to draw the background area of inactive tabs. |
The default value of Default_Color for these properties indicates that the table uses its normal color. The following diagram shows an example of the
The
Text box controls do not successfully handle back brushes and non-solid colors for the backColor property.