方法

GtkTextBuffercreate_mark

声明 [源]

GtkTextMark*
gtk_text_buffer_create_mark (
  GtkTextBuffer* buffer,
  const char* mark_name,
  const GtkTextIter* where,
  gboolean left_gravity
)

描述 [源]

在位置 where 创建一个标记。

如果 mark_name 是 NULL，则标记是无名的；否则，可以通过名称使用 gtk_text_buffer_get_mark() 来检索标记。如果标记具有左重力，并且在新插入的文本位置处插入文本，则标记将移动到新插入文本的左侧。如果标记具有右重力（left_gravity = FALSE），则标记将位于新插入文本的右侧。标准的从左至右的光标是一个具有右重力的标记（当你输入时，光标保持在你要输入文本的右侧）。

此函数的调用者不拥有返回的 GtkTextMark 引用，因此你可以忽略返回值。标记属于缓冲区，并在缓冲区不存在时消失。

发出 GtkTextBuffer::mark-set 信号以通知标记的初始放置。

参数

mark_name

类型: const char*

标记的名称。

参数可以是 NULL。

数据由方法的调用者拥有。

该值是一个以 NULL 结尾的 UTF-8 字符串。

where

类型: GtkTextIter

放置标记的位置。

数据由方法的调用者拥有。

left_gravity

类型: gboolean

标记是否具有左重力。

返回值

类型: GtkTextMark

新的 GtkTextMark 对象。

返回的数据由实例拥有。