[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
Syntax:
GOTOBUTTON field-argument-1 field-argument-2
field-argument-1:
expression
field-argument-2:
expression
Description: Inserts a jump command, such that when it is activated, the insertion point of the document is moved to the location specified by text in field-argument-1. text can be a bookmark, a page number, or some other item (as described below). The page number can be a reference resulting from a REF field. The other items than can be locations are:
|
a n |
annotation |
|
f n | |
|
l n |
line |
|
p n |
page |
|
s n |
section |
where n is an integer that designates the nth occurrence of the corresponding item (which is not necessarily the item numbered n).
text in field-argument-2 is the text or graphic "button" that appears in the document, such that it can be selected to activate the jump. [Note: The BOOKMARK and INCLUDEPICTURE fields make for some interesting button possibilities. end note] The text or graphic shall appear on one line in the field result; otherwise, an error occurs.
Field Value: None.
Switches: None.
[Example: Consider the following fields:
GOTOBUTTON MyBookmark Dest
GOTOBUTTON p3 Page
GOTOBUTTON "f 2" Footnote
When the Dest "button" is activated, the insertion point becomes the location marked by MyBookmark. When Page is activated, the insertion point becomes the beginning of the third page. When Footnote is activated, the insertion point becomes the marker of the second footnote, at the place it is used in the document, not in any footnote list.
end example]