gtk_source_view_new ()

GtkWidget *
gtk_source_view_new (void);

Creates a new GtkSourceView widget.

By default, an empty GtkSourceBuffer will be lazily created and can be retrieved with gtk_text_view_get_buffer().

If you want to specify your own buffer, either override the GtkTextViewClass create_buffer factory method, or use 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 buffer .

gtk_source_view_get_completion ()

GtkSourceCompletion *
gtk_source_view_get_completion (GtkSourceView *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 left gutter.

Since: 2.8

gtk_source_view_get_space_drawer ()

GtkSourceSpaceDrawer *
gtk_source_view_get_space_drawer (GtkSourceView *view);

Since: 3.24

gtk_source_view_set_show_line_numbers ()

void
gtk_source_view_set_show_line_numbers (GtkSourceView *view,
                                       gboolean show);

Sets the “show-line-numbers” property.

gtk_source_view_get_show_line_numbers ()

gboolean
gtk_source_view_get_show_line_numbers (GtkSourceView *view);

gtk_source_view_set_show_right_margin ()

void
gtk_source_view_set_show_right_margin (GtkSourceView *view,
                                       gboolean show);

Sets the “show-right-margin” property.

gtk_source_view_get_show_right_margin ()

gboolean
gtk_source_view_get_show_right_margin (GtkSourceView *view);

gtk_source_view_set_right_margin_position ()

void
gtk_source_view_set_right_margin_position
                               (GtkSourceView *view,
                                guint pos);

Sets the “right-margin-position” property.

gtk_source_view_get_right_margin_position ()

guint
gtk_source_view_get_right_margin_position
                               (GtkSourceView *view);

gtk_source_view_set_highlight_current_line ()

void
gtk_source_view_set_highlight_current_line
                               (GtkSourceView *view,
                                gboolean highlight);

Sets the “highlight-current-line” property.

gtk_source_view_get_highlight_current_line ()

gboolean
gtk_source_view_get_highlight_current_line
                               (GtkSourceView *view);

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.

When Enter is pressed to create a new line, the auto-indentation inserts the same indentation as the previous line. This is not a "smart indentation" where an indentation level is added or removed depending on the context.

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 when several lines are selected, the selected lines are indented of one level instead of being replaced with a \t character. Shift+Tab unindents the selection.

If the first or last line is not selected completely, it is also indented or unindented.

When the selection doesn't span several lines, the tab key always replaces the selection with a normal \t character.

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.

gtk_source_view_set_tab_width ()

void
gtk_source_view_set_tab_width (GtkSourceView *view,
                               guint width);

Sets the “tab-width” property.

gtk_source_view_get_tab_width ()

guint
gtk_source_view_get_tab_width (GtkSourceView *view);

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 when the tab key is pressed. If width is -1, the value of the “tab-width” property will be used.

The “indent-width” interacts with the “insert-spaces-instead-of-tabs” property and “tab-width”. An example will be clearer: if the “indent-width” is 4 and “tab-width” is 8 and “insert-spaces-instead-of-tabs” is FALSE, then pressing the tab key at the beginning of a line will insert 4 spaces. So far so good. Pressing the tab key a second time will remove the 4 spaces and insert a \t character instead (since “tab-width” is 8). On the other hand, if “insert-spaces-instead-of-tabs” is TRUE, the second tab key pressed will insert 4 more spaces for a total of 8 spaces in the GtkTextBuffer.

The test-widget program (available in the GtkSourceView repository) may be useful to better understand the indentation settings (enable the space drawing!).

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 a tab key pressed is replaced by a group of space characters. Of course it is still possible to insert a real \t programmatically with the GtkTextBuffer API.

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_indent_lines ()

void
gtk_source_view_indent_lines (GtkSourceView *view,
                              GtkTextIter *start,
                              GtkTextIter *end);

Inserts one indentation level at the beginning of the specified lines. The empty lines are not indented.

Since: 3.16

gtk_source_view_unindent_lines ()

void
gtk_source_view_unindent_lines (GtkSourceView *view,
                                GtkTextIter *start,
                                GtkTextIter *end);

Removes one indentation level at the beginning of the specified lines.

Since: 3.16

gtk_source_view_get_visual_column ()

guint
gtk_source_view_get_visual_column (GtkSourceView *view,
                                   const GtkTextIter *iter);

Determines the visual column at iter taking into consideration the “tab-width” of view .

gtk_source_view_set_smart_backspace ()

void
gtk_source_view_set_smart_backspace (GtkSourceView *view,
                                     gboolean smart_backspace);

When set to TRUE, pressing the Backspace key will try to delete spaces up to the previous tab stop.

Since: 3.18

gtk_source_view_get_smart_backspace ()

gboolean
gtk_source_view_get_smart_backspace (GtkSourceView *view);

Returns TRUE if pressing the Backspace key will try to delete spaces up to the previous tab stop.

Since: 3.18

gtk_source_view_set_smart_home_end ()

void
gtk_source_view_set_smart_home_end (GtkSourceView *view,
                                    GtkSourceSmartHomeEndType smart_home_end);

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_attributes ()

void
gtk_source_view_set_mark_attributes (GtkSourceView *view,
                                     const gchar *category,
                                     GtkSourceMarkAttributes *attributes,
                                     gint priority);

Sets attributes and priority for the category .

gtk_source_view_get_mark_attributes ()

GtkSourceMarkAttributes *
gtk_source_view_get_mark_attributes (GtkSourceView *view,
                                     const gchar *category,
                                     gint *priority);

Gets attributes and priority for the category .

gtk_source_view_set_show_line_marks ()

void
gtk_source_view_set_show_line_marks (GtkSourceView *view,
                                     gboolean show);

Sets the “show-line-marks” property.

Since: 2.2

gtk_source_view_get_show_line_marks ()

gboolean
gtk_source_view_get_show_line_marks (GtkSourceView *view);

Since: 2.2

GtkSourceView

typedef struct _GtkSourceView GtkSourceView;

enum GtkSourceSmartHomeEndType

enum GtkSourceViewGutterPosition

The “auto-indent” property

  “auto-indent”              gboolean

Whether to enable auto indentation.

Owner: GtkSourceView

Flags: Read / Write

Default value: FALSE

The “completion” property

  “completion”               GtkSourceCompletion *

The completion object associated with the view.

The completion object is guaranteed to be the same for the lifetime of the view. Each view has a different completion object.

Owner: GtkSourceView

Flags: Read

The “highlight-current-line” property

  “highlight-current-line”   gboolean

Whether to highlight the current line.

Owner: GtkSourceView

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.

Owner: GtkSourceView

Flags: Read / Write

Default value: TRUE

The “indent-width” property

  “indent-width”             int

Width of an indentation step expressed in number of spaces.

Owner: GtkSourceView

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.

Owner: GtkSourceView

Flags: Read / Write

Default value: FALSE

The “right-margin-position” property

  “right-margin-position”    guint

The width in characters where to position the right margin.

Owner: GtkSourceView

Flags: Read / Write

Allowed values: [1,1000]

Default value: 80

The “show-line-marks” property

  “show-line-marks”          gboolean

Whether to display line mark pixbufs beside the text.

Owner: GtkSourceView

Flags: Read / Write

Default value: FALSE

The “show-line-numbers” property

  “show-line-numbers”        gboolean

Whether to display line numbers beside the text.

Owner: GtkSourceView

Flags: Read / Write

Default value: FALSE

The “show-right-margin” property

  “show-right-margin”        gboolean

Whether to display the right margin.

Owner: GtkSourceView

Flags: Read / Write

Default value: FALSE

The “smart-backspace” property

  “smart-backspace”          gboolean

Whether smart Backspace should be used.

Owner: GtkSourceView

Flags: Read / Write

Default value: FALSE

Since: 3.18

The “smart-home-end” property

  “smart-home-end”           GtkSourceSmartHomeEndType

Set the behavior of the HOME and END keys.

Owner: GtkSourceView

Flags: Read / Write

Default value: GTK_SOURCE_SMART_HOME_END_DISABLED

Since: 2.0

The “space-drawer” property

  “space-drawer”             GtkSourceSpaceDrawer *

The GtkSourceSpaceDrawer object associated with the view.

The GtkSourceSpaceDrawer object is guaranteed to be the same for the lifetime of the view. Each view has a different GtkSourceSpaceDrawer object.

Owner: GtkSourceView

Flags: Read

Since: 3.24

The “tab-width” property

  “tab-width”                guint

The width of a tabulation character expressed in number of spaces.

The GtkTextBuffer still contains \t characters, but they can take a different visual width in a GtkSourceView widget.

Owner: GtkSourceView

Flags: Read / Write

Allowed values: [1,32]

Default value: 8

The “change-case” signal

void
user_function (GtkSourceView          *view,
               GtkSourceChangeCaseType case_type,
               gpointer                user_data)

Keybinding signal to change case of the text at the current cursor position.

Flags: Action

Since: 3.16

The “change-number” signal

void
user_function (GtkSourceView *view,
               int            count,
               gpointer       user_data)

Keybinding signal to edit a number at the current cursor position.

Flags: Action

Since: 3.16

The “join-lines” signal

void
user_function (GtkSourceView *view,
               gpointer       user_data)

Keybinding signal to join the lines currently selected.

Flags: Action

Since: 3.16

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       down,
               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 up or down by one line.

Flags: Action

The “move-to-matching-bracket” signal

void
user_function (GtkSourceView *view,
               gboolean       extend_selection,
               gpointer       user_data)

Keybinding signal to move the cursor to the matching bracket.

Flags: Action

Since: 3.16

The “move-words” signal

void
user_function (GtkSourceView *view,
               int            count,
               gpointer       user_data)

The ::move-words signal is a keybinding which gets emitted when the user initiates moving a word. The default binding key is Alt+Left/Right Arrow and moves the current selection, or the current word by one word.

Flags: Action

Since: 3.0

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 key binding signal which gets emitted when the user requests a completion, by pressing

This will create a GtkSourceCompletionContext with the activation type as GTK_SOURCE_COMPLETION_ACTIVATION_USER_REQUESTED.

Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to activate the completion by another means, for example with another key binding or a menu entry.

Flags: Action

The “smart-home-end” signal

void
user_function (GtkSourceView *view,
               GtkTextIter   *iter,
               int            count,
               gpointer       user_data)

Emitted when a the cursor was moved according to the smart home end setting. The signal is emitted after the cursor is moved, but during the GtkTextView::move-cursor action. This can be used to find out whether the cursor was moved by a normal home/end or by a smart home/end.

Flags: Run Last

Since: 3.0

The “undo” signal

void
user_function (GtkSourceView *sourceview,
               gpointer       user_data)

Flags: Action