GtkText
a text widget.
#GtkText is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol %GTK_ENABLE_BROKEN
prior to including the GTK+ header files. Use #GtkTextView instead.
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.
Most of the #GtkText-struct struct members should not be accessed directly.
Listed below are a few exceptions and how to use them.
Internal #GtkText data type.
Internal #GtkText data type. Should not be accessed directly.
@property:
@offset:
@index:
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().
@hadj: horizontal adjustment.
@vadj: vertical adjustment.
@Returns: the new #GtkText widget.
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.
@text: the #GtkText widget
@editable: %TRUE makes it editable, %FALSE makes it immutable by the user
Sets whether the #GtkText widget wraps words down to the next line if it
can't be completed on the current line.
@text: the #GtkText widget
@word_wrap: %TRUE makes it word wrap, %FALSE disables word wrapping
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.
@text: the #GtkText widget
@line_wrap: %TRUE turns line wrap on, %FALSE turns it off
Allows you to set #GtkAdjustment pointers which in turn allows you to
keep track of the viewing position of the #GtkText widget.
@text: the #GtkText widget
@hadj: the horizontal adjustment
@vadj: the vertical adjustment
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.
@text: the #GtkText widget
@index: the number of characters from the upper left corner
Gets the current position of the cursor as the number of characters from
the upper left corner of the #GtkText widget.
@text: the #GtkText widget
@Returns: the number of characters from the upper left corner
Returns the length of the all the text contained within the #GtkText widget;
disregards current point position.
@text: the #GtkText widget
@Returns: the length of the 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.
@text: the #GtkText widget
Allows the #GtkText widget to be redrawn again by GTK.
@text: the #GtkText widget
Inserts given text into the #GtkText widget with the given properties as
outlined below.
@text: the #GtkText widget
@font: the #GdkFont to use
@fore: the foreground color to insert with
@back: the background color to insert with
@chars: the actual text to be inserted
@length: the length of the text to be inserted, passing -1 makes it insert
all the text.
Deletes from the current point position backward the given number of
characters.
@text: the #GtkText widget
@nchars: the number of characters to delete
@Returns: %TRUE if the operation was successful, otherwise returns %FALSE
Deletes from the current point position forward the given number of
characters.
@text: the #GtkText widget
@nchars: the number of characters to delete
@Returns: %TRUE if the operation was successful, otherwise returns %FALSE
Returns the character at the given index within the #GtkText widget.
@t: the #GtkText widget
@index: the number of characters from the upper left corner
@text: the object which received the signal.
@arg1:
@arg2:
Used by the #GtkText widget to keep track of the size of its horizontal
text.
Boolean value indicating whether line wrap is enabled or not.
Used by the #GtkText widget to keep track of the size of its vertical
text.
Boolean value indicated whether word wrap is enabled or not.