Method
GtkTextBuffercreate_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. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
where |
GtkTextIter |
Location to place mark. |
|
The data is owned by the caller of the function. | |
left_gravity |
gboolean |
Whether the mark has left gravity. |
Return value
Returns: | GtkTextMark |
The new |
|
The data is owned by the instance. |