Home » Adobe Manuals » Computer Software » Adobe 38039927 » Manual Viewer

Adobe 38039927 Extended User Guide - Page 24

The Document object

UPC - 883919091389

Add to My Manuals
Save this manual to your list of manuals

Page 24 highlights

20 Chapter 3: The Document object This chapter describes the Fireworks Document object and functions. The following table lists the properties of the Document object, along with their data types, acceptable values and notes. Read-only properties are marked with a bullet (•). You can also use many API calls to work with documents. For more information, see "Property inspector functions" on page 294. Property backgroundColor backgroundURL brushes • currentFrameNum currentLayerNum defaultAltText Data type string string array zero-based index zero-based index string docTitleWithoutExtensio string n exportFormatOptions object exportOptions object exportSettings object filePathForRevert string filePathForSave string fills • array frameCount integer Notes A color string that specifies the document canvas color (for more information, see "Color string data type" on page 5). Sets a general URL for a document that uses a Hotspot. Everything that is not covered by the Hotspot has the background URL. Array of Brush objects that are available for use in the document (for more information, see "Brush object" on page 208). The index of the current frame. The index of the current layer. Default Alt text for the output images. It works for single and sliced images. Sliced images get the default, unless specific text is specified for a slice. Corresponds to the text that is specified in File > HTML Properties > ImageMap > AltImageDescription. The title of the document file, without any file extension. If the document has not been saved, this string is empty. Identical to exportOptions. Included for backward compatibility with Fireworks 2. ExportOptions object (for more information, see "ExportOptions object" on page 227). ExportSettings object (for more information, see "ExportSettings object" on page 230). The path to the file from which this document was opened, which is expressed as file://URL, or null if created from scratch. The location to which this document was saved, which is expressed as file://URL, or null if never saved. Array of Fill objects that are available for use in the document (for more information, see "Fill object" on page 233). The number of frames in the current document.

Section	Page
Contents	3
Chapter 1: Extending Fireworks Overview	5
Prerequisites	5
Installing an extension	5
What’s new in Extending Fireworks CS3	6
Conventions used in this guide	6
Additional resources for extension writers	7
Chapter 2: The Fireworks Object Model	8
Using the Fireworks Object Model	8
Accessing a Fireworks document	8
Passing values	8
Fireworks Object Model calls and API calls	9
Formatting nonstandard data types	9
Color string data type	9
Mask data type	9
Matrix data type	10
Point data type	10
Rectangle data type	10
Resolution data type	10
Using Fireworks API functions	10
Zero-based indexes	10
Passing null values	10
Working with selected elements	10
Palette or panel	11
Using the common API	11
app.toggleFloater()	11
app.setFloaterVisibility()	11
app.getRootDirectory()	11
app.browseDocument()	11
Working with selected objects	11
Working with properties for any selected object	12
elementMask	12
effectList	12
Working with specific properties for selected elements	13
Hotspot	13
SliceHotspot	13
Path	13
Group	14
Instance	14
Text	14
RectanglePrimitive	14
pathAttributes	15
Global methods	15
alert(message)	15
confirm(message)	16
prompt(caption, text)	16
write(arg1, arg2, ..., argN)	16
WRITE_CSS	17
WRITE_HTML(arg1, arg2, ..., argN)	17
Core objects	17
Errors object	18
Files object	18
File Reference object	20
Find object	21
Finding and replacing text	21
Finding and replacing fonts and styles	21
Finding and replacing colors, fills, strokes, and effects	22
Finding and replacing URLs	22
Finding and replacing non-websafe colors with the closest websafe color	22
System object	22
Chapter 3: The Document object	24
The pngText property	27
Document functions	27
dom.addBehavior()	27
Using the dom.addBehavior() function	28
MM_nbGroup [down]	28
MM_nbGroup [highlight]	29
MM_nbGroup [image]	29
MM_nbGroup [out]	30
MM_simpleRollover	30
MM_statusMessage	30
MM_swapImage	31
MM_swapImgRestore	31
dom.addElementMask()	31
dom.addFrames()	32
dom.addGuide()	32
dom.addMasterPageLayer()	33
dom.addNewHotspot()	33
dom.addNewImage()	34
dom.addNewImageViaCopy()	34
dom.addNewImageViaCut()	35
dom.addNewLayer()	35
dom.addNewLine()	36
dom.addNewOval()	36
dom.addNewPage()	37
dom.addNewRectangle()	37
dom.addNewRectanglePrimitive()	38
dom.addNewSinglePointPath()	38
dom.addNewStar()	39
dom.addNewSubLayer()	39
dom.addNewSymbol()	40
dom.addNewText()	40
dom.addSwapImageBehaviorFromPoint()	41
dom.adjustExportToSize()	41
dom.adjustFontSize()	42
dom.align()	42
dom.appendPointToHotspot()	43
dom.appendPointToPath()	43
dom.appendPointToSlice()	44
dom.applyCharacterMarkup()	44
dom.applyCurrentFill()	44
dom.applyEffects()	45
dom.applyFontMarkup()	45
dom.applyStyle()	46
dom.arrange()	46
dom.attachTextToPath()	47
dom.changeCurrentPage()	47
dom.changeGuide()	47
dom.changeNineScaleGuide()	48
dom.changeSliceGuide()	49
dom.clearJPEGMask()	49
dom.clipCopy()	50
dom.clipCopyAsPaths()	50
dom.clipCopyFormats()	51
dom.clipCut()	51
dom.clipPaste()	51
dom.clipPasteAsMask()	52
dom.clipPasteAttributes()	53
dom.clipPasteFromChannelToChannel()	53
dom.clipPasteInside()	54
dom.cloneSelection()	54
dom.close()	55
dom.convertAnimSymbolToGraphicSymbol()	55
dom.convertMarqueeToPath()	56
dom.convertPathToMarquee()	56
dom.convertToAnimSymbol()	56
dom.convertToPaths()	57
dom.convertToSymbol()	58
dom.convolveSelection()	58
dom.copyHtmlWizard()	59
dom.copyToHotspot()	59
dom.cropSelection()	60
dom.deleteAllInDocument()	60
dom.deleteFrames()	61
dom.deleteLayer()	61
dom.deletePageAt()	62
dom.deletePointOnPath()	62
dom.deleteSavedSelection()	62
dom.deleteSelection()	63
dom.deleteSymbol()	63
dom.detachInstanceFromSymbol()	64
dom.detachSharedLayer()	65
dom.distribute()	65
dom.distributeLayerToFrames()	66
dom.distributeSelectionToFrames()	66
dom.dragControlPoint()	66
dom.duplicateFrame()	67
dom.duplicateLayer()	67
dom.duplicatePage()	68
dom.duplicateSelection()	68
dom.duplicateSelectionToFrameRange()	69
dom.duplicateSelectionToFrames()	69
dom.duplicateSymbol()	70
dom.duplicateSymbolForAlias()	70
dom.elementsAt()	70
dom.enableElementMask()	71
dom.enableNineScale()	71
dom.enableTextAntiAliasing()	72
dom.enterElementMaskEditMode()	72
dom.enterPaintMode()	73
dom.exitElementMaskEditMode()	73
dom.exitPaintMode()	73
dom.exportOptions.loadColorPalette()	74
dom.exportOptions.saveColorPalette()	74
dom.exportTo()	74
dom.fillSelectedPixels()	75
dom.filterSelection()	76
dom.filterSelectionByID()	76
dom.filterSelectionByName()	77
dom.findNamedElements()	77
dom.flattenDocument()	77
dom.flattenSelection()	78
dom.getFontMarkup()	78
dom.getParentLayerNum()	79
dom.getPixelMask()	79
dom.getSelectionBounds()	79
dom.getShowGrid()	80
dom.getShowGuides()	80
dom.getShowRulers()	80
dom.getSnapToGuides()	81
dom.getSnapToGrid()	81
dom.getTextAlignment()	81
dom.group()	82
dom.hasCharacterMarkup()	82
dom.hasMasterPage()	83
dom.hideSelection()	83
dom.importFile()	83
dom.importSymbol()	84
dom.importSymbolButNotAsAlias()	84
dom.inLaunchAndEdit()	85
dom.insertPointInPath()	85
dom.insertSmartShapeAt()	86
dom.insertSymbolAt()	86
dom.isMasterPageLayer()	87
dom.isSelectionDirectlyAboveBitmapObject()	87
dom.joinPaths()	88
dom.knifeElementsFromPoint()	88
dom.knifeElementsFromPoints()	88
dom.linkElementMask()	89
dom.lockNineScale()	89
dom.lockSelection()	90
dom.makeFind()	90
dom.makeActive()	91
dom.mergeDown()	91
dom.modifyPointOnPath()	91
dom.motionBlurSelection()	92
dom.moveBezierHandleBy()	92
dom.moveElementMaskBy()	93
dom.moveFillVectorHandleBy()	93
dom.moveMaskGroupContentsBy()	94
dom.movePixelMaskBy()	94
dom.movePointOnHotspotBy()	95
dom.movePointOnHotspotByWithFlags()	95
dom.moveSelectedBezierPointsBy()	96
dom.moveSelectionBy()	96
dom.moveSelectionMaskBy()	97
dom.moveSelectionTo()	97
dom.moveSelectionToFrame()	98
dom.moveSelectionToLayer()	98
dom.moveSelectionToNewLayer()	99
dom.pageName()	99
dom.pathCrop()	99
dom.pathExpand()	100
dom.pathInset()	100
dom.pathIntersect()	101
dom.pathPunch()	101
dom.pathSimplify()	101
dom.pathUnion()	102
dom.previewInBrowser()	102
dom.rebuildColorTable()	102
dom.redo()	103
dom.redraw()	103
dom.redrawSmartShape()	103
dom.reflectSelection()	104
dom.removeAllGuides()	104
dom.removeBehavior()	105
dom.removeBrush()	105
dom.removeCharacterMarkup()	105
dom.removeElementMask()	106
dom.removeFontMarkup()	106
dom.removeFill()	107
dom.removeGuide()	107
dom.removeNineScale()	107
dom.removeTransformation()	108
dom.reorderFrame()	108
dom.reorderLayer()	109
dom.reorderPages()	109
dom.replaceButtonTextStrings()	109
dom.replaceButtonTextStringsInInstances()	110
dom.replaceTextString()	110
dom.resetNineScale()	111
dom.resizeSelection()	111
dom.restoreJPEGMask()	112
dom.restoreSelection()	112
dom.reversePathTextDirection()	113
dom.rotateDocument()	113
dom.rotateSelection()	113
dom.save()	114
dom.saveCopyAs()	114
dom.saveJPEGMask()	115
dom.saveSelection()	115
dom.scaleSelection()	116
dom.scalingGridRect()	116
dom.selectAdjustPixelSel()	117
dom.selectAll()	117
dom.selectAllOnLayer()	117
dom.selectChildren()	118
dom.selectFeather()	118
dom.selectInverse()	119
dom.selectNone()	119
dom.selectParents()	119
dom.selectSimilar()	120
dom.selectSimilarFromPoint()	120
dom.sendEmail()	121
dom.setAllLayersDisclosure()	121
dom.setAnimInstanceLoopCount()	122
dom.setAnimInstanceNumFrames()	122
dom.setAnimInstanceOffsetDist()	123
dom.setAnimInstanceRotationAmount()	123
dom.setAnimInstanceScaleAmount()	124
dom.setAnimInstanceStartEndOpacity()	124
dom.setAnimInstanceStartFrame()	125
dom.setBlendMode()	125
dom.setBrush()	125
dom.setBrushColor()	126
dom.setBrushName()	126
dom.setBrushNColor()	127
dom.setBrushNColorNTexture()	127
dom.setBrushPlacement()	127
dom.setButtonAutoSlice()	128
dom.setButtonIncludeDownState()	128
dom.setButtonIncludeOverWhileDownState()	128
dom.setButtonShowDownOnLoad()	129
dom.setButtonOptions()	129
dom.setDefaultBrushAndFillColors()	130
dom.setDefaultFillVector()	130
dom.setDocumentCanvasColor()	130
dom.setDocumentCanvasSize()	131
dom.setDocumentCanvasSizeToDocumentExtents()	131
dom.setDocumentCanvasSizeToSelection()	132
dom.setDocumentImageSize()	132
dom.setDocumentResolution()	133
dom.setEffectName()	133
dom.setElementLocked()	134
dom.setElementLockedByName()	134
dom.setElementMaskMode()	135
dom.setElementMaskShowAttrs()	135
dom.setElementName()	135
dom.setElementVisible()	136
dom.setElementVisibleByName()	137
dom.setExportOptions()	137
dom.setExportSettings()	137
dom.setFill()	138
dom.setFillColor()	138
dom.setFillEdgeMode()	138
dom.setFillNColor()	139
dom.setFillNColorNTexture()	139
dom.setFillPlacement()	140
dom.setFillVector()	140
dom.setFillVectorStart()	141
dom.setGradientName()	141
dom.setGridOrigin()	141
dom.setGridSize()	142
dom.setGridColor()	142
dom.setGroupType()	142
dom.setGuideColor()	143
dom.setHotspotAltTag()	143
dom.setHotspotColor()	144
dom.setHotspotRectangle()	144
dom.setHotspotShape()	145
dom.setHotspotTarget()	145
dom.setHotspotText()	145
dom.setLayerDisclosure()	146
dom.setLayerLocked()	147
dom.setLayerName()	147
dom.setLayerSharing()	148
dom.setLayerVisible()	148
dom.setMasterPage()	149
dom.setMatteColor()	149
dom.setPixelMask()	150
dom.setOnionSkinning()	150
dom.setOpacity()	151
dom.setPageName()	151
dom.setQuadrangle()	152
dom.setRectRoundness()	152
dom.setRectSides()	153
dom.setSelectionBounds()	153
dom.setSelectionMask()	153
dom.setShowEdges()	154
dom.setShowGammaPreview()	154
dom.setShowGrid()	155
dom.setShowGuides()	155
dom.setShowRulers()	155
dom.setShowSliceGuides()	156
dom.setShowSliceOverlay()	156
dom.setSliceAutonaming()	156
dom.setSliceExportOptions()	157
dom.setSliceFilename()	157
dom.setSliceGuideColor()	157
dom.setSliceHtml()	158
dom.setSliceIsHtml()	158
dom.setSnapToGrid()	159
dom.setSnapToGuides()	159
dom.setSymbolProperties()	159
dom.setTextAlignment()	160
dom.setTextAntiAliasing()	160
dom.setTextAutoKern()	161
dom.setTextCharSpacing()	161
dom.setTextCustomAntiAliasOverSample()	161
dom.setTextCustomAntiAliasSharpness()	162
dom.setTextCustomAntiAliasStrength()	162
dom.setTextFlow()	162
dom.setTextHorizontalScale()	163
dom.setTextLeading()	163
dom.setTextOnPathMode()	164
dom.setTextOnPathOffset()	164
dom.setTextOrientation()	164
dom.setTextParaIndent()	165
dom.setTextParaSpacingAfter()	165
dom.setTextParaSpacingBefore()	165
dom.setTextRuns()	166
dom.setTransformMode()	166
dom.setTextRectangle()	166
dom.setTextRectangleAuto()	167
dom.setTextRectangleAutoFromPoint()	167
dom.setWebObjectsVisibility()	168
dom.shareLayerToPages()	168
dom.shareWebLayerToPages()	169
dom.showAllHidden()	169
dom.splitPaths()	170
dom.swapBrushAndFillColors()	170
dom.transformSelection()	170
dom.tween()	171
dom.undo()	171
dom.updateSymbol()	171
dom.ungroup()	172
dom.unsetMasterPage()	172
Chapter 4: The Fireworks Object	174
Fireworks functions	178
fw.browseDocument()	178
fw.browseForFileURL()	178
fw.browseForFolderURL()	178
fw.browseHelp()	179
fw.checkFwJsVersion()	179
fw.chooseBrowser()	180
fw.chooseScriptTargetDialog()	180
fw.closeDocument()	180
fw.createDocument()	181
fw.createDocumentWithDialog()	181
fw.createFireworksDocument()	182
fw.dialogs.runEditGrids()	182
fw.dialogs.runEditGuides()	183
fw.dialogs.runNumericTransform()	183
fw.disableFlashDebugging()	183
fw.dismissBatchDialogWhenDone()	184
fw.enableFlashDebugging()	184
fw.exportAndCopyHTMLCode()	184
fw.exportDirectorAsLayers()	185
fw.exportDirectorAsSlices()	185
fw.exportDocumentAs()	186
fw.exportFrames()	186
fw.exportHtmlAndImages()	187
fw.exportIllustrator()	187
fw.exportLayers()	188
fw.exportPSD()	188
fw.exportSWF()	190
fw.findApp()	191
fw.findNext()	191
fw.findOpenDocument()	192
fw.getDocumentDOM()	192
fw.getDocumentPath()	193
fw.getFloaterGroupings()	193
fw.getFloaterPosition()	193
fw.getFloaterVisibility()	194
fw.getHideAllFloaters()	194
fw.getHTMLFileForScript()	195
fw.getNumberOfTables()	195
fw.getPref()	195
fw.launchApp()	196
fw.launchBrowserTo()	196
fw.locateDocDialog()	197
fw.openDocument()	198
fw.popupColorPicker()	198
fw.popupColorPickerOverMouse()	199
fw.quit()	199
fw.quitApplication()	200
fw.readNthTable()	200
fw.readPanelStateFromFile()	200
fw.replace()	201
fw.replaceAll()	201
fw.revertDocument()	202
fw.runScript()	202
fw.saveAll()	202
fw.saveDocument()	203
fw.saveDocumentAs()	203
fw.saveDocumentCopyAs()	204
fw.saveJsCommand()	204
fw.setActiveViewScale()	205
fw.setActiveWindow()	205
fw.setFloaterGrouping()	206
fw.setFloaterPosition()	206
fw.setFloaterVisibility()	207
fw.setHideAllFloaters()	207
fw.setPref()	208
fw.setUpFindReplace()	208
fw.toggleFloater()	208
fw.ungroupPrimitives()	209
fw.updateHTML()	209
fw.writePanelStateToFile()	210
fw.yesNoDialog()	210
Chapter 5: Objects within Fireworks documents	212
Behavior object	212
Brush object	212
Contour object	215
ContourNode object	215
ContourNodeDynamicInfo object	216
ControlPoint object	217
Effect object	218
Bevel object	218
Blur object	220
Blur More object	220
Brightness/Contrast object	220
Convert to Alpha object	221
Curves object	221
Drop Shadow object	221
Find Edges object	222
Gaussian Blur object	222
Hue/Saturation object	222
Inner Shadow object	222
Invert object	223
Levels object	223
Sharpen object	224
Sharpen More object	224
Unsharp Mask object	224
EffectList object	225
Element object	225
Group object	226
Image object	227
Instance object	227
Hotspot object	228

Match case Limit results 1 per page

Chapter 3: The Document object

This chapter describes the Fireworks Document object and functions.

The following table lists the properties of the Document object, along with their data types, acceptable values and

notes. Read-only properties are marked with a bullet (•). You can also use many API calls to work with documents.

For more information, see “Property inspector functions” on page 294.

Property

Data type

Notes

backgroundColor

string

A color string that specifies the document canvas

color (for more information, see “Color string data

type” on page 5).

backgroundURL

string

Sets a general URL for a document that uses a

Hotspot. Everything that is not covered by the

Hotspot has the background URL.

brushes •

array

Array of Brush objects that are available for use in the

document (for more information, see “Brush object”

on page 208).

currentFrameNum

zero-based index

The index of the current frame.

currentLayerNum

zero-based index

The index of the current layer.

defaultAltText

string

Default Alt text for the output images. It works for

single and sliced images. Sliced images get the

default, unless specific text is specified for a slice.

Corresponds to the text that is specified in File >

HTML

Properties > ImageMap > AltImageDescription.

docTitleWithoutExtensio

string

The title of the document file, without any file exten-

sion. If the document has not been saved, this string

is empty.

exportFormatOptions

object

Identical to

exportOptions

. Included for back-

ward compatibility with Fireworks 2.

exportOptions

object

ExportOptions object (for more information, see

“ExportOptions object” on page 227).

exportSettings

object

ExportSettings object (for more information, see

“ExportSettings object” on page 230).

filePathForRevert

string

The path to the file from which this document was

opened, which is expressed as

file://URL

, or

null

created from scratch.

filePathForSave

string

The location to which this document was saved,

which is expressed as

file://URL

, or

null

if never

saved.

fills •

array

Array of Fill objects that are available for use in the

document (for more information, see “Fill object” on

page 233).

frameCount

integer

The number of frames in the current document.