Table 150 – Entries in a viewer preferences dictionary

Key

Type

Value

HideToolbar

boolean

(Optional) A flag specifying whether to hide the conforming reader’s tool bars when the document is active. Default value: false.

HideMenubar

boolean

(Optional) A flag specifying whether to hide the conforming reader’s menu bar when the document is active. Default value: false.

HideWindowUI

boolean

(Optional) A flag specifying whether to hide user interface elements in the document’s window (such as scroll bars and navigation controls), leaving only the document’s contents displayed. Default value: false.

FitWindow

boolean

(Optional) A flag specifying whether to resize the document’s window to fit the size of the first displayed page. Default value: false.

CenterWindow

boolean

(Optional) A flag specifying whether to position the document’s window in the center of the screen. Default value: false.

DisplayDocTitle

boolean

(Optional; PDF 1.4) A flag specifying whether the window’s title bar should display the document title taken from the Title entry of the document information dictionary (see 14.3.3, “Document Information Dictionary” ). If false, the title bar should instead display the name of the PDF file containing the document. Default value: false.

NonFullScreenPageMode

name

(Optional) The document’s page mode, specifying how to display the document on exiting full-screen mode:

UseNone Neither document outline nor thumbnail images visible

UseOutlines Document outline visible

UseThumbs Thumbnail images visible

UseOC Optional content group panel visible

This entry is meaningful only if the value of the PageMode entry in the Catalog dictionary (see 7.7.2, “Document Catalog” ) is FullScreen; it shall be ignored otherwise. Default value: UseNone.

Direction

name

(Optional; PDF 1.3) The predominant reading order for text:

L2R Left to right

R2L Right to left (including vertical writing systems, such as Chinese, Japanese, and Korean)

This entry has no direct effect on the document’s contents or page numbering but may be used to determine the relative positioning of pages when displayed side by side or printed n-up. Default value: L2R.

ViewArea

name

(Optional; PDF 1.4) The name of the page boundary representing the area of a page that shall be displayed when viewing the document on the screen. The value is the key designating the relevant page boundary in the page object (see 7.7.3, “Page Tree” and 14.11.2, “Page Boundaries” ). If the specified page boundary is not defined in the page object, its default value shall be used, as specified in Ta b l e 30 . Default value: CropBox.

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in 14.11.2, “Page Boundaries.”

NOTE 1 Most conforming readers disregard it.

ViewClip

name

(Optional; PDF 1.4) The name of the page boundary to which the contents of a page shall be clipped when viewing the document on the screen. The value is the key designating the relevant page boundary in the page object (see 7.7.3, “Page Tree” and 14.11.2, “Page Boundaries” ). If the specified page boundary is not defined in the page object, its default value shall be used, as specified in Ta b l e 30 . Default value: CropBox.

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in 14.11.2, “Page Boundaries.”

NOTE 2 Most conforming readers disregard it.

PrintArea

name

(Optional; PDF 1.4) The name of the page boundary representing the area of a page that shall be rendered when printing the document. The value is the key designating the relevant page boundary in the page object (see 7.7.3, “Page Tree” and 14.11.2, “Page Boundaries” ). If the specified page boundary is not defined in the page object, its default value shall be used, as specified in Ta b l e 30 . Default value: CropBox.

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in 14.11.2, “Page Boundaries.”

NOTE 3 Most conforming readers disregard it.

PrintClip

name

(Optional; PDF 1.4) The name of the page boundary to which the contents of a page shall be clipped when printing the document. The value is the key designating the relevant page boundary in the page object (see 7.7.3, “Page Tree” and 14.11.2, “Page Boundaries” ). If the specified page boundary is not defined in the page object, its default value shall be used, as specified in Ta b l e 30 . Default value: CropBox.

This entry is intended primarily for use by prepress applications that interpret or manipulate the page boundaries as described in 14.11.2, “Page Boundaries.”

NOTE 4 Most conforming readers disregard it.

PrintScaling

name

(Optional; PDF 1.6) The page scaling option that shall be selected when a print dialog is displayed for this document. Valid values are None, which indicates no page scaling, and AppDefault, which indicates the conforming reader’s default print scaling. If this entry has an unrecognized value, AppDefault shall be used. Default value: AppDefault.

If the print dialog is suppressed and its parameters are provided from some other source, this entry nevertheless shall be honored.

Duplex

name

(Optional; PDF 1.7) The paper handling option that shall be used when printing the file from the print dialog. The following values are valid:

Simplex Print single-sided

DuplexFlipShortEdge Duplex and flip on the short edge of the sheet

DuplexFlipLongEdge Duplex and flip on the long edge of the sheet

Default value: none

PickTrayByPDFSize

boolean

(Optional; PDF 1.7) A flag specifying whether the PDF page size shall be used to select the input paper tray. This setting influences only the preset values used to populate the print dialog presented by a conforming reader. If PickTrayByPDFSize is true, the check box in the print dialog associated with input paper tray shall bechecked.

This setting has no effect on operating systems that do not provide the ability to pick the input tray by size.

Default value: as defined by the conforming reader

PrintPageRange

array

(Optional; PDF 1.7) The page numbers used to initialize the print dialog box when the file is printed. The array shall contain an even number of integers to be interpreted in pairs, with each pair specifying the first and last pages in a sub-range of pages to be printed.The first page of the PDF file shall be denoted by 1. Default value: as defined by the conforming reader

NumCopies

integer

(Optional; PDF 1.7) The number of copies that shall be printed when the print dialog is opened for this file. Values outside this range shall be ignored.

Default value: as defined by the conforming reader, but typically 1