<< Click to Display Table of Contents >> Navigation: GDI Print Directives > DocInfo |
These variables all relate to the properties that one may—but is not required to—associate with a document: title, subject, author, creator and a variable number of keywords. Although the variables and values in this category appear straightforward, they are actually a little tricky because of a non-obvious hierarchy of precedence. If you set Info.Ask to yes (1), then a dialog box will dutifully pop up and ask the user for title, subject, etc. However, the values entered by the user will be overridden by the values entered via the GDI directives for Info.Title, Info.Subject, etc, if they are present. In other words, the values entered by the user will only be used in the PDF document if there is no corresponding GDI directive.
Name |
Values |
Description |
PDFX3 |
---|---|---|---|
Enabled |
Boolean |
If this property is False, no information fields will be specified within the PDF document except the Producer field, which is always specified and contains the PDFX version information for the creation of this PDF file. Default = True |
Use |
AskForDocInfo |
Boolean |
If this option is True, a popup window where Document information fields can be entered will be shown after the document is spooled. Default = False |
Ask |
AddXMP |
Boolean |
If this option is True, XMP metadata will be added within the PDF document. This metadata will contain values of information fields, date of document creation etc. Note that when PDF/A mode used, XMP metadata will be added into the document regardless of the value of this property and Enabled property. Default = False |
(No V3) |
Title |
String |
Specifies the Title information field of the document. Default = empty string |
(same) |
Subject |
String |
Specifies the Subject information field of the document. Default = empty string |
(same) |
Author |
String |
Specifies the Author information field of the document. Default = empty string |
(same) |
Keywords |
String |
Specifies the Keywords information field of the document. Keywords should be comma separated. Default = empty string |
(same) |
Creator |
String |
Specifies the Creator information field of the document. Default = empty string |
(same) |
Examples
The following tells Acrobat to not ask the user to provide properties info, to set the author to "George Author," and to ignore the rest of the properties options (because of the semicolon after the double slash).
//PDFX,DocInfo.Author,"George Author"
//PDFX,DocInfo.Creator,"Henry Creator"
//PDFX,DocInfo.Keywords,"Robert,George,Henry,Peter"
//PDFX,DocInfo.Subject,"Robert Subject"
//PDFX,DocInfo.Title,"Peter Title"
Compatibility
The DocInfo property group was known as Info in PDFXv3, e.g. //PDFX,Info.Title. etc. The old property names are automatically converted to the new ones when printing to the PDFXv5+ driver (but not the other way around).
Also note that in the standard PDFXv5+ driver, the Enabled property defaults to False. A-Shell overrides the default to True.