Adobe InDesign CS6 (8.0) Object Model JS: BookContent

InDesign CS6

previous page next page

Class

BookContent

A document added to a book.

QuickLinks

addEventListener, extractLabel, getElements, insertLabel, move, preflight, remove, removeEventListener, replace, synchronize, toSource, toSpecifier

Hierarchy

Book

BookContent

Event | EventListener | MutationEvent

Properties

Property	Type	Access	Description
date	Date	readonly	The date and time the BookContent was created.
documentPageRange	string	readonly	The page range of the book content object within the book.
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 BookContent, including the name of the BookContent.
id	number	readonly	The unique ID of the BookContent.
index	number	readonly	The index of the BookContent within its containing object.
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.
name	string	readonly	The name of the BookContent.
parent	Book	readonly	The parent of the BookContent (a Book).
properties	Object	r/w	A property that allows setting of several properties at the same time.
size	number	readonly	The size of the BookContent file.
status	BookContentStatus: BookContentStatus.NORMAL BookContentStatus.MISSING_DOCUMENT BookContentStatus.DOCUMENT_OUT_OF_DATE BookContentStatus.DOCUMENT_IN_USE BookContentStatus.DOCUMENT_IS_OPEN	readonly	The status of the book content object file.

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)

string extractLabel (key: string)
Gets the label value associated with the specified key.

Parameter	Type	Description
key	string	The key.

Array of BookContent 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.

BookContent move ([to: LocationOptions=LocationOptions.AT_END][, reference: BookContent])
Moves the book content object.

Parameter	Type	Description
to	LocationOptions: LocationOptions.BEFORE LocationOptions.AFTER LocationOptions.AT_END LocationOptions.AT_BEGINNING LocationOptions.UNKNOWN	The location relative to the reference object or within the book. (Optional) (default: LocationOptions.AT_END)
reference	BookContent	The reference object. Note: Required when the to parameter specifies before or after. (Optional)

void preflight ([to: File][, autoOpen: bool=false])
Preflight a book content object 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 remove ()
Deletes the BookContent.

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)

BookContent replace (using: File)
Replaces a book content object with a new file. Note: If the new file replaces the current style source document, the new file becomes the style source document.

Parameter	Type	Description
using	File	The full path name of the new book content object.

void synchronize ()
Matches the formatting of the book content object to the style source document.

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

string toSpecifier ()
Retrieves the object specifier.

Element of

Book.styleSourceDocument

Used in:

void Book.exportFile (format: varies[, to: File][, showingOptions: bool=false][, using: PDFExportPreset][, whichDocuments: Array of BookContent][, versionComments: string][, forceSave: bool=false])