Window Margins

Certain window styles supported by VAqua optionally allow a top and/or bottom window margin to be specified. Window margins are partial window backgrounds whose appearance changes when the window becomes active or inactive. Window margins also allow the window to be moved by dragging.

The intended use of a window margin is to define an area for controls, such as buttons. Controls placed in a window margin should use a textured style.

Window margins are not components; they do not affect the size or border of the content pane. Controls must be arranged to fit in the declared margins.

A top window margin is painted in the style of a unified title and tool bar. Although similar in appearance to a unified toolbar window style, a top window margin does not require the use of a toolbar component.

A top window margin is supported for the noTitleBar window style and the transparentTitleBar window style. A top window margin is specified by setting the Aqua.windowTopMargin client property on the root pane to the desired height of the margin area.

A bottom window margin is painted in a style similar to the button area in an open file dialog.

A bottom window margin is supported for the noTitleBar window style, the transparentTitleBar window style, and any of the unified toolbar window styles. A bottom window margin is specified by setting the Aqua.bottomTopMargin client property on the root pane to the desired height of the margin area.

Any window with a supported top or bottom window margin will have its content pane set to not opaque so that the window margin background will be visible.