Selection.InsertCrossReference method (Word)
Inserts a cross-reference to a heading, bookmark, footnote, or endnote, or to an item for which a caption label is defined (for example, an equation, figure, or table).
Syntax
expression. InsertCrossReference( _ReferenceType_ , _ReferenceKind_ , _ReferenceItem_ , _InsertAsHyperlink_ , _IncludePosition_ , _SeparateNumbers_ , _SeparatorString_ )
expression Required. A variable that represents a Selection object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| ReferenceType | Required | Variant | The type of item for which a cross-reference is to be inserted. Can be any WdReferenceType or WdCaptionLabelID constant or a user defined caption label. |
| ReferenceKind | Required | WdReferenceKind | The information to be included in the cross-reference. |
| ReferenceItem | Required | Variant | If ReferenceType is wdRefTypeBookmark, this argument specifies a bookmark name. For all other ReferenceType values, this argument specifies the item number or name in the Reference type box in the Cross-reference dialog box. Use the GetCrossReferenceItems method to return a list of item names that can be used with this argument. |
| InsertAsHyperlink | Optional | Variant | True to insert the cross-reference as a hyperlink. |
| IncludePosition | Optional | Variant | True to insert "above" or "below," depending on the location of the reference item in relation to the cross-reference. |
| SeparateNumbers | Optional | Variant | True to use a separator to separate the numbers from the associated text. (Use only if the ReferenceType parameter is set to wdRefTypeNumberedItem and the ReferenceKind parameter is set to wdNumberFullContext.) |
| SeparatorString | Optional | Variant | Specifies the string to use as a separator if the SeparateNumbers parameter is set to True. |
Remarks
If you specify wdPageNumber for the value of ReferenceKind, you may need to repaginate the document to see the correct cross-reference information.
Example
This example inserts a sentence that contains two cross-references: one cross-reference to heading text, and another one to the page where the heading text appears.
With Selection
.Collapse Direction:=wdCollapseStart
.InsertBefore "For more information, see "
.Collapse Direction:=wdCollapseEnd
.InsertCrossReference ReferenceType:=wdRefTypeHeading, _
ReferenceKind:=wdContentText, ReferenceItem:=1
.InsertAfter " on page "
.Collapse Direction:=wdCollapseEnd
.InsertCrossReference ReferenceType:=wdRefTypeHeading, _
ReferenceKind:=wdPageNumber, ReferenceItem:=1
.InsertAfter "."
End With
See also
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.