titlebarOptions

Usage

-- Lingo syntax
windowObjRef.titlebarOptions

// JavaScript syntax
windowObjRef.titlebarOptions;

Description

Window property; specifies a list of properties that stores the title bar options of a window. Read/write.

The property list contains the following properties:

Property Description
#icon

Specifies the cast member icon to use in the title bar. This property is only available if the title bar is visible (the #visible property is set to TRUE).

#visible

Specifies whether the title bar is visible. If FALSE, the title bar is not visible, and all other title bar and window properties are unaffected. If TRUE, the title bar is visible, and the window maintains the states of all other title bar and window properties. The default value is TRUE.

#closebox

Specifies whether a close box appears in the upper right corner of the window. If TRUE, a close box appears. If FALSE, a close box does not appear. The default value is TRUE.

#minimizebox

Specifies whether a minimize box appears in the upper right corner of the window. If TRUE, a minimize box appears. If FALSE, a minimize box does not appear. The default value is TRUE.

#maximizebox

Specifies whether a maximize box appears in the upper right corner of the window. If TRUE, a maximize box appears. If FALSE, a maximize box does not appear. The default value is TRUE.

#sideTitlebar

(Macintosh only) Specifies whether the title bar should appear on the side of the winow. If TRUE, the title bar appears on the side of the window. If FALSE, the title bar does not appear on the side of the window. The default value is FALSE.

These properties can also be accessed by using the Movie object's displayTemplate property.

Example

This statement displays in the Message window the available titlebar options for the window named Elements:

-- Lingo syntax
trace(window("Elements").titlebarOptions)

// JavaScript syntax
trace(window("Elements").titlebarOptions);

These statements set the icon property to the bitmap cast member named smallIcon:

-- Lingo syntax
window("Elements").titlebarOptions.icon = member("smallIcon")

// JavaScript syntax
window("Elements").titlebarOptions.icon = member("smallIcon");

See also

appearanceOptions, displayTemplate, Window