User Guide

396 Chapter 12: Methods

mergeProps()

Usage

-- Lingo syntax

windowObjRef.mergeProps(propList)

// JavaScript syntax

windowObjRef.mergeProps(propList);

Description

Windows method. Merges an arbitrary number of window properties, all at once, into the

existing set of window properties.

Parameters

propList

Required. A set of window properties to merge into the existing set of window

properties. The properties are specified by the

appearanceOptions and titlebarOptions

properties.

• In Lingo, propList can be either a comma-separated list of name/value pairs or a comma-

separated list of symbol/value pairs.

• In JavaScript syntax, propList can only be a comma-separated list of name/value pairs.

Example

This statement sets various properties for the window named Cars.

-- Lingo syntax

window("Cars").mergeProps([#title:"Car pictures", #resizable:FALSE, \

#titlebarOptions:[#closebox:TRUE, #icon:member(2)], \

#appearanceOptions:[#border:#line, #shadow:TRUE]])

// JavaScript syntax

window("Cars").mergeProps(propList("title","Car pictures", "resizable",false,

"titlebarOptions",propList("closebox",true, "icon",member(2)),

"appearanceOptions",propList("border","line", "shadow",true)));