typedef struct tag_EPNPDFOPTIONS
{
L_UINT uStructSize;
EEPNPDFVERSION Version;
L_INT nLevelMajor;
L_INT nLevelMinor;
L_CHAR szTitle [ MAX_STRING ];
L_CHAR szSubject [ MAX_STRING ];
L_CHAR szAuthor [ MAX_STRING ];
L_CHAR szKeywords [ MAX_STRING ];
L_BOOL bNoCompression;
L_BOOL bCompressedImages;
L_INT nFactor;
L_INT nBookmarkFontsCount;
L_BOOL bBold[ MAX_BOOKMARK_FONTS ];
L_BOOL bItalic[ MAX_BOOKMARK_FONTS ];
L_INT nSize[ MAX_BOOKMARK_FONTS ];
L_CHAR szArrFonts[ MAX_BOOKMARK_FONTS ] [ LF_FACESIZE ];
L_INT nLevels;
L_INT Levels [ PDF_MAX_BOOKMARKS ];
EEPNPDFPAGEMODE PageMode;
EEPNPDFPAGELAYOUT PageLayout;
EEPNPDFMAGNIFICATION Magnification;
L_INT nCustomMag;
L_INT nStartPage;
L_INT nCountPages;
L_BOOL bShowToolbar;
L_BOOL bShowMenu;
L_BOOL bShowWindowControl;
L_BOOL bProtect;
EEPNPDFSECURITYMETHOD Method;
L_CHAR szUserPassword [ MAX_STRING ];
L_CHAR szOwnerPassword [ MAX_STRING ];
L_BOOL bCopy;
L_BOOL bEdit;
L_BOOL bComments;
L_BOOL bAssembly;
L_BOOL bPrint;
L_BOOL bFaithfulPrint;
L_BOOL bLinearized;
L_BOOL bEnableURLDetect;
L_BOOL bDashedHyperlink;
L_BOOL bForceHyperlinkColor;
COLORREF rgbHyperlink;
L_BOOL bForceEmbed;
L_BOOL bAutoEmbed;
L_BOOL bEmbedAll;
L_INT nEmbeddedFontsCount;
L_BOOL bArrChecked[ MAX_EMBEDDED_FONTS ];
L_BOOL bArrEmbedable[ MAX_EMBEDDED_FONTS ];
L_CHAR strArrFonts[ MAX_EMBEDDED_FONTS ][ MAX_STRING ];
} EPNPDFOPTIONS, L_FAR * pEPNPDFOPTIONS;
The EPNPDFOPTIONS structure provides information about PDF document properties.
|
Member |
Description |
|
|
uStructSize |
Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value. |
|
|
Version |
Value that determines the PDF version to be used while saving documents. For a list of possible values, refer to the EEPNPDFVERSION enumeration. |
|
|
nLevelMajor |
Reserved for future use. Pass 0. |
|
|
nLevelMinor |
Reserved for future use. Pass 0. |
|
|
szTitle |
Character string that contains the title of the document. |
|
|
szSubject |
Character string that contains the subject of the document. |
|
|
szAuthor |
Character string that contains the author of the document. |
|
|
szKeywords |
Character string that contains the keywords of the document. |
|
|
bNoCompression |
Flag that indicates whether to compress the text of the document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Compress the text of the document. |
|
|
FALSE |
Do not compress the text of the document. |
|
bCompressedImages |
Flag that indicates whether to compress the images of the document using JPEG compression. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Compress the images of the document. The quality factor value is specified in the nFactor member. |
|
|
FALSE |
Do not compress the images of the document. |
|
nFactor |
Value the represents the compression quality factor. Possible values range from 2 to 255, where 2 is the highest quality (which means largest file size) and 255 is the maximum compression (which means smallest file size). Use this member only if the value of bCompressedImages is set to TRUE. |
|
|
nBookmarkFontsCount |
Value that represents the number of bookmark fonts. This value determines the number of elements in the bBold, bItalic, nSize, and szArrFonts arrays. The maximum value for this member is MAX_BOOKMARK_FONTS. |
|
|
bBold |
Array of flags. Each element in this array is a flag that indicates whether the font of a specific bookmark is bold. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
The font is bold. |
|
|
FALSE |
The font is not bold. |
|
|
The number of elements in this array is specified by the value of the nBookmarkFontsCount member. |
|
|
bItalic |
Array of flags. Each element in this array is a flag that indicates whether the font of a specific bookmark is italic. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
The font is italic. |
|
|
FALSE |
The font is not italic. |
|
|
The number of elements in this array is specified by the value of the nBookmarkFontsCount member. |
|
|
nSize |
Array of values. Each element in this array is a value that represents the height in points of a font, of a specific bookmark. |
|
|
|
The number of elements in this array is specified by the value of nBookmarkFontsCount member. |
|
|
szArrFonts |
Array of character strings. Each element in this array is a character string that contains the name of the font of a specific bookmark. |
|
|
|
The number of elements in this array is specified by the value of the nBookmarkFontsCount member. |
|
|
nLevels |
Value that represents the number of bookmark levels in the Levels array. |
|
|
Levels |
Array of integer values that represent the fonts indexes in the szArrFonts member. |
|
|
PageMode |
Value that determines the display mode of PDF documents when they are initially opened. For a list of possible values, refer to the EEPNPDFPAGEMODE enumeration. |
|
|
PageLayout |
Value that determines the PDF document pages layout when it is opened. For a list of possible values, refer to the EEPNPDFPAGELAYOUT enumeration. |
|
|
Magnification |
Value that determines the magnification to be used when the PDF document is displayed initially. For a list of possible values, refer to the EEPNPDFMAGNIFICATION enumeration. |
|
|
nCustomMag |
Value that represents the custom magnification to be used when displaying the PDF document initially. Use this member only if the value of Magnification is set to PDFMAGNIFICATION_CUSTOM. |
|
|
nStartPage |
The number of the page to be displayed initially when a document is opened. |
|
|
nCountPages |
Reserved for future use. Pass 0. |
|
|
bShowToolbar |
Flag that indicates whether to show the Adobe Acrobat Reader toolbar when a document is displayed. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Show the Adobe Acrobat Reader toolbar. |
|
|
FALSE |
Do not show the Adobe Acrobat Reader toolbar. |
|
bShowMenu |
Flag that indicates whether to show the Adobe Acrobat Reader menu when a document is displayed. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Show the Adobe Acrobat Reader menu. |
|
|
FALSE |
Do not show the Adobe Acrobat Reader menu. |
|
bShowWindowControl |
Flag that indicates whether to show the Adobe Acrobat scrollbars and navigation aids when a document is displayed. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Show the Adobe Acrobat Reader scrollbars and navigation aids. |
|
|
FALSE |
Do not show the Adobe Acrobat Reader scrollbars and navigation aids. |
|
bProtect |
Flag that indicates whether to protect the PDF document by applying an encryption algorithm. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Protect a document. |
|
|
FALSE |
Do not protect a document. |
|
Method |
Value that determines the encryption algorithm to be applied to protect the PDF document. For a list of possible values, refer to the EEPNPDFSECURITYMETHOD enumeration. Use this member only if the bProtect member value is set to TRUE. |
|
|
szUserPassword |
Character string that contains the user password to open the PDF document. |
|
|
szOwnerPassword |
Character string that contains the owner password. |
|
|
bCopy |
Flag that indicates whether to give users permission to copy from the document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Give users permission to copy from the document. |
|
|
FALSE |
Do not give users permission to copy from the document. |
|
bEdit |
Flag that indicates whether to give users permission to edit the document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Give users permission to edit the document. |
|
|
FALSE |
Do not give users permission to edit the document. |
|
bComments |
Flag that indicates whether to give users permission to add comments to the document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Give users permission to add comments to the document. |
|
|
FALSE |
Do not give users permission to add comments to the document. |
|
bAssembly |
Flag that indicates whether to give users permission to add pages to or delete pages from the document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Give users permission to add pages to or delete pages from the document. |
|
|
FALSE |
Do not give users permission to add pages to or delete pages from the document. |
|
bPrint |
Flag that indicates whether to give users permission to print the document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Give users permission to print the document. |
|
|
FALSE |
Do not give users permission to print the document. |
|
bFaithfulPrint |
Flag that indicates whether give users permission to print the document in high quality. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Give users permission to print the document in high quality. |
|
|
FALSE |
Do not give users permission to print the document in high quality. |
|
bLinearized |
Flag that indicates whether to save the PDF file specifically to be loaded from the Internet. This allows the file to be loaded progressively. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Save specifically to be loaded from the internet. |
|
|
FALSE |
Normal PDF file. |
|
bEnableURLDetect |
Flag that indicates whether to enable URL detection in the PDF document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Enable URL detection. |
|
|
FALSE |
Disable URL detection. |
|
bDashedHyperlink |
Flag that indicates whether to underline the detected URLs in the PDF document with a dashed line. This value is used only if the bEnableURLDetect member is set to TRUE. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Underline the detected URLs with a dashed line. |
|
|
FALSE |
Do not underline the detected URLs with a dashed line. |
|
bForceHyperlinkColor |
Flag that indicates whether to use a custom color for the detected URLs. This value is used only if the bEnableURLDetect member is set to TRUE. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Use a custom color for the detected URLs. |
|
|
FALSE |
Do not use a custom color for the detected URLs. |
|
rgbHyperlink |
COLORREF value that specifies the custom color to be used for the detected URLs. The value of this member is used only if the value of the bForceHyperlinkColor member is set to TRUE. |
|
|
bForceEmbed |
Flag that indicates whether to embed the Licensed Fonts in the PDF documents. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Embed the Licensed Fonts. For more information about embedding licensed fonts, refer to Licensed Fonts. |
|
|
FALSE |
Do not embed the Licensed Fonts. |
|
bAutoEmbed |
Flag that indicates whether to automatically embed fonts in the PDF document. The automatically embedding fonts process depends on the font file size, and how common this font is. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Automatically embed fonts. |
|
|
FALSE |
Do not automatically embed fonts. |
|
bEmbedAll |
Flag that indicates whether to embed all fonts, including licensed fonts, in the PDF document. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
Embed all fonts. For more information about embedding licensed fonts, refer to Licensed Fonts. |
|
|
FALSE |
Do not embed all fonts. |
|
nEmbeddedFontsCount |
Value that represents the number of embedded fonts. It determines the number of elements in the bArrChecked, bArrEmbedable, and strArrFonts arrays. The maximum value for this member is MAX_EMBEDDED_FONTS. |
|
|
|
Use this member only if the value of bEmbedAll is set to FALSE. |
|
|
bArrChecked |
Array of flags. Each element in this array is a flag that indicates whether the font at the same index in the strArrFonts array will be embedded. Use this member only if the value of bEmbedAll is set to FALSE. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
The font will be embedded. |
|
|
FALSE |
The font will not be embedded. |
|
|
The number of elements in this array is specified by the value of the nEmbeddedFontsCount member. |
|
|
bArrEmbedable |
Array of flags. Each element in this array is a flag that indicates whether the font at the same index in the strArrFonts array is a licenced font. Use this member only if the value of bEmbedAll is set to FALSE. Possible values are: |
|
|
|
Value |
Meaning |
|
|
TRUE |
The font is not licenced. |
|
|
FALSE |
The font is licenced. |
|
|
The number of elements in this array is specified by the value of the nEmbeddedFontsCount member. |
|
|
strArrFonts |
Array of character strings. Each element in this array is a character string that contains the name of the font to be used while saving document. |
|
|
|
The number of elements in this array is specified by the value of the nEmbeddedFontsCount member. |
|
|
|
Use this member only if the value of bEmbedAll is set to FALSE. |
|
Comments
This structure is used within EPNDOCUMENTOPTIONS structure.