Adobe 38039927 Extended User Guide - Page 19

Extending Guide, Method, Data type, Notes

Page 19 highlights

ADOBE FIREWORKS CS3 15 Extending Guide Method enumFiles(docOrDir) Data type string exists(docOrDir) getDirectory(docname) string string getExtension(docname) string getFilename(docname) string getLanguageDirectory() getLastErrorString() string none getTempFilePath ({dirname}) string isDirectory(dirname) string makePathFromDirAndFile(dir string, string name, plainFilename) Notes 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. The argument, if used, must be expressed as file://URL. Returns a file URL in the Temporary Files directory or in the specified directory. This method does not create a file; it simply returns a unique file URL that does not conflict with existing files in the directory. If dirname is passed and is not null, the URL that is returned indicates a file in the specified directory rather than in the Temporary Files directory. The argument must be expressed as file://URL. Returns true if the specified URL refers to a directory that exists; false otherwise. The first argument must be expressed as file://URL. Concatenates the two arguments to return a file URL that references the specified filename in the specified directory. For example, Files.makePathFromDirAndFile("file:///work/reports", "logo.png") returns "file:///work/reports/logo.png" .

  • 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

ADOBE FIREWORKS CS3
Extending Guide
15
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.getDirec-
tory("file://work/logo.png")
returns
"file:///work"
.
getExtension(docname)
string
Returns the filename extension, if any, of
docname
. For example,
Files.getExten-
sion("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.getFile-
name("file:///work/logo.png")
returns
"logo.png"
.
getLanguageDirectory()
string
Returns the URL of the language directory associ-
ated 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
.
getTempFilePath
({dirname})
string
The argument, if used, must be expressed as
file://URL
. Returns a file URL in the Temporary
Files directory or in the specified directory. This
method does not create a file; it simply returns a
unique file URL that does not conflict with
existing files in the directory. If
dirname
is
passed and is not
null
, the URL that is returned
indicates a file in the specified directory rather
than in the Temporary Files directory.
isDirectory(dirname)
string
The argument must be expressed as
file://URL
.
Returns
true
if the specified URL refers to a
directory that exists;
false
otherwise.
makePathFromDirAndFile(dir
name, plainFilename)
string, string
The first argument must be expressed as
file://URL
. Concatenates the two arguments to
return a file URL that references the specified file-
name in the specified directory. For example,
Files.makePathFromDirAnd-
File("file:///work/reports",
"logo.png")
returns
"file:///work/reports/logo.png"
.
Method
Data type
Notes