Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The ARS DocumentReference class corresponds with the Define-XML def:DocumentRef element that is referenced in the ARM for Define-XML specification:

ARS DocumentReference Attributes

Corresponding Define-XML def:DocumentRef Attribute/Element

referenceDocumentId

leafID attribute
pageRefsdef:PDFPageRef elements (see below)

A document reference must include the identifier of the reference document (as specified in the referenceDocumentId attribute) to indicate which document is being referenced. If needed, the document reference may also include one or more "page references" (each specified in the pageRefs attribute) to indicate the relevant page or pages within the reference document. A document reference that does not include any page references is a reference to the document as a whole.  In general, there are two types of document reference:

...

The abstract ARS PageRef class corresponds with the Define-XML def:PDFPageRef element that is referenced in the ARM for Define-XML specification:

ARS PageRef Attributes

Corresponding Define-XML def:PDFPageRef Attribute

refType

Type
labelTitle
pageNamesPageRefs
pageNumbersPageRefs
firstPageFirstPage
lastPageLastPage

All page references must include an indication of the page reference type in the refType attribute, and may also include a description of the page reference in the label attribute. Individual pages or sets of pages may be referenced in different ways using any of the specializations of the abstract PageRef class:

...

Multiple page references may be created for a single document reference if more than one type of page reference is required (e.g., reference to both a set of individual page numbers and a range of page numbers) or , if more that than one range of pages needs to be specified, or if the sponsor prefers to to assign different labels for page references of the same type.

Pagenav