Package: gtk

Class gtk-text-mark


g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses


Direct Slots

The left-gravity property of type :boolean (Read / Write / Construct)
Whether the mark has left gravity.
Default value: nil
The name property of type :string (Read / Write / Construct)
Mark name.
Default value: nil


A gtk-text-mark is like a bookmark in a text buffer; it preserves a position in the text.

You can convert the mark to an iterator using the function gtk-text-buffer-get-iter-at-mark. Unlike iterators, marks remain valid across buffer mutations, because their behavior is defined when text is inserted or deleted. When text containing a mark is deleted, the mark remains in the position originally occupied by the deleted text. When text is inserted at a mark, a mark with left gravity will be moved to the beginning of the newly-inserted text, and a mark with right gravity will be moved to the end.

Marks are reference counted, but the reference count only controls the validity of the memory; marks can be deleted from the buffer at any time with the function gtk-text-buffer-delete-mark. Once deleted from the buffer, a mark is essentially useless.

Marks optionally have names; these can be convenient to avoid passing the gtk-text-mark object around.

Marks are typically created using the gtk-text-buffer-create-mark function.

Slot Access Functions

Inherited Slot Access Functions

See also