Previous Next
377
SECTION 4.10 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.
Order array (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:
• 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.
Previous Next