DynaPDF Manual - Page 380

Previous Page 379   Index   Next Page 381

Function Reference
Page 380 of 839
struct TPDFCollectionInfo
{
UI32
StructSize; // Must be set to sizeof(TPDFColectionInfo)
SI32
InitalFile; // Possible values are -2, -1, or a valid embedded files handle.
TColView
InitalView; // Determines how embedded files should be displayed.
const char*
SortBy;
// Optional name of the first field that should be used to sort the
// list of embedded files.
LBOOL
SortDesc;
// If true, the list of embedded files should be sorted in
// descending order.
TPDFColSplitInfo SplitInfo;
// Determines whether a splitter bar should be displayed.
float
SplitPos;
// Meaningful only, if SplitInfo is not spiNone. The initial
// position of the splitter bar, specified as a percentage of the
// available window area (0 to 100).
};
The function returns the most important properties of a PDF Collection, also called PDF Portfolio. A
PDF collection consists of a container PDF and a set of embedded files which make up the collection.
The embedded files are mostly PDF files but can be of arbitrary type.
Remarks:
Adobe has changed the way how PDF Collections are displayed in Acrobat or Reader several
times. PDF Collections were initially fully integrated in Adobes Acrobat or Reader. Beginning
with Acrobat 10 the user interface based on Flash but Flash became obsolete and was finally
fully disabled. PDF collections do no longer work with Acrobat 10 or 11 at all.
In Acrobat DC PDF collections work again but the implementation is very restricted and it is not
known whether Adobe will maintain this feature anymore.
Due to the unclear status it is not planned to add further functions in order to access all
available properties of PDF collections.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
GetColorSpace
Syntax:
SI32 pdfGetColorSpace(
const PPDF* IPDF) // Instance pointer
typedef enum
{
esDeviceRGB
= 0,
// Device color space
esDeviceCMYK = 1,
// Device color space
esDeviceGray = 2,
// Device color space
esCalGray
= 3,
// CIE-based color space
esCalRGB
= 4,
// CIE-based color space
esLab
= 5,
// CIE-based color space
esICCBased
= 6,
// ICC-based color space -> contains an ICC profile
esPattern
= 7,
// Special color space
esIndexed
= 8,
// Special color space
esSeparation = 9,
// Special color space
esDeviceN
= 10, // Special color space
esNChannel
= 11, // Special color space
esInitSpace
= -1
// Internal -> This value cannot occur.
}TExtColorSpace;
 

Previous topic: GetCMapCount, GetCollectionInfo

Next topic: GetColorSpaceCount, GetColorSpaceObj