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

Adobe 38039927 Extended User Guide - Page 11

Using the common API, Working with selected objects

UPC - 883919091389

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

Page 11 highlights

ADOBE FIREWORKS CS3 7 Extending Guide Palette or panel Several API functions reference the History panel (see "History panel functions" on page 297). Throughout the Fireworks documentation and online help, the term palette is reserved for discussions of a color palette, and the term panel is used to refer to the floating windows that are available within Fireworks. Therefore, when the function name contains palette, the descriptions refer to a panel. Using the common API You can use the common Adobe API if you want commands to use a common syntax (and thus run a single command in multiple applications). You can access this API using app.methodName().The following methods are currently supported in Fireworks and Dreamweaver to let developers easily create commands for both applications. app.toggleFloater() Identical to "fw.toggleFloater()" on page 204. app.setFloaterVisibility() Identical to "fw.setFloaterVisibility()" on page 203. app.getRootDirectory() Identical to the Fireworks object property "appDir •" on page 170. app.browseDocument() Identical to "fw.browseDocument()" on page 174. Note: The app.getRootDirectory() function is useful if you want to use app.browseDocument() to view files within the applications's folder. Working with selected objects When an object is selected, either programmatically (for example, using the dom.selectAll() function) or by a user, you can return (get) or set the value of that object's properties using common notation that will work on various objects. In other words, you can write a command that will get or set the value of an object's properties whether the user selects a Text object, or an Image object, or any other recognized object. In Fireworks, a recognizable object is classified as one of the following element types: • Hotspot • SliceHotspot (basically, a slice) • Path • Group • Instance • Text

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