Adobe 65011817 Extended User Guide - Page 31

The Document object

Page 31 highlights

Last updated 12/8/2009 27 Chapter 3: The Document object This chapter describes the Fireworks Document object and functions. Document object properties 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 315. Property backgroundColor backgroundURL brushes • currentFrameNum currentLayerNum defaultAltText Data type string string array zero-based index zero-based index string docTitleWithoutExtension exportFormatOptions exportOptions exportSettings filePathForRevert filePathForSave fills • frameCount frameLoopingCount string object object object string string array integer integer Notes A color string that specifies the document canvas color (for more information, see "Color string data type" on page 7). 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 236). 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 the Document-Specific tab of the HTML Setup dialog box. 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 253). ExportSettings object (for more information, see "ExportSettings object" on page 256). 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 258). The number of frames in the current document. -1 - don't repeat 0 - repeat forever > 0 - repeat this number of times

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336

27
Las
t
up
d
a
ted
12/8/2009
Chapter 3: The Document object
This chapter describes the Fireworks Document object and functions.
Document object properties
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
315.
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
7).
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
236).
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 the Document-Specific tab of the HTML Setup dialog box.
docTitleWithoutExtension
string
The title of the document file, without any file extension. If the
document has not been saved, this string is empty.
exportFormatOptions
object
Identical to
exportOptions
. Included for backward
compatibility with Fireworks 2.
exportOptions
object
ExportOptions object (for more information, see
ExportOptions object
” on page
253).
exportSettings
object
ExportSettings object (for more information, see
ExportSettings object
” on page
256).
filePathForRevert
string
The path to the file from which this document was opened,
which is expressed as
file://URL
, or
null
if 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
258).
frameCount
integer
The number of frames in the current document.
frameLoopingCount
integer
–1 — don’t repeat
0 — repeat forever
> 0 — repeat this number of times