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

   widget = Gtk2::Label->new ($str=undef)
       •   $str (string or undef)

   widget = Gtk2::Label->new_with_mnemonic ($str)
       •   $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 or undef = $label->get_mnemonic_widget
   $label->set_mnemonic_widget ($widget)
       •   $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

       activate-current-link (Gtk2::Label)
       boolean = activate-link (Gtk2::Label, string)
       copy-clipboard (Gtk2::Label)
       move-cursor (Gtk2::Label, Gtk2::MovementStep, integer, boolean)
       populate-popup (Gtk2::Label, Gtk2::Menu)

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.