DynaPDF Manual - Page 251

Previous Page 250   Index   Next Page 252

Function Reference
Page 251 of 839
Acrobat 9 or higher displays the embedded files as thumbnails in a navigation pane. The fields
FileName and Description are shown below or beside the thumbnail. The other fields are displayed
in the Properties dialog of an embedded file.
Acrobat 9 or higher support also SWF files to manage the collection presentation. It is not possible to
create SWF based collections with DynaPDF but it is possible to import such a collection and to add
further embedded files to it.
The embedded files of a collection are shown in a list view in Acrobat or Reader 8. Without
adding further information to the collection, the list view contains a set of default columns such
as file name, description, modification date and so on, displayed in the current language of the
viewer. The information displayed in the rows is taken from the embedded files.
The information displayed in the list view can be customized to your own requirements. To
understand how this works keep in mind that a list view consists of columns and rows. The
columns which should be displayed are defined in the collection (collection fields) while the
information displayed in the rows is taken from the embedded files.
To customize the list view of a collection you must first create one or more collection fields with
CreateCollectionField(). The function defines the column name as well as the key and data type
to be used for that column. The information for the collection field is stored in the embedded
files.
Therefore, each field that was defined in the collection should have a related collection item in
all embedded files file specification dictionaries. However, only user defined fields require a
collection item. Depending on the data type that was defined for a specific collection field, the
collection items can be added to the embedded files with the following functions:
CreateColItemDate()
CreateColItemNumber()
CreateColItemString()
The functions above require always the embedded file’s handle, the key, and the data for that
key. The key was defined in the prior CreateCollectionField() call. Note that the key of a
collection field is used to find the data in the embedded files file specification dictionaries. The
column name is used to display it in the user interface.
Once the collection fields and items were defined it is possible to mark one field as sort field.
The list is then sorted by this field either in ascending or descending order (see SetColSortField()
for further information).
Remarks:
DynaPDF contains example projects which demonstrate how collection fields and items can be
created. Use the function CheckCollection() to determine whether the connection between collection
fields and collection items is valid.
 

Previous topic: CreateCollection

Next topic: CreateCollectionField