Parameter

Description

name

The name of the window. This attribute is required to interact with the window, including to dynamically show or hide it. If a window with the specified name exists, the function shows that window, and ignores the remaining parameters; otherwise, the name must be unique on the page.

title

The text to display on the window title bar. You can use HTML mark-up to control the title appearance.

URL

The URL from which to get the window body contents. This attribute can use URL parameters to pass data to the page. ColdFusion uses standard page path resolution rules to locate the page.Note: If the page specified in this attribute contains tags that use ColdFusion Ajax features, such as the cfform, cfgrid, and cfpod tags, identify the tags in a cfajaximport tag on the page that includes this function. For more information, see cfajaximport.

configuration

An object containing window configuration parameters. For details, see "Usage".

refreshonshow

The default value is false.

Entry

Default

Description

callbackhandler

A function that is called when the window body loads. This function must not take any arguments.

center

false

A Boolean value that specifies whether to center the window over the browser window.

closable

true

A Boolean value that specifies whether the user can close the window. If true, the window has an X close icon.

draggable

true

A Boolean value that specifies whether the user can drag the window. To drag the window, click the mouse on the title bar and hold the button down while dragging. If the window does not have a title, users cannot drag it.

errorHandler

A function that is called if an error occurs in loading the window body. This function must take two arguments:

height

300

Height of the window in pixels. If you specify a value greater than the available space, the window occupies the available space and the resize handles do not appear.

initshow

false

A Boolean value that specifies whether to display the window when the containing page first displays. If this value is false, use the ColdFusion.Window.show JavaScript function to display the window.

minheight

0

The minimum height, in pixels, to which users can resize the window.Specifying this parameter and a resizable="false" parameter causes an error.

minwidth

0

The minimum width, in pixels, to which users can resize the window.Specifying this parameter and a resizable="false" parameter causes an error.

modal

false

A Boolean value that specifies whether the window is modal, that is, whether the user can interact with the main window while this window is displaying. If true, the user cannot interact with the main window.

resizable

true

A Boolean value that specifies whether the user can resize the window.

width

500

Width of the window in pixels. If you specify a value greater than the available space, the window occupies the available space and the resize handles do not appear.

x

The X (horizontal) coordinate of the upper-left corner of the window, relative to the browser window. ColdFusion ignores this attribute if the center attribute value is true, and if you do not set the y attribute value.

y

The Y (vertical) coordinate of the upper-left corner of the window, relative to the browser window.ColdFusion ignores this attribute if the center attribute value is true, and if you do not set the x attribute value.