68. selectById
Prev | Chapter 6. Commands written in the Java™ programming language | Next

## 68. selectById

Parameter syntax:

    ('id' | 'reference' | 'nextReference' |
    'previousReference' | 'swapIdAndReference') S [ id ]?

id

  An element with an IDREF or IDREFS attribute must be implicitly or explicitly selected. Scrolls to and selects the element having this ID (if found).

reference

  An element with an ID attribute must be implicitly or explicitly selected. Scrolls to and selects first element referencing this ID (if found).

nextReference

  An element with an IDREF or IDREFS attribute must be implicitly or explicitly selected. Scrolls to and selects following element referencing this ID (if found).

previousReference

  An element with an IDREF or IDREFS attribute must be implicitly or explicitly selected. Scrolls to and selects preceding element referencing this ID (if found).

swapIdAndReference

  An element with an ID, IDREF or IDREFS attribute must be implicitly or explicitly selected. Scrolls to and selects opposite link end (if found).

Notes:

- An ID argument may be specified with options `id` and `reference` (but not with options `nextReference`, `previousReference` and `swapIdAndReference`). When this ID argument is specified (non interactive command typically used in a macro), there is no need for an element with an ID, IDREF or IDREFS attribute to be implicitly or explicitly selected.

- When implicitly or explicitly selected element has an IDREFS attribute containing several IDs, user is prompted to choose on of these IDs.

Examples:

    selectById swapIdAndReference
    selectById id introduction

Prev | Up | Next
67. selectBlockAtY | Home | 69. selectFile