1Gtk2::Label(3) User Contributed Perl Documentation Gtk2::Label(3)
2
6 Gtk2::Label - wrapper for GtkLabel
7
9 Glib::Object
10 +----Glib::InitiallyUnowned
11 +----Gtk2::Object
12 +----Gtk2::Widget
13 +----Gtk2::Misc
14 +----Gtk2::Label
15
17 Glib::Object::_Unregistered::AtkImplementorIface
18 Gtk2::Buildable
19
21 widget = Gtk2::Label->new ($str=undef)
22 • $str (string or undef)
23 widget = Gtk2::Label->new_with_mnemonic ($str)
25 • $str (string)
26 double = $label->get_angle
28 Since: gtk+ 2.6
29 $label->set_angle ($angle)
31 • $angle (double)
32 Since: gtk+ 2.6
34 attrlist = $label->get_attributes
36 $label->set_attributes ($attrs)
37 • $attrs (Pango::AttrList)
38 string = $label->get_current_uri
40 Since: gtk+ 2.18
41 ellipsizemode = $label->get_ellipsize
43 Since: gtk+ 2.6
44 $label->set_ellipsize ($mode)
46 • $mode (Pango::EllipsizeMode)
47 Since: gtk+ 2.6
49 justification = $label->get_justify
51 $label->set_justify ($jtype)
52 • $jtype (Gtk2::Justification)
53 string = $label->get_label
55 $label->set_label ($str)
56 • $str (string)
57 layout = $label->get_layout
59 (x, y) = $label->get_layout_offsets
60 boolean = $label->get_line_wrap
61 wrapmode = $label->get_line_wrap_mode
62 Since: gtk+ 2.9
63 $label->set_line_wrap_mode ($wrap_mode)
65 • $wrap_mode (Pango::WrapMode)
66 Since: gtk+ 2.9
68 $label->set_line_wrap ($wrap)
70 • $wrap (boolean)
71 $label->set_markup ($str)
73 • $str (string)
74 $label->set_markup_with_mnemonic ($str)
76 • $str (string)
77 integer = $label->get_max_width_chars
79 Since: gtk+ 2.6
80 $label->set_max_width_chars ($n_chars)
82 • $n_chars (integer)
83 Since: gtk+ 2.6
85 integer = $label->get_mnemonic_keyval
87 widget or undef = $label->get_mnemonic_widget
88 $label->set_mnemonic_widget ($widget)
89 • $widget (Gtk2::Widget or undef)
90 $label->set_pattern ($pattern)
92 • $pattern (string)
93 $label->select_region ($start_offset=-1, $end_offset=-1)
95 • $start_offset (integer)
96 • $end_offset (integer)
98 boolean = $label->get_selectable
100 $label->set_selectable ($setting)
101 • $setting (boolean)
102 (start, end) = $label->get_selection_bounds
104 Returns integers, start and end.
105 boolean = $label->get_single_line_mode
107 Since: gtk+ 2.6
108 $label->set_single_line_mode ($single_line_mode)
110 • $single_line_mode (boolean)
111 Since: gtk+ 2.6
113 string or undef = $label->get_text
115 $label->set_text ($str)
116 • $str (string or undef)
117 $label->set_text_with_mnemonic ($str)
119 • $str (string)
120 boolean = $label->get_track_visited_links
122 Since: gtk+ 2.18
123 $label->set_track_visited_links ($track_links)
125 • $track_links (boolean)
126 Since: gtk+ 2.18
128 boolean = $label->get_use_markup
130 $label->set_use_markup ($setting)
131 • $setting (boolean)
132 boolean = $label->get_use_underline
134 $label->set_use_underline ($setting)
135 • $setting (boolean)
136 integer = $label->get_width_chars
138 Since: gtk+ 2.6
139 $label->set_width_chars ($n_chars)
141 • $n_chars (integer)
142 Since: gtk+ 2.6
144
146 'angle' (double : default 0 : readable / writable / private / static-
147 nick / static-blurb)
148 Angle at which the label is rotated
149 'attributes' (Pango::AttrList : default undef : readable / writable /
151 private / static-nick / static-blurb)
152 A list of style attributes to apply to the text of the label
153 'cursor-position' (integer : default 0 : readable / private / static-
155 nick / static-blurb)
156 The current position of the insertion cursor in chars
157 'ellipsize' (Pango::EllipsizeMode : default "none" : readable /
159 writable / private / static-nick / static-blurb)
160 The preferred place to ellipsize the string, if the label does not
161 have enough room to display the entire string
162 'justify' (Gtk2::Justification : default "left" : readable / writable /
164 private / static-nick / static-blurb)
165 The alignment of the lines in the text of the label relative to
166 each other. This does NOT affect the alignment of the label within
167 its allocation. See GtkMisc::xalign for that
168 'label' (string : default "" : readable / writable / private / static-
170 nick / static-blurb)
171 The text of the label
172 'max-width-chars' (integer : default -1 : readable / writable / private
174 / static-nick / static-blurb)
175 The desired maximum width of the label, in characters
176 'mnemonic-keyval' (Glib::UInt : default 0xFFFFFF VoidSymbol : readable
178 / private / static-nick / static-blurb)
179 The mnemonic accelerator key for this label
180 'mnemonic-widget' (Gtk2::Widget : default undef : readable / writable /
182 private / static-nick / static-blurb)
183 The widget to be activated when the label's mnemonic key is pressed
184 'pattern' (string : default undef : writable / private / static-nick /
186 static-blurb)
187 A string with _ characters in positions correspond to characters in
188 the text to underline
189 'selectable' (boolean : default false : readable / writable / private /
191 static-nick / static-blurb)
192 Whether the label text can be selected with the mouse
193 'selection-bound' (integer : default 0 : readable / private / static-
195 nick / static-blurb)
196 The position of the opposite end of the selection from the cursor
197 in chars
198 'single-line-mode' (boolean : default false : readable / writable /
200 private / static-nick / static-blurb)
201 Whether the label is in single line mode
202 'track-visited-links' (boolean : default true : readable / writable /
204 private / static-nick / static-blurb)
205 Whether visited links should be tracked
206 'use-markup' (boolean : default false : readable / writable / private /
208 static-nick / static-blurb)
209 The text of the label includes XML markup. See pango_parse_markup()
210 'use-underline' (boolean : default false : readable / writable /
212 private / static-nick / static-blurb)
213 If set, an underline in the text indicates the next character
214 should be used for the mnemonic accelerator key
215 'width-chars' (integer : default -1 : readable / writable / private /
217 static-nick / static-blurb)
218 The desired width of the label, in characters
219 'wrap' (boolean : default false : readable / writable / private /
221 static-nick / static-blurb)
222 If set, wrap lines if the text becomes too wide
223 'wrap-mode' (Pango::WrapMode : default "word" : readable / writable /
225 private / static-nick / static-blurb)
226 If wrap is set, controls how linewrapping is done
227
229 activate-current-link (Gtk2::Label)
230 boolean = activate-link (Gtk2::Label, string)
231 copy-clipboard (Gtk2::Label)
232 move-cursor (Gtk2::Label, Gtk2::MovementStep, integer, boolean)
233 populate-popup (Gtk2::Label, Gtk2::Menu)
234
236 enum Gtk2::Justification
237 • 'left' / 'GTK_JUSTIFY_LEFT'
238 • 'right' / 'GTK_JUSTIFY_RIGHT'
240 • 'center' / 'GTK_JUSTIFY_CENTER'
242 • 'fill' / 'GTK_JUSTIFY_FILL'
244 enum Gtk2::MovementStep
246 • 'logical-positions' / 'GTK_MOVEMENT_LOGICAL_POSITIONS'
247 • 'visual-positions' / 'GTK_MOVEMENT_VISUAL_POSITIONS'
249 • 'words' / 'GTK_MOVEMENT_WORDS'
251 • 'display-lines' / 'GTK_MOVEMENT_DISPLAY_LINES'
253 • 'display-line-ends' / 'GTK_MOVEMENT_DISPLAY_LINE_ENDS'
255 • 'paragraphs' / 'GTK_MOVEMENT_PARAGRAPHS'
257 • 'paragraph-ends' / 'GTK_MOVEMENT_PARAGRAPH_ENDS'
259 • 'pages' / 'GTK_MOVEMENT_PAGES'
261 • 'buffer-ends' / 'GTK_MOVEMENT_BUFFER_ENDS'
263 • 'horizontal-pages' / 'GTK_MOVEMENT_HORIZONTAL_PAGES'
265 enum Pango::EllipsizeMode
267 • 'none' / 'PANGO_ELLIPSIZE_NONE'
268 • 'start' / 'PANGO_ELLIPSIZE_START'
270 • 'middle' / 'PANGO_ELLIPSIZE_MIDDLE'
272 • 'end' / 'PANGO_ELLIPSIZE_END'
274 enum Pango::WrapMode
276 • 'word' / 'PANGO_WRAP_WORD'
277 • 'char' / 'PANGO_WRAP_CHAR'
279 • 'word-char' / 'PANGO_WRAP_WORD_CHAR'
281
283 Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget,
284 Gtk2::Misc
285
287 Copyright (C) 2003-2011 by the gtk2-perl team.
288 This software is licensed under the LGPL. See Gtk2 for a full notice.
290perl v5.36.0 2023-01-20 Gtk2::Label(3)