SECTION 4.10
377
Optional Content
KEY
TYPE
VALUE
AS
array
(Optional)
An array of usage application dictionaries (see Table 4.53) speci-
fying which usage dictionary categories (see Table 4.52) should be consulted
by viewer applications to automatically set the states of optional content
groups based on external factors, such as the current system language or
viewing magnification, and when they should be applied.
(Optional)
An array specifying the recommended order for presentation of
optional content groups in a user interface. The array elements may include
the following objects:
Order
array
•
Optional content group dictionaries, whose
Name
entry is to be displayed
in the user interface.
•
Arrays of optional content groups to allow nesting as in a tree or outline
structure. Each nested array may optionally have as its first element a text
string to be used as a non-selectable label in the user interface.
Note:
Text labels in nested arrays should be used to present collections of relat-
ed optional content groups, and not to communicate actual nesting of content
inside multiple layers of groups (see Example 4.37). To reflect actual nesting of
groups in the content, such as for layers with sublayers, nested arrays of groups
without a text label should be used (see Example 4.38).
An empty array
[]
explicitly specifies that no groups should be presented.
In the default configuration dictionary, the default value is an empty array;
in other configuration dictionaries, the default is the
Order
value from the
default configuration dictionary.
Note:
Any groups not listed in this array should not be presented in any user
interface that uses the configuration.
ListMode
name
(Optional)
A name specifying which optional content groups in the
Order
array should be displayed to the user. Valid values are:
•
AllPages
: Display all groups in the
Order
array.
•
VisiblePages
: Display only those groups in the
Order
array that are refer-
enced by one or more visible pages.
Default value:
AllPages
.