This storage object holds text to be displayed by one or more TextView widgets.

• See "Text Widget Overview" in the Gtk+ docs.
• The following convenience functions are omitted: gtk_text_buffer_insert_with_tags gtk_text_buffer_insert_with_tags_by_name gtk_text_buffer_create_tag gtk_text_buffer_get_bounds gtk_text_buffer_get_selection_bounds
• The following functions do not make sense due to Haskell's wide character representation of Unicode: gtk_text_buffer_get_iter_at_line_index
• The function gtk_text_buffer_get_selection_bounds is only used to test if there is a selection (see textBufferHasSelection).

TODO

• The functionality of inserting widgets (child anchors) is not implemented since there will probably some changes before the final release. The following functions are not bound: gtk_text_buffer_insert_child_anchor gtk_text_buffer_create_child_anchor gtk_text_buffer_get_iter_at_anchor connectToInsertChildAnchor
• Check textBufferGetInsert, in case there is no cursor in the editor, is there a mark called "insert"? If not, the function needs to return Maybe TextMark. The same holds for textBufferGetSelectionBound.
• If Clipboards are bound, then these functions need to be bound as well: gtk_text_buffer_paste_clipboard gtk_text_buffer_copy_clipboard gtk_text_buffer_cut_clipboard gtk_text_buffer_add_selection_clipboard gtk_text_buffer_remove_selection_clipboard

Obtain the number of characters in the buffer.

• Note that the comment in the Gtk+ documentation about bytes and chars does not hold because Haskell uses 31-bit characters and not UTF8.

Insert text at the TextIter only if a normal user would be able to do so as well.

• Insert the text obeying special editable or non-editable Tags.
• If no tag is at the specified position, use the default value def to decide if the text should be inserted. This value could be set to the result of textViewGetEditable.

Copy text as textBufferInsertRange does, but obey editable and non-editable tags.

• Insert the text obeying special editable or non-editable Tags.
• If no tag is at the specified position, use the default value def to decide if the text should be inserted. This value could be set to the result of textViewGetEditable.

Extract all the text between start and end from a TextBuffer.

• The start position is included, end is not.
• If incl is True, text tagged with the invisible attribute is also returned.
• Characters representing embedded images are not included. (So offsets within the returned text are different from the Buffer itself.)

Extract text and special characters between start and end.

• As opposed to textBufferGetText, this function returns (chr 0xFFFC) for images, so offsets within the returned string correspond to offsets in the TextBuffer. Note the (chr 0xFFFC) can occur in normal text without images as well.

Insert an image into the TextBuffer.

• See textBufferGetSlice and textBufferGetText.

Create a TextMark from an iterator.

• Pass Nothing as mark name for an anonymous TextMark.
• Set gravity to True if the mark should keep left.

Move a mark.

• Emits "mark_set".

Move a named mark.

• The mark should exist (otherwise a nasty warning is generated).

Delete a mark.

• This renders the TextMark tm unusable forever.

Delete a mark by name.

• The mark should exist (otherwise a nasty warning is generated).

Get the current cursor position.

• This is equivalent to liftM unJust $ textBufferGetMark "insert"

Place the cursor.

• This is faster than moving the "insert" and the "selection_bound" marks in sequence since it avoids generating a transient selection.

Remove all tags within a range.

• Be careful with this function; it could remove tags added in code unrelated to the code you're currently writing. That is, using this function is probably a bad idea if you have two or more unrelated code sections that add tags.

Create an iterator at a specific line and offset.

• The line and offset arguments must be valid.

Create an iterator at a specific offset.

• The offset arguments must be valid, starting from the first character in the buffer.

Create an iterator at a specific line.

• The line arguments must be valid.

Create an iterator at the end of the buffer.

• The iterator represents the position after the last character in the buffer.

Query if the buffer was modified.

• This flag is reset by calling textBufferSetModified.
• It is usually more convenient to use "connectToModifiedChanged".

Delete the current selection.

• The interactive flag determines if this function is invoked on behalf of the user (i.e. if we honour editable/non-editable tags).
• See textBufferInsertAtCursor for information on def.
• The function returns True if a non-empty selection was deleted.

Start a new atomic user action.

• Called to indicate that the buffer operations between here and a call to textBufferEndUserAction are part of a single user-visible operation. The operations between textBufferBeginUserAction and textBufferEndUserAction can then be grouped when creating an undo stack. TextBuffer objects maintains a count of calls to textBufferBeginUserAction that have not been closed with a call to textBufferEndUserAction, and emits the "begin_user_action" and "end_user_action" signals only for the outermost pair of calls. This allows you to build user actions from other user actions. The "interactive" buffer mutation functions, such as textBufferInsertInteractive, automatically call begin/end user action around the buffer operations they perform, so there's no need to add extra calls if you user action consists solely of a single call to one of those functions.

A new atomic user action is started.

• Together with connectToEndUserAction these signals can be used to build an undo stack.

An atomic action has ended.

• see connectToBeginUserAction

A widgets is inserted into the buffer. connectToInsertChildAnchor :: TextBufferClass tb => (TextIter -> TextChildAnchor -> IO ()) -> ConnectAfter -> tb -> IO (ConnectId tb) connectToInsertChildAnchor = connect_BOXED_OBJECT__NONE insert_child_anchor mkTextIter

A Pixbuf is inserted into the buffer.