ColdFusion.Window.onShow

Description

Specifies a function to run each time a specific window shows, including when you create a window and specify an initShow attribute or configuration entry value of true.

Function syntax

See also

cfwindow, ColdFusion.Window.create, ColdFusion.Window.getWindowObject, ColdFusion.Window.onHide, 

ColdFusion.Window.hide, ColdFusion.Window.show, ColdFusion.Tree.getTreeObject, 

Using pop-up windows in Using Ajax form controls and features in the Developing ColdFusion Applications

History

ColdFusion 8: Added this function

Parameters

Returns

This function does not return a value.

Usage

The function specified in the handler parameter can optionally take one parameter, which contains the window name.One use for this function is to fetch window data only when the window shows. You could use a cfajaxproxy tag to create a JavaScript proxy for a CFC function that provides the data, and then a ColdFusion.Window.onShow function to specify a function that calls the proxy function and updates the window contents with the new data.

Example

The following example uses the ColdFusion.Window.onShow function to display an alert with information about the window when you click a button that shows the window: