WPS 加载项开发 > 文字 API 参考 > Range > 方法 > Range.InsertCrossReference 方法
插入对标题、书签、脚注、尾注或定义了题注标签的项（如公式、图表或表格）的交叉引用。

语法

表达式.InsertCrossReference(ReferenceType, ReferenceKind, ReferenceItem, InsertAsHyperlink, IncludePosition, SeparateNumbers, SeparatorString)

表达式   必选。一个代表 Range 对象的变量。

参数

名称 必选/可选 数据类型 说明
ReferenceType 必选 Variant 要插入交叉引用的项目的类型。可以是任意 WdReferenceType 或 WdCaptionLabelID 常量，也可以是用户定义的题注标签。
ReferenceKind 必选 WdReferenceKind 要包含在交叉引用中的信息。
ReferenceItem 必选 Variant 如果 ReferenceType 为 wdRefTypeBookmark，则此参数指定一个书签名称。对于所有其他 ReferenceType 值，此参数将指定“交叉引用”对话框的“引用类型”选项中的项目编号或名称。使用 GetCrossReferenceItems 方法可返回能够用于此参数的项目名称的列表。
InsertAsHyperlink 可选 Variant 如果该参数值为 True，则将交叉引用作为超链接插入到引用项目中。
IncludePosition 可选 Variant 如果该参数值为 True，则根据引用项目相对于交叉引用的位置插入“above”或“below”。
IncludePosition 可选 Variant 如果该参数值为 True，则使用分隔符将数字从关联文本中分离出来。（仅在将 ReferenceType 参数设置为 wdRefTypeNumberedItem 并将 ReferenceKind 参数设置为 wdNumberFullContext 时才可使用）。
IncludePosition 可选 Variant 如果 SeparateNumbers 参数设置为 True，则指定字符串用作分隔符。

说明

如果指定 wdPageNumber 作为 ReferenceKind 的值，则可能需要对文档重新分页才能看到正确的交叉引用信息。

示例

以下示例在活动文档的开头插入一个对包含文档中第一个书签的页的交叉引用。

示例代码 
let myRange = ActiveDocument.Range(0, 0)
let myBookmarks = ActiveDocument.GetCrossReferenceItems(wdRefTypeBookmark)
myRange.InsertBefore("Page ")
myRange.Collapse(wdCollapseEnd)
myRange.InsertCrossReference(wdRefTypeBookmark, wdPageNumber, myBookmarks[1])


请参阅