Gtk2::Label(3)						User Contributed Perl Documentation					    Gtk2::Label(3)

NAME

       Gtk2::Label

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)
       o   $str (string or undef)

   widget = Gtk2::Label->new_with_mnemonic ($str)
       o   $str (string)

   double = $label->get_angle
       Since: gtk+ 2.6

   $label->set_angle ($angle)
       o   $angle (double)

       Since: gtk+ 2.6

   attrlist = $label->get_attributes
   $label->set_attributes ($attrs)
       o   $attrs (Pango::AttrList)

   ellipsizemode = $label->get_ellipsize
       Since: gtk+ 2.6

   $label->set_ellipsize ($mode)
       o   $mode (Pango::EllipsizeMode)

       Since: gtk+ 2.6

   justification = $label->get_justify
   $label->set_justify ($jtype)
       o   $jtype (Gtk2::Justification)

   string = $label->get_label
   $label->set_label ($str)
       o   $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)
       o   $wrap_mode (Pango::WrapMode)

       Since: gtk+ 2.9

   $label->set_line_wrap ($wrap)
       o   $wrap (boolean)

   $label->set_markup ($str)
       o   $str (string)

   $label->set_markup_with_mnemonic ($str)
       o   $str (string)

   integer = $label->get_max_width_chars
       Since: gtk+ 2.6

   $label->set_max_width_chars ($n_chars)
       o   $n_chars (integer)

       Since: gtk+ 2.6

   integer = $label->get_mnemonic_keyval
   widget or undef = $label->get_mnemonic_widget
   $label->set_mnemonic_widget ($widget)
       o   $widget (Gtk2::Widget or undef)

   $label->set_pattern ($pattern)
       o   $pattern (string)

   $label->select_region ($start_offset=-1, $end_offset=-1)
       o   $start_offset (integer)

       o   $end_offset (integer)

   boolean = $label->get_selectable
   $label->set_selectable ($setting)
       o   $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)
       o   $single_line_mode (boolean)

       Since: gtk+ 2.6

   string or undef = $label->get_text
   $label->set_text ($str)
       o   $str (string or undef)

   $label->set_text_with_mnemonic ($str)
       o   $str (string)

   boolean = $label->get_use_markup
   $label->set_use_markup ($setting)
       o   $setting (boolean)

   boolean = $label->get_use_underline
   $label->set_use_underline ($setting)
       o   $setting (boolean)

   integer = $label->get_width_chars
       Since: gtk+ 2.6

   $label->set_width_chars ($n_chars)
       o   $n_chars (integer)

       Since: gtk+ 2.6

PROPERTIES

       'angle' (double : readable / writable / private)
	   Angle at which the label is rotated

       'attributes' (Pango::AttrList : readable / writable / private)
	   A list of style attributes to apply to the text of the label

       'cursor-position' (integer : readable / private)
	   The current position of the insertion cursor in chars

       'ellipsize' (Pango::EllipsizeMode : 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 : 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 : readable / writable / private)
	   The text of the label

       'max-width-chars' (integer : readable / writable / private)
	   The desired maximum width of the label, in characters

       'mnemonic-keyval' (Glib::UInt : readable / private)
	   The mnemonic accelerator key for this label

       'mnemonic-widget' (Gtk2::Widget : readable / writable / private)
	   The widget to be activated when the label's mnemonic key is pressed

       'pattern' (string : writable / private)
	   A string with _ characters in positions correspond to characters in the text to underline

       'selectable' (boolean : readable / writable / private)
	   Whether the label text can be selected with the mouse

       'selection-bound' (integer : readable / private)
	   The position of the opposite end of the selection from the cursor in chars

       'single-line-mode' (boolean : readable / writable / private)
	   Whether the label is in single line mode

       'track-visited-links' (boolean : readable / writable / private)
	   Whether visited links should be tracked

       'use-markup' (boolean : readable / writable / private)
	   The text of the label includes XML markup. See pango_parse_markup()

       'use-underline' (boolean : 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 : readable / writable / private)
	   The desired width of the label, in characters

       'wrap' (boolean : readable / writable / private)
	   If set, wrap lines if the text becomes too wide

       'wrap-mode' (Pango::WrapMode : 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
       o   'left' / 'GTK_JUSTIFY_LEFT'

       o   'right' / 'GTK_JUSTIFY_RIGHT'

       o   'center' / 'GTK_JUSTIFY_CENTER'

       o   'fill' / 'GTK_JUSTIFY_FILL'

   enum Gtk2::MovementStep
       o   'logical-positions' / 'GTK_MOVEMENT_LOGICAL_POSITIONS'

       o   'visual-positions' / 'GTK_MOVEMENT_VISUAL_POSITIONS'

       o   'words' / 'GTK_MOVEMENT_WORDS'

       o   'display-lines' / 'GTK_MOVEMENT_DISPLAY_LINES'

       o   'display-line-ends' / 'GTK_MOVEMENT_DISPLAY_LINE_ENDS'

       o   'paragraphs' / 'GTK_MOVEMENT_PARAGRAPHS'

       o   'paragraph-ends' / 'GTK_MOVEMENT_PARAGRAPH_ENDS'

       o   'pages' / 'GTK_MOVEMENT_PAGES'

       o   'buffer-ends' / 'GTK_MOVEMENT_BUFFER_ENDS'

       o   'horizontal-pages' / 'GTK_MOVEMENT_HORIZONTAL_PAGES'

   enum Pango::EllipsizeMode
       o   'none' / 'PANGO_ELLIPSIZE_NONE'

       o   'start' / 'PANGO_ELLIPSIZE_START'

       o   'middle' / 'PANGO_ELLIPSIZE_MIDDLE'

       o   'end' / 'PANGO_ELLIPSIZE_END'

   enum Pango::WrapMode
       o   'word' / 'PANGO_WRAP_WORD'

       o   'char' / 'PANGO_WRAP_CHAR'

       o   'word-char' / 'PANGO_WRAP_WORD_CHAR'

SEE ALSO

       Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Misc

COPYRIGHT

       Copyright (C) 2003-2008 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gtk2 for a full notice.

perl v5.12.1							    2010-07-05							    Gtk2::Label(3)