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

This module has no additional attributes over those derived from Gtk2::Ex::FormFactory::Widget.

REQUIREMENTS FOR ASSOCIATED APPLICATION OBJECTS

Application objects represented by a Gtk2::Ex::FormFactory::Popup must define additional methods. 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. Two data models are supported here:

ARRAY

If the method returns a reference to an 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.

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

Jörn Reder <joern at zyn dot de>

COPYRIGHT AND LICENSE

Copyright 2004 by Jörn 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.