diff options
-rw-r--r-- | docs/reference/gtk/tmpl/.gitignore | 1 | ||||
-rw-r--r-- | docs/reference/gtk/tmpl/gtktextview.sgml | 883 | ||||
-rw-r--r-- | gtk/gtktextchild.h | 12 | ||||
-rw-r--r-- | gtk/gtktextview.c | 12 | ||||
-rw-r--r-- | gtk/gtktextview.h | 6 |
5 files changed, 26 insertions, 888 deletions
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore index 59036d9fa2..4c4c615f90 100644 --- a/docs/reference/gtk/tmpl/.gitignore +++ b/docs/reference/gtk/tmpl/.gitignore @@ -48,6 +48,7 @@ gtkstyle.sgml gtktesting.sgml gtktextiter.sgml gtktexttagtable.sgml +gtktextview.sgml gtktoggleaction.sgml gtktoolbar.sgml gtktoolitem.sgml diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml deleted file mode 100644 index 68a3c312a7..0000000000 --- a/docs/reference/gtk/tmpl/gtktextview.sgml +++ /dev/null @@ -1,883 +0,0 @@ -<!-- ##### SECTION Title ##### --> -GtkTextView - -<!-- ##### SECTION Short_Description ##### --> -Widget that displays a GtkTextBuffer - -<!-- ##### SECTION Long_Description ##### --> -<para> -You may wish to begin by reading the <link linkend="TextWidget">text widget -conceptual overview</link> which gives an overview of all the objects and data -types related to the text widget and how they work together. -</para> - -<para> - -</para> - -<!-- ##### SECTION See_Also ##### --> -<para> -#GtkTextBuffer, #GtkTextIter -</para> - -<!-- ##### SECTION Stability_Level ##### --> - - -<!-- ##### SECTION Image ##### --> - - -<!-- ##### STRUCT GtkTextView ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL GtkTextView::backspace ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::copy-clipboard ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::cut-clipboard ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::delete-from-cursor ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### SIGNAL GtkTextView::insert-at-cursor ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: - -<!-- ##### SIGNAL GtkTextView::move-cursor ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: -@arg3: - -<!-- ##### SIGNAL GtkTextView::move-viewport ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### SIGNAL GtkTextView::paste-clipboard ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::populate-popup ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: - -<!-- ##### SIGNAL GtkTextView::preedit-changed ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: - -<!-- ##### SIGNAL GtkTextView::select-all ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: - -<!-- ##### SIGNAL GtkTextView::set-anchor ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::set-scroll-adjustments ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### SIGNAL GtkTextView::toggle-cursor-visible ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::toggle-overwrite ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### ARG GtkTextView:accepts-tab ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:buffer ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:cursor-visible ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:editable ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:im-module ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:indent ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:justification ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:left-margin ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:overwrite ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:pixels-above-lines ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:pixels-below-lines ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:pixels-inside-wrap ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:right-margin ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:tabs ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:wrap-mode ##### --> -<para> - -</para> - -<!-- ##### ARG GtkTextView:error-underline-color ##### --> -<para> - -</para> - -<!-- ##### ENUM GtkTextWindowType ##### --> -<para> - -</para> - -@GTK_TEXT_WINDOW_PRIVATE: -@GTK_TEXT_WINDOW_WIDGET: -@GTK_TEXT_WINDOW_TEXT: -@GTK_TEXT_WINDOW_LEFT: -@GTK_TEXT_WINDOW_RIGHT: -@GTK_TEXT_WINDOW_TOP: -@GTK_TEXT_WINDOW_BOTTOM: - -<!-- ##### FUNCTION gtk_text_view_new ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_new_with_buffer ##### --> -<para> - -</para> - -@buffer: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_buffer ##### --> -<para> - -</para> - -@text_view: -@buffer: - - -<!-- ##### FUNCTION gtk_text_view_get_buffer ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_get_hadjustment ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_get_vadjustment ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_scroll_to_mark ##### --> -<para> - -</para> - -@text_view: -@mark: -@within_margin: -@use_align: -@xalign: -@yalign: - - -<!-- ##### FUNCTION gtk_text_view_scroll_to_iter ##### --> -<para> - -</para> - -@text_view: -@iter: -@within_margin: -@use_align: -@xalign: -@yalign: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_scroll_mark_onscreen ##### --> -<para> - -</para> - -@text_view: -@mark: - - -<!-- ##### FUNCTION gtk_text_view_move_mark_onscreen ##### --> -<para> - -</para> - -@text_view: -@mark: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_place_cursor_onscreen ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_get_visible_rect ##### --> -<para> - -</para> - -@text_view: -@visible_rect: - - -<!-- ##### FUNCTION gtk_text_view_get_iter_location ##### --> -<para> - -</para> - -@text_view: -@iter: -@location: - - -<!-- ##### FUNCTION gtk_text_view_get_line_at_y ##### --> -<para> - -</para> - -@text_view: -@target_iter: -@y: -@line_top: - - -<!-- ##### FUNCTION gtk_text_view_get_line_yrange ##### --> -<para> - -</para> - -@text_view: -@iter: -@y: -@height: - - -<!-- ##### FUNCTION gtk_text_view_get_iter_at_location ##### --> -<para> - -</para> - -@text_view: -@iter: -@x: -@y: - - -<!-- ##### FUNCTION gtk_text_view_get_iter_at_position ##### --> -<para> - -</para> - -@text_view: -@iter: -@trailing: -@x: -@y: - - -<!-- ##### FUNCTION gtk_text_view_buffer_to_window_coords ##### --> -<para> - -</para> - -@text_view: -@win: -@buffer_x: -@buffer_y: -@window_x: -@window_y: - - -<!-- ##### FUNCTION gtk_text_view_window_to_buffer_coords ##### --> -<para> - -</para> - -@text_view: -@win: -@window_x: -@window_y: -@buffer_x: -@buffer_y: - - -<!-- ##### FUNCTION gtk_text_view_get_window ##### --> -<para> - -</para> - -@text_view: -@win: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_get_window_type ##### --> -<para> - -</para> - -@text_view: -@window: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_border_window_size ##### --> -<para> - -</para> - -@text_view: -@type: -@size: - - -<!-- ##### FUNCTION gtk_text_view_get_border_window_size ##### --> -<para> - -</para> - -@text_view: -@type: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_forward_display_line ##### --> -<para> - -</para> - -@text_view: -@iter: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_backward_display_line ##### --> -<para> - -</para> - -@text_view: -@iter: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_forward_display_line_end ##### --> -<para> - -</para> - -@text_view: -@iter: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_backward_display_line_start ##### --> -<para> - -</para> - -@text_view: -@iter: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_starts_display_line ##### --> -<para> - -</para> - -@text_view: -@iter: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_move_visually ##### --> -<para> - -</para> - -@text_view: -@iter: -@count: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_add_child_at_anchor ##### --> -<para> - -</para> - -@text_view: -@child: -@anchor: - - -<!-- ##### STRUCT GtkTextChildAnchor ##### --> -<para> -A <structname>GtkTextChildAnchor</structname> is a spot in the buffer -where child widgets can be "anchored" (inserted inline, as if they were -characters). The anchor can have multiple widgets anchored, to allow for -multiple views. -</para> - - -<!-- ##### FUNCTION gtk_text_child_anchor_new ##### --> -<para> - -</para> - -@void: -@Returns: - - -<!-- ##### FUNCTION gtk_text_child_anchor_get_widgets ##### --> -<para> - -</para> - -@anchor: -@Returns: - - -<!-- ##### FUNCTION gtk_text_child_anchor_get_deleted ##### --> -<para> - -</para> - -@anchor: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_add_child_in_window ##### --> -<para> - -</para> - -@text_view: -@child: -@which_window: -@xpos: -@ypos: - - -<!-- ##### FUNCTION gtk_text_view_move_child ##### --> -<para> - -</para> - -@text_view: -@child: -@xpos: -@ypos: - - -<!-- ##### FUNCTION gtk_text_view_set_wrap_mode ##### --> -<para> - -</para> - -@text_view: -@wrap_mode: - - -<!-- ##### FUNCTION gtk_text_view_get_wrap_mode ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_editable ##### --> -<para> - -</para> - -@text_view: -@setting: - - -<!-- ##### FUNCTION gtk_text_view_get_editable ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_cursor_visible ##### --> -<para> - -</para> - -@text_view: -@setting: - - -<!-- ##### FUNCTION gtk_text_view_get_cursor_visible ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_overwrite ##### --> -<para> - -</para> - -@text_view: -@overwrite: - - -<!-- ##### FUNCTION gtk_text_view_get_overwrite ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_pixels_above_lines ##### --> -<para> - -</para> - -@text_view: -@pixels_above_lines: - - -<!-- ##### FUNCTION gtk_text_view_get_pixels_above_lines ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_pixels_below_lines ##### --> -<para> - -</para> - -@text_view: -@pixels_below_lines: - - -<!-- ##### FUNCTION gtk_text_view_get_pixels_below_lines ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_pixels_inside_wrap ##### --> -<para> - -</para> - -@text_view: -@pixels_inside_wrap: - - -<!-- ##### FUNCTION gtk_text_view_get_pixels_inside_wrap ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_justification ##### --> -<para> - -</para> - -@text_view: -@justification: - - -<!-- ##### FUNCTION gtk_text_view_get_justification ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_left_margin ##### --> -<para> - -</para> - -@text_view: -@left_margin: - - -<!-- ##### FUNCTION gtk_text_view_get_left_margin ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_right_margin ##### --> -<para> - -</para> - -@text_view: -@right_margin: - - -<!-- ##### FUNCTION gtk_text_view_get_right_margin ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_indent ##### --> -<para> - -</para> - -@text_view: -@indent: - - -<!-- ##### FUNCTION gtk_text_view_get_indent ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_tabs ##### --> -<para> - -</para> - -@text_view: -@tabs: - - -<!-- ##### FUNCTION gtk_text_view_get_tabs ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_set_accepts_tab ##### --> -<para> - -</para> - -@text_view: -@accepts_tab: - - -<!-- ##### FUNCTION gtk_text_view_get_accepts_tab ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_get_default_attributes ##### --> -<para> - -</para> - -@text_view: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_im_context_filter_keypress ##### --> -<para> - -</para> - -@text_view: -@event: -@Returns: - - -<!-- ##### FUNCTION gtk_text_view_reset_im_context ##### --> -<para> - -</para> - -@text_view: - - -<!-- ##### MACRO GTK_TEXT_VIEW_PRIORITY_VALIDATE ##### --> -<para> -The priority at which the text view validates onscreen lines -in an idle job in the background. -</para> - - - diff --git a/gtk/gtktextchild.h b/gtk/gtktextchild.h index 7835e68f91..dd132f4278 100644 --- a/gtk/gtktextchild.h +++ b/gtk/gtktextchild.h @@ -36,12 +36,14 @@ G_BEGIN_DECLS -/* A GtkTextChildAnchor is a spot in the buffer where child widgets - * can be "anchored" (inserted inline, as if they were characters). - * The anchor can have multiple widgets anchored, to allow for multiple - * views. - */ +/** + * GtkTextChildAnchor: + * + * A #GtkTextChildAnchor is a spot in the buffer where child widgets can + * be "anchored" (inserted inline, as if they were characters). The anchor + * can have multiple widgets anchored, to allow for multiple views. + */ typedef struct _GtkTextChildAnchor GtkTextChildAnchor; typedef struct _GtkTextChildAnchorClass GtkTextChildAnchorClass; diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c index 27c21d0edd..78d380f98a 100644 --- a/gtk/gtktextview.c +++ b/gtk/gtktextview.c @@ -52,6 +52,18 @@ #include "gtkscrollable.h" +/** + * SECTION:gtktextview + * @Short_description: Widget that displays a GtkTextBuffer + * @Title: GtkTextView + * @See_also: #GtkTextBuffer, #GtkTextIter + * + * You may wish to begin by reading the <link linkend="TextWidget">text widget + * conceptual overview</link> which gives an overview of all the objects and data + * types related to the text widget and how they work together. + */ + + /* How scrolling, validation, exposes, etc. work. * * The expose_event handler has the invariant that the onscreen lines diff --git a/gtk/gtktextview.h b/gtk/gtktextview.h index 4e64b33e15..2853c63962 100644 --- a/gtk/gtktextview.h +++ b/gtk/gtktextview.h @@ -56,6 +56,12 @@ typedef enum GTK_TEXT_WINDOW_BOTTOM } GtkTextWindowType; +/** + * GTK_TEXT_VIEW_PRIORITY_VALIDATE: + * + * The priority at which the text view validates onscreen lines + * in an idle job in the background. + */ #define GTK_TEXT_VIEW_PRIORITY_VALIDATE (GDK_PRIORITY_REDRAW + 5) typedef struct _GtkTextView GtkTextView; |