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.



a `GtkTextBuffer`


name for mark


location to place mark


whether the mark has left gravity


the new `GtkTextMark` object