The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.