forked from AuroraMiddleware/gtk
5f91b6fca6
2000-11-04 Havoc Pennington <hp@pobox.com> * gtk/gtk-sections.txt: Added a bunch of stuff from unused 2000-11-04 Havoc Pennington <hp@pobox.com> * gtk/gtkenums.h: remove trailing comma from GtkDeleteType member list * docs/Changes-2.0.txt: Add note about gtk_container_get_toplevels() * gtk/gtktextview.h: formatting * gtk/gtktextview.c: don't start descriptions with "Returns", confuses gtk-doc
100 lines
2.3 KiB
Plaintext
100 lines
2.3 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkTextMark
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
A position in the buffer preserved across buffer modifications
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
You may wish to begin by reading the <link linkend="TextWidget">text widget
|
|
conceptual overview</link> which gives an overview of all the objects and data
|
|
types related to the text widget and how they work together.
|
|
</para>
|
|
|
|
<para>
|
|
A #GtkTextMark is like a bookmark in a text buffer; it preserves a position in
|
|
the text. You can convert the mark to an iterator using
|
|
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 <firstterm>left gravity</firstterm> will be moved to the
|
|
beginning of the newly-inserted text, and a mark with <firstterm>right
|
|
gravity</firstterm> will be moved to the end.
|
|
|
|
<footnote>
|
|
<para>
|
|
"left" and "right" here refer to logical direction (left is the toward the start
|
|
of the buffer); in some languages such as Hebrew the logically-leftmost text is
|
|
not actually on the left when displayed.
|
|
</para>
|
|
</footnote>
|
|
</para>
|
|
|
|
<para>
|
|
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
|
|
gtk_text_buffer_delete_mark(). Once deleted from the buffer, a mark is
|
|
essentially useless.
|
|
</para>
|
|
|
|
<para>
|
|
Marks optionally have names; these can be convenient to avoid passing the
|
|
#GtkTextMark object around.
|
|
</para>
|
|
|
|
<para>
|
|
Marks are typically created using the gtk_text_buffer_create_mark() function.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkTextMark ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent_instance:
|
|
@segment:
|
|
|
|
<!-- ##### FUNCTION gtk_text_mark_set_visible ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@mark:
|
|
@setting:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_text_mark_is_visible ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@mark:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_text_mark_get_deleted ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@mark:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_text_mark_get_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@mark:
|
|
@Returns:
|
|
|
|
|