gtktext

typedef struct _gtktext gtktext;

most of the gtktext-struct struct members should not be accessed directly. listed below are a few exceptions and how to use them.

gtktextfont

typedef struct _gtktextfont gtktextfont;

internal gtktext data type.

gtkpropertymark

typedef struct {
  /* position in list. */
  glist* property;

  /* offset into that property. */
  guint offset;

  /* current index. */
  guint index;
} gtkpropertymark;

internal gtktext data type. should not be accessed directly.

gtk_text_new ()

gtkwidget*  gtk_text_new                    (gtkadjustment *hadj,
                                             gtkadjustment *vadj);

creates a new gtktext widget, initialized with the given pointers to gtkadjustments. these pointers can be used to track the viewing position of the gtktext widget. passing null to either or both of them will make the gtktext create its own. you can set these later with the function gtk_text_set_adjustment().

gtk_text_set_editable ()

void        gtk_text_set_editable           (gtktext *text,
                                             gboolean editable);

sets whether the gtktext widget can be edited by the user or not. this still allows you the programmer to make changes with the various gtktext functions.

gtk_text_set_word_wrap ()

void        gtk_text_set_word_wrap          (gtktext *text,
                                             gboolean word_wrap);

sets whether the gtktext widget wraps words down to the next line if it can't be completed on the current line.

gtk_text_set_line_wrap ()

void        gtk_text_set_line_wrap          (gtktext *text,
                                             gboolean line_wrap);

controls how gtktext handles long lines of continuous text. if line wrap is on, the line is broken when it reaches the extent of the gtktext widget viewing area and the rest is displayed on the next line. if it is not set, the line continues regardless size of current viewing area. similar to word wrap but it disregards word boundaries.

gtk_text_set_adjustments ()

void        gtk_text_set_adjustments        (gtktext *text,
                                             gtkadjustment *hadj,
                                             gtkadjustment *vadj);

allows you to set gtkadjustment pointers which in turn allows you to keep track of the viewing position of the gtktext widget.

gtk_text_set_point ()

void        gtk_text_set_point              (gtktext *text,
                                             guint index);

sets the cursor at the given point. in this case a point constitutes the number of characters from the extreme upper left corner of the gtktext widget.

gtk_text_get_point ()

guint       gtk_text_get_point              (gtktext *text);

gets the current position of the cursor as the number of characters from the upper left corner of the gtktext widget.

gtk_text_get_length ()

guint       gtk_text_get_length             (gtktext *text);

returns the length of the all the text contained within the gtktext widget; disregards current point position.

gtk_text_freeze ()

void        gtk_text_freeze                 (gtktext *text);

freezes the gtktext widget which disallows redrawing of the widget until it is thawed. this is useful if a large number of changes are going to made to the text within the widget, reducing the amount of flicker seen by the user.

gtk_text_thaw ()

void        gtk_text_thaw                   (gtktext *text);

allows the gtktext widget to be redrawn again by gtk.

gtk_text_insert ()

void        gtk_text_insert                 (gtktext *text,
                                             gdkfont *font,
                                             const gdkcolor *fore,
                                             const gdkcolor *back,
                                             const char *chars,
                                             gint length);

inserts given text into the gtktext widget with the given properties as outlined below.

gtk_text_backward_delete ()

gboolean    gtk_text_backward_delete        (gtktext *text,
                                             guint nchars);

deletes from the current point position backward the given number of characters.

gtk_text_forward_delete ()

gboolean    gtk_text_forward_delete         (gtktext *text,
                                             guint nchars);

deletes from the current point position forward the given number of characters.

gtk_text_index()

#define     gtk_text_index(t, index)

returns the character at the given index within the gtktext widget.

the "hadjustment" property

  "hadjustment"          gtkadjustment         : read / write

used by the gtktext widget to keep track of the size of its horizontal text.

the "line-wrap" property

  "line-wrap"            gboolean              : read / write

boolean value indicating whether line wrap is enabled or not.

default value: true

the "vadjustment" property

  "vadjustment"          gtkadjustment         : read / write

used by the gtktext widget to keep track of the size of its vertical text.

the "word-wrap" property

  "word-wrap"            gboolean              : read / write

boolean value indicated whether word wrap is enabled or not.

default value: false

the "set-scroll-adjustments" signal

void        user_function                  (gtktext       *text,
                                            gtkadjustment *arg1,
                                            gtkadjustment *arg2,
                                            gpointer       user_data)      : run last