NAME
   Tk::autobind - automatically bind a widget to an ALT-key

SYNOPSIS
   use Tk::autobind;

   $widget->autobind(callback);

DESCRIPTION
   `Tk::autobind' offers a convenient way to set up a form and have ALT-key
   bindings for the widgets on that form. All you have to do is call
   `autobind' after you create a widget. If the widget has an `-underline'
   configuration option set to a value greater than or equal to 0, its
   ALT-key binding is the key at that location in the widget's `-text'
   configuration option.

   For example, if you have a Checkbutton with the following `-text':

       Automatically fix

   and its `-underline' value is set to 0, then if the user presses ALT-A
   while the focus is in the widget's main window, the checkbutton widget
   will be invoked.

   The binding that is generated is essentially

   `$widget->toplevel->bind('<Alt-Key-*x*>', $callback);'

METHODS
   $widget->autobind(callback);
       Adds the binding given above. If *callback* is specified, it must be
       one of the forms of a valid Tk callback (see the Tk::callbacks
       manpage). If it is omitted, a closure is generated and used:

           sub { $widget->Invoke }

       If *callback* is explicitly set to an empty string, the binding is
       removed.

       This method always returns $widget to allow method chaining. For
       example, you can stick autobind before the call to pack:

           my $checkbutton = $mw->Checkbutton(Name => 'cb1')->autobind->pack;

SEE ALSO
   the Tk::bind manpage

AUTHOR
   Kevin Michael Vail <[email protected]>