myImageMask

Type: JadeSkinWindowStateImage

Availability: Read or write at any time

The myImageMask property of the JadeSkinWindow class contains an optional reference to the JadeSkinWindowStateImage object used to construct a Windows region for the window. (See also the JadeSkinButton class createRegionFromMask property.)

By default, all windows are rectangular. Applying a region to a window enables it to be of any shape and include ‘holes’ inside it.

Any part of any child outside the defined region is not displayed.

To understand the way in which a region is constructed, consider that the image specified by the myImageMask property is drawn (stretched) over the top of the window, including any border area.

Only black pixels are considered part of the window when it is painted or clicked on. 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 as 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.