1Gtk2::Ex::FormFactory::ULsaebrelC(o3n)tributed Perl DocuGmtekn2t:a:tEixo:n:FormFactory::Label(3)
2
3
4
6 Gtk2::Ex::FormFactory::Label - A Label in a FormFactory framework
7
9 Gtk2::Ex::FormFactory::Label->new (
10 with_markup => Should the label render with markup?,
11 bold => Should the label render as bold text?,
12 for => Name for Widget this label belongs to,
13 ...
14 Gtk2::Ex::FormFactory::Widget attributes
15 );
16
18 This class implements a Label in a Gtk2::Ex::FormFactory framework.
19 The text of the Label is the value of the associated application object
20 attribute. If no object is associated with the Label, the text is taken
21 from the standard label attribute.
22
24 Gtk2::Ex::FormFactory::Intro
25
26 Gtk2::Ex::FormFactory::Widget
27 +--- Gtk2::Ex::FormFactory::Label
28
29 Gtk2::Ex::FormFactory::Layout
30 Gtk2::Ex::FormFactory::Rules
31 Gtk2::Ex::FormFactory::Context
32 Gtk2::Ex::FormFactory::Proxy
33
35 Attributes are handled through the common get_ATTR(), set_ATTR() style
36 accessors, but they are mostly passed once to the object constructor
37 and must not be altered after the associated FormFactory was built.
38
39 with_markup = BOOL [optional]
40 If this is set to TRUE the Label may contain basic HTML markup,
41 which is rendered accordingly. Refer to the "Pango Text Attribute
42 Markup" chapter in the Gtk+ documentation for details.
43
44 bold = BOOL [optional]
45 If set to TRUE the label is implicitly renderd as markup set into
46 <b>...</b> tags.
47
48 for = SCALAR [optional]
49 If this label belongs to another widget pass the widget's name
50 here. This way the label greys out automatically, if the widget
51 gets inactive.
52
53 You may not just specify a simple name here but reference siblings
54 of the label widget as well by specifying
55
56 sibling($nr)
57
58 whereby $nr has a negative value to address siblings left from the
59 Label and positive to address right siblings. E.g. sibling(-1) is
60 the first left sibling and sibling(2) the second on the right.
61
62 If you add your Widgets to a Gtk2::Ex::ForFactory::Form container
63 the label attributes of the Widgets are rendered automatically
64 correspondently. But you need this feature for complex layouts not
65 covered by Gtk2::Ex::ForFactory::Form, e.g. in a
66 Gtk2::Ex::ForFactory::Table.
67
68 For more attributes refer to Gtk2::Ex::FormFactory::Widget.
69
71 Jörn Reder <joern at zyn dot de>
72
74 Copyright 2004-2006 by Jörn Reder.
75
76 This library is free software; you can redistribute it and/or modify it
77 under the terms of the GNU Library General Public License as published
78 by the Free Software Foundation; either version 2.1 of the License, or
79 (at your option) any later version.
80
81 This library is distributed in the hope that it will be useful, but
82 WITHOUT ANY WARRANTY; without even the implied warranty of
83 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
84 Library General Public License for more details.
85
86 You should have received a copy of the GNU Library General Public
87 License along with this library; if not, write to the Free Software
88 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307
89 USA.
90
92 Hey! The above document had some coding errors, which are explained
93 below:
94
95 Around line 140:
96 Non-ASCII character seen before =encoding in 'Jörn'. Assuming UTF-8
97
98
99
100perl v5.28.0 2006-02-27 Gtk2::Ex::FormFactory::Label(3)