GtkSourceBuffer

typedef struct _GtkSourceBuffer GtkSourceBuffer;

GtkSourceBufferClass

typedef struct {
	GtkTextBufferClass parent_class;

	/* views connect to this signal */
	void (* highlight_updated)      (GtkSourceBuffer *buffer,
					 GtkTextIter     *start,
					 GtkTextIter     *end);
	void (* marker_updated)         (GtkSourceBuffer *buffer,
					 GtkTextIter     *where);

	/* Padding for future expansion */
	void (*_gtk_source_reserved1) (void);
	void (*_gtk_source_reserved2) (void);
	void (*_gtk_source_reserved3) (void);
	void (*_gtk_source_reserved4) (void);
} GtkSourceBufferClass;

gtk_source_buffer_new ()

GtkSourceBuffer*    gtk_source_buffer_new               (GtkTextTagTable *table);

Creates a new source buffer.

gtk_source_buffer_new_with_language ()

GtkSourceBuffer*    gtk_source_buffer_new_with_language (GtkSourceLanguage *language);

Creates a new source buffer using the highlighting patterns in language. This is equivalent to creating a new source buffer with the default tag table and then calling gtk_source_buffer_set_language().

gtk_source_buffer_set_highlight ()

void                gtk_source_buffer_set_highlight     (GtkSourceBuffer *buffer,
                                                         gboolean highlight);

Controls whether text is highlighted in the buffer. If highlight is TRUE, the text will be highlighted according to the patterns installed in the buffer (either set with gtk_source_buffer_set_language() or by adding individual GtkSourceTag tags to the buffer's tag table). Otherwise, any current highlighted text will be restored to the default buffer style.

Tags not of GtkSourceTag type will not be removed by this option, and normal GtkTextTag priority settings apply when highlighting is enabled.

If not using a GtkSourceLanguage for setting the highlighting patterns in the buffer, it is recommended for performance reasons that you add all the GtkSourceTag tags with highlighting disabled and enable it when finished.

gtk_source_buffer_get_highlight ()

gboolean            gtk_source_buffer_get_highlight     (GtkSourceBuffer *buffer);

Determines whether text highlighting is activated in the source buffer.

gtk_source_buffer_set_language ()

void                gtk_source_buffer_set_language      (GtkSourceBuffer *buffer,
                                                         GtkSourceLanguage *language);

Sets the GtkSourceLanguage the source buffer will use, adding GtkSourceTag tags with the language's patterns. Note that this will remove any GtkSourceTag tags currently in the buffer's tag table. The buffer holds a reference to the language set.

gtk_source_buffer_get_language ()

GtkSourceLanguage*  gtk_source_buffer_get_language      (GtkSourceBuffer *buffer);

Determines the GtkSourceLanguage used by the buffer. The returned object should not be unreferenced by the user.

gtk_source_buffer_set_check_brackets ()

void                gtk_source_buffer_set_check_brackets
                                                        (GtkSourceBuffer *buffer,
                                                         gboolean check_brackets);

Controls the bracket match highlighting function in the buffer. If activated, when you position your cursor over a bracket character (a parenthesis, a square bracket, etc.) the matching opening or closing bracket character will be highlighted. You can specify the style with the gtk_source_buffer_set_bracket_match_style() function.

gtk_source_buffer_get_check_brackets ()

gboolean            gtk_source_buffer_get_check_brackets
                                                        (GtkSourceBuffer *buffer);

Determines whether bracket match highlighting is activated for the source buffer.

gtk_source_buffer_set_style_scheme ()

void                gtk_source_buffer_set_style_scheme  (GtkSourceBuffer *buffer,
                                                         GtkSourceStyleScheme *scheme);

Sets style scheme used by the buffer.

gtk_source_buffer_get_style_scheme ()

GtkSourceStyleScheme* gtk_source_buffer_get_style_scheme
                                                        (GtkSourceBuffer *buffer);

Returns the GtkSourceStyleScheme currently used in buffer.

gtk_source_buffer_get_max_undo_levels ()

gint                gtk_source_buffer_get_max_undo_levels
                                                        (GtkSourceBuffer *buffer);

Determines the number of undo levels the buffer will track for buffer edits.

gtk_source_buffer_set_max_undo_levels ()

void                gtk_source_buffer_set_max_undo_levels
                                                        (GtkSourceBuffer *buffer,
                                                         gint max_undo_levels);

Sets the number of undo levels for user actions the buffer will track. If the number of user actions exceeds the limit set by this function, older actions will be discarded.

A new action is started whenever the function gtk_text_buffer_begin_user_action() is called. In general, this happens whenever the user presses any key which modifies the buffer, but the undo manager will try to merge similar consecutive actions, such as multiple character insertions into one action. But, inserting a newline does start a new action.

gtk_source_buffer_redo ()

void                gtk_source_buffer_redo              (GtkSourceBuffer *buffer);

Redoes the last undo operation. Use gtk_source_buffer_can_redo() to check whether a call to this function will have any effect.

gtk_source_buffer_undo ()

void                gtk_source_buffer_undo              (GtkSourceBuffer *buffer);

Undoes the last user action which modified the buffer. Use gtk_source_buffer_can_undo() to check whether a call to this function will have any effect.

Actions are defined as groups of operations between a call to gtk_text_buffer_begin_user_action() and gtk_text_buffer_end_user_action(), or sequences of similar edits (inserts or deletes) on the same line.

gtk_source_buffer_can_redo ()

gboolean            gtk_source_buffer_can_redo          (GtkSourceBuffer *buffer);

Determines whether a source buffer can redo the last action (i.e. if the last operation was an undo).

gtk_source_buffer_can_undo ()

gboolean            gtk_source_buffer_can_undo          (GtkSourceBuffer *buffer);

Determines whether a source buffer can undo the last action.

gtk_source_buffer_begin_not_undoable_action ()

void                gtk_source_buffer_begin_not_undoable_action
                                                        (GtkSourceBuffer *buffer);

Marks the beginning of a not undoable action on the buffer, disabling the undo manager. Typically you would call this function before initially setting the contents of the buffer (e.g. when loading a file in a text editor).

You may nest gtk_source_buffer_begin_not_undoable_action() / gtk_source_buffer_end_not_undoable_action() blocks.

gtk_source_buffer_end_not_undoable_action ()

void                gtk_source_buffer_end_not_undoable_action
                                                        (GtkSourceBuffer *buffer);

Marks the end of a not undoable action on the buffer. When the last not undoable block is closed through the call to this function, the list of undo actions is cleared and the undo manager is re-enabled.

gtk_source_buffer_create_marker ()

GtkSourceMarker*    gtk_source_buffer_create_marker     (GtkSourceBuffer *buffer,
                                                         const gchar *name,
                                                         const gchar *type,
                                                         const GtkTextIter *where);

Creates a marker in the buffer of type type. A marker is semantically very similar to a GtkTextMark, except it has a type which is used by the GtkSourceView displaying the buffer to show a pixmap on the left margin, at the line the marker is in. Because of this, a marker is generally associated to a line and not a character position. Markers are also accessible through a position or range in the buffer.

Markers are implemented using GtkTextMark, so all characteristics and restrictions to marks apply to markers too. These includes life cycle issues and "mark-set" and "mark-deleted" signal emissions.

Like a GtkTextMark, a GtkSourceMarker can be anonymous if the passed name is NULL. Also, the buffer owns the markers so you shouldn't unreference it.

Markers always have left gravity and are moved to the beginning of the line when the user deletes the line they were in. Also, if the user deletes a region of text which contained lines with markers, those are deleted.

Typical uses for a marker are bookmarks, breakpoints, current executing instruction indication in a source file, etc..

gtk_source_buffer_delete_marker ()

void                gtk_source_buffer_delete_marker     (GtkSourceBuffer *buffer,
                                                         GtkSourceMarker *marker);

Deletes marker from the source buffer. The same conditions as for GtkTextMark apply here. The marker is no longer accessible from the buffer, but if you held a reference to it, it will not be destroyed.

gtk_source_buffer_move_marker ()

void                gtk_source_buffer_move_marker       (GtkSourceBuffer *buffer,
                                                         GtkSourceMarker *marker,
                                                         const GtkTextIter *where);

Moves marker to the new location where.

gtk_source_buffer_get_first_marker ()

GtkSourceMarker*    gtk_source_buffer_get_first_marker  (GtkSourceBuffer *buffer);

Returns the first (nearest to the top of the buffer) marker in buffer.

gtk_source_buffer_get_last_marker ()

GtkSourceMarker*    gtk_source_buffer_get_last_marker   (GtkSourceBuffer *buffer);

Returns the last (nearest to the bottom of the buffer) marker in buffer.

gtk_source_buffer_get_marker ()

GtkSourceMarker*    gtk_source_buffer_get_marker        (GtkSourceBuffer *buffer,
                                                         const gchar *name);

Looks up the GtkSourceMarker named name in buffer, returning NULL if it doesn't exists.

gtk_source_buffer_get_markers_in_region ()

GSList*             gtk_source_buffer_get_markers_in_region
                                                        (GtkSourceBuffer *buffer,
                                                         const GtkTextIter *begin,
                                                         const GtkTextIter *end);

Returns an ordered (by position) GSList of GtkSourceMarker objects inside the region delimited by the GtkTextIter begin and end. The iters may be in any order.

gtk_source_buffer_get_next_marker ()

GtkSourceMarker*    gtk_source_buffer_get_next_marker   (GtkSourceBuffer *buffer,
                                                         GtkTextIter *iter);

Returns the nearest marker to the right of iter. If there are multiple markers at the same position, this function will always return the first one (from the internal linked list), even if starting the search exactly at its location. You can get the others using gtk_source_marker_next().

gtk_source_buffer_get_prev_marker ()

GtkSourceMarker*    gtk_source_buffer_get_prev_marker   (GtkSourceBuffer *buffer,
                                                         GtkTextIter *iter);

Returns the nearest marker to the left of iter. If there are multiple markers at the same position, this function will always return the last one (from the internal linked list), even if starting the search exactly at its location. You can get the others using gtk_source_marker_prev().

gtk_source_buffer_get_iter_at_marker ()

void                gtk_source_buffer_get_iter_at_marker
                                                        (GtkSourceBuffer *buffer,
                                                         GtkTextIter *iter,
                                                         GtkSourceMarker *marker);

Initializes iter at the location of marker.

The "can-redo" property

  "can-redo"                 gboolean              : Read

Whether Redo operation is possible.

Default value: FALSE

The "can-undo" property

  "can-undo"                 gboolean              : Read

Whether Undo operation is possible.

Default value: FALSE

The "check-brackets" property

  "check-brackets"           gboolean              : Read / Write

Whether to check and highlight matching brackets.

Default value: TRUE

The "highlight" property

  "highlight"                gboolean              : Read / Write

Whether to highlight syntax in the buffer.

Default value: TRUE

The "language" property

  "language"                 GtkSourceLanguage     : Read / Write

Language object to get highlighting patterns from.

The "max-undo-levels" property

  "max-undo-levels"          gint                  : Read / Write

Number of undo levels for the buffer.

Allowed values: [0,200]

Default value: 25

The "style-scheme" property

  "style-scheme"             GtkSourceStyleScheme  : Read / Write

Style scheme. It contains styles for syntax highlighting, optionally foreground, background, cursor color, current line color, and matching brackets style.

Since 2.0

The "highlight-updated" signal

void                user_function                      (GtkSourceBuffer *sourcebuffer,
                                                        GtkTextIter     *arg1,
                                                        GtkTextIter     *arg2,
                                                        gpointer         user_data)         : Run Last

The "marker-updated" signal

void                user_function                      (GtkSourceBuffer *sourcebuffer,
                                                        GtkTextIter     *arg1,
                                                        gpointer         user_data)         : Run Last