Adobe 65011817 Extended User Guide - Page 21

The Fireworks Object Model, Method, Data type, Notes

Page 21 highlights

Last updated 12/8/2009 Method copy(docname1, docname2) Data type string, string createDirectory(dirname) createFile(fileURL, fileType, fileCreator) string string, string, string deleteFile(docOrDir) string deleteFileIfExisting (docOrDir) enumFiles(docOrDir) string string exists(docOrDir) getDirectory(docname) string string getExtension(docname) string getFilename(docname) string getLanguageDirectory() getLastErrorString() string none EXTENDING FIREWORKS 17 The Fireworks Object Model Notes Copies the file specified in the first argument to the file specified in the second argument. Each argument must be the name of a file, which is expressed as file://URL. Only files (not directories) can be copied. The files do not need to reside on the same drive, and the method does not overwrite a file if it already exists. Returns a value of true if the copy is successful; false otherwise. Creates the specified directory. Returns true if successful; false otherwise. Creates the specified file. The file must not already exist. The first argument is the name of the file, which is expressed as file://URL. The last two arguments let you specify the file type and file creator strings. The fileType and fileCreator strings should each be strings of exactly four characters in length, for example: Files.createFile(newFile,".txt","FWMX"); Deletes the specified file or directory. Returns true if successful; false if the file or directory does not exist or cannot be deleted. Compare with deleteFileIfExisting(). Deletes the specified file or directory. Returns true if successful; false if the file or directory cannot be deleted. Unlike deleteFile(), this method returns true if the file or directory does not exist. Returns an array of file URLs. If docOrDir is a directory, the array contains an entry for every file or directory that is contained in the specified directory. If docOrDir is a file, the array contains a single entry (the file passed in). Returns true if docOrDir refers to a directory or file that exists; false otherwise. Returns only the directory name from docname, which is expressed as file://URL. For example, Files.getDirectory("file://work/logo.png") returns "file:///work". Returns the filename extension, if any, of docname. For example, Files.getExtension("birthday.png") returns ".png". If the filename has no extension, an empty string is returned. A filename that is expressed as file://URL is acceptable. Returns just the filename from docname, which is expressed as file://URL. For example, Files.getFilename("file:///work/logo.png") returns "logo.png". Returns the URL of the language directory associated with the currently running language. If the last call to a method in a Files object resulted in an error, returns a string that describes the error. If the last call succeeded, returns null.

  • 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

17
EXTENDING FIREWORKS
The Fireworks Object Model
Las
t
up
d
a
ted
12/8/2009
Method
Data type
Notes
copy
(docname1, docname2)
string, string
Copies the file specified in the first argument to the file
specified in the second argument. Each argument must be the
name of a file, which is expressed as
file://URL
. Only files (not
directories) can be copied. The files do not need to reside on
the same drive, and the method does not overwrite a file if it
already exists. Returns a value of
true
if the copy is successful;
false
otherwise.
createDirectory(dirname)
string
Creates the specified directory. Returns
true
if successful;
false
otherwise.
createFile(fileURL,
fileType, fileCreator)
string, string, string
Creates the specified file. The file must not already exist. The
first argument is the name of the file, which is expressed as
file://URL
. The last two arguments let you specify the file type
and file creator strings. The
fileType
and
fileCreator
strings should each be strings of exactly four characters in
length, for example:
Files.createFile(newFile,".txt","FWMX");
deleteFile(docOrDir)
string
Deletes the specified file or directory. Returns
true
if
successful;
false
if the file or directory does not exist or
cannot be deleted. Compare with
deleteFileIfExisting()
.
deleteFileIfExisting
(docOrDir)
string
Deletes the specified file or directory. Returns
true
if
successful;
false
if the file or directory cannot be deleted.
Unlike
deleteFile()
, this method returns
true
if the file or
directory does not exist.
enumFiles(docOrDir)
string
Returns an array of file URLs. If
docOrDir
is a directory, the
array contains an entry for every file or directory that is
contained in the specified directory. If
docOrDir
is a file, the
array contains a single entry (the file passed in).
exists(docOrDir)
string
Returns
true
if
docOrDir
refers to a directory or file that
exists;
false
otherwise.
getDirectory(docname)
string
Returns only the directory name from
docname
, which is
expressed as
file://URL
. For example,
Files.getDirectory("file://work/logo.png")
returns
"file:///work"
.
getExtension(docname)
string
Returns the filename extension, if any, of
docname
. For
example,
Files.getExtension("birthday.png")
returns
".png"
. If the filename has no extension, an empty
string is returned. A filename that is expressed as
file://URL
is
acceptable.
getFilename(docname)
string
Returns just the filename from
docname
, which is expressed as
file://URL
. For example,
Files.getFilename("file:///work/logo.png")
returns
"logo.png"
.
getLanguageDirectory()
string
Returns the URL of the language directory associated with the
currently running language.
getLastErrorString()
none
If the last call to a method in a Files object resulted in an error,
returns a string that describes the error. If the last call
succeeded, returns
null
.