Method
Gtk.TextBuffer.create_mark
Declaration [src]
GtkTextMark*
gtk_text_buffer_create_mark (
GtkTextBuffer* buffer,
const char* mark_name,
const GtkTextIter* where,
gboolean left_gravity
)
Description [src]
Creates a mark at position where.
If mark_name is NULL, the mark is anonymous; otherwise, the mark
can be retrieved by name using gtk_text_buffer_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 GtkTextBuffer::mark-set signal as notification of
the mark’s initial placement.
Parameters
mark_name |
const char* |
name for mark, or |
|
Can be NULL | |
| Ownership is not transferred to the callee | |
| The string is a NUL terminated UTF-8 string | |
where |
GtkTextIter |
location to place mark |
|
| Ownership is not transferred to the callee | |
left_gravity |
gboolean |
whether the mark has left gravity |
Return value
Returns: GtkTextMark |
|
the new |
|
| Ownership is not transferred to the caller | |