Gtk2::TextView(3)

NAME
Gtk2::TextView

HIERARCHY
  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::TextView

INTERFACES
  Glib::Object::_Unregistered::AtkImplementorIface
  Gtk2::Buildable

METHODS

  widget = Gtk2::TextView->new

  widget = Gtk2::TextView->new_with_buffer ($buffer)

•   $buffer (Gtk2::TextBuffer)

  boolean = $text_view->get_accepts_tab
Since: gtk+ 2.4

  $text_view->set_accepts_tab ($accepts_tab)

•   $accepts_tab (boolean)

Since: gtk+ 2.4

  $text_view->add_child_at_anchor ($child, $anchor)

•   $child (Gtk2::Widget)

•   $anchor (Gtk2::TextChildAnchor)

  $text_view->add_child_in_window ($child, $which_window, $xpos, $ypos)

•   $child (Gtk2::Widget)

•   $which_window (Gtk2::TextWindowType)

•   $xpos (integer)

•   $ypos (integer)

  boolean = $text_view->backward_display_line ($iter)

•   $iter (Gtk2::TextIter)

  boolean = $text_view->backward_display_line_start ($iter)

•   $iter (Gtk2::TextIter)

  integer = $text_view->get_border_window_size ($type)

•   $type (Gtk2::TextWindowType)

  $text_view->set_border_window_size ($type, $size)

•   $type (Gtk2::TextWindowType)

•   $size (integer)

  textbuffer = $text_view->get_buffer

  $text_view->set_buffer ($buffer)

•   $buffer (Gtk2::TextBuffer)

  (window_x, window_y) = $text_view->buffer_to_window_coords ($win, $buffer_x, $buffer_y)

•   $win (Gtk2::TextWindowType)

•   $buffer_x (integer)

•   $buffer_y (integer)

  boolean = $text_view->get_cursor_visible

  $text_view->set_cursor_visible ($setting)

•   $setting (boolean)

  textattributes = $text_view->get_default_attributes

  boolean = $text_view->get_editable

  $text_view->set_editable ($setting)

•   $setting (boolean)

  boolean = $text_view->forward_display_line ($iter)

•   $iter (Gtk2::TextIter)

  boolean = $text_view->forward_display_line_end ($iter)

•   $iter (Gtk2::TextIter)

  integer = $text_view->get_indent

  $text_view->set_indent ($indent)

•   $indent (integer)

  textiter = $text_view->get_iter_at_location ($x, $y)

•   $x (integer)

•   $y (integer)

  ($iter, $trailing) = $text_view->get_iter_at_position ($x, $y)

  $iter = $text_view->get_iter_at_position ($x, $y)

•   $x (integer)

•   $y (integer)

Retrieves the iterator pointing to the character at buffer coordinates x and y. Buffer coordinates are coordinates for the entire buffer, not just the currently-displayed portion. If you have coordinates from an event, you have to convert those to buffer coordinates with "$text_view->window_to_buffer_coords()".

Note that this is different from "$text_view->get_iter_at_location()", which returns cursor locations, i.e. positions between characters.

Since: gtk+ 2.6

  rectangle = $text_view->get_iter_location ($iter)

•   $iter (Gtk2::TextIter)

  justification = $text_view->get_justification

  $text_view->set_justification ($justification)

•   $justification (Gtk2::Justification)

  integer = $text_view->get_left_margin

  $text_view->set_left_margin ($left_margin)

•   $left_margin (integer)

  (target_iter, line_top) = $text_view->get_line_at_y ($y)

•   $y (integer)

  (y, height) = $text_view->get_line_yrange ($iter)

•   $iter (Gtk2::TextIter)

  $text_view->move_child ($child, $xpos, $ypos)

•   $child (Gtk2::Widget)

•   $xpos (integer)

•   $ypos (integer)

  boolean = $text_view->move_mark_onscreen ($mark)

•   $mark (Gtk2::TextMark)

  boolean = $text_view->move_visually ($iter, $count)

•   $iter (Gtk2::TextIter)

•   $count (integer)

  boolean = $text_view->get_overwrite
Since: gtk+ 2.4

  $text_view->set_overwrite ($overwrite)

•   $overwrite (boolean)

Since: gtk+ 2.4

  integer = $text_view->get_pixels_above_lines

  $text_view->set_pixels_above_lines ($pixels_above_lines)

•   $pixels_above_lines (integer)

  integer = $text_view->get_pixels_below_lines

  $text_view->set_pixels_below_lines ($pixels_below_lines)

•   $pixels_below_lines (integer)

  integer = $text_view->get_pixels_inside_wrap

  $text_view->set_pixels_inside_wrap ($pixels_inside_wrap)

•   $pixels_inside_wrap (integer)

  boolean = $text_view->place_cursor_onscreen

  integer = $text_view->get_right_margin

  $text_view->set_right_margin ($right_margin)

•   $right_margin (integer)

  $text_view->scroll_mark_onscreen ($mark)

•   $mark (Gtk2::TextMark)

  boolean = $text_view->scroll_to_iter ($iter, $within_margin, $use_align, $xalign, $yalign)

•   $iter (Gtk2::TextIter)

•   $within_margin (double)

•   $use_align (boolean)

•   $xalign (double)

•   $yalign (double)

  $text_view->scroll_to_mark ($mark, $within_margin, $use_align, $xalign, $yalign)

•   $mark (Gtk2::TextMark)

•   $within_margin (double)

•   $use_align (boolean)

•   $xalign (double)

•   $yalign (double)

  boolean = $text_view->starts_display_line ($iter)

•   $iter (Gtk2::TextIter)

  tabarray = $text_view->get_tabs

  $text_view->set_tabs ($tabs)

•   $tabs (Pango::TabArray)

  rectangle = $text_view->get_visible_rect

  window = $text_view->get_window ($win)

•   $win (Gtk2::TextWindowType)

  (buffer_x, buffer_y) = $text_view->window_to_buffer_coords ($win, $window_x, $window_y)

•   $win (Gtk2::TextWindowType)

•   $window_x (integer)

•   $window_y (integer)

  textwindowtype = $text_view->get_window_type ($window)

•   $window (Gtk2::Gdk::Window)

  wrapmode = $text_view->get_wrap_mode

  $text_view->set_wrap_mode ($wrap_mode)

•   $wrap_mode (Gtk2::WrapMode)

PROPERTIES

'accepts-tab' (boolean : default true : readable / writable / private)
    Whether Tab will result in a tab character being entered

'buffer' (Gtk2::TextBuffer : default undef : readable / writable / private)
    The buffer which is displayed

'cursor-visible' (boolean : default true : readable / writable / private)
    If the insertion cursor is shown

'editable' (boolean : default true : readable / writable / private)
    Whether the text can be modified by the user

'im-module' (string : default undef : readable / writable / private)
    Which IM module should be used

'indent' (integer : default 0 : readable / writable / private)
    Amount to indent the paragraph, in pixels

'justification' (Gtk2::Justification : default "left" : readable / writable / private)
    Left, right, or center justification

'left-margin' (integer : default 0 : readable / writable / private)
    Width of the left margin in pixels

'overwrite' (boolean : default false : readable / writable / private)
    Whether entered text overwrites existing contents

'pixels-above-lines' (integer : default 0 : readable / writable / private)
    Pixels of blank space above paragraphs

'pixels-below-lines' (integer : default 0 : readable / writable / private)
    Pixels of blank space below paragraphs

'pixels-inside-wrap' (integer : default 0 : readable / writable / private)
    Pixels of blank space between wrapped lines in a paragraph

'right-margin' (integer : default 0 : readable / writable / private)
    Width of the right margin in pixels

'tabs' (Pango::TabArray : default undef : readable / writable / private)
    Custom tabs for this text

'wrap-mode' (Gtk2::WrapMode : default "none" : readable / writable / private)
    Whether to wrap lines never, at word boundaries, or at character boundaries

SIGNALS

preedit-changed (Gtk2::TextView, string)
set-scroll-adjustments (Gtk2::TextView, Gtk2::Adjustment, Gtk2::Adjustment)
select-all (Gtk2::TextView, boolean)
move-cursor (Gtk2::TextView, Gtk2::MovementStep, integer, boolean)
page-horizontally (Gtk2::TextView, integer, boolean)
move-viewport (Gtk2::TextView, GtkScrollStep, integer)
set-anchor (Gtk2::TextView)
insert-at-cursor (Gtk2::TextView, string)
delete-from-cursor (Gtk2::TextView, Gtk2::DeleteType, integer)
backspace (Gtk2::TextView)
cut-clipboard (Gtk2::TextView)
copy-clipboard (Gtk2::TextView)
paste-clipboard (Gtk2::TextView)
toggle-overwrite (Gtk2::TextView)
populate-popup (Gtk2::TextView, Gtk2::Menu)
toggle-cursor-visible (Gtk2::TextView)

ENUMS AND FLAGS

  enum Gtk2::DeleteType

•   'chars' / 'GTK_DELETE_CHARS'

•   'word-ends' / 'GTK_DELETE_WORD_ENDS'

•   'words' / 'GTK_DELETE_WORDS'

•   'display-lines' / 'GTK_DELETE_DISPLAY_LINES'

•   'display-line-ends' / 'GTK_DELETE_DISPLAY_LINE_ENDS'

•   'paragraph-ends' / 'GTK_DELETE_PARAGRAPH_ENDS'

•   'paragraphs' / 'GTK_DELETE_PARAGRAPHS'

•   'whitespace' / 'GTK_DELETE_WHITESPACE'

  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 Gtk2::TextWindowType

•   'private' / 'GTK_TEXT_WINDOW_PRIVATE'

•   'widget' / 'GTK_TEXT_WINDOW_WIDGET'

•   'text' / 'GTK_TEXT_WINDOW_TEXT'

•   'left' / 'GTK_TEXT_WINDOW_LEFT'

•   'right' / 'GTK_TEXT_WINDOW_RIGHT'

•   'top' / 'GTK_TEXT_WINDOW_TOP'

•   'bottom' / 'GTK_TEXT_WINDOW_BOTTOM'

  enum Gtk2::WrapMode

•   'none' / 'GTK_WRAP_NONE'

•   'char' / 'GTK_WRAP_CHAR'

•   'word' / 'GTK_WRAP_WORD'

•   'word-char' / 'GTK_WRAP_WORD_CHAR'

  enum GtkScrollStep

•   'steps' / 'GTK_SCROLL_STEPS'

•   'pages' / 'GTK_SCROLL_PAGES'

•   'ends' / 'GTK_SCROLL_ENDS'

•   'horizontal-steps' / 'GTK_SCROLL_HORIZONTAL_STEPS'

•   'horizontal-pages' / 'GTK_SCROLL_HORIZONTAL_PAGES'

•   'horizontal-ends' / 'GTK_SCROLL_HORIZONTAL_ENDS'

SEE ALSO
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container

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

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