Creates a popup window object.
Syntax
oPopup = object.createPopup( [vArgs])
Parameters
| vArgs |
Optional.
This argument is reserved.
|
Return Value
Returns a popup window object.
Remarks
The pop-up window is initially in a hidden state.
When an element has focus and causes a popup to appear, the element does not lose focus. Because of this, an onblur event associated with an element that creates a popup will not occur when the popup is displayed.
Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2) places several restrictions on windows created with this method. Restricted properties include size, screen position, and z-order. For more information, see About Window Restrictions.
Note Pages that change the
document.domain property before creating the
popup object may receive an "Access is denied" error message when accessing the pop-up object. Changes made to
document.domain in the calling page will not propagate to the new pop-up object; currently, this is a design restriction that serves to limit access with the pop-up object.
Windows Internet Explorer 7 and later. By default, windows created with the createPopup function are displayed in IE5 mode compatibility mode (also called "quirks" mode), regardless of the display mode of the Web page that created them. To display standards-based content in a popup window, use document.location location to load an external document into the popup window. When you do this, the popup window will render the content according to the document compatibility mode of the loaded content. For information, see Defining Document Compatibility.
Internet Explorer 8. Windows created with createPopup inherit the zoom state of windows that created them.
Example
The following example shows how to use the createPopup method to create and display a pop-up window.
<HTML>
<HEAD>
<TITLE>Popup Example</TITLE>
<SCRIPT LANGUAGE="JScript">
var oPopup = window.createPopup();
function ButtonClick()
{
var oPopBody = oPopup.document.body;
oPopBody.style.backgroundColor = "lightyellow";
oPopBody.style.border = "solid black 1px";
oPopBody.innerHTML = "Click outside <B>popup</B> to close.";
oPopup.show(100, 100, 180, 25, document.body);
}
</SCRIPT>
</HEAD>
<BODY>
<BUTTON onclick="ButtonClick()">Click Me!</BUTTON>
</BODY>
</HTML>
Standards Information
There is no public standard that applies to this method.
Applies To
See Also