create_mark


Description:

public unowned TextMark create_mark (string? mark_name, TextIter where, bool left_gravity)

Creates a mark at position where.

If mark_name is null, the mark is anonymous; otherwise, the mark can be retrieved by name using [method@Gtk.TextBuffer.get_mark]. If a mark has left gravity, and text is inserted at the mark’s current location, the mark will be moved to the left of the newly-inserted text. If the mark has right gravity (left_gravity = false), the mark will end up on the right of newly-inserted text. The standard left-to-right cursor is a mark with right gravity (when you type, the cursor stays on the right side of the text you’re typing).

The caller of this function does not own a reference to the returned `GtkTextMark`, so you can ignore the return value if you like. Marks are owned by the buffer and go away when the buffer does.

Emits the [signal@Gtk.TextBuffer:GtkTextBuffer:mark-set] signal as notification of the mark's initial placement.

Parameters:

this

a `GtkTextBuffer`

mark_name

name for mark

where

location to place mark

left_gravity

whether the mark has left gravity

Returns:

the new `GtkTextMark` object