NAME

Mozilla::DOM::Window

DESCRIPTION

Mozilla::DOM::Window is a wrapper around an instance of Mozilla's nsIDOMWindow interface. This class inherits from Supports.

* The nsIDOMWindow interface is the primary interface for a DOM
* window object. It represents a single window object that may
* contain child windows if the document in the window contains a
* HTML frameset document or if the document contains iframe elements.
*
* This interface is not officially defined by any standard bodies, it
* originates from the defacto DOM Level 0 standard.

Note: the GetScrollbars is not wrapped (non-trivial to do)

CLASS METHODS

$iid = Mozilla::DOM::Window->GetIID()

Pass this to QueryInterface.

METHODS

$document = $window->GetDocument()

    * Accessor for the document in this window.

$window_collection = $window->GetFrames()

* Accessor for the child windows in this window.

In scalar context, returns a Mozilla::DOM::WindowCollection.

In list context, returns a list of Mozilla::DOM::Window (I think... whatever $window_collection->Item($n) is.)

$name = $window->GetName()

    Get the name of this window.

    This corresponds to window.name in JavaScript.

$window = $window->GetParent()

    * Accessor for this window's parent window, or the window itself if
    * there is no parent, or if the parent is of different type
    * (i.e. this does not cross chrome-content boundaries).

$selection = $window->GetSelection()

    * Method for accessing this window's selection object.

$num = $window->GetTextZoom()

    * Set/Get the document scale factor as a multiplier on the default
    * size. When setting this attribute, a NS_ERROR_NOT_IMPLEMENTED
    * error may be returned by implementations not supporting
    * zoom. Implementations not supporting zoom should return 1.0 all
    * the time for the Get operation. 1.0 is equals normal size,
    * i.e. no zoom.

$window = $window->GetTop()

    * Accessor for the root of this hierarchy of windows. This root may
    * be the window itself if there is no parent, or if the parent is
    * of different type (i.e. this does not cross chrome-content
    * boundaries).
    *
    * This property is "replaceable" in JavaScript */

$window->SetName($name)

    • $name (string)

    Set the name of this window.

    "This attribute is 'replaceable' in JavaScript"; where it corresponds to window.name.

$window->SetTextZoom($zoom)

    • $zoom (double)

$window->SizeToContent()

    * Method for sizing this window to the content in the window.

    XXX: doesn't seem to work. Maybe window resize is disabled, or maybe Gtk2 prevents it.

$x = $window->GetScrollX()

    * Accessor for the current x scroll position in this window in
    * pixels.
    *
    * This attribute is "replaceable" in JavaScript
    • $x (double)

$y = $window->GetScrollY()

    * Accessor for the current y scroll position in this window in
    * pixels.
    *
    * This attribute is "replaceable" in JavaScript
    • $y (double)

$window->ScrollTo($xScroll, $yScroll)

    * Method for scrolling this window to an absolute pixel offset.
    • $xScroll (double)

    • $yScroll (double)

$window->ScrollBy($xScrollDif, $yScrollDif)

    * Method for scrolling this window to a pixel offset relative to
    * the current scroll position.
    • $xScrollDif (double)

    • $yScrollDif (double)

$window->ScrollByLines($numLines)

    * Method for scrolling this window by a number of lines.
    • $numLines (double)

$window->ScrollByPages($numPages)

    * Method for scrolling this window by a number of pages.
    • $numPages (double)

SEE ALSO

Mozilla::DOM

COPYRIGHT

Copyright (C) 2005-2007, Scott Lanning

This software is licensed under the LGPL. See Mozilla::DOM for a full notice.