Gtk.TextBuffer::begin_user_action
function vfunc_begin_user_action():void { }
Called to indicate that the buffer operations between here and a call to Gtk.TextBuffer.prototype.end_user_action are part of a single user-visible operation. The operations between Gtk.TextBuffer.prototype.begin_user_action and Gtk.TextBuffer.prototype.end_user_action can then be grouped when creating an undo stack. Gtk.TextBuffer maintains a count of calls to Gtk.TextBuffer.prototype.begin_user_action that have not been closed with a call to Gtk.TextBuffer.prototype.end_user_action, 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 Gtk.TextBuffer.prototype.insert_interactive, 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.