GtkSourceViewMarkTooltipFunc ()

gchar *
(*GtkSourceViewMarkTooltipFunc) (GtkSourceMark *mark,
                                 gpointer user_data);

Function type for setting up a tooltip for GtkSourceMark.

gtk_source_view_new ()

GtkWidget *
gtk_source_view_new (void);

Creates a new GtkSourceView. An empty default buffer will be created for you. If you want to specify your own buffer, consider gtk_source_view_new_with_buffer().

gtk_source_view_new_with_buffer ()

GtkWidget *
gtk_source_view_new_with_buffer (GtkSourceBuffer *buffer);

Creates a new GtkSourceView widget displaying the buffer buffer . One buffer can be shared among many widgets.

gtk_source_view_set_auto_indent ()

void
gtk_source_view_set_auto_indent (GtkSourceView *view,
                                 gboolean enable);

If TRUE auto indentation of text is enabled.

gtk_source_view_get_auto_indent ()

gboolean
gtk_source_view_get_auto_indent (GtkSourceView *view);

Returns whether auto indentation of text is enabled.

gtk_source_view_set_indent_on_tab ()

void
gtk_source_view_set_indent_on_tab (GtkSourceView *view,
                                   gboolean enable);

If TRUE, when the tab key is pressed and there is a selection, the selected text is indented of one level instead of being replaced with the \t characters. Shift+Tab unindents the selection.

Since: 1.8

gtk_source_view_get_indent_on_tab ()

gboolean
gtk_source_view_get_indent_on_tab (GtkSourceView *view);

Returns whether when the tab key is pressed the current selection should get indented instead of replaced with the \t character.

Since: 1.8

gtk_source_view_set_indent_width ()

void
gtk_source_view_set_indent_width (GtkSourceView *view,
                                  gint width);

Sets the number of spaces to use for each step of indent. If width is -1, the value of the GtkSourceView::tab-width property will be used.

gtk_source_view_get_indent_width ()

gint
gtk_source_view_get_indent_width (GtkSourceView *view);

Returns the number of spaces to use for each step of indent. See gtk_source_view_set_indent_width() for details.

gtk_source_view_set_insert_spaces_instead_of_tabs ()

void
gtk_source_view_set_insert_spaces_instead_of_tabs
                               (GtkSourceView *view,
                                gboolean enable);

If TRUE any tabulator character inserted is replaced by a group of space characters.

gtk_source_view_get_insert_spaces_instead_of_tabs ()

gboolean
gtk_source_view_get_insert_spaces_instead_of_tabs
                               (GtkSourceView *view);

Returns whether when inserting a tabulator character it should be replaced by a group of space characters.

gtk_source_view_set_smart_home_end ()

void
gtk_source_view_set_smart_home_end (GtkSourceView *view,
                                    GtkSourceSmartHomeEndType smart_he);

Set the desired movement of the cursor when HOME and END keys are pressed.

gtk_source_view_get_smart_home_end ()

GtkSourceSmartHomeEndType
gtk_source_view_get_smart_home_end (GtkSourceView *view);

Returns a GtkSourceSmartHomeEndType end value specifying how the cursor will move when HOME and END keys are pressed.

gtk_source_view_set_mark_category_priority ()

void
gtk_source_view_set_mark_category_priority
                               (GtkSourceView *view,
                                const gchar *category,
                                gint priority);

Set the priority for the given mark category . When there are multiple marks on the same line, marks of categories with higher priorities will be drawn on top.

Since: 2.2

gtk_source_view_get_mark_category_priority ()

gint
gtk_source_view_get_mark_category_priority
                               (GtkSourceView *view,
                                const gchar *category);

Gets the priority which is associated with the given category .

Since: 2.2

gtk_source_view_set_mark_category_pixbuf ()

void
gtk_source_view_set_mark_category_pixbuf
                               (GtkSourceView *view,
                                const gchar *category,
                                GdkPixbuf *pixbuf);

Associates a given pixbuf with a given mark category . If pixbuf is NULL, the pixbuf is unset.

Since: 2.2

gtk_source_view_get_mark_category_pixbuf ()

GdkPixbuf *
gtk_source_view_get_mark_category_pixbuf
                               (GtkSourceView *view,
                                const gchar *category);

Gets the pixbuf which is associated with the given mark category .

Since: 2.2

gtk_source_view_set_mark_category_icon_from_pixbuf ()

void
gtk_source_view_set_mark_category_icon_from_pixbuf
                               (GtkSourceView *view,
                                const gchar *category,
                                GdkPixbuf *pixbuf);

Sets the icon to be used for category to pixbuf . If pixbuf is NULL, the icon is unset.

Since: 2.8

gtk_source_view_set_mark_category_icon_from_stock ()

void
gtk_source_view_set_mark_category_icon_from_stock
                               (GtkSourceView *view,
                                const gchar *category,
                                const gchar *stock_id);

Sets the icon to be used for category to the stock item stock_id . If stock_id is NULL, the icon is unset.

Since: 2.8

gtk_source_view_set_mark_category_icon_from_icon_name ()

void
gtk_source_view_set_mark_category_icon_from_icon_name
                               (GtkSourceView *view,
                                const gchar *category,
                                const gchar *name);

Sets the icon to be used for category to the named theme item name . If name is NULL, the icon is unset.

Since: 2.8

gtk_source_view_get_mark_category_background ()

gboolean
gtk_source_view_get_mark_category_background
                               (GtkSourceView *view,
                                const gchar *category,
                                GdkColor *dest);

Gets the background color associated with given category .

Since: 2.4

gtk_source_view_set_mark_category_background ()

void
gtk_source_view_set_mark_category_background
                               (GtkSourceView *view,
                                const gchar *category,
                                const GdkColor *color);

Sets given background color for mark category . If color is NULL, the background color is unset.

Since: 2.4

gtk_source_view_set_mark_category_tooltip_func ()

void
gtk_source_view_set_mark_category_tooltip_func
                               (GtkSourceView *view,
                                const gchar *category,
                                GtkSourceViewMarkTooltipFunc func,
                                gpointer user_data,
                                GDestroyNotify user_data_notify);

Set a GtkSourceViewMarkTooltipFunc used to set tooltip on marks from the given mark category . If you also specified a function with gtk_source_view_set_mark_category_tooltip_markup_func() the markup variant takes precedence.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

static gchar *
tooltip_func (GtkSourceMark *mark,
              gpointer       user_data)
{
  gchar *text;

  text = get_tooltip_for_mark (mark, user_data);

  return text;
}

...

GtkSourceView *view;

gtk_source_view_set_mark_category_tooltip_func (view, "other-mark",
                                                tooltip_func,
                                                NULL, NULL);

Since: 2.8

gtk_source_view_set_mark_category_tooltip_markup_func ()

void
gtk_source_view_set_mark_category_tooltip_markup_func
                               (GtkSourceView *view,
                                const gchar *category,
                                GtkSourceViewMarkTooltipFunc markup_func,
                                gpointer user_data,
                                GDestroyNotify user_data_notify);

See gtk_source_view_set_mark_category_tooltip_func() for more information.

Since: 2.8

gtk_source_view_set_highlight_current_line ()

void
gtk_source_view_set_highlight_current_line
                               (GtkSourceView *view,
                                gboolean show);

If show is TRUE the current line is highlighted.

gtk_source_view_get_highlight_current_line ()

gboolean
gtk_source_view_get_highlight_current_line
                               (GtkSourceView *view);

Returns whether the current line is highlighted

gtk_source_view_set_show_line_marks ()

void
gtk_source_view_set_show_line_marks (GtkSourceView *view,
                                     gboolean show);

If TRUE line marks will be displayed beside the text.

Since: 2.2

gtk_source_view_get_show_line_marks ()

gboolean
gtk_source_view_get_show_line_marks (GtkSourceView *view);

Returns whether line marks are displayed beside the text.

Since: 2.2

gtk_source_view_set_show_line_numbers ()

void
gtk_source_view_set_show_line_numbers (GtkSourceView *view,
                                       gboolean show);

If TRUE line numbers will be displayed beside the text.

gtk_source_view_get_show_line_numbers ()

gboolean
gtk_source_view_get_show_line_numbers (GtkSourceView *view);

Returns whether line numbers are displayed beside the text.

gtk_source_view_set_show_right_margin ()

void
gtk_source_view_set_show_right_margin (GtkSourceView *view,
                                       gboolean show);

If TRUE a right margin is displayed

gtk_source_view_get_show_right_margin ()

gboolean
gtk_source_view_get_show_right_margin (GtkSourceView *view);

Returns whether a right margin is displayed.

gtk_source_view_set_right_margin_position ()

void
gtk_source_view_set_right_margin_position
                               (GtkSourceView *view,
                                guint pos);

Sets the position of the right margin in the given view .

gtk_source_view_get_right_margin_position ()

guint
gtk_source_view_get_right_margin_position
                               (GtkSourceView *view);

Gets the position of the right margin in the given view .

gtk_source_view_set_tab_width ()

void
gtk_source_view_set_tab_width (GtkSourceView *view,
                               guint width);

Sets the width of tabulation in characters.

gtk_source_view_get_tab_width ()

guint
gtk_source_view_get_tab_width (GtkSourceView *view);

Returns the width of tabulation in characters.

gtk_source_view_set_draw_spaces ()

void
gtk_source_view_set_draw_spaces (GtkSourceView *view,
                                 GtkSourceDrawSpacesFlags flags);

Set if and how the spaces should be visualized. Specifying flags as 0 will disable display of spaces.

gtk_source_view_get_draw_spaces ()

GtkSourceDrawSpacesFlags
gtk_source_view_get_draw_spaces (GtkSourceView *view);

Returns the GtkSourceDrawSpacesFlags specifying if and how spaces should be displayed for this view .

gtk_source_view_get_completion ()

GtkSourceCompletion *
gtk_source_view_get_completion (GtkSourceView *view);

Gets the GtkSourceCompletion associated with view .

gtk_source_view_get_gutter ()

GtkSourceGutter *
gtk_source_view_get_gutter (GtkSourceView *view,
                            GtkTextWindowType window_type);

Returns the GtkSourceGutter object associated with window_type for view . Only GTK_TEXT_WINDOW_LEFT and GTK_TEXT_WINDOW_RIGHT are supported, respectively corresponding to the left and right gutter. The line numbers and mark category icons are rendered in the gutter corresponding to GTK_TEXT_WINDOW_LEFT.

Since: 2.8

struct GtkSourceView

struct GtkSourceView;

struct GtkSourceViewClass

struct GtkSourceViewClass {
	GtkTextViewClass parent_class;

	void (*undo) (GtkSourceView *view);
	void (*redo) (GtkSourceView *view);
	void (*line_mark_activated) (GtkSourceView *view, 
	                             GtkTextIter   *iter,
	                             GdkEvent      *event);
	void (*show_completion) (GtkSourceView *view);
	void (*move_lines) (GtkSourceView *view,
	                    gboolean       copy,
	                    gint           step);

	/* Padding for future expansion */
	void (*_gtk_source_reserved1) (void);
};

enum GtkSourceSmartHomeEndType

enum GtkSourceDrawSpacesFlags

GtkSourceDrawSpacesFlags determine what kind of spaces whould be drawn. If none of GTK_SOURCE_DRAW_SPACES_LEADING, GTK_SOURCE_DRAW_SPACES_TEXT or GTK_SOURCE_DRAW_SPACES_TRAILING is specified, whitespaces at any position in the line will be drawn (i.e. it has the same effect as specifying all of them).

enum GtkSourceViewGutterPosition

The “auto-indent” property

  “auto-indent”              gboolean

Whether to enable auto indentation.

Flags: Read / Write

Default value: FALSE

The “completion” property

  “completion”               GtkSourceCompletion *

The completion object associated with the view.

Flags: Read

The “draw-spaces” property

  “draw-spaces”              GtkSourceDrawSpacesFlags

Set if and how the spaces should be visualized.

Flags: Read / Write

Since: 2.4

The “highlight-current-line” property

  “highlight-current-line”   gboolean

Whether to highlight the current line.

Flags: Read / Write

Default value: FALSE

The “indent-on-tab” property

  “indent-on-tab”            gboolean

Whether to indent the selected text when the tab key is pressed.

Flags: Read / Write

Default value: TRUE

The “indent-width” property

  “indent-width”             gint

Width of an indentation step expressed in number of spaces.

Flags: Read / Write

Allowed values: [-1,32]

Default value: -1

The “insert-spaces-instead-of-tabs” property

  “insert-spaces-instead-of-tabs” gboolean

Whether to insert spaces instead of tabs.

Flags: Read / Write

Default value: FALSE

The “right-margin-position” property

  “right-margin-position”    guint

Position of the right margin.

Flags: Read / Write

Allowed values: [1,200]

Default value: 80

The “show-line-marks” property

  “show-line-marks”          gboolean

Whether to display line mark pixbufs

Flags: Read / Write

Default value: FALSE

The “show-line-numbers” property

  “show-line-numbers”        gboolean

Whether to display line numbers

Flags: Read / Write

Default value: FALSE

The “show-right-margin” property

  “show-right-margin”        gboolean

Whether to display the right margin.

Flags: Read / Write

Default value: FALSE

The “smart-home-end” property

  “smart-home-end”           GtkSourceSmartHomeEndType

Set the behavior of the HOME and END keys.

Flags: Read / Write

Default value: GTK_SOURCE_SMART_HOME_END_DISABLED

Since: 2.0

The “tab-width” property

  “tab-width”                guint

Width of an tab character expressed in number of spaces.

Flags: Read / Write

Allowed values: [1,32]

Default value: 8

The “line-mark-activated” signal

void
user_function (GtkSourceView *view,
               GtkTextIter   *iter,
               GdkEvent      *event,
               gpointer       user_data)

Emitted when a line mark has been activated (for instance when there was a button press in the line marks gutter). You can use iter to determine on which line the activation took place.

Flags: Run Last

The “move-lines” signal

void
user_function (GtkSourceView *view,
               gboolean       copy,
               gint           count,
               gpointer       user_data)

The ::move-lines signal is a keybinding which gets emitted when the user initiates moving a line. The default binding key is Alt+Up/Down arrow. And moves the currently selected lines, or the current line by count . For the moment, only count of -1 or 1 is valid.

Flags: Action

Since: 2.10

The “redo” signal

void
user_function (GtkSourceView *sourceview,
               gpointer       user_data)

Flags: Action

The “show-completion” signal

void
user_function (GtkSourceView *view,
               gpointer       user_data)

The ::show-completion signal is a keybinding signal which gets emitted when the user initiates a completion in default mode.

Applications should not connect to it, but may emit it with g_signal_emit_by_name if they need to control the default mode completion activation.

Flags: Action

The “undo” signal

void
user_function (GtkSourceView *sourceview,
               gpointer       user_data)

Flags: Action