NAME

       Gtk2::Ex::FormFactory::Popup - A Popup in a FormFactory framework

SYNOPSIS

         Gtk2::Ex::FormFactory::Popup->new (
           ...
           Gtk2::Ex::FormFactory::Widget attributes
         );

DESCRIPTION

       This class implements a Popup in a Gtk2::Ex::FormFactory framework.  The selected entry of
       the Popup is controlled by the value of the associated application object attribute, which
       is either an index in an array of possible Popup entries or a key of a hash of possible
       Popup entries.

       Refer to the chapter REQUIREMENTS FOR ASSOCIATED APPLICATION OBJECTS for details.

OBJECT HIERARCHY

         Gtk2::Ex::FormFactory::Intro

         Gtk2::Ex::FormFactory::Widget
         +--- Gtk2::Ex::FormFactory::Popup

         Gtk2::Ex::FormFactory::Layout
         Gtk2::Ex::FormFactory::Rules
         Gtk2::Ex::FormFactory::Context
         Gtk2::Ex::FormFactory::Proxy

ATTRIBUTES

       Attributes are handled through the common get_ATTR(), set_ATTR() style accessors, but they
       are mostly passed once to the object constructor and must not be altered after the
       associated FormFactory was built.

       items = ARRAYREF|HASHREF [optional]
           This attribute takes a static list of popup items, if the popup shouldn't be
           controlled dynamically by an associated application object. Refer to the next chapter
           for details of the data structure applied here.

REQUIREMENTS FOR ASSOCIATED APPLICATION OBJECTS

       Application objects represented by a Gtk2::Ex::FormFactory::Popup must define additional
       methods, unless their content is static by setting items.

       The naming of the methods listed beyond uses the standard get_ prefix for the attribute
       read accessor. ATTR needs to be replaced by the actual name of the attribute associated
       with the widget.

       get_ATTR_list
           This returns the entries of the Popup. Three data models are supported here:

           Simple ARRAY
                  If the method returns a reference to a simple array, the popup will be filled
                  with the array values in the original array order.

                  The index of the actually selected popup entry is stored in the attribute of
                  the associated application object.

           Two dimensional ARRAY
                  The method may return a reference to a two dimensional array. Each row needs to
                  have the attribute value in the first column and the label for the
                  corresponding item in the second.

           HASH   If the method returns a reference to a hash, the popup will be filled with the
                  alphanumerically sorted hash values.

                  In turn the hash key of the actually selected popup entry is stored in the
                  attribute of the associated application object.

AUTHORS

        Joern Reder <joern at zyn dot de>

COPYRIGHT AND LICENSE

       Copyright 2004-2006 by Joern Reder.

       This library is free software; you can redistribute it and/or modify it under the terms of
       the GNU Library General Public License as published by the Free Software Foundation;
       either version 2.1 of the License, or (at your option) any later version.

       This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU Library General Public License for more details.

       You should have received a copy of the GNU Library General Public License along with this
       library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
       Boston, MA  02111-1307 USA.