Description
A GtkText widget allows one to display any given text and manipulate it
by deleting from one point to another, selecting a region, and various
other functions as outlined below. It is inherited from GtkEditable.
Details
struct GtkText
Most of the GtkText struct members should not be accessed directly.
Listed below are a few exceptions and how to use them.
struct GtkTextFont
Internal GtkText data type.
struct GtkPropertyMark
struct GtkPropertyMark
{
/* Position in list. */
GList* property;
/* Offset into that property. */
guint offset;
/* Current index. */
guint index;
}; |
Internal GtkText data type. Should not be access directly.
gtk_text_new ()
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 it's own. You can set these later with the function
gtk_text_set_adjustment()
gtk_text_set_editable ()
Set 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,
gint 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,
gint 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 ()
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 ()
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 ()
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 ()
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 ()
Inserts given text into the GtkText widget with the given properties as
outlined below.
gtk_text_backward_delete ()
Deletes from the current point position backward the given number of
characters.
gtk_text_forward_delete ()
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.