17.16.5.23 GOTOBUTTON
-
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
footnote
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).
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]
Syntax: