GOTOBUTTON

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	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).

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.

The text or graphic shall appear on one line in the field result; otherwise, an error occurs.

Field Value: None.

Switches: None.

example:

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.