NAME¶
Gtk2::Label - wrapper for GtkLabel
HIERARCHY¶
Glib::Object
+----Glib::InitiallyUnowned
+----Gtk2::Object
+----Gtk2::Widget
+----Gtk2::Misc
+----Gtk2::Label
INTERFACES¶
Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable
METHODS¶
- •
- $str (string or undef)
- •
- $str (string)
double = $label->get_angle¶
Since: gtk+ 2.6
$label->set_angle ($angle)¶
- •
- $angle (double)
Since: gtk+ 2.6
attrlist = $label->get_attributes¶
$label->set_attributes ($attrs)¶
- •
- $attrs (Pango::AttrList)
string = $label->get_current_uri¶
Since: gtk+ 2.18
ellipsizemode = $label->get_ellipsize¶
Since: gtk+ 2.6
$label->set_ellipsize ($mode)¶
- •
- $mode (Pango::EllipsizeMode)
Since: gtk+ 2.6
justification = $label->get_justify¶
$label->set_justify ($jtype)¶
- •
- $jtype (Gtk2::Justification)
string = $label->get_label¶
$label->set_label ($str)¶
- •
- $str (string)
layout = $label->get_layout¶
(x, y) = $label->get_layout_offsets¶
boolean = $label->get_line_wrap¶
wrapmode = $label->get_line_wrap_mode¶
Since: gtk+ 2.9
$label->set_line_wrap_mode ($wrap_mode)¶
- •
- $wrap_mode (Pango::WrapMode)
Since: gtk+ 2.9
$label->set_line_wrap ($wrap)¶
- •
- $wrap (boolean)
$label->set_markup ($str)¶
- •
- $str (string)
$label->set_markup_with_mnemonic ($str)¶
- •
- $str (string)
integer = $label->get_max_width_chars¶
Since: gtk+ 2.6
$label->set_max_width_chars ($n_chars)¶
- •
- $n_chars (integer)
Since: gtk+ 2.6
integer = $label->get_mnemonic_keyval¶
- •
- $widget (Gtk2::Widget or undef)
$label->set_pattern ($pattern)¶
- •
- $pattern (string)
$label->select_region ($start_offset=-1,
$end_offset=-1)¶
- •
- $start_offset (integer)
- •
- $end_offset (integer)
boolean = $label->get_selectable¶
$label->set_selectable ($setting)¶
- •
- $setting (boolean)
(start, end) = $label->get_selection_bounds¶
Returns integers, start and end.
boolean = $label->get_single_line_mode¶
Since: gtk+ 2.6
$label->set_single_line_mode ($single_line_mode)¶
- •
- $single_line_mode (boolean)
Since: gtk+ 2.6
string or undef = $label->get_text¶
$label->set_text ($str)¶
- •
- $str (string or undef)
$label->set_text_with_mnemonic ($str)¶
- •
- $str (string)
boolean = $label->get_track_visited_links¶
Since: gtk+ 2.18
$label->set_track_visited_links ($track_links)¶
- •
- $track_links (boolean)
Since: gtk+ 2.18
boolean = $label->get_use_markup¶
$label->set_use_markup ($setting)¶
- •
- $setting (boolean)
boolean = $label->get_use_underline¶
$label->set_use_underline ($setting)¶
- •
- $setting (boolean)
integer = $label->get_width_chars¶
Since: gtk+ 2.6
$label->set_width_chars ($n_chars)¶
- •
- $n_chars (integer)
Since: gtk+ 2.6
PROPERTIES¶
- 'angle' (double : default 0 : readable / writable /
private)
- Angle at which the label is rotated
- 'attributes' (Pango::AttrList : default undef : readable /
writable / private)
- A list of style attributes to apply to the text of the
label
- 'cursor-position' (integer : default 0 : readable /
private)
- The current position of the insertion cursor in chars
- 'ellipsize' (Pango::EllipsizeMode : default
"none" : readable / writable / private)
- The preferred place to ellipsize the string, if the label
does not have enough room to display the entire string
- 'justify' (Gtk2::Justification : default "left" :
readable / writable / private)
- The alignment of the lines in the text of the label
relative to each other. This does NOT affect the alignment of the label
within its allocation. See GtkMisc::xalign for that
- 'label' (string : default "" : readable /
writable / private)
- The text of the label
- 'max-width-chars' (integer : default -1 : readable /
writable / private)
- The desired maximum width of the label, in characters
- 'mnemonic-keyval' (Glib::UInt : default 0xFFFFFF VoidSymbol
: readable / private)
- The mnemonic accelerator key for this label
- 'mnemonic-widget' (Gtk2::Widget : default undef : readable
/ writable / private)
- The widget to be activated when the label's mnemonic key is
pressed
- 'pattern' (string : default undef : writable /
private)
- A string with _ characters in positions correspond to
characters in the text to underline
- 'selectable' (boolean : default false : readable / writable
/ private)
- Whether the label text can be selected with the mouse
- 'selection-bound' (integer : default 0 : readable /
private)
- The position of the opposite end of the selection from the
cursor in chars
- 'single-line-mode' (boolean : default false : readable /
writable / private)
- Whether the label is in single line mode
- 'track-visited-links' (boolean : default true : readable /
writable / private)
- Whether visited links should be tracked
- 'use-markup' (boolean : default false : readable / writable
/ private)
- The text of the label includes XML markup. See
pango_parse_markup()
- 'use-underline' (boolean : default false : readable /
writable / private)
- If set, an underline in the text indicates the next
character should be used for the mnemonic accelerator key
- 'width-chars' (integer : default -1 : readable / writable /
private)
- The desired width of the label, in characters
- 'wrap' (boolean : default false : readable / writable /
private)
- If set, wrap lines if the text becomes too wide
- 'wrap-mode' (Pango::WrapMode : default "word" :
readable / writable / private)
- If wrap is set, controls how linewrapping is done
SIGNALS¶
- move-cursor (Gtk2::Label, Gtk2::MovementStep,
integer, boolean)
- copy-clipboard (Gtk2::Label)
- populate-popup (Gtk2::Label, Gtk2::Menu)
- activate-current-link (Gtk2::Label)
- boolean = activate-link (Gtk2::Label, string)
ENUMS AND FLAGS¶
enum Gtk2::Justification¶
- •
- 'left' / 'GTK_JUSTIFY_LEFT'
- •
- 'right' / 'GTK_JUSTIFY_RIGHT'
- •
- 'center' / 'GTK_JUSTIFY_CENTER'
- •
- 'fill' / 'GTK_JUSTIFY_FILL'
enum Gtk2::MovementStep¶
- •
- 'logical-positions' / 'GTK_MOVEMENT_LOGICAL_POSITIONS'
- •
- 'visual-positions' / 'GTK_MOVEMENT_VISUAL_POSITIONS'
- •
- 'words' / 'GTK_MOVEMENT_WORDS'
- •
- 'display-lines' / 'GTK_MOVEMENT_DISPLAY_LINES'
- •
- 'display-line-ends' / 'GTK_MOVEMENT_DISPLAY_LINE_ENDS'
- •
- 'paragraphs' / 'GTK_MOVEMENT_PARAGRAPHS'
- •
- 'paragraph-ends' / 'GTK_MOVEMENT_PARAGRAPH_ENDS'
- •
- 'pages' / 'GTK_MOVEMENT_PAGES'
- •
- 'buffer-ends' / 'GTK_MOVEMENT_BUFFER_ENDS'
- •
- 'horizontal-pages' / 'GTK_MOVEMENT_HORIZONTAL_PAGES'
enum Pango::EllipsizeMode¶
- •
- 'none' / 'PANGO_ELLIPSIZE_NONE'
- •
- 'start' / 'PANGO_ELLIPSIZE_START'
- •
- 'middle' / 'PANGO_ELLIPSIZE_MIDDLE'
- •
- 'end' / 'PANGO_ELLIPSIZE_END'
enum Pango::WrapMode¶
- •
- 'word' / 'PANGO_WRAP_WORD'
- •
- 'char' / 'PANGO_WRAP_CHAR'
- •
- 'word-char' / 'PANGO_WRAP_WORD_CHAR'
SEE ALSO¶
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget,
Gtk2::Misc
COPYRIGHT¶
Copyright (C) 2003-2011 by the gtk2-perl team.
This software is licensed under the LGPL. See Gtk2 for a full notice.