GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  WWW::SCRIPTER::WINDOWGROUP (3)

.ds Aq ’

NAME

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

CONTENTS

VERSION

Version 0.031

SYNOPSIS



 use WWWScripterWindowGroup;

 $browser = new WWWScripterWindowGroup;
 # This has one window already

 # OR:

 $browser = new WWWScripterWindowGroup empty => 1;
 $browser->attach($w = new WWWScripter);

 $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
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 WWW::SCRIPTER::WINDOWGROUP (3) 2016-02-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.