XMLComment

An XML comment.

Methods:

addEventListener, duplicate, getElements, move, remove, removeEventListener, select, toSource, toSpecifier

Objects:

Boolean, EventListeners, Events, InsertionPoint, Number, Object, String,

Hierarchy:

Superclass: XMLItem

Class: XMLComment

Property Listing

Property

Type

Access

Description

eventListeners

EventListeners EventListener

readonly

A collection of event listeners.

events

Events Event

readonly

A collection of events.

id

Number

readonly

The unique ID of the XMLComment.

index

Number

readonly

The index of the XMLComment within its containing object.

isValid

Boolean

readonly

Returns true if the object specifier resolves to valid objects.

parent

Document

XMLElement

readonly

The parent of the XMLComment (a Document or XMLElement).

properties

Object

read/write

A property that allows setting of several properties at the same time.

storyOffset

InsertionPoint

readonly

The insertion point before the table in the story containing the table.

value

String

read/write

The text of the XML comment.

Method Listing

EventListener addEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Adds an event listener.

Parameter

Type

Description

eventType

String

The event type.

handler

File

JavaScriptFunction

The event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

XMLComment duplicate ()

Duplicates the XMLComment.

XMLComment getElements ()

Resolves the object specifier, creating an array of object references.

XMLComment move (to:LocationOptions, reference:Varies XMLItem Text)

Moves the element to the specified location.

Parameter

Type

Description

to

LocationOptions

LocationOptions.AFTER

LocationOptions.AT_BEGINNING

LocationOptions.AT_END

LocationOptions.BEFORE

LocationOptions.UNKNOWN

The location in relation to the reference object or within the containing object.

reference

XMLItem

Text

The reference object. Note: Required when the to parameter specifies before or after. . Can accept: XMLItem or Text. (Optional)

undefined remove ()

Deletes the XMLComment.

Boolean removeEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Removes the event listener.

Parameter

Type

Description

eventType

String

The registered event type.

handler

File

JavaScriptFunction

The registered event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

undefined select ([existingSelection:SelectionOptions=SelectionOptions])

Selects the object.

Parameter

Type

Description

existingSelection

SelectionOptions

SelectionOptions.ADD_TO

SelectionOptions.REMOVE_FROM

SelectionOptions.REPLACE_WITH

SelectionOptions.SET_KEY

The selection status of the XMLComment in relation to previously selected objects. (Optional)

(default: SelectionOptions.REPLACE_WITH)

String toSource ()

Generates a string which, if executed, will return the XMLComment.

String toSpecifier ()

Retrieves the object specifier.

Object of

Event.parent

EventListener.parent

MutationEvent.parent

Return

XMLComments.add()

XMLComment.duplicate()

XMLComment.move()

XMLComment.getElements()

XMLComments.anyItem()

XMLComments.everyItem()

XMLComments.nextItem()

XMLComments.previousItem()

XMLComments.itemByID()

XMLComments.item()

XMLComments.[]()

XMLComments.itemByRange()

XMLComments.firstItem()

XMLComments.lastItem()

XMLComments.middleItem()