Book
QuickLinks
Hierarchy
Properties
| Property | Type | Access | Description |
|---|---|---|---|
| automaticDocumentConversion | bool | r/w | If true, automatically converts the book content object during repagination and synchronization. |
| automaticPagination | bool | r/w | If true, automatically updates page numbers when pages in book content files are added, deleted, or rearranged. |
| bookContents | BookContents | readonly | A collection of book content objects. |
| epubExportPreferences | EPubExportPreference | readonly | EPub export preference settings. |
| eventListeners | EventListeners | readonly | A collection of event listeners. |
| events | Events | readonly | A collection of events. |
| filePath | File | readonly | The full path to the file. |
| fullName | File | readonly | The full path to the Book, including the name of the Book. |
| index | number | readonly | The index of the Book within its containing object. |
| insertBlankPage | bool | r/w | If 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. |
| isValid | bool | readonly | Returns true if the object specifier resolves to valid objects. |
| label | string | r/w | A property that can be set to any string. |
| mergeIdenticalLayers | bool | r/w | If true, merges identically named layers when exporting to PDF. |
| modified | bool | readonly | If true, the Book has been modified since it was last saved. |
| name | string | readonly | The name of the Book. |
| parent | Application | readonly | The parent of the Book (a Application). |
| preferences | Preferences | readonly | A collection of preferences objects. |
| preflightBookOptions | PreflightBookOption | readonly | Preflight book option settings. |
| printPreferences | PrintPreference | readonly | Print preference settings. |
| properties | Object | r/w | A property that allows setting of several properties at the same time. |
| repaginationOption | RepaginateOption: RepaginateOption.NEXT_PAGE RepaginateOption.NEXT_ODD_PAGE RepaginateOption.NEXT_EVEN_PAGE |
r/w | Page numbering options for book content objects within the book. |
| saved | bool | readonly | If true, the Book has been saved since it was created. |
| smartMatchStyleGroups | SmartMatchOptions: SmartMatchOptions.MATCH_STYLE_PATH SmartMatchOptions.MATCH_STYLE_NAME |
r/w | How to match styles with same name while synchronizing a book. |
| styleSourceDocument | BookContent Document |
r/w | Current style source document. Can return: Document or BookContent. |
| synchronizeBulletNumberingList | bool | r/w | If true, synchronize bullets and numbering. |
| synchronizeCellStyle | bool | r/w | If true, synchronize cell styles. |
| synchronizeCharacterStyle | bool | r/w | If true, synchronize character styles. |
| synchronizeConditionalText | bool | r/w | If true, synchronize conditional text. |
| synchronizeMasterPage | bool | r/w | If true, synchronize master pages. |
| synchronizeObjectStyle | bool | r/w | If true, synchronize object styles. |
| synchronizeParagraphStyle | bool | r/w | If true, synchronize paragraph styles. |
| synchronizeSwatch | bool | r/w | If true, synchronize swatches. |
| synchronizeTableOfContentStyle | bool | r/w | If true, synchronize table of content styles. |
| synchronizeTableStyle | bool | r/w | If true, synchronize table styles. |
| synchronizeTextVariable | bool | r/w | If true, synchronize text variables. |
| synchronizeTrapStyle | bool | r/w | If true, synchronize trap styles. |
Methods
Instances
EventListener addEventListener (eventType:
string, handler:
varies[, captures:
bool=false])
Adds an event listener.
| Parameter | Type | Description |
|---|---|---|
| eventType | string | The event type. |
| handler | File JavaScript Function | The event handler. Can accept: File or JavaScript Function. |
| captures | bool | This parameter is obsolete. (Optional) (default: false) |
void close ([saving:
SaveOptions=SaveOptions.ASK][, savingIn:
File][, versionComments:
string][, forceSave:
bool=false])
Close the Book
| Parameter | Type | Description |
|---|---|---|
| saving | SaveOptions: SaveOptions.NO SaveOptions.ASK SaveOptions.YES | Whether to save changes before closing the Book (Optional) (default: SaveOptions.ASK) |
| savingIn | File | The file in which to save the Book (Optional) |
| versionComments | string | The comment for this version (Optional) |
| forceSave | bool | Forcibly save a version (Optional) (default: false) |
void exportFile (format:
varies[, to:
File][, showingOptions:
bool=false][, using:
PDFExportPreset][, whichDocuments:
Array of BookContent][, versionComments:
string][, forceSave:
bool=false])
Exports the book to a file.
| Parameter | Type | Description |
|---|---|---|
| format | ExportFormat String | The export format, specified as an enumeration value or as an extension that appears in the Save as type or Format menu in the Export dialog. Can accept: ExportFormat enumerator or String. |
| to | File | The file to which to export the book. (Optional) |
| showingOptions | bool | Used to specify if the PDF Export Options Dialog needs to be shown or not (Optional) (default: false) |
| using | PDFExportPreset | Used to specify the presets for the export which can be the object of the preset type, enumeration for existing presets or user defined presets, or a string naming the preset to be used, but in case Showing Options is true, the preset specified in the Export Dialog will over ride this parameter (Optional) |
| whichDocuments | Array of BookContent | Used to specify a list of book content references, from the current book, where the list may contain duplicate entries and if the list is not specified then the entire book contents shall be exported (Optional) |
| versionComments | string | The comment for this version. (Optional) |
| forceSave | bool | If true, forcibly saves a version. (Optional) (default: false) |
string extractLabel (key:
string)
Gets the label value associated with the specified key.
| Parameter | Type | Description |
|---|---|---|
| key | string | The key. |
Array of Book getElements ()
Resolves the object specifier, creating an array of object references.
void insertLabel (key:
string, value:
string)
Sets the label to the value associated with the specified key.
| Parameter | Type | Description |
|---|---|---|
| key | string | The key. |
| value | string | The value. |
bool packageForPrint (to:
File, copyingFonts:
bool, copyingLinkedGraphics:
bool, copyingProfiles:
bool, updatingGraphics:
bool, includingHiddenLayers:
bool, ignorePreflightErrors:
bool, creatingReport:
bool[, versionComments:
string][, forceSave:
bool=false])
Packages the document.
| Parameter | Type | Description |
|---|---|---|
| to | File | The folder, alias, or path in which to place the packaged files. |
| copyingFonts | bool | If true, copies fonts used in the document to the package folder. |
| copyingLinkedGraphics | bool | If true, copies linked graphics files to the package folder. |
| copyingProfiles | bool | If true, copies color profiles to the package folder. |
| updatingGraphics | bool | If true, updates graphics links to the package folder. |
| includingHiddenLayers | bool | If true, copies fonts and links from hidden layers to the package. |
| ignorePreflightErrors | bool | If true, ignores preflight errors and proceeds with the packaging. If false, cancels the packaging when errors exist. |
| creatingReport | bool | If true, creates a package report that includes printing instructions, print settings, lists of fonts, links and required inks, and other information. |
| versionComments | string | The comments for the version. (Optional) |
| forceSave | bool | If true, forcibly saves a version. (Optional) (default: false) |
void preflight ([to:
File][, autoOpen:
bool=false])
Preflight a book and optionally save the resulting report.
| Parameter | Type | Description |
|---|---|---|
| to | File | The preflight report to save to. (Optional) |
| autoOpen | bool | If true, automatically open the report after creation. (Optional) (default: false) |
void print ([printDialog:
bool][, using:
varies])
Prints the Book(s).
| Parameter | Type | Description |
|---|---|---|
| printDialog | bool | Whether to invoke the print dialog (Optional) |
| using | PrinterPreset PrinterPresetTypes | Printer preset to use. Can accept: PrinterPresetTypes enumerator or PrinterPreset. (Optional) |
bool removeEventListener (eventType:
string, handler:
varies[, captures:
bool=false])
Removes the event listener.
| Parameter | Type | Description |
|---|---|---|
| eventType | string | The registered event type. |
| handler | File JavaScript Function | The registered event handler. Can accept: File or JavaScript Function. |
| captures | bool | This parameter is obsolete. (Optional) (default: false) |
void repaginate ()
Repaginates the book.
void save ([to:
File][, versionComments:
string][, forceSave:
bool=false])
Saves the book.
| Parameter | Type | Description |
|---|---|---|
| to | File | The file path. Note: Required only if the book has not been previously saved. If the book has previously been saved, specifying a path saves a copy and closes the original book. (Optional) |
| versionComments | string | The comment for this version. (Optional) |
| forceSave | bool | If true, forcibly saves a version. (Optional) (default: false) |
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.
void updateAllCrossReferences ()
Updates the cross references in the entire book.
void updateAllNumbers ()
Update all numbers (e.g. Page numbers, chapter numbers and paragraph numbers) throughout the book.
void updateChapterAndParagraphNumbers ()
Updates chapter numbers and paragraph numbers throughout the book.
Element of
Application.activeBook
BookContent.parent
EPubExportPreference.parent
PreflightBookOption.parent
PrintPreference.parent
Used in:
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
Array of Book Book.getElements ()
Book Books.[] (index: number)
Book Books.add (fullName: File[, withProperties: Object])
Book Books.anyItem ()
Array of Book Books.everyItem ()
Book Books.firstItem ()
Book Books.item (index: varies)
Book Books.itemByName (name: string)
Array of Book Books.itemByRange (from: varies, to: varies)
Book Books.lastItem ()
Book Books.middleItem ()
Book Books.nextItem (obj: Book)
Book Books.previousItem (obj: Book)
| Jongware, 28-Apr-2012 v3.0.3h | Contents :: Index |