Gnome2::AppHelper

Section: User Contributed Perl Documentation (3pm)
Updated: 2009-03-15
Index Return to Main Contents

NAME

Gnome2::AppHelper

GnomeUIInfo

In Gnome2 GnomeUIInfo's are often used as a convenient way to create GUI's. In Perl, GnomeUIInfo's are always references to arrays of items. Items can either be references to hashs or references to arrays:

Hash Reference

When using hash references, items are specified by giving key-value pairs. A typical example:

  { type => "item", label => "Quit", callback => sub { exit(0); } }

For the list of valid keys, see below.

Array References

When using array references, items are a list of the following keys, in this order:

  type,
  label,
  hint,
  moreinfo,
  pixmap_type,
  pixmap_info,
  accelerator_key and
  modifiers.

The example from above would become:

  [ "item", "Item", undef, sub { exit(0); },
    undef, undef, undef, undef ]

To create multi-level structures, you use the ``subtree'' type and the ``subtree'' key, as in the following example:

  {
    type => "subtree",
    label => "Radio Items",
    subtree => [
      {
        type => "radioitems",
        moreinfo => [
          {
            type => "item",
            label => "A"
          },
          {
            type => "item",
            label => "B"
          },
          {
            type => "item",
            label => "C"
          },
          {
            type => "item",
            label => "D"
          },
          {
            type => "item",
            label => "E"
          }
        ]
      }
    ]
  }