Method

GtkTextBuffercreate_mark

Declaration [src]

GtkTextMark*
gtk_text_buffer_create_mark (
  GtkTextBuffer* buffer,
  const gchar* 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

Type: const gchar*

Name for mark, or NULL.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
where

Type: GtkTextIter

Location to place mark.

The data is owned by the caller of the method.
left_gravity

Type: gboolean

Whether the mark has left gravity.

Return value

Type: GtkTextMark

The new GtkTextMark object.

The returned data is owned by the instance.