Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WWW::Scripter::WindowGUser(Contributed Perl DocumWWW::Scripter::WindowGroup(3)

NAME
       WWW::Scripter::WindowGroup - Multiple-window browsing environment

VERSION
       Version 0.032

SYNOPSIS
	use WWW'Scripter'WindowGroup;

	$browser = new WWW'Scripter'WindowGroup;
	# This has one window already

	# OR:

	$browser = new WWW'Scripter'WindowGroup	empty => 1;
	$browser->attach($w = new WWW'Scripter);

	$w = $browser->active_window;
	$w->get('http://ghare.dr/');
	$w->close;

	$w = $browser->new_window;
	@w = $browser->windows;

DESCRIPTION
       This module provides a virtual multiple-window browsing environment for
       WWW::Scripter. It does not actually create any windows on the screen,
       but it can be used to script websites that make use of multiple
       windows.	The individual windows themselves are WWW::Scripter objects.

       Before you start	using this, consider whether the site you are
       scripting actually needs	multiple windows. If a single-window
       environment will	do, use	WWW::Scripter directly.

       Note: Window groups hold	strong references to their windows, but	the
       windows themselves hold weak references to the window group. So if you
       let a window group go out of scope while	retaining a reference to a
       window, that window will	revert to single-window	mode.

METHODS
       new The constructor. Call this method on	the class, not on an object
	   thereof.  It	takes no arguments.

       active_window
	   Returns the window that is currently	'active'. This can be changed
	   by scripts calling the "focus" method on a window, or opening a new
	   one,	so keep	your own reference to it if you	need to	refer to a
	   specific window repeatedly.

       windows
	   Returns a list of all windows in list context, or the number	of
	   windows in scalar context.

       new_window
	   Adds	a new WWW::Scripter to the window group	and returns it.

       attach ($window)
	   This	methods	adds a window to the group, making it the frontmost
	   window and setting its "window_group" attribute appropriately.

	   If you attach a window that is already attached to another group,
	   strange things may happen. Detach it	first.

       detach ($window)
	   This	removes	the window from	the group and sets its "window_group"
	   attribute to	"undef". This is used internally by WWW::Scripter's
	   "close" method.

       bring_to_front ($window)
	   This	makes $window the active window.

AUTHOR & COPYRIGHT
       See WWW::Scripter

SEE ALSO
       -   WWW::Scripter

perl v5.32.1			  2016-07-16	 WWW::Scripter::WindowGroup(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | METHODS | AUTHOR & COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=WWW::Scripter::WindowGroup&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help