create_source_mark


Description:

[ Version ( since = "2.2" ) ]
public unowned SourceMark create_source_mark (string? name, string category, TextIter where)

Creates a source mark in the this of category category.

A source mark is a TextMark but organised into categories. Depending on the category a pixbuf can be specified that will be displayed along the line of the mark.

Like a TextMark, a SourceMark can be anonymous if the passed name is null. Also, the buffer owns the marks so you shouldn't unreference it.

Marks always have left gravity and are moved to the beginning of the line when the user deletes the line they were in.

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

Parameters:

this

a SourceBuffer.

name

the name of the mark, or null.

category

a string defining the mark category.

where

location to place the mark.

Returns:

a new SourceMark, owned by the buffer.