GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GTK2::EX::FORMFACTORY::POPUP (3)

.ds Aq ’

NAME

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

CONTENTS

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.
<B>itemsB> = 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 <B>itemsB>.

The naming of the methods listed beyond uses the standard <B>get_B> prefix for the attribute read accessor. <B>ATTRB> needs to be replaced by the actual name of the attribute associated with the widget.
<B>get_ATTR_listB> This returns the entries of the Popup. Three data models are supported here:
Simple <B>ARRAYB> 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 <B>ARRAYB> 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.
<B>HASHB> If the method returns a reference to a hash, the popup will be filled with the alphanumerically sorted hash <B>valuesB>.

In turn the hash <B>keyB> 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.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 245: Non-ASCII character seen before =encoding in ’Joern’. Assuming ISO8859-1
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 GTK2::EX::FORMFACTORY::POPUP (3) 2006-07-02

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.