Previous Next

                                                      656
       CHAPTER 8                                                                Interactive Features



       Embedded go-to actions provide a complete facility for linking between a file in a
       hierarchy of nested embedded files and another file in the same or different hier-
       archy. The following terminology is used:

       • The source is the document containing the embedded go-to action.
       • The target is the document in which the destination lives.
            The T entry in the action dictionary is a target dictionary that locates the target
            in relation to the source, in much the same way that a relative path describes
            the physical relationship between two files in a file system. Target dictionaries
            may be nested recursively to specify one or more intermediate targets before
            reaching the final one. As the hierarchy is navigated, each intermediate target is
            referred to as the current document. Initially, the source is the current docu-
            ment.
            Note: It is an error for a target dictionary to have an infinite cycle (for example,
            one where a target dictionary refers to itself). Viewer applications should attempt
            to detect such cases and refuse to execute the action if found.
       • A child document is one that is embedded within another PDF file.
       • The document in which a file is embedded is its parent.
       • A root document is one that is not embedded in another PDF file. The target
            and source may be contained in root documents or embedded documents.

                    TABLE 8.51 Additional entries specific to an embedded go-to action
KEY          TYPE                 VALUE

S            name                 (Required) The type of action that this dictionary describes; must be GoToE
                                  for an embedded go-to action.

F            file specification   (Optional) The root document of the target relative to the root document of
                                  the source. If this entry is absent, the source and target share the same root
                                  document.

D            name,                (Required) The destination in the target to jump to (see Section 8.2.1, “Desti-
             byte string,         nations”).
             or array

NewWindow    boolean              (Optional) If true, the destination document should be opened in a new win-
                                  dow; if false, the destination document should replace the current document
                                  in the same window. If this entry is absent, the viewer application should hon-
                                  or the current user preference.

Previous Next