Slaven Rezić > Tk-Autoscroll > Tk::Autoscroll

Download:
Tk-Autoscroll-1.14.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.14   Source  

NAME ^

Tk::Autoscroll - space invaders-like scrolling

SYNOPSIS ^

    use Tk::Autoscroll;
    Tk::Autoscroll::Init($widget);

DESCRIPTION ^

This lets you enable scrolling similar to the one in Microsoft Explorer. Press the middle mouse button and then move the mouse to scroll the widget. A further press on the middle button stops the scrolling.

It is also possible to use the autoscrolling feature for all Scrolled() widgets automatically. To do so, you have to write

    use Tk::Autoscroll 'as_default';

FUNCTIONS ^

Init($widget, [options ...])

Possible options:

-trigger

Default value is "<Button-2>"

-stoptrigger

An event to stop autoscrolling. Normally, this is not defined meaning that autoscrolling will stop if Button-2 is pressed again. If -stoptrigger is set to <ButtonRelease-2>, then the user have to hold the middle button down to autoscroll and autoscrolling will stop if the user releases the button.

-speed

Values are "slow", "normal" and "fast". Default value is "normal".

-beforestartcommand, -afterstartcommand, -beforestopcommand, -afterstopcommand

Commands which are executed before/after beginning/ending autoscroll operation. Note that only subroutine references are allowed, but not perl/Tk callbacks (i.e. the [ ] notation). The "-before" callbacks should return true, otherwise the operation is cancelled.

If you want to apply any Init options to all widgets when using as_default, then you can define the global variable @default_args. Example:

    @Tk::Autoscroll::default_args = (-stoptrigger => '<ButtonRelease-2>');

Reset($widget)

Remove the binding, scrolling is not possible anymore.

BUGS ^

The import() function could be better implemented, i.e. avoiding the duplicate of Scrolled() definition.

Any motion binding for the widget is overwritten.

Reset() should probably restore all used bindings.

SEE ALSO ^

Tk, Tk::Scrolled

AUTHOR ^

Slaven Rezic <slaven@rezic.de>

COPYRIGHT ^

Copyright (c) 1999,2001,2002 Slaven Rezic. All rights reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: