text-props.el

约 411 字大约 1 分钟

2025-10-09

内置函数介绍

下面所有函数参数中可选的 object 可以是 string 或 buffer，nil 表示当前 buffer。

(put-text-property start end prop value &optional object)
给 object 的 start 到 end 范围内的文本设置 prop 属性的值为 value。如果属性已经存在，会用当前值覆盖。
(add-text-properties start end props &optional object)
给 object 的 start 到 end 范围内的文本设置多个属性，props 是 property lists。如果属性已经存在，会用当前值覆盖。
(remove-text-properties start end props &optional object)
移除 object 的 start 到 end 范围内的文本的属性，props 是一个 property lists，但其中属性的值无效。
(remove-list-of-text-properties start end list-of-properties &optional object)
移除 object 的 start 到 end 范围内的文本的属性，list-of-properties 是属性名的列表
(set-text-properties start end props &optional object)
替换 object 的 start 到 end 范围内的文本的属性为 props，props 是一个 property lists。相当于清除掉该范围内的所有属性后重新设置为新的。
(add-face-text-property start end face &optional appendp object)
给 object 的 start 到 end 范围内的文本增加 face 属性，appendp 为 t 是表示追加在后面。该方法不会覆盖 face 中已有的属性，每次执行都会增加一个。
(propertize string &rest properties)
给 string 中每个字符设置 properties 属性，properties 是一个属性列表。已经存在的属性会被覆盖。返回一个设置了属性的新的字符串。