Adobe 65011817 Extended User Guide - Page 96

dom.importSymbol, dom.importSymbolButNotAsAlias

Page 96 highlights

Last updated 12/8/2009 EXTENDING FIREWORKS 92 The Document object bMaintainAspectRatio If bMaintainAspectRatio is true, the file is scaled to the largest size that fits within boundingRectangle while retaining the file's current aspect ratio. (This is a handy option for creating thumbnails.) If it is false, the file is scaled to fill boundingRectangle. Returns Nothing. Description Imports the specified file at the specified location. Example The following command imports the specified file and maintains its aspect ratio: fw.getDocumentDOM().importFile("file:///C|/images/foo.psd", {left:25, top:50, right:100, bottom:250}, true); dom.importSymbol() Availability Fireworks 3. Usage dom.importSymbol(fileURL, bAddToDoc, bAllowUI) Arguments fileURL The name of the file to be imported into the library, which is expressed as a file://URL. bAddToDoc If bAddToDoc is true, the symbol is added to the library and an instance of the symbol is inserted into the center of the document. If it is false, the symbol is added only to the library. bAllowUI If bAllowUI is true, and fileURL is a Fireworks document that contains symbols, then a dialog box lets the user specify which symbols to import from the external file. If it is false, all the symbols in the external file are imported. Returns Nothing. Description Imports the specified external graphics file (for example, GIF, JPEG, or Fireworks document) into the library of the document. dom.importSymbolButNotAsAlias() Availability Fireworks MX. Usage dom.importSymbolButNotAsAlias(filepath, whichSymbol)

  • 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

92
EXTENDING FIREWORKS
The Document object
Las
t
up
d
a
ted
12/8/2009
bMaintainAspectRatio
If
bMaintainAspectRatio
is
true
, the file is scaled to the largest size that fits within
boundingRectangle
while retaining the file’s current aspect ratio. (This is a handy option for creating thumbnails.)
If it is
false
, the file is scaled to fill
boundingRectangle
.
Returns
Nothing.
Description
Imports the specified file at the specified location.
Example
The following command imports the specified file and maintains its aspect ratio:
fw.getDocumentDOM().importFile("file:///C|/images/foo.psd", {left:25, top:50, right:100,
bottom:250}, true);
dom.importSymbol()
Availability
Fireworks 3.
Usage
dom.importSymbol(
fileURL, bAddToDoc, bAllowUI
)
Arguments
fileURL
The name of the file to be imported into the library, which is expressed as a
file://URL
.
bAddToDoc
If
bAddToDoc
is
true
, the symbol is added to the library and an instance of the symbol is inserted into the
center of the document. If it is
false
, the symbol is added only to the library.
bAllowUI
If
bAllowUI
is
true
, and
fileURL
is a Fireworks document that contains symbols, then a dialog box lets the
user specify which symbols to import from the external file. If it is
false
, all the symbols in the external file are
imported.
Returns
Nothing.
Description
Imports the specified external graphics file (for example, GIF, JPEG, or Fireworks document) into the library of the
document.
dom.importSymbolButNotAsAlias()
Availability
Fireworks MX.
Usage
dom.importSymbolButNotAsAlias(
filepath, whichSymbol
)