# Copyright (c) 1990-1994 The Regents of the University of California. # Copyright (c) 1994-1996 Sun Microsystems, Inc. # See the file "license.terms" for information on usage and redistribution # of this file, and for a DISCLAIMER OF ALL WARRANTIES. # # =head1 NAME Tk::options - Standard options supported by widgets and their manipulation =for category Creating and Configuring Widgets =head1 SYNOPSIS S< >I<$value> = I<$widget>-EB('I<-option>'); S< >I<$widget>-EB(I<-option>=EI ?,I<-option>=EI ...?); S< >I<@list> = I<$widget>-EB('I<-option>'); S< >I<@lol> = I<$widget>-EB; =head1 DESCRIPTION All widgets, and images have a standard mechanism for setting and querying attibutes or options. The mechanism is based on two methods B and B. The behaviour of these methods is as follows: =over 4 =item I<$widget>-EB(I<-option>=EI ?,I<-option>=EI ...?); Sets the values of I<-option> to I for each I<-option>=EI pair. The internal B method does an implicit B in this form with options passed in at widget create time. =item I<$widget>-EB('I<-option>') In array context returns a list of five or two elements. If I<-option> is an alias for another options it return a list consisting of the alias option and the name for the option is is an alias for, e.g., C<('-bg', 'background')>. If I<-option> is not an alias the returned list has the following five elements: =over 8 =item I