Adobe InDesign CS2 (4.0) Object Model JS: Book

InDesign CS2

Class

Book

 A book.

QuickLinks

close, exportFile, getElements, packageForGoLive, packageForPrint, print, repaginate, save, synchronize, toSource, toSpecifier

Hierarchy

Application
Book
BookContent | PackageForGoLivePreference | PrintPreference | SynchronizeOption

Properties

PropertyTypeAccessDescription
automaticDocumentConversionbool r/wIf true, automatically converts the book content object during repagination and synchronization.
automaticPaginationbool r/wIf true, automatically updates page numbers when pages in book content files are added, deleted, or rearranged.
bookContentsBookContents readonlyA collection of book content objects.
filePathFile readonlyThe full path to the file.
fullNameFile readonlyThe full path to the Book, including the name of the Book.
indexnumber readonlyThe index of the Book within its containing object.
insertBlankPagebool r/wIf true, inserts a blank page as necessary to fill in page number gaps caused by the odd or even specification set in the repagination option.
modifiedbool readonlyIf true, the Book has been modified since it was last saved.
namestring readonlyThe name of the Book.
packageForGoLivePreferencesPackageForGoLivePreference readonlyThe Package For GoLive preference properties that define how a document is packaged for GoLive.
parentApplication readonlyThe parent of the Book (a Application).
printPreferencesPrintPreference readonlyPrint preference settings.
propertiesObject r/wA property that allows setting of several properties at the same time.
repaginationOptionRepaginateOption:
RepaginateOption.NEXT_PAGE
RepaginateOption.NEXT_ODD_PAGE
RepaginateOption.NEXT_EVEN_PAGE
r/wPage numbering options for book content objects within the book.
savedbool readonlyIf true, the Book has been saved since it was created.
styleSourceDocumentDocument r/wThe book content object used as the style source document.
synchronizeOptionsSynchronizeOptions readonlyA collection of book synchronization option styles.

Methods

Instances

void close ([saving: SaveOptions=SaveOptions.ASK][, savingIn: File])
Closes the Book.

ParameterTypeDescription
savingSaveOptions:
SaveOptions.NO
SaveOptions.ASK
SaveOptions.YES
The option for saving changes. (Optional) (default: SaveOptions.ASK)
savingInFileThe file path of the saved document. Note: Required only when saving the document for the first time. If the document has previously been saved, specifying a path saves a copy and closes the original document. (Optional)

void exportFile ([to: File])
Exports the book to PDF.

ParameterTypeDescription
toFileThe full path name, including the file extension '.pdf', of the pdf file. (Optional)

Array of Object getElements ()
Resolves the object specifier, creating an array of object references.

bool packageForGoLive (location: File[, objects: Array of any])
Packages for GoLive

ParameterTypeDescription
locationFileFile location for package
objects Array of :
Array of Pages
PageItems
Texts
Objects location for package. Can accept: Array of Pages, PageItems or Texts. (Optional)

bool packageForPrint (to: File, copyingFonts: bool, copyingLinkedGraphics: bool, copyingProfiles: bool, updatingGraphics: bool, includingHiddenLayers: bool, ignorePreflightErrors: bool, creatingReport: bool)
Packages the document for handoff to a service provider.

ParameterTypeDescription
toFileThe folder, alias, or path in which to place the packaged files.
copyingFontsboolIf true, copies fonts used in the document to the package folder.
copyingLinkedGraphicsboolIf true, copies linked graphics files to the package folder.
copyingProfilesboolIf true, copies color profiles to the package folder.
updatingGraphicsboolIf true, updates graphics links to the package folder.
includingHiddenLayersboolIf true, copies fonts and links from hidden layers to the package.
ignorePreflightErrorsboolIf true, ignores preflight errors and proceeds with the packaging. If false, cancels the packaging when errors exist.
creatingReportboolIf true, creates a package report that includes printing instructions, print settings, lists of fonts, links and required inks, and other information.

void print ([printDialog: bool][, using: any])
Prints the Book(s).

ParameterTypeDescription
printDialogboolWhether to invoke the print dialog (Optional)
usingPrinterPreset
PrinterPresetTypes
Printer preset to use. Can accept: PrinterPresetTypes enumerator or PrinterPreset. (Optional)

void repaginate ()
Repaginates the book.

void save ([to: File])
Saves the book.

ParameterTypeDescription
toFileThe full path name, including the book file extension '.indb', that specifies where to save the book. (Optional)

void synchronize ()
Synchronizes the entire book to the style source document.

string toSource ()
Generates a string which, if executed, will return the Book.

string toSpecifier ()
Retrieves the object specifier.

Element of

BookContent.parent

PackageForGoLivePreference.parent

PrintPreference.parent

SynchronizeOption.parent

Used in:

array of Book Books.itemByRange (from: any, to: any)

Book Books.nextItem (obj: Book)

Book Books.previousItem (obj: Book)

array of Story Document.createTOC (using: TOCStyle[, replacing: bool=false][, fromBook: Book][, placePoint: Array of Measurement Unit (Number or String)][, includeOverset: bool=false][, destinationLayer: Layer])

Return

Book Books.add (fullName: File[, withProperties: Object])

Book Books.anyItem ()

Array of Book Books.everyItem ()

Book Books.firstItem ()

Book Books.item (index: any)

Book Books.itemByName (name: string)

Array of Book Books.itemByRange (from: any, to: any)

Book Books.lastItem ()

Book Books.middleItem ()

Book Books.nextItem (obj: Book)

Book Books.previousItem (obj: Book)

Jongware, 27-Jun-2010 v3.0.3dContents :: Index