# -*-mode: text; fill-column: 80; comment-column: 80; -*- # README -- # # This file provides out of bounds mechanics. # # Copyright (c) 2000-2007 Meccanomania # # See the file "license.terms" for information on usage and redistribution # of this file, and for a DISCLAIMER OF ALL WARRANTIES. # # svn: @(#) $Id: README 55 2008-01-10 23:23:38Z meccanomania $ #------------------------------------------------------------------------------- If you read this file _as_is_, just ignore the funny characters you see. It is written in the POD format (see pod/perlpod.pod) which is specifically designed to be readable as is. =head1 NAME README - This file provides out of bounds mechanics. =head1 DESCRIPTION This document describes the main features of the out-of-bounds mechanics that extends the bind and bindtags functions. The B method associates callbacks with X events in the same manner as bind does. For example : S< >I<$widget>-EB(I,I,I,I) If I is specified, B will arrange for I to be evaluated whenever the event(s) given by I occur in the window(s) identified by I<$widget> or I. If I is an empty string then the current binding for I is destroyed, leaving I bound less. In all of the cases where a I argument is provided, B returns an empty string. If I is specified and evaluated to a valid out of bounds bit mask, then B will arrange for I to be called, if specified, for the previous callback to be called otherwise. The B method associates callbacks with X events in the same manner as bindtags does. For example : S< >I<$widget>-EB([I],[I]); When a bounding is created with the B command, it is associated either with a particular window such as I<$widget>, a class name such as B, the keyword B, or any other string. All of these forms are called I. Each window has a list of bounding tags and levels that determine how events are processed for the window. When an event occurs in a window, it is applied to each of the window's tags in order: for each tag, the most specific bounding that matches the given tag and event is executed. See the L documentation for more information on the matching process. In addition, Tk::Bounded is used with Perl's multiple inheritance to override some methods normally inherited from Tk::Derived and Tk::Widget. It also specifies level 1 bound tags for caller class. =head1 AUTHOR Copyright (c) 2000-2007 Meccanomania =cut