JSV_defineWindow - JavaScript Vision

Allows the user to define a window but not open it.

Syntax

JSV_defineWindow(winName [, winURL, winAttributes, winReplace, winOptions...])

Returns

The index of the array element at which the named window is defined. If the return value is equal to WINDOWNOTDEFINED, then no window name was passed.

Parameters

The JSV_defineWindow function uses the same arguments as JSV_openWindow

Remarks

Subsequent calls to JSV_defineWindow using the same window name but with a different values in any of the parameters causes the window to be redefined with the new parameter values being passed. If null is passed in any of the parameters on a redefinition of the window, then the original value for that parameter remains.

Dependencies

JSV_isWhitespace

Example

The following lines of code


var myWindow = "Jack_in_the_Box";
function windowDefinition() {
    var dummy = JSV_defineWindow(myWindow,
            'testpage.htm',
            'menubar=1,status=1,scrollbars=1,resizable=1,width=580,height=240,left=40,top=40,screenX=40,screenY=40');
}

function windowTest() {
    if ( JSV_isWindowDefined(myWindow) )
        var dummy = JSV_openWindow(myWindow);
    else
        alert(myWindow + ": Window not defined.");
}

produce a new window when the button is clicked