方法

GtkTextBufferadd_commit_notify

since: 4.16

声明 [源]

guint
gtk_text_buffer_add_commit_notify (
  GtkTextBuffer* buffer,
  GtkTextBufferNotifyFlags flags,
  GtkTextBufferCommitNotify commit_notify,
  gpointer user_data,
  GDestroyNotify destroy
)

描述 [源]

当需要对GtkTextBuffer进行更改时,添加一个GtkTextBufferCommitNotify调用。

函数显式禁止从此回调中修改GtkTextBuffer。它的目的是仅跟踪缓冲区更改。

使用GtkTextBufferCommitNotify可能比连接到GtkTextBuffer::insert-textGtkTextBuffer::delete-range信号更有优势,以避免与其他可能进一步修改GtkTextBuffer的其他信号处理器的顺序问题。

Available since: 4.16

参数

flags

类型: GtkTextBufferNotifyFlags

应向callback分发哪些通知。

commit_notify

类型: GtkTextBufferCommitNotify

一个用于提交通知的GtkTextBufferCommitNotify

user_data

类型: gpointer

用于commit_notify的闭包数据。

该参数可以是NULL
该数据由方法调用者拥有。
destroy

类型: GDestroyNotify

一个回调,当移除commit_notify时用于释放user_data

返回值

类型: guint

一个句柄ID,可用于使用gtk_text_buffer_remove_commit_notify()移除提交通知回调。