Synopsis#include <gtk/gtk.h> GtkText; GtkTextFont; GtkPropertyMark; GtkWidget* gtk_text_new (GtkAdjustment *hadj, GtkAdjustment *vadj); void gtk_text_set_editable (GtkText *text, gboolean editable); void gtk_text_set_word_wrap (GtkText *text, gboolean word_wrap); void gtk_text_set_line_wrap (GtkText *text, gboolean line_wrap); void gtk_text_set_adjustments (GtkText *text, GtkAdjustment *hadj, GtkAdjustment *vadj); void gtk_text_set_point (GtkText *text, guint index); guint gtk_text_get_point (GtkText *text); guint gtk_text_get_length (GtkText *text); void gtk_text_freeze (GtkText *text); void gtk_text_thaw (GtkText *text); void gtk_text_insert (GtkText *text, GdkFont *font, const GdkColor *fore, const GdkColor *back, const char *chars, gint length); gboolean gtk_text_backward_delete (GtkText *text, guint nchars); gboolean gtk_text_forward_delete (GtkText *text, guint nchars); #define GTK_TEXT_INDEX (t, index) Object HierarchyGObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkOldEditable +----GtkText Properties"hadjustment" GtkAdjustment* : Read / Write "line-wrap" gboolean : Read / Write "vadjustment" GtkAdjustment* : Read / Write "word-wrap" gboolean : Read / Write Description
Warning
GtkText is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol 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. DetailsGtkTexttypedef struct _GtkText GtkText; Warning
Most of the GtkText struct members should not be accessed directly. Listed below are a few exceptions and how to use them. GtkTextFonttypedef struct _GtkTextFont GtkTextFont; Warning
Internal GtkText data type. GtkPropertyMarktypedef struct { /* Position in list. */ GList* property; /* Offset into that property. */ guint offset; /* Current index. */ guint index; } GtkPropertyMark; Warning
Internal GtkText data type. Should not be accessed directly. gtk_text_new ()GtkWidget* gtk_text_new (GtkAdjustment *hadj, GtkAdjustment *vadj); Warning
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
gtk_text_set_editable ()void gtk_text_set_editable (GtkText *text, gboolean editable); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
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); Warning
Deletes from the current point position forward the given number of characters.
Property DetailsThe
|
|
the object which received the signal. |
|
|
|
|
|
user data set when the signal handler was connected. |