Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) Standard preamble: ========================================================================
NAMEGtk2::Ex::FormFactory::Popup - A Popup in a FormFactory framework
Gtk2::Ex::FormFactory::Popup->new ( ... Gtk2::Ex::FormFactory::Widget attributes );
DESCRIPTIONThis 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
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
ATTRIBUTESAttributes 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 OBJECTSApplication 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.
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.
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.
Jo.rn Reder <joern at zyn dot de>
COPYRIGHT AND LICENSECopyright 2004-2006 by Jo.rn Reder.
This library is free software; you can redistribute it and/or modify it under the terms of the
This library is distributed in the hope that it will be useful, but
You should have received a copy of the