Gtk2::Ex::FormFactory:UsereContributed Perl DocGtk2::Ex::FormFactory::Label(3)NAMEGtk2::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
JA~Xrn Reder <joern at zyn dot de>
COPYRIGHT AND LICENSE
Copyright 2004-2006 by JA~Xrn 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.
perl v5.14.1 2006-02-27 Gtk2::Ex::FormFactory::Label(3)