GtkTextMark

GtkTextMark

Synopsis

#include <gtk/gtk.h>

                    GtkTextMark;
GtkTextMark *       gtk_text_mark_new                   (const gchar *name,
                                                         gboolean left_gravity);
void                gtk_text_mark_set_visible           (GtkTextMark *mark,
                                                         gboolean setting);
gboolean            gtk_text_mark_get_visible           (GtkTextMark *mark);
gboolean            gtk_text_mark_get_deleted           (GtkTextMark *mark);
const gchar*        gtk_text_mark_get_name              (GtkTextMark *mark);
GtkTextBuffer*      gtk_text_mark_get_buffer            (GtkTextMark *mark);
gboolean            gtk_text_mark_get_left_gravity      (GtkTextMark *mark);

Description

Details

GtkTextMark

typedef struct {
  GObject parent_instance;
} GtkTextMark;


gtk_text_mark_new ()

GtkTextMark *       gtk_text_mark_new                   (const gchar *name,
                                                         gboolean left_gravity);

Creates a text mark. Add it to a buffer using gtk_text_buffer_add_mark(). If 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).

name :

mark name or NULL. [allow-none]

left_gravity :

whether the mark should have left gravity

Returns :

new GtkTextMark

Since 2.12


gtk_text_mark_set_visible ()

void                gtk_text_mark_set_visible           (GtkTextMark *mark,
                                                         gboolean setting);

Sets the visibility of mark; the insertion point is normally visible, i.e. you can see it as a vertical bar. Also, the text widget uses a visible mark to indicate where a drop will occur when dragging-and-dropping text. Most other marks are not visible. Marks are not visible by default.

mark :

a GtkTextMark

setting :

visibility of mark

gtk_text_mark_get_visible ()

gboolean            gtk_text_mark_get_visible           (GtkTextMark *mark);

Returns TRUE if the mark is visible (i.e. a cursor is displayed for it).

mark :

a GtkTextMark

Returns :

TRUE if visible

gtk_text_mark_get_deleted ()

gboolean            gtk_text_mark_get_deleted           (GtkTextMark *mark);

Returns TRUE if the mark has been removed from its buffer with gtk_text_buffer_delete_mark(). See gtk_text_buffer_add_mark() for a way to add it to a buffer again.

mark :

a GtkTextMark

Returns :

whether the mark is deleted

gtk_text_mark_get_name ()

const gchar*        gtk_text_mark_get_name              (GtkTextMark *mark);

Returns the mark name; returns NULL for anonymous marks.

mark :

a GtkTextMark

Returns :

mark name

gtk_text_mark_get_buffer ()

GtkTextBuffer*      gtk_text_mark_get_buffer            (GtkTextMark *mark);

Gets the buffer this mark is located inside, or NULL if the mark is deleted.

mark :

a GtkTextMark

Returns :

the mark's GtkTextBuffer. [transfer none]

gtk_text_mark_get_left_gravity ()

gboolean            gtk_text_mark_get_left_gravity      (GtkTextMark *mark);

Determines whether the mark has left gravity.

mark :

a GtkTextMark

Returns :

TRUE if the mark has left gravity, FALSE otherwise