TextBuffer.beginUserAction

Called to indicate that the buffer operations between here and a call to [gtk.text_buffer.TextBuffer.endUserAction] are part of a single user-visible operation.

The operations between [gtk.text_buffer.TextBuffer.beginUserAction] and [gtk.text_buffer.TextBuffer.endUserAction] can then be grouped when creating an undo stack. [gtk.text_buffer.TextBuffer] maintains a count of calls to [gtk.text_buffer.TextBuffer.beginUserAction] that have not been closed with a call to [gtk.text_buffer.TextBuffer.endUserAction], 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.text_buffer.TextBuffer.insertInteractive], 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.