Class Window
public
class
Window
extends
Object
This class provides access to the browser window's methods, properties, and
events.
Methods
Method Detail
addWindowCloseListener
Adds a listener to receive window closing events.
Parameters
- listener
- the listener to be informed when the window is closing
addWindowResizeListener
Adds a listener to receive window resize events.
Parameters
- listener
- the listener to be informed when the window is resized
alert
public static void
alert(
String msg)
Displays a message in a modal dialog box.
Parameters
- msg
- the message to be displayed.
confirm
public static boolean
confirm(
String msg)
Displays a message in a modal dialog box, along with the standard 'OK' and
'Cancel' buttons.
Parameters
- msg
- the message to be displayed.
Return Value
true
if 'OK' is clicked,
false
if
'Cancel' is clicked.
enableScrolling
public static void enableScrolling(boolean enable)
Use this method to explicitly disable the window's scrollbars.
Applications that choose to resize their user-interfaces to fit within the
window's client area will normally want to disable window scrolling.
Parameters
- enable
-
false
to disable window scrolling
getClientHeight
public static int getClientHeight()
Gets the height of the browser window's client area.
Return Value
the window's client height
getClientWidth
public static int getClientWidth()
Gets the width of the browser window's client area.
Return Value
the window's client width
getTitle
public static
String getTitle()
Gets the browser window's current title.
Return Value
the window's title.
open
Opens a new browser window. The "name" and "features" arguments are
specified
here.
Parameters
- url
- the URL that the new window will display
- name
- the name of the window (e.g. "_blank")
- features
- the features to be enabled/disabled on this window
removeWindowCloseListener
Removes a window closing listener.
Parameters
- listener
- the listener to be removed
removeWindowResizeListener
Removes a window resize listener.
Parameters
- listener
- the listener to be removed
setMargin
public static void
setMargin(
String size)
Sets the size of the margins used within the window's client area. It is
sometimes necessary to do this because some browsers, such as Internet
Explorer, add margins by default, which can confound attempts to resize
panels to fit exactly within the window.
Parameters
- size
- the window's new margin size, in CSS units.
setTitle
public static void
setTitle(
String title)
Sets the browser window's title.
Parameters
- title
- the new window title.