Adobe 65011817 Extended User Guide - Page 148

dom.setDocumentCanvasSize

Page 148 highlights

Last updated 12/8/2009 EXTENDING FIREWORKS 144 The Document object fw.getDocumentDOM().setDocumentCanvasColor("#0000ff"); dom.setDocumentCanvasSize() Availability Fireworks 3, with new argument added in Fireworks CS3. Usage dom.setDocumentCanvasSize(boundingRectangle, currentPageOnly) Arguments boundingRectangle A rectangle that specifies the new canvas size for the document, in pixels (see "Rectangle data type" on page 8). Any items outside the specified rectangle are removed. currentPageOnly A Boolean value that specifies whether the change in canvas size applies to all pages or only the current page. If the value is true, only the current page is resized. If it is false, all pages of the document are resized. The default value is true. Returns Nothing. Description Sets the document's canvas size to the specified rectangle and apply the change to the current page or all pages. Example The following command sets the canvas to a size of 200 by 200 pixels: fw.getDocumentDOM().setDocumentCanvasSize({left:150, top:150, right:350, bottom:350}); dom.setDocumentCanvasSizeToDocumentExtents() Availability Fireworks 3. Usage dom.setDocumentCanvasSizeToDocumentExtents(bGrowCanvas) Arguments bGrowCanvas Boolean. If true, the canvas can expand or shrink in size; if false, it only shrinks. Returns Nothing. Description Calculates the size of all the items in the document and resizes the document canvas to that size. This action is the same behavior as Modify > Trim Canvas.

  • 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

144
EXTENDING FIREWORKS
The Document object
Las
t
up
d
a
ted
12/8/2009
fw.getDocumentDOM().setDocumentCanvasColor("#0000ff");
dom.setDocumentCanvasSize()
Availability
Fireworks 3, with new argument added in Fireworks CS3.
Usage
dom.setDocumentCanvasSize(
boundingRectangle, currentPageOnly
)
Arguments
boundingRectangle
A rectangle that specifies the new canvas size for the document, in pixels (see “
Rectangle data
type
” on page
8). Any items outside the specified rectangle are removed.
currentPageOnly
A Boolean value that specifies whether the change in canvas size applies to all pages or only the
current page. If the value is
true
, only the current page is resized. If it is
false
, all pages of the document are resized.
The default value is
true
.
Returns
Nothing.
Description
Sets the document’s canvas size to the specified rectangle and apply the change to the current page or all pages.
Example
The following command sets the canvas to a size of 200 by 200 pixels:
fw.getDocumentDOM().setDocumentCanvasSize({left:150, top:150, right:350, bottom:350});
dom.setDocumentCanvasSizeToDocumentExtents()
Availability
Fireworks 3.
Usage
dom.setDocumentCanvasSizeToDocumentExtents(
bGrowCanvas
)
Arguments
bGrowCanvas
Boolean. If
true
, the canvas can expand or shrink in size; if
false
, it only shrinks.
Returns
Nothing.
Description
Calculates the size of all the items in the document and resizes the document canvas to that size. This action is the same
behavior as Modify > Trim Canvas.