mark 参数

使用 mark 参数来查询、设置或除去已命名的或未命名的标记。标记是对文档的相连部分指定的标签。编辑文档时,会保持标记的位置,因此标记不会与最初的文本分离。

有两种类型的标记,即元素标记和字符标记。元素标记没有列位置,因此只引用完整的元素。字符标记有列位置,因此可以引用部分元素。还可以指定标记是否应该是粘性标记。如果刚好在标记之前或之后的位置添加文本,则粘性标记将展开。

可用性

query 命令
set 命令

作用域

当前视图。

语法

query mark.[name | #id]
set mark.[name | #id] { clear
                      | [ sticky ] element [ element1 [ element2 ] ]
                      | [ sticky ] [ element1 [ column1 [ element2 [ column2 ] ] ] ]
                      } 

参数

name 使用 name 参数来指定新名称或现有标记的名称。名称可以包含除空格之外的任何字符,但不能以 # 字符开头。
id 使用 id 参数来指定现有标记的标识。标识是正整数值,它唯一地标识标记。
clear 使用 clear 参数来除去指定的标记。
[ sticky ] element
[ element1 [ element2 ] ]
如果当刚好在标记之前或之后添加元素时要展开此标记,则指定可选的 sticky 参数。使用 element 参数来指示应该将标记创建为(或重新创建为)元素标记。元素标记只引用完整的元素。 

指定可选的 element1element2 参数以指示元素标记的范围。element1element2 必须是正整数,并且是指元素序数。如果未指定 element2,则创建标记时将 element1 既用作标记起始也用作标记结束。如果未指定 element1element2,则创建标记时将当前元素既用作标记起始也用作标记结束。
[ sticky ]
[ element1 [ column1
[ element2 [ column2 ] ] ] ]
如果当刚好在标记之前或之后添加文本时要展开此标记,则指定可选的 sticky 参数。如果未指定任何参数,则将创建字符标记。字符标记包含带有起始列的起始元素以及带有结束列的结束元素。缺省情况下,在创建字符标记时,它的起始点和结束点都位于当前光标位置。 

如果仅指定 element1,则标记在指定元素的第 1 列开始和结束。如果仅指定 element1column1,则元素在指定的位置开始和结束。如果仅指定 element1column1element2,则标记在 element1column1 开始,并在 element2 的第 1 列结束。

描述

如果未指定标记名称或标记标识,并且未指定 clear 选项,则将创建未命名的标记。只能通过标识来引用这个未命名的标记。可通过发出“query markId.”(注意尾部的句点)来确定标记的标识。“query markId.”将返回所创建的上一个标记的标识。如果未指定标记名称或标记标识,而指定了 clear 选项,则将除去所创建的上一个标记。

示例

query mark.test
set mark.test element 5 10
set mark.test sticky 1 1 1 1
set mark.test clear
set mark. element
query markId.
query mark.#2
set mark.#2 clear 

相关参考
locate 命令
query 命令
set 命令
headerMark 参数
markExcluded 参数
markExcludedHeader 参数
markHighlight 参数
markId 参数
markIncluded 参数
markProtect 参数
markStyle 参数
findMark 操作
findQuickMark 操作
nameMark 操作
setQuickMark 操作