diff options
Diffstat (limited to 'docs/reference/pygtk-gtktextview.xml')
-rw-r--r-- | docs/reference/pygtk-gtktextview.xml | 3462 |
1 files changed, 0 insertions, 3462 deletions
diff --git a/docs/reference/pygtk-gtktextview.xml b/docs/reference/pygtk-gtktextview.xml deleted file mode 100644 index 2330395b..00000000 --- a/docs/reference/pygtk-gtktextview.xml +++ /dev/null @@ -1,3462 +0,0 @@ -<?xml version="1.0" standalone="no"?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> - -<refentry id="class-gtktextview"> - <refnamediv> - <refname>gtk.TextView</refname> - <refpurpose>a widget that displays the contents of a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link></refpurpose> - </refnamediv> - - <refsect1> - <title>Synopsis</title> - - <classsynopsis language="python"> - <ooclass><classname>gtk.TextView</classname></ooclass> - <ooclass><classname><link -linkend="class-gtkcontainer">gtk.Container</link></classname></ooclass> - <constructorsynopsis language="python"> - <methodname><link -linkend="constructor-gtktextview">gtk.TextView</link></methodname> - <methodparam><parameter - role="keyword">buffer</parameter><initializer>None</initializer></methodparam> - </constructorsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-buffer">set_buffer</link></methodname> - <methodparam><parameter - role="keyword">buffer</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-buffer">get_buffer</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--scroll-to-iter">scroll_to_iter</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - <methodparam><parameter - role="keyword">within_margin</parameter></methodparam> - <methodparam><parameter - role="keyword">use_align</parameter><initializer>False</initializer></methodparam> - <methodparam><parameter - role="keyword">xalign</parameter><initializer>0.5</initializer></methodparam> - <methodparam><parameter - role="keyword">yalign</parameter><initializer>0.5</initializer></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--scroll-to-mark">scroll_to_mark</link></methodname> - <methodparam><parameter - role="keyword">mark</parameter></methodparam> - <methodparam><parameter - role="keyword">within_margin</parameter></methodparam> - <methodparam><parameter - role="keyword">use_align</parameter><initializer>False</initializer></methodparam> - <methodparam><parameter - role="keyword">xalign</parameter><initializer>0.5</initializer></methodparam> - <methodparam><parameter - role="keyword">yalign</parameter><initializer>0.5</initializer></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--scroll-mark-onscreen">scroll_mark_onscreen</link></methodname> - <methodparam><parameter - role="keyword">mark</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--move-mark-onscreen">move_mark_onscreen</link></methodname> - <methodparam><parameter - role="keyword">mark</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--place-cursor-onscreen">place_cursor_onscreen</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-visible-rect">get_visible_rect</link></methodname> - <methodparam></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-cursor-visible">set_cursor_visible</link></methodname> - <methodparam><parameter - role="keyword">setting</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-cursor-visible">get_cursor_visible</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-iter-location">get_iter_location</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-iter-at-location">get_iter_at_location</link></methodname> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-line-yrange">get_line_yrange</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-line-at-y">get_line_at_y</link></methodname> - <methodparam><parameter - role="keyword">target_iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--buffer-to-window-coords">buffer_to_window_coords</link></methodname> - <methodparam><parameter role="keyword">win</parameter></methodparam> - <methodparam><parameter - role="keyword">buffer_x</parameter></methodparam> - <methodparam><parameter - role="keyword">buffer_y</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--window-to-buffer-coords">window_to_buffer_coords</link></methodname> - <methodparam><parameter role="keyword">win</parameter></methodparam> - <methodparam><parameter - role="keyword">window_x</parameter></methodparam> - <methodparam><parameter - role="keyword">window_y</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-window">get_window</link></methodname> - <methodparam><parameter role="keyword">win</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-window-type">get_window_type</link></methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-border-window-size">set_border_window_size</link></methodname> - <methodparam><parameter - role="keyword">type</parameter></methodparam> - <methodparam><parameter - role="keyword">size</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-border-window-size">get_border_window_size</link></methodname> - <methodparam><parameter - role="keyword">type</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--forward-display-line">forward_display_line</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--backward-display-line">backward_display_line</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--forward-display-line-end">forward_display_line_end</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--backward-display-line-start">backward_display_line_start</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--starts-display-line">starts_display_line</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--move-visually">move_visually</link></methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - <methodparam><parameter - role="keyword">count</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--add-child-at-anchor">add_child_at_anchor</link></methodname> - <methodparam><parameter - role="keyword">child</parameter></methodparam> - <methodparam><parameter - role="keyword">anchor</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--add-child-in-window">add_child_in_window</link></methodname> - <methodparam><parameter - role="keyword">child</parameter></methodparam> - <methodparam><parameter - role="keyword">which_window</parameter></methodparam> - <methodparam><parameter - role="keyword">xpos</parameter></methodparam> - <methodparam><parameter - role="keyword">ypos</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--move-child">move_child</link></methodname> - <methodparam><parameter - role="keyword">child</parameter></methodparam> - <methodparam><parameter - role="keyword">xpos</parameter></methodparam> - <methodparam><parameter - role="keyword">ypos</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-wrap-mode">set_wrap_mode</link></methodname> - <methodparam><parameter - role="keyword">wrap_mode</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-wrap-mode">get_wrap_mode</link></methodname> - <methodparam></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-editable">set_editable</link></methodname> - <methodparam><parameter - role="keyword">setting</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-editable">get_editable</link></methodname> - <methodparam></methodparam> - </methodsynopsis> - - <methodsynopsis language="python"> - <methodname><link linkend="method-gtktextview--set-overwrite">set_overwrite</link></methodname> - <methodparam><parameter - role="keyword">overwrite</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link linkend="method-gtktextview--get-overwrite">get_overwrite</link></methodname> - <methodparam></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link linkend="method-gtktextview--set-accepts-tab">set_accepts_tab</link></methodname> - <methodparam><parameter - role="keyword">accepts_tab</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link linkend="method-gtktextview--get-accepts-tab">get_accepts_tab</link></methodname> - <methodparam></methodparam> - </methodsynopsis> - - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-pixels-above-lines">set_pixels_above_lines</link></methodname> - <methodparam><parameter - role="keyword">pixels_above_lines</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-pixels-above-lines">get_pixels_above_lines</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-pixels-below-lines">set_pixels_below_lines</link></methodname> - <methodparam><parameter - role="keyword">pixels_below_lines</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-pixels-below-lines">get_pixels_below_lines</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-pixels-inside-wrap">set_pixels_inside_wrap</link></methodname> - <methodparam><parameter - role="keyword">pixels_inside_wrap</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-pixels-inside-wrap">get_pixels_inside_wrap</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-justification">set_justification</link></methodname> - <methodparam><parameter - role="keyword">justification</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-justification">get_justification</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-left-margin">set_left_margin</link></methodname> - <methodparam><parameter - role="keyword">left_margin</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-left-margin">get_left_margin</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-right-margin">set_right_margin</link></methodname> - <methodparam><parameter - role="keyword">right_margin</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-right-margin">get_right_margin</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-indent">set_indent</link></methodname> - <methodparam><parameter - role="keyword">indent</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-indent">get_indent</link></methodname> - <methodparam></methodparam> </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--set-tabs">set_tabs</link></methodname> - <methodparam><parameter - role="keyword">tabs</parameter></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-tabs">get_tabs</link></methodname> - <methodparam></methodparam> - </methodsynopsis> - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview--get-default-attributes">get_default_attributes</link></methodname> - <methodparam></methodparam> - </methodsynopsis> -<!-- NOT IMPLEMENTED - <methodsynopsis language="python"> - <methodname><link -linkend="method-gtktextview- -get-iter-at-position">get_iter_at_position</link></methodname> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis> -END OF NOT IMPLEMENTED --> - </classsynopsis> - - </refsect1> - - <refsect1> - <title>Ancestry</title> - -<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link> - +-- <link linkend="class-gtkobject">gtk.Object</link> - +-- <link linkend="class-gtkwidget">gtk.Widget</link> - +-- <link linkend="class-gtkcontainer">gtk.Container</link> - +-- <link linkend="class-gtktextview">gtk.TextView</link> -</synopsis> - - </refsect1> - - <refsect1 id="properties-gtktextview"> - <title>gtk.TextView Properties</title> - - <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para> - <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para> - <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para> - - <blockquote role="properties"> - <informaltable pgwide="1" frame="none"> - <tgroup cols="3"> - <colspec column="1" colwidth="1in"/> - <colspec column="2" colwidth="1in"/> - <colspec column="3" colwidth="4in"/> - <tbody> - - <row valign="top"> - <entry>"accepts-tab"</entry> - <entry>Read-Write</entry> - - <entry>If <literal>True</literal>, pressing -<keycap>Tab</keycap> will result in a tab character being entered; otherwise -the focus will be moved. Available in GTK+ 2.4 and above.</entry> - </row> - - <row valign="top"> - <entry>"buffer"</entry> - <entry>Read-Write</entry> - - <entry>The buffer that is displayed. Available in GTK+ 2.4 and -above.</entry> - </row> - - <row valign="top"> - <entry>"cursor-visible"</entry> - <entry>Read-Write</entry> - <entry>If <literal>True</literal>, the insertion cursor is -shown</entry> - </row> - - <row valign="top"> - <entry>"editable"</entry> - <entry>Read-Write</entry> - <entry>If <literal>True</literal>, the text can be modified by -the user by default</entry> - </row> - - <row valign="top"> - <entry>"indent"</entry> - <entry>Read-Write</entry> - <entry>The default amount to indent the paragraph, in -pixels</entry> - </row> - - <row valign="top"> - <entry>"justification"</entry> - <entry>Read-Write</entry> - <entry>The default text justification: -<literal>gtk.JUSTIFY_LEFT</literal>, <literal>gtk.JUSTIFY_RIGHT</literal>, -<literal>gtk.JUSTIFY_CENTER</literal> or -<literal>gtk.JUSTIFY_FILL</literal></entry> - </row> - - <row valign="top"> - <entry>"left-margin"</entry> - <entry>Read-Write</entry> - <entry>The default width of the left margin in pixels</entry> - </row> - - <row valign="top"> - <entry>"overwrite"</entry> - <entry>Read-Write</entry> - - <entry>If <literal>True</literal>, the entered text overwrites - existing contents. Available in GTK+ 2.4 and above.</entry> - </row> - - <row valign="top"> - <entry>"pixels-above-lines"</entry> - <entry>Read-Write</entry> - <entry>The default number of pixels of blank space above -paragraphs</entry> - </row> - - <row valign="top"> - <entry>"pixels-below-lines"</entry> - <entry>Read-Write</entry> - <entry>The default number of pixels of blank space below -paragraphs</entry> - </row> - - <row valign="top"> - <entry>"pixels-inside-wrap"</entry> - <entry>Read-Write</entry> - <entry>The default number of pixels of blank space between -wrapped lines in a paragraph</entry> - </row> - - <row valign="top"> - <entry>"right-margin"</entry> - <entry>Read-Write</entry> - <entry>The default width of the right margin in pixels</entry> - </row> - - <row valign="top"> - <entry>"tabs"</entry> - <entry>Read-Write</entry> - <entry>The default custom tabs</entry> - </row> - - <row valign="top"> - <entry>"wrap-mode"</entry> - <entry>Read-Write</entry> - <entry>The default wrap mode: -<literal>gtk.WRAP_NONE</literal>, <literal>gtk.WRAP_CHAR</literal> or -<literal>gtk.WRAP_WORD</literal></entry> - </row> - - </tbody> - </tgroup> - </informaltable> - </blockquote> - - </refsect1> - - <refsect1 id="style-properties-gtktextview"> - <title>gtk.TextView Style Properties</title> - - <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para> - - <blockquote role="properties"> - <informaltable pgwide="1" frame="none"> - <tgroup cols="3"> - <colspec column="1" colwidth="1in"/> - <colspec column="2" colwidth="1in"/> - <colspec column="3" colwidth="4in"/> - <tbody> - - <row valign="top"> - <entry>"error-underline-color"</entry> - <entry>Read-Write</entry> - - <entry>The <link -linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link> with -which to draw error-indication underlines. Available in GTK+ 2.4 and -above.</entry> - </row> - - </tbody> - </tgroup> - </informaltable> - </blockquote> - - </refsect1> - - <refsect1 id="signal-prototypes-gtktextview"> - <title>gtk.TextView Signal Prototypes</title> - - <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para> - <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para> - <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para> - <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para> - - <variablelist> - <varlistentry> - <term>"<link linkend="signal-gtktextview--backspace">backspace</link></term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--copy-clipboard">copy-clipboard</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--cut-clipboard">cut-clipboard</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--delete-from-cursor">delete-from-cursor</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>delete_type</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--insert-at-cursor">insert-at-cursor</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>string</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--move-cursor">move-cursor</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>step_size</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>extend_selection</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--move-focus">move-focus</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>direction</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--move-viewport">move-viewport</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>scrollstep</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--page-horizontally">page-horizontally</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>extend_selection</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--paste-clipboard">paste-clipboard</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--populate-popup">populate-popup</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>menu</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--select-all">select-all</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>select</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--set-anchor">set-anchor</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--set-scroll-adjustments">set-scroll-adjustments</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>hadjustment</parameter></methodparam> - <methodparam><parameter>vadjustment</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - <varlistentry> - <term>"<link linkend="signal-gtktextview--toggle-overwrite">toggle-overwrite</link>"</term> - <listitem> - <methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis> - </listitem> - </varlistentry> - </variablelist> - - </refsect1> - - <refsect1 id="description-gtktextview"> - <title>Description</title> - - <para>A <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> -widget provides the display for the contents of a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -object. A textview provides a set of attributes for the default display of -text from a textbuffer. The attributes set by <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> objects -override the attributes set on a <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> -widget. Since a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -can be associated with multiple <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> -widgets each having a different set of default attributes, the display of -the same text in different textview widgets can be quite different except -for those attributes that are overridden by texttags.</para> - - <para>A <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> -widget has several <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link> -widgets most of which are not displayed by default:</para> - - <variablelist> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_WIDGET</literal></term> - <listitem> - <simpara>The widget window</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_TEXT</literal></term> - <listitem> - <simpara>The window that holds the text</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_LEFT</literal></term> - <listitem> - <simpara>The left border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_RIGHT</literal></term> - <listitem> - <simpara>The right border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_TOP</literal></term> - <listitem> - <simpara>The top border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_BOTTOM</literal></term> - <listitem> - <simpara>The bottom border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_PRIVATE</literal></term> - <listitem> - <simpara>An internal inaccessible <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara> - </listitem> - </varlistentry> - </variablelist> - - <para>The border windows are not created until they are given a size by -using the <link -linkend="method-gtktextview--set-border-window-size"><methodname>set_border_window_size</methodname>()</link> -method.</para> - - <para>Depending on the wrap mode of the textview a textbuffer line may be -displayed as more than one screen display line. The textview has methods to -navigate through the display lines.</para> - - <para>A <link -linkend="class-gtktextchildanchor"><classname>gtk.TextChildAnchor</classname></link> -in a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -provides a place for a <literal>PyGTK</literal> widget to be placed in a -<link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link>. Each -textview displaying the same textbuffer with a child anchor must have a -different widget placed at that child anchor. In addition, a widget can be -placed at a specific location in one of the above <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> -windows using the <link -linkend="method-gtktextview--add-child-in-window"><methodname>add_child_in_window</methodname>()</link> -method. The widget will be clipped to the window boundaries if it is larger -than the window or located where it extends beyond the window -boundaries.</para> - - <para>A <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> has a -default popup menu that includes the usual cut, copy and paste -capabilities. In PyGTK 2.2 <link -linkend="class-gtkclipboard"><classname>gtk.Clipboard</classname></link> -objects are supported so your program can access the contents of the cut, -copy and paste clipboard through the -<literal>gdk.SELECTION_CLIPBOARD</literal> clipboard. Also the selected text -in a <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> is -available on the <literal>gdk.SELECTION_PRIMARY</literal> clipboard.</para> - - </refsect1> - - <refsect1 id="constructor-gtktextview"> - <title>Constructor</title> - - <programlisting><constructorsynopsis language="python"> - <methodname>gtk.TextView</methodname> - <methodparam><parameter - role="keyword">buffer</parameter><initializer>None</initializer></methodparam> - </constructorsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">buffer</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -or <literal>None</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a new <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link>.</simpara></listitem> - </varlistentry> - </variablelist> - - <para>Creates a new <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> -widget displaying the <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -specified by <parameter>buffer</parameter>. If <parameter>buffer</parameter> -is <literal>None</literal>, a new <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -will be created. One textbuffer can be shared among many widgets.</para> - - </refsect1> - - <refsect1> - <title>Methods</title> - - <refsect2 id="method-gtktextview--set-buffer"> - <title>gtk.TextView.set_buffer</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_buffer</methodname> - <methodparam><parameter - role="keyword">buffer</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">buffer</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_buffer</methodname>() method sets the <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -specified by <parameter>buffer</parameter> as the textbuffer being displayed -by the textview.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-buffer"> - <title>gtk.TextView.get_buffer</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_buffer</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_buffer</methodname>() method returns the -<link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link> -being displayed by this textview.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--scroll-to-iter"> - <title>gtk.TextView.scroll_to_iter</title> - - <programlisting><methodsynopsis language="python"> - <methodname>scroll_to_iter</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - <methodparam><parameter - role="keyword">within_margin</parameter></methodparam> - <methodparam><parameter - role="keyword">use_align</parameter><initializer>False</initializer></methodparam> - <methodparam><parameter - role="keyword">xalign</parameter><initializer>0.5</initializer></methodparam> - <methodparam><parameter - role="keyword">yalign</parameter><initializer>0.5</initializer></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> -object</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">within_margin</parameter> :</term> - <listitem><simpara>the margin as a [0.0,0.5) fraction of screen -size</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">use_align</parameter> :</term> - <listitem><simpara>if <literal>True</literal> use the alignment -arguments; if <literal>False</literal>, just get <parameter>iter</parameter> -on screen</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">xalign</parameter> :</term> - <listitem><simpara>the horizontal alignment of -<parameter>iter</parameter> within visible area.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">yalign</parameter> :</term> - <listitem><simpara>the vertical alignment of -<parameter>iter</parameter> within visible area</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if scrolling -occurred</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>scroll_to_iter</methodname>() method scrolls the -textview so that the <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> -location specified by <parameter>iter</parameter> is on the screen in the -position indicated by <parameter>xalign</parameter> and -<parameter>yalign</parameter>. If <parameter>use_align</parameter> is -<literal>True</literal> the alignments specify the fraction of screen space -to the left of or above the location of <parameter>iter</parameter>. If -<parameter>use_align</parameter> is <literal>False</literal>, the text -scrolls the minimal distance to get <parameter>iter</parameter> on screen, -possibly not scrolling at all. The effective screen for purposes of this -method is reduced by a margin of size specified by -<parameter>within_margin</parameter>.</para> - - <note> - <para>This method uses the currently-computed height of the lines in -the text buffer. The line heights are computed in an idle handler so this -method may not have the desired effect if it's called before the height -computations are complete. To avoid oddness, consider using the <link -linkend="method-gtktextview--scroll-to-mark"><methodname>scroll_to_mark</methodname>()</link> -method that saves a point to be scrolled to after line validation.</para> - </note> - - </refsect2> - - <refsect2 id="method-gtktextview--scroll-to-mark"> - <title>gtk.TextView.scroll_to_mark</title> - - <programlisting><methodsynopsis language="python"> - <methodname>scroll_to_mark</methodname> - <methodparam><parameter - role="keyword">mark</parameter></methodparam> - <methodparam><parameter - role="keyword">within_margin</parameter></methodparam> - <methodparam><parameter - role="keyword">use_align</parameter><initializer>False</initializer></methodparam> - <methodparam><parameter - role="keyword">xalign</parameter><initializer>0.5</initializer></methodparam> - <methodparam><parameter - role="keyword">yalign</parameter><initializer>0.5</initializer></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">mark</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextmark"><classname>gtk.TextMark</classname></link> -object</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">within_margin</parameter> :</term> - <listitem><simpara>the margin as a [0.0,0.5) fraction of screen -size</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">use_align</parameter> :</term> - <listitem><simpara>if <literal>True</literal> use the alignment -arguments; if <literal>False</literal>, just get <parameter>mark</parameter> -on screen</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">xalign</parameter> :</term> - <listitem><simpara>the horizontal alignment of -<parameter>mark</parameter> within the visible area.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">yalign</parameter> :</term> - <listitem><simpara>the vertical alignment of -<parameter>mark</parameter> within the visible area</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>scroll_to_mark</methodname>() method scrolls the -textview so that the <link -linkend="class-gtktextmark"><classname>gtk.TextMark</classname></link> -location specified by <parameter>mark</parameter> is on the screen in the -position specified by <parameter>xalign</parameter> and -<parameter>yalign</parameter>. If <parameter>use_align</parameter> is -<literal>True</literal> the alignments specify the fraction of screen space -to the left of or above the location of <parameter>mark</parameter>. If -<parameter>use_align</parameter> is <literal>False</literal>, the text -scrolls the minimal distance to get <parameter>mark</parameter> on screen, -possibly not scrolling at all. The effective screen for purposes of this -function is reduced by a margin of size specified by -<parameter>within_margin</parameter>.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--scroll-mark-onscreen"> - <title>gtk.TextView.scroll_mark_onscreen</title> - - <programlisting><methodsynopsis language="python"> - <methodname>scroll_mark_onscreen</methodname> - <methodparam><parameter - role="keyword">mark</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">mark</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextmark"><classname>gtk.TextMark</classname></link> in -the textbuffer for textview</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>scroll_mark_onscreen</methodname>() method -scrolls the textview the minimum distance to place the <link -linkend="class-gtktextmark"><classname>gtk.TextMark</classname></link> -location specified by <parameter>mark</parameter> within the visible area of -the widget.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--move-mark-onscreen"> - <title>gtk.TextView.move_mark_onscreen</title> - - <programlisting><methodsynopsis language="python"> - <methodname>move_mark_onscreen</methodname> - <methodparam><parameter - role="keyword">mark</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">mark</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextmark"><classname>gtk.TextMark</classname></link> -object</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if -<parameter>mark</parameter> moved (wasn't already -on screen)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>move_mark_onscreen</methodname>() moves the -<link linkend="class-gtktextmark"><classname>gtk.TextMark</classname></link> -location specified by <parameter>mark</parameter> to a location within the -currently-visible text area of the textview.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--place-cursor-onscreen"> - <title>gtk.TextView.place_cursor_onscreen</title> - - <programlisting><methodsynopsis language="python"> - <methodname>place_cursor_onscreen</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>True if the cursor had to be -moved.</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>place_cursor_onscreen</methodname>() method -moves the cursor to a new location within the currently visible region of -the buffer, if it isn't there already.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-visible-rect"> - <title>gtk.TextView.get_visible_rect</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_visible_rect</methodname> - <methodparam></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_visible_rect</methodname>() method returns a -<link -linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link> -containing the coordinates of the currently-visible region of the buffer. -The rectangle is in buffer coordinates that can be converted to window -coordinates with the <link -linkend="method-gtktextview--buffer-to-window-coords"><methodname>buffer_to_window_coords</methodname>()</link> -method.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-cursor-visible"> - <title>gtk.TextView.set_cursor_visible</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_cursor_visible</methodname> - <methodparam><parameter - role="keyword">setting</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">setting</parameter> :</term> - <listitem><simpara>if <literal>True</literal> show the insertion -cursor</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_cursor_visible</methodname>() method sets -the "cursor-visible" property to the value of -<parameter>setting</parameter>. If <parameter>setting</parameter> is -<literal>True</literal> the cursor is visible; if <literal>False</literal>, -it is not. A buffer with no editable text probably shouldn't have a visible -cursor, so you may want to turn the cursor off.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-cursor-visible"> - <title>gtk.TextView.get_cursor_visible</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_cursor_visible</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if the insertion mark -is visible</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_cursor_visible</methodname>() method returns -the value of the "cursor-visible" property that determines if the insertion -point is visible.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-iter-location"> - <title>gtk.TextView.get_iter_location</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_iter_location</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link> -containing the bounds of the character at -<parameter>iter</parameter></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_iter_location</methodname>() method returns -a <link -linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link> -that contains the character at the location specified by -<parameter>iter</parameter>. The rectangle position is in buffer coordinates -that can be converted to window coordinates with the <link -linkend="method-gtktextview--buffer-to-window-coords"><methodname>buffer_to_window_coords</methodname>()</link> -method.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-iter-at-location"> - <title>gtk.TextView.get_iter_at_location</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_iter_at_location</methodname> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>x position, in buffer -coordinates</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>y position, in buffer -coordinates</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_iter_at_location</methodname>() method -returns a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> that -points at the location specified by the buffer coordinates -<parameter>x</parameter> and <parameter>y</parameter>. Buffer coordinates -are coordinates for the entire buffer, not just the currently-displayed -portion. Window coordinates from an event, must be converted to buffer -coordinates with the <link -linkend="method-gtktextview--window-to-buffer-coords"><methodname>window_to_buffer_coords</methodname>()</link> -method before using them with this method.</para> - - </refsect2> - -<!-- NOT IMPLEMENTED - <refsect2 id="method-gtktextview- -get-iter-at-position"> - <title>gtk.TextView.get_iter_at_position</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_iter_at_position</methodname> - <methodparam><parameter role="keyword">x</parameter></methodparam> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">x</parameter> :</term> - <listitem><simpara>x position, in buffer -coordinates</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>y position, in buffer -coordinates</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a 2-tuple containing a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> and -an integer indicating where in the grapheme the user clicked. It will either -be zero, or the number of characters in the grapheme. 0 represents the -trailing edge of the grapheme.</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This method is available in PyGTK 2.8 and above.</para> - </note> - - <para>The <methodname>get_iter_at_position</methodname>() method -returns a 2-tuple containing a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> that -points at the location specified by the buffer coordinates -<parameter>x</parameter> and <parameter>y</parameter> and an integer -indicating where in the grapheme the user clicked. It will either be zero, -or the number of characters in the grapheme. 0 represents the trailing edge -of the grapheme.</para> - - <para>Buffer coordinates are coordinates for the entire buffer, not -just the currently-displayed portion. Window coordinates from an event, -must be converted to buffer coordinates with the <link -linkend="method-gtktextview- -window-to-buffer-coords"><methodname>window_to_buffer_coords</methodname>()</link> -method before using them with this method.</para> - - <para>Note that this method is different from the <link -linkend="method-gtktextview- -get-iter-at-location"><methodname>get_iter_at_location</methodname>()</link> -method that returns cursor locations, i.e. positions between -characters.</para> - - </refsect2> -END OF NOT IMPLEMENTED --> - - <refsect2 id="method-gtktextview--get-line-yrange"> - <title>gtk.TextView.get_line_yrange</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_line_yrange</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a tuple containing a y coordinate and a -height</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_line_yrange</methodname>() method locates -the line containing the <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> -specified by <parameter>iter</parameter> and returns a tuple containing the -y coordinate of the top of the line and the height of the line. The -coordinate is a buffer coordinate that can be converted to window -coordinates with the <link -linkend="method-gtktextview--buffer-to-window-coords"><methodname>buffer_to_window_coords</methodname>()</link> -method.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-line-at-y"> - <title>gtk.TextView.get_line_at_y</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_line_at_y</methodname> - <methodparam><parameter role="keyword">y</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">y</parameter> :</term> - <listitem><simpara>a y coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a tuple containing a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> -pointing at the line start and the top coordinate of the -line</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_line_at_y</methodname>() method returns a -tuple containing:</para> - - <itemizedlist> - <listitem> - <simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link> -pointing at the start of the line with the vertical coordinate specified by -<parameter>y</parameter> and,</simpara> - </listitem> - <listitem> - <simpara>the vertical coordinate of the top edge of the -line.</simpara> - </listitem> - </itemizedlist> - - <para><parameter>y</parameter> is in buffer coordinates that can be -converted from window coordinates with the <link -linkend="method-gtktextview--window-to-buffer-coords"><methodname>window_to_buffer_coords</methodname>()</link> -method.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--buffer-to-window-coords"> - <title>gtk.TextView.buffer_to_window_coords</title> - - <programlisting><methodsynopsis language="python"> - <methodname>buffer_to_window_coords</methodname> - <methodparam><parameter - role="keyword">win</parameter></methodparam> - <methodparam><parameter - role="keyword">buffer_x</parameter></methodparam> - <methodparam><parameter - role="keyword">buffer_y</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">win</parameter> :</term> - <listitem><simpara>one of the textview windows except -<literal>gtk.TEXT_WINDOW_PRIVATE</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">buffer_x</parameter> :</term> - <listitem><simpara>buffer x coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">buffer_y</parameter> :</term> - <listitem><simpara>buffer y coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a tuple containing the window x and y -coordinates</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>buffer_to_window_coords</methodname>() method -returns a tuple containing the x and y coordinates for the window specified -by <parameter>win</parameter> that correspond to the textbuffer coordinates -specified by <parameter>buffer_x</parameter> and -<parameter>buffer_y</parameter>. See the above <link -linkend="description-gtktextview">description</link> for more details on -textview window types.</para> - - <note> - <para>You can't convert coordinates for a non-existing window (see -the <link -linkend="method-gtktextview--set-border-window-size"><methodname>set_border_window_size</methodname>()</link> -method).</para> - </note> - - </refsect2> - - <refsect2 id="method-gtktextview--window-to-buffer-coords"> - <title>gtk.TextView.window_to_buffer_coords</title> - - <programlisting><methodsynopsis language="python"> - <methodname>window_to_buffer_coords</methodname> - <methodparam><parameter - role="keyword">win</parameter></methodparam> - <methodparam><parameter - role="keyword">window_x</parameter></methodparam> - <methodparam><parameter - role="keyword">window_y</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">win</parameter> :</term> - <listitem><simpara>a textview window except -<literal>gtk.TEXT_WINDOW_PRIVATE</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">window_x</parameter> :</term> - <listitem><simpara>window x coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">window_y</parameter> :</term> - <listitem><simpara>window y coordinate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a tuple containing the textbuffer x and y -coordinates</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>window_to_buffer_coords</methodname>() method -returns a tuple containing the textbuffer x and y coordinates corresponding -to the <parameter>window_x</parameter> and<parameter> window_y</parameter> -coordinates in the window specified by <parameter>win</parameter>, See the -above <link linkend="description-gtktextview">description</link> for more -details on textview window types.</para> - - <note> - <para>You can't convert coordinates for a non-existing window (see -the <link -linkend="method-gtktextview--set-border-window-size"><methodname>set_border_window_size</methodname>()</link>) -method.</para> - </note> - - </refsect2> - - <refsect2 id="method-gtktextview--get-window"> - <title>gtk.TextView.get_window</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_window</methodname> - <methodparam><parameter - role="keyword">win</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">win</parameter> :</term> - <listitem><simpara>a textview window type</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link>, or -<literal>None</literal></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_window</methodname>() method returns the -<link linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link> -corresponding to an area of the textview specified by -<parameter>win</parameter>:</para> - - <variablelist> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_WIDGET</literal></term> - <listitem> - <simpara>The widget window</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_TEXT</literal></term> - <listitem> - <simpara>The window that holds the text</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_LEFT</literal></term> - <listitem> - <simpara>The left border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_RIGHT</literal></term> - <listitem> - <simpara>The right border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_TOP</literal></term> - <listitem> - <simpara>The top border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_BOTTOM</literal></term> - <listitem> - <simpara>The bottom border window - not displayed by -default</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.TEXT_WINDOW_PRIVATE</literal></term> - <listitem> - <simpara>An internal inaccessible <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link></simpara> - </listitem> - </varlistentry> - </variablelist> - - <para>This method returns <literal>None</literal> if the window is -nonexistent i.e. if its width or height is 0.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-window-type"> - <title>gtk.TextView.get_window_type</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_window_type</methodname> - <methodparam><parameter - role="keyword">window</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">window</parameter> :</term> - <listitem><simpara>a window type</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the window type.</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_window_type</methodname>() method returns -the type of the <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link> -specified by <parameter>window</parameter>. This method is used to find out -what window type an event corresponds to. If you connect to an event signal -on the textview, this method can be called on -<literal>event.window</literal> to see what window type it was. See the -<link -linkend="method-gtktextview--get-window"><methodname>get_window</methodname>()</link> -method for more details on window types.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-border-window-size"> - <title>gtk.TextView.set_border_window_size</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_border_window_size</methodname> - <methodparam><parameter - role="keyword">type</parameter></methodparam> - <methodparam><parameter - role="keyword">size</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">type</parameter> :</term> - <listitem><simpara>a textview border window -type</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">size</parameter> :</term> - <listitem><simpara>the width or height of the -window</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_border_window_size</methodname>() method -sets the width of a <literal>gtk.TEXT_WINDOW_LEFT</literal> or -<literal>gtk.TEXT_WINDOW_RIGHT</literal> window, or the height of a -<literal>gtk.TEXT_WINDOW_TOP</literal> or -<literal>gtk.TEXT_WINDOW_BOTTOM</literal> window. This method automatically -destroys the corresponding window if the size is set to 0, and creates the -window if the size is set to non-zero. This method can only be used for the -"border windows", it doesn't work with the -<literal>gtk.TEXT_WINDOW_WIDGET</literal>, -<literal>gtk.TEXT_WINDOW_TEXT</literal>, or -<literal>gtk.TEXT_WINDOW_PRIVATE</literal> windows.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-border-window-size"> - <title>gtk.TextView.get_border_window_size</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_border_window_size</methodname> - <methodparam><parameter - role="keyword">type</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">type</parameter> :</term> - <listitem><simpara>a textview border window -type</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the width or height of the textview border -window</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_border_window_size</methodname>() method -returns the width or height of the border window of the type specified by -<parameter>type</parameter>. See the <link -linkend="method-gtktextview--set-border-window-size"><methodname>set_border_window_size</methodname>()</link> -method for more details.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--forward-display-line"> - <title>gtk.TextView.forward_display_line</title> - - <programlisting><methodsynopsis language="python"> - <methodname>forward_display_line</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if -<parameter>iter</parameter> was moved and is not on the end -iterator</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>forward_display_line</methodname>() method moves -the location of <parameter>iter</parameter> forward by one display line. A -textview display line is different from a textbuffer line. Textbuffer lines -are paragraphs and are separated by newlines or other paragraph separator -characters. Display lines are created by line-wrapping a textbuffer line. If -wrapping is turned off, display lines and textbuffer lines will be the same. -Display lines are divided differently for each textview, since they depend -on the textview's width and the textview's default wrap mode. Paragraphs are -the same in all views, since they depend on the contents of the <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link>. -This method returns <literal>True</literal> if the location of -<parameter>iter</parameter> moves to a dereferenceable position (i.e. not -the end position).</para> - - </refsect2> - - <refsect2 id="method-gtktextview--backward-display-line"> - <title>gtk.TextView.backward_display_line</title> - - <programlisting><methodsynopsis language="python"> - <methodname>backward_display_line</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if -<parameter>iter</parameter> was moved</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>backward_display_line</methodname>() method -moves the location of <parameter>iter</parameter> backward by one display -line. A textview display line is different from a textbuffer line. Textview -lines are paragraphs and are separated by newlines or other paragraph -separator characters. Display lines are created by line-wrapping a -textbuffer line. If wrapping is turned off, display lines and textbuffer -lines will be the same. Display lines are divided differently for each -textview, since they depend on the textview's width and the textview's -default wrap mode. Paragraphs are the same in all views, since they depend -on the contents of the <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link>. -This method returns <literal>True</literal> if the location of -<parameter>iter</parameter> moves to a dereferenceable position (i.e. not -the end position).</para> - - </refsect2> - - <refsect2 id="method-gtktextview--forward-display-line-end"> - <title>gtk.TextView.forward_display_line_end</title> - - <programlisting><methodsynopsis language="python"> - <methodname>forward_display_line_end</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if -<parameter>iter</parameter> was moved and is not on the end -iterator</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>forward_display_line_end</methodname>() method -moves the location of <parameter>iter</parameter> forward to the next -display line end. A textview display line is different from a textbuffer -line. Textbuffer lines are paragraphs and are separated by newlines or other -paragraph separator characters. Display lines are created by line-wrapping a -textbuffer line. If wrapping is turned off, display lines and textbuffer -lines will be the same. Display lines are divided differently for each -textview, since they depend on the textview's width and the textview's -default wrap mode. Paragraphs are the same in all views, since they depend -on the contents of the <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link>. -This method returns <literal>True</literal> if the location of -<parameter>iter</parameter> moves to a dereferenceable position (i.e. not -the end position).</para> - - </refsect2> - - <refsect2 id="method-gtktextview--backward-display-line-start"> - <title>gtk.TextView.backward_display_line_start</title> - - <programlisting><methodsynopsis language="python"> - <methodname>backward_display_line_start</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if -<parameter>iter</parameter> was moved</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>backward_display_line_start</methodname>() -method moves the location of <parameter>iter</parameter> backward to the -next display line start. A textview display line is different from a -textbuffer line. Textbuffer lines are paragraphs and are separated by newlines -or other paragraph separator characters. Display lines are created by -line-wrapping a textbuffer line. If wrapping is turned off, display lines -and textbuffer lines will be the same. Display lines are divided differently -for each textview, since they depend on the textview's width and the -textview's default wrap mode. Paragraphs are the same in all views, since -they depend on the contents of the <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link>. -This method returns <literal>True</literal> if the location of -<parameter>iter</parameter> moves to a dereferenceable position (i.e. not -the end position).</para> - - </refsect2> - - <refsect2 id="method-gtktextview--starts-display-line"> - <title>gtk.TextView.starts_display_line</title> - - <programlisting><methodsynopsis language="python"> - <methodname>starts_display_line</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if the location of -<parameter>iter</parameter> is at the beginning of a display -line</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>starts_display_line</methodname>() method -returns <literal>True</literal> if the location of -<parameter>iter</parameter> is at the start of a display line. See the <link -linkend="method-gtktextview--forward-display-line"><methodname>forward_display_line</methodname>()</link> -method for an explanation of display lines vs. textbuffer lines -(paragraphs).</para> - - </refsect2> - - <refsect2 id="method-gtktextview--move-visually"> - <title>gtk.TextView.move_visually</title> - - <programlisting><methodsynopsis language="python"> - <methodname>move_visually</methodname> - <methodparam><parameter - role="keyword">iter</parameter></methodparam> - <methodparam><parameter - role="keyword">count</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">iter</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextiter"><classname>gtk.TextIter</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">count</parameter> :</term> - <listitem><simpara>the number of characters to move (may be -negative)</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if -<parameter>iter</parameter> moved and is not on the end -iterator</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The<methodname> move_visually</methodname>() method moves the -location of <parameter>iter</parameter> by <parameter>count</parameter> -cursor positions. If count is negative the location moves against the -normal text direction. Note a cursor position move may move over multiple -characters when multiple characters combine to form one grapheme.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--add-child-at-anchor"> - <title>gtk.TextView.add_child_at_anchor</title> - - <programlisting><methodsynopsis language="python"> - <methodname>add_child_at_anchor</methodname> - <methodparam><parameter - role="keyword">child</parameter></methodparam> - <methodparam><parameter - role="keyword">anchor</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">child</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">anchor</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtktextchildanchor"><classname>gtk.TextChildAnchor</classname></link> -in the textview's <link -linkend="class-gtktextbuffer"><classname>gtk.TextBuffer</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>add_child_at_anchor</methodname>() method adds -the widget specified by <parameter>child</parameter> in the textview, at the -<link -linkend="class-gtktextchildanchor"><classname>gtk.TextChildAnchor</classname></link> -specified by <parameter>anchor</parameter>.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--add-child-in-window"> - <title>gtk.TextView.add_child_in_window</title> - - <programlisting><methodsynopsis language="python"> - <methodname>add_child_in_window</methodname> - <methodparam><parameter - role="keyword">child</parameter></methodparam> - <methodparam><parameter - role="keyword">which_window</parameter></methodparam> - <methodparam><parameter - role="keyword">xpos</parameter></methodparam> - <methodparam><parameter - role="keyword">ypos</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">child</parameter> :</term> - <listitem><simpara>a <link -linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter -role="keyword">which_window</parameter> :</term> - <listitem><simpara>the textview window -<parameter>child</parameter> should appear in</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">xpos</parameter> :</term> - <listitem><simpara>the X position of <parameter>child</parameter> -in window coordinates</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">ypos</parameter> :</term> - <listitem><simpara>the Y position of <parameter>child</parameter> -in window coordinates</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>add_child_in_window</methodname>() method adds -the widget specified by <parameter>child</parameter> at the fixed -coordinates specified by <parameter>xpos</parameter> and -<parameter>ypos</parameter> in one of the text widget's windows specified by -<parameter>which_window</parameter>. The window must have nonzero size (see -the <link -linkend="method-gtktextview--set-border-window-size"><methodname>set_border_window_size</methodname>()</link> -method).</para> - - <note> - <para>The <parameter>child</parameter> coordinates are given -relative to the <link -linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link> -specified by <parameter>which_window</parameter>, and these coordinates have -no sane relationship to scrolling. When placing <parameter>child</parameter> -in a <literal>gtk.TEXT_WINDOW_WIDGET</literal> window, scrolling is -irrelevant, <parameter>child</parameter> floats above all scrollable areas. -However, placing <parameter>child</parameter> in one of the scrollable -windows (a border windows or the text window), you'll need to compute the -correct position of <parameter>child</parameter> in textbuffer coordinates -any time scrolling occurs or textbuffer changes occur, and then call the -<link -linkend="method-gtktextview--move-child"><methodname>move_child</methodname>()</link> -method to update the child's position. Unfortunately there's no good way to -detect that scrolling has occurred, using the current API; a possible hack -would be to update all child positions when the scroll adjustments change or -the text buffer changes.</para> - </note> - - </refsect2> - - <refsect2 id="method-gtktextview--move-child"> - <title>gtk.TextView.move_child</title> - - <programlisting><methodsynopsis language="python"> - <methodname>move_child</methodname> - <methodparam><parameter - role="keyword">child</parameter></methodparam> - <methodparam><parameter - role="keyword">xpos</parameter></methodparam> - <methodparam><parameter - role="keyword">ypos</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">child</parameter> :</term> - <listitem><simpara>a child widget in the -textview</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">xpos</parameter> :</term> - <listitem><simpara>the new X position in window -coordinates</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter role="keyword">ypos</parameter> :</term> - <listitem><simpara>the new Y position in window -coordinates</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>move_child</methodname>() method moves the -position of <parameter>child</parameter> to the location (in its current -window) specified by <parameter>xpos</parameter> and -<parameter>ypos</parameter>.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-wrap-mode"> - <title>gtk.TextView.set_wrap_mode</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_wrap_mode</methodname> - <methodparam><parameter - role="keyword">wrap_mode</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">wrap_mode</parameter> :</term> - <listitem><simpara>a wrap mode value</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_wrap_mode</methodname>() method sets the -"wrap-mode" property of the textview to the value specified by -<parameter>wrap_mode</parameter>. The value of wrap_mode can be one of: -<literal>gtk.WRAP_NONE</literal>, <literal>gtk.WRAP_CHAR</literal> or -<literal>gtk.WRAP_WORD</literal>. The "wrap-mode" property defines the wrap -mode for text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "wrap_mode" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-wrap-mode"> - <title>gtk.TextView.get_wrap_mode</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_wrap_mode</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the line wrap setting</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_wrap_mode</methodname>() method returns the -value of the "wrap-mode" property. The value of "wrap-mode" can be one of: -<literal>gtk.WRAP_NONE</literal>, <literal>gtk.WRAP_CHAR</literal> or -<literal>gtk.WRAP_WORD</literal>. The "wrap-mode" property defines the wrap -mode for text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "wrap_mode" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-editable"> - <title>gtk.TextView.set_editable</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_editable</methodname> - <methodparam><parameter - role="keyword">setting</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">setting</parameter> :</term> - <listitem><simpara>if <literal>True</literal> the text is editable -by default</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_editable</methodname>() method sets the -"editable" property to the value of <parameter>setting</parameter>. If -<parameter>setting</parameter> is <literal>True</literal> the text in -textview is editable by default. The "editable" property determines the -editability of the <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> text -that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "editable" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-editable"> - <title>gtk.TextView.get_editable</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_editable</methodname> - <methodparam></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><parameter>True</parameter> if text is editable -by default</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_editable</methodname>() method returns the -value of the "editable" property. The "editable" property determines the -editability of the <link -linkend="class-gtktextview"><classname>gtk.TextView</classname></link> text -that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "editable" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-overwrite"> - <title>gtk.TextView.set_overwrite</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_overwrite</methodname> - <methodparam><parameter role="keyword">overwrite</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter - role="keyword">overwrite</parameter> :</term> - <listitem><simpara>if <literal>True</literal> turn on overwrite - mode; if <literal>False</literal> turn it off</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This method is available in PyGTK 2.4 and above.</para> - </note> - - <para>The <methodname>set_overwrite</methodname>() method sets the -"overwrite" property to the value of <parameter>overwrite</parameter>. If -<parameter>overwrite</parameter> is <literal>True</literal>, inserted text -overwrites the existing text.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-overwrite"> - <title>gtk.TextView.get_overwrite</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_overwrite</methodname> - <methodparam></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if the textview is in - overwrite mode</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This method is available in PyGTK 2.4 and above.</para> - </note> - - <para>The <methodname>get_overwrite</methodname>() method returns the -value of the "overwrite" property. see the <link -linkend="method-gtktextview--set-overwrite"><methodname>set_overwrite</methodname>()</link> -method for more information.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-accepts-tab"> - <title>gtk.TextView.set_accepts_tab</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_accepts_tab</methodname> - <methodparam><parameter role="keyword">accepts_tab</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter - role="keyword">accepts_tab</parameter> :</term> - <listitem><simpara>if <literal>True</literal> pressing the - <keycap>Tab</keycap> key should insert a tab character; if - <literal>False</literal>, pressing the <keycap>Tab</keycap> key - should move the keyboard focus.</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This method is available in PyGTK 2.4 and above.</para> - </note> - - <para>The <methodname>set_accepts_tab</methodname>() method sets the -"accepts_tab" property to the value of -<parameter>accepts_tab</parameter>. If <parameter>accepts_tab</parameter> is -<literal>True</literal> a tab character is inserted. If -<parameter>accepts_tab</parameter> is <literal>False</literal> the keyboard -focus is moved to the next widget in the focus chain.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-accepts-tab"> - <title>gtk.TextView.get_accepts_tab</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_accepts_tab</methodname> - <methodparam></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>True</literal> if pressing the - <keycap>Tab</keycap> key inserts a tab character, - <literal>False</literal> if pressing the <keycap>Tab</keycap> key - moves the keyboard focus.</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This method is available in PyGTK 2.4 and above.</para> - </note> - - <para>The <methodname>get_accepts_tab</methodname>() method returns -the value of the "accepts_tab" property. See the <link -linkend="method-gtktextview--set-accepts-tab"><methodname>set_accepts_tab()</methodname></link> -method for more information.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-pixels-above-lines"> - <title>gtk.TextView.set_pixels_above_lines</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_pixels_above_lines</methodname> - <methodparam><parameter - role="keyword">pixels_above_lines</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">pixels_above_lines</parameter> :</term> - <listitem><simpara>the number of pixels above -paragraphs</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_pixels_above_lines</methodname>() method -sets the "pixels-above-lines" property to the value of -<parameter>pixels_above_lines</parameter>. The "pixels-above-lines" property -determines the number of blank pixels to place above textbuffer lines -(paragraphs) in the textview for text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "pixels-above-lines" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-pixels-above-lines"> - <title>gtk.TextView.get_pixels_above_lines</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_pixels_above_lines</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default number of pixels above -paragraphs</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_pixels_above_lines</methodname>() method -returns the value of the "pixels-above-lines" property. The -"pixels-above-lines" property determines the number of pixels to put above -textbuffer lines (paragraphs) in the textview for text that is not -influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "pixels-above-lines" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-pixels-below-lines"> - <title>gtk.TextView.set_pixels_below_lines</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_pixels_below_lines</methodname> - <methodparam><parameter - role="keyword">pixels_below_lines</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">pixels_below_lines</parameter> :</term> - <listitem><simpara>the default number of pixels below -paragraphs</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_pixels_below_lines</methodname>() method -sets the "pixels-below-lines" property to the value of -<parameter>pixels_below_lines</parameter>. The "pixels-below-lines" property -determines the number of blank pixels to place below textbuffer lines -(paragraphs) in the textview for text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "pixels-below-lines" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-pixels-below-lines"> - <title>gtk.TextView.get_pixels_below_lines</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_pixels_below_lines</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default number of blank pixels below -paragraphs</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_pixels_below_lines</methodname>() method -returns the value of the "pixels-below-lines" property. The -"pixels-below-lines" property determines the number of pixels to put below -textbuffer lines (paragraphs) in the textview for text that is not -influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "pixels-below-lines" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-pixels-inside-wrap"> - <title>gtk.TextView.set_pixels_inside_wrap</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_pixels_inside_wrap</methodname> - <methodparam><parameter - role="keyword">pixels_inside_wrap</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">pixels_inside_wrap</parameter> :</term> - <listitem><simpara>the default number of pixels between wrapped -lines</simpara></listitem> - </varlistentry> - </variablelist> - <para>The <methodname>set_pixels_inside_wrap</methodname>() method -sets the "pixels-inside_wrap" property to the value of -<parameter>pixels_inside_wrap</parameter>. The "pixels-inside_wrap" property -determines the number of blank pixels to place between wrapped textbuffer -lines (inside paragraphs) for text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "pixels-inside_wrap" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-pixels-inside-wrap"> - <title>gtk.TextView.get_pixels_inside_wrap</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_pixels_inside_wrap</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default number of pixels of blank space -between wrapped lines</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_pixels_inside_wrap</methodname>() method -returns the value of the "pixels-inside-wrap" property. The -"pixels-inside-wrap" property determines the number of pixels to put between -wrapped textbuffer lines (inside paragraphs) for text that is not influenced -by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "pixels-inside-wrap" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-justification"> - <title>gtk.TextView.set_justification</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_justification</methodname> - <methodparam><parameter - role="keyword">justification</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">justification</parameter> :</term> - <listitem><simpara>the text justification</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_justification</methodname>() method sets the -"justification" property to the value of -<parameter>justification</parameter>. The value of justification must be one -of: <literal>gtk.JUSTIFY_LEFT</literal>, -<literal>gtk.JUSTIFY_RIGHT</literal>, <literal>gtk.JUSTIFY_CENTER</literal> -or <literal>gtk.JUSTIFY_FILL</literal>. The "justification" property -determines the justification of text in the textview that is not influenced -by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -set its "justification" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-justification"> - <title>gtk.TextView.get_justification</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_justification</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default justification</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_justification</methodname>() method returns -the value of the "justification" property. the default justification of -paragraphs in <parameter>text_view</parameter>. The value of "justification" -must be one of: <literal>gtk.JUSTIFY_LEFT</literal>, -<literal>gtk.JUSTIFY_RIGHT</literal>, <literal>gtk.JUSTIFY_CENTER</literal> -or <literal>gtk.JUSTIFY_FILL</literal>. The "justification" property -determines the justification of text in the textview that is not influenced -by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -set its "justification" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-left-margin"> - <title>gtk.TextView.set_left_margin</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_left_margin</methodname> - <methodparam><parameter - role="keyword">left_margin</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">left_margin</parameter> :</term> - <listitem><simpara>the default left margin in pixels</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_left_margin</methodname>() method sets the -"left-margin" property to the value of <parameter>left_margin</parameter>. -The "left-margin"property determines the number of pixels of space for the -left margin of text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "left_margin" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-left-margin"> - <title>gtk.TextView.get_left_margin</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_left_margin</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default left margin in -pixels</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_left_margin</methodname>() method returns -the value of the "left_margin" property. The "left-margin"property -determines the number of pixels of space for the left margin of text that -is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "left_margin" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-right-margin"> - <title>gtk.TextView.set_right_margin</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_right_margin</methodname> - <methodparam><parameter - role="keyword">right_margin</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter -role="keyword">right_margin</parameter> :</term> - <listitem><simpara>the default right margin in -pixels</simpara></listitem> - </varlistentry> - </variablelist> - <para>The <methodname>set_right_margin</methodname>() method sets the -"right-margin" property to the value of <parameter>right_margin</parameter>. -The "right-margin"property determines the number of pixels of space for the -right margin of text that is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "right_margin" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-right-margin"> - <title>gtk.TextView.get_right_margin</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_right_margin</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default right margin in -pixels</simpara></listitem> - </varlistentry> - </variablelist> - <para>The <methodname>get_right_margin</methodname>() method returns -the value of the "right_margin" property. The "right-margin"property -determines the number of pixels of space for the right margin of text that -is not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "right_margin" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-indent"> - <title>gtk.TextView.set_indent</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_indent</methodname> - <methodparam><parameter - role="keyword">indent</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">indent</parameter> :</term> - <listitem><simpara>the default indentation in -pixels</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_indent</methodname>() method sets the -"indent" property to the value of <parameter>indent</parameter>. The -"indent" property determines the indentation for textview paragraphs that -are not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "indent" attribute. The indentation may be negative.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-indent"> - <title>gtk.TextView.get_indent</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_indent</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>the default number of pixels of -indentation</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_indent</methodname>() method returns the -value of the "indent" property. The "indent" property determines the -indentation for textview paragraphs that are not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "indent" attribute. The indentation may be negative.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--set-tabs"> - <title>gtk.TextView.set_tabs</title> - - <programlisting><methodsynopsis language="python"> - <methodname>set_tabs</methodname> - <methodparam><parameter - role="keyword">tabs</parameter></methodparam> - </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><parameter role="keyword">tabs</parameter> :</term> - <listitem><simpara>the default tabs as a <link -linkend="class-pangotabarray"><classname>pango.TabArray</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>set_tabs</methodname>() method sets the "tabs" -property to a copy of the value of <parameter>tabs</parameter>. The "tabs" -property contains the custom tab stops for the textview paragraphs that are -not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "tabs" attribute.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-tabs"> - <title>gtk.TextView.get_tabs</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_tabs</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a copy of default tab array, or -<literal>None</literal> if "standard" tabs are used</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_tabs</methodname>() method returns the value -of the "tabs" property. The "tabs" property contains the custom tab stops -for the textview paragraphs that are not influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link> that -sets its "tabs" attribute. The returned value will be -<literal>None</literal> if "standard" (8-space) tabs are used.</para> - - </refsect2> - - <refsect2 id="method-gtktextview--get-default-attributes"> - <title>gtk.TextView.get_default_attributes</title> - - <programlisting><methodsynopsis language="python"> - <methodname>get_default_attributes</methodname> - <methodparam></methodparam> </methodsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a new <link -linkend="class-gtktextattributes"><classname>gtk.TextAttributes</classname></link></simpara></listitem> - </varlistentry> - </variablelist> - - <para>The <methodname>get_default_attributes</methodname>() method -returns a copy of the default <link -linkend="class-gtktextattributes"><classname>gtk.TextAttributes</classname></link>. -These attributes are used for text unless the text is influenced by a <link -linkend="class-gtktexttag"><classname>gtk.TextTag</classname></link>. -You'd typically pass the default attributes in to the <link -linkend="method-gtktextiter--get-attributes"><methodname>gtk.TextIter.get_attributes</methodname>()</link> -method to get the attributes in effect at a given text position.</para> - - </refsect2> - - </refsect1> - - <refsect1> - <title>Signals</title> - - <refsect2 id="signal-gtktextview--backspace"> - <title>The "backspace" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"><methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the object which received the signal.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified - with the <link - linkend="method-gobject--connect"><methodname>connect</methodname>()</link> - method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if any)</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This signal is available in GTK+ 2.10 and above.</para> - </note> - - <para>The "backspace" signal is emitted when the - <keycap>Backspace</keycap> key is pressed.</para> - - - </refsect2> - - <refsect2 id="signal-gtktextview--copy-clipboard"> - <title>The "copy-clipboard" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "copy-clipboard" signal is emitted when a selection is -copied to the clipboard from <parameter>textview</parameter>.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--cut-clipboard"> - <title>The "cut-clipboard" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "cut-clipboard" signal is emitted when a selection is cut -from <parameter>textview</parameter> to the clipboard.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--delete-from-cursor"> - <title>The "delete-from-cursor" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>delete_type</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>delete_type</parameter> :</term> - <listitem><simpara>the type of deletion</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>count</parameter> :</term> - <listitem><simpara>the number of deletions to -do</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "delete-from-cursor" signal is emitted when a deletion of -the type specified by <parameter>delete_type</parameter> is initiated by -user action (e.g. pressing the <keycap>Delete</keycap> or -<keycap>Backspace</keycap> keys). The value of -<parameter>delete_type</parameter> must be one of:</para> - - <itemizedlist> - <listitem> - <simpara><literal>gtk.DELETE_CHARS</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_WORD_ENDS</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_WORDS</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_DISPLAY_LINES</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_DISPLAY_LINE_ENDS</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_PARAGRAPH_ENDS</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_PARAGRAPHS</literal></simpara> - </listitem> - <listitem> - <simpara><literal>gtk.DELETE_WHITESPACE</literal></simpara> - </listitem> - </itemizedlist> - - <para><parameter>count</parameter> specifies the number of times that -deletion should be applied.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--insert-at-cursor"> - <title>The "insert-at-cursor" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>string</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>string</parameter> :</term> - <listitem><simpara>the text to be inserted</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "insert-at-cursor" signal is emitted when -<parameter>string</parameter> is being inserted in -<parameter>textview</parameter>.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--move-cursor"> - <title>The "move-cursor" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>step_size</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>extend_selection</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>step_size</parameter> :</term> - <listitem><simpara>the step size to move</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>count</parameter> :</term> - <listitem><simpara>the number of steps to -move</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>extend_selection</parameter> :</term> - <listitem><simpara>if <literal>True</literal> extend the -selection</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "move-cursor" signal is emitted when the cursor is moved by -<parameter>count</parameter> steps of <parameter>step_size</parameter>. If -<parameter>extend_selection</parameter> is <literal>True</literal> the -selection is extended by the cursor movement. The value of step_size must be -one of:</para> - - <variablelist> - <varlistentry> - <term><literal>gtk.MOVEMENT_LOGICAL_POSITIONS</literal></term> - <listitem> - <simpara>move by graphemes</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_VISUAL_POSITIONS</literal></term> - <listitem> - <simpara>move by graphemes</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_WORDS</literal></term> - <listitem> - <simpara>move by words</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_DISPLAY_LINES</literal></term> - <listitem> - <simpara>move by lines(wrapped lines)</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_DISPLAY_LINE_ENDS</literal></term> - <listitem> - <simpara>move to line ends(wrapped lines)</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_PARAGRAPHS</literal></term> - <listitem> - <simpara>move by paragraphs(newline-ended lines)</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_PARAGRAPH_ENDS</literal></term> - <listitem> - <simpara>move to ends of a paragraph</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_PAGES</literal></term> - <listitem> - <simpara>move by pages</simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>gtk.MOVEMENT_BUFFER_ENDS</literal></term> - <listitem> - <simpara>move to ends of the buffer</simpara> - </listitem> - </varlistentry> - </variablelist> - - <para></para> - - </refsect2> - - <refsect2 id="signal-gtktextview--move-focus"> - <title>The "move-focus" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>direction</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>direction</parameter> :</term> - <listitem><simpara>the direction to move the -focus</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "move-focus" signal is emitted when the focus moves from -<parameter>textview</parameter> in the direction specified by -<parameter>direction</parameter> that must be one of: -<literal>gtk.DIR_TAB_FORWARD</literal>, -<literal>gtk.DIR_TAB_BACKWARD</literal>, <literal>gtk.DIR_UP</literal>, -<literal>gtk.DIR_DOWN</literal>, <literal>gtk.DIR_LEFT</literal> or -<literal>gtk.DIR_RIGHT</literal></para> - - </refsect2> - - <refsect2 id="signal-gtktextview--move-viewport"> - <title>The "move-viewport" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>scrollstep</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>scrollstep</parameter> :</term> - <listitem><simpara>the size of the scroll step: - <literal>gtk.SCROLL_STEPS</literal>, - <literal>gtk.SCROLL_PAGES</literal>, - <literal>gtk.SCROLL_ENDS</literal>, - <literal>gtk.SCROLL_HORIZONTAL_STEPS</literal>, - <literal>gtk.SCROLL_HORIZONTAL_PAGES</literal> or - <literal>gtk.SCROLL_HORIZONTAL_ENDS</literal></simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>count</parameter> :</term> - <listitem><simpara>the number of scroll steps of size - <parameter>scrollstep</parameter> to take</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <note> - <para>This signal is available in GTK+ 2.4 and above.</para> - </note> - - <para>The "move-viewport" signal is emitted when the viewport is being -moved usually as the result of user action in moving the cursor or using -the scrollbars.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--page-horizontally"> - <title>The "page-horizontally" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>count</parameter></methodparam> - <methodparam><parameter>extend_selection</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>count</parameter> :</term> - <listitem><simpara>the number of pages to -move</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>extend_selection</parameter> :</term> - <listitem><simpara>if <literal>True</literal> extend the -selection</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "page-horizontally" signal is emitted when user initiates -horizontal paging by pressing one of the key combinations:</para> - - <variablelist> - <varlistentry> - <term><keycombo action="simul"><keycap>Control</keycap> - <keycap>Page Up</keycap> - </keycombo></term> - <listitem> - <simpara>Page horizontally with -<parameter>extend_selection</parameter> set to -<literal>False</literal></simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><keycombo action="simul"><keycap>Shift</keycap> - <keycap>Control</keycap> - <keycap>Page Up</keycap> - </keycombo></term> - <listitem> - <simpara>Page horizontally with -<parameter>extend_selection</parameter> set to -<literal>True</literal></simpara> - </listitem> - </varlistentry> - </variablelist> - - <para></para> - - </refsect2> - - <refsect2 id="signal-gtktextview--paste-clipboard"> - <title>The "paste-clipboard" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "paste-clipboard" signal is emitted when the contents of the -clipboard are pasted into <parameter>textview</parameter>.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--populate-popup"> - <title>The "populate-popup" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>menu</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>menu</parameter> :</term> - <listitem><simpara>the menu to populate</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "populate-popup" signal is emitted when the popup menu -(specified by <parameter>menu</parameter>) associated with -<parameter>textview</parameter> needs to be populated.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--select-all"> - <title>The "select-all" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>select</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>select</parameter> :</term> - <listitem><simpara>if <literal>True</literal> select the buffer - contents; otherwise deselect the buffer - contents</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - - <note> - <para>This signal is available in GTK+ 2.2 and above.</para> - </note> - - <para>The "select-all" signal is emitted when the user presses one -of:</para> - - <itemizedlist> - <listitem> - <simpara><keycombo -action='simul'><keycap>Control</keycap><keycap>a</keycap></keycombo> or -<keycombo -action='simul'><keycap>Control</keycap><keycap>/</keycap></keycombo> to -select all text in a buffer</simpara> - </listitem> - <listitem> - <simpara><keycombo -action='simul'><keycap>Control</keycap><keycap>\</keycap></keycombo> to -deselect all text in a buffer</simpara> - </listitem> - </itemizedlist> - - <para></para> - - </refsect2> - - <refsect2 id="signal-gtktextview--set-anchor"> - <title>The "set-anchor" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "set-anchor" signal is emitted when an application calls the -<link -linkend="method-gobject--emit"><methodname>GObject.emit()</methodname>()</link> -method on textview with "set-anchor" as the signal.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--set-scroll-adjustments"> - <title>The "set-scroll-adjustments" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>hadjustment</parameter></methodparam> - <methodparam><parameter>vadjustment</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>hadjustment</parameter> :</term> - <listitem><simpara>the horizontal adjustment</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>vadjustment</parameter> :</term> - <listitem><simpara>the vertical adjustment</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "set-scroll-adjustments" signal is emitted when one or both -adjustments (specified by <parameter>hadjustment</parameter> and -<parameter>vadjustment</parameter>) are set on -<parameter>textview</parameter>.</para> - - </refsect2> - - <refsect2 id="signal-gtktextview--toggle-overwrite"> - <title>The "toggle-overwrite" gtk.TextView Signal</title> - - <programlisting><methodsynopsis language="python"> - <methodname>callback</methodname> - <methodparam><parameter>textview</parameter></methodparam> - <methodparam><parameter>user_param1</parameter></methodparam> - <methodparam><parameter>...</parameter></methodparam> - </methodsynopsis></programlisting> - - <variablelist> - <varlistentry> - <term><parameter>textview</parameter> :</term> - <listitem><simpara>the textview that received the -signal</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified -with the <link -linkend="method-gobject--connect"><methodname>connect</methodname>()</link> -method</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if -any)</simpara></listitem> - </varlistentry> - </variablelist> - - <para>The "toggle-overwrite" signal is emitted when the user presses -the <keycap>Insert</keycap> key.</para> - - </refsect2> - - </refsect1> - -</refentry> |