NAME

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

SYNOPSIS

         Gtk2::Ex::FormFactory::Label->new (
           with_markup => Should the label render with markup?,
           bold        => Should the label render as bold text?,
           for         => Name for Widget this label belongs to,
           ...
           Gtk2::Ex::FormFactory::Widget attributes
         );

DESCRIPTION

       This class implements a Label in a Gtk2::Ex::FormFactory framework.  The text of the Label
       is the value of the associated application object attribute. If no object is associated
       with the Label, the text is taken from the standard label attribute.

OBJECT HIERARCHY

         Gtk2::Ex::FormFactory::Intro

         Gtk2::Ex::FormFactory::Widget
         +--- Gtk2::Ex::FormFactory::Label

         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.

       with_markup = BOOL [optional]
           If this is set to TRUE the Label may contain basic HTML markup, which is rendered
           accordingly. Refer to the "Pango Text Attribute Markup" chapter in the Gtk+
           documentation for details.

       bold = BOOL [optional]
           If set to TRUE the label is implicitly renderd as markup set into <b>...</b> tags.

       for = SCALAR [optional]
           If this label belongs to another widget pass the widget's name here.  This way the
           label greys out automatically, if the widget gets inactive.

           You may not just specify a simple name here but reference siblings of the label widget
           as well by specifying

             sibling($nr)

           whereby $nr has a negative value to address siblings left from the Label and positive
           to address right siblings. E.g. sibling(-1) is the first left sibling and sibling(2)
           the second on the right.

           If you add your Widgets to a Gtk2::Ex::ForFactory::Form container the label attributes
           of the Widgets are rendered automatically correspondently. But you need this feature
           for complex layouts not covered by Gtk2::Ex::ForFactory::Form, e.g. in a
           Gtk2::Ex::ForFactory::Table.

       For more attributes refer to Gtk2::Ex::FormFactory::Widget.

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.