Adobe 38039927 Extended User Guide - Page 276

Events

Page 276 highlights

ADOBE FIREWORKS CS3 272 Extending Guide Events Fireworks events for Flash panels allow developers to write event handlers for specific user interaction. For example, a panel for creating a customized shape can respond to the user changing the stroke attribute, and make changes to the lines in the shape accordingly. How event handlers work When a panel is launched and the Flash movie starts, Fireworks will scan the movie script for the presence of event handlers. If a handler is present, Fireworks automatically registers the function to receive the corresponding event. Fireworks only looks at the SWF file to see if it needs any of these events when the panel opens (when the SWF file runs). Creating event handlers To create an event handler, implement a function with the corresponding event name. Currently, Fireworks supports the following events for Flash panels: Event onFwStartMovie onFwStopMovie onFwUnitsChange onFwPICollapseOrExpand onFwDocumentNameChange onFwCurrentFrameChange onFwCurrentLayerChange onFwHistoryChange onFwIdle0 onFwIdle1 onFwIdle2 onFwApplicationDeactivate onFwApplicationActivate onFwSymbolLibraryChange onFwURLListChange onFwFavoritesChange onFwPreferencesChange Description Sent to the SWF file right after Fireworks has started (or restarted) the SWF file. Sent to the SWF file right before Fireworks stops the file (and possibly unloads it). Sent when the user changes the type of units (inches, pixels, centimeters) in the Info panel. Sent when the user switches the PI between two rows high and four rows high. Sent when the name of the current document changes (for example, when the user performs a save). Sent when the user selects a different frame. Sent when the user selects a different layer. Sent when the user creates an non-scriptable history step. Sent when Fireworks is in the first of a sequence of idle states. Because Fireworks may often go through a sequence of idle states, triggering functions by this event may impair application performance. Sent when Fireworks is in the second of a sequence of idle states. Because Fireworks may often go through a sequence of idle states, triggering functions by this event may impair application performance. Sent when Fireworks is in the third of a sequence of idle states. Because Fireworks may often go through a sequence of idle states, triggering functions by this event may impair application performance. Sent when the Fireworks application loses focus. Sent when the Fireworks application gains focus. Sent when the symbol library changes in some way. Sent when a new URL is added to the document. Sent when the favorite URLs list is modified. Sent when the preferences are changed.

  • 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
272
Events
Fireworks events for Flash panels allow developers to write event handlers for specific user interaction. For example,
a panel for creating a customized shape can respond to the user changing the stroke attribute, and make changes to
the lines in the shape accordingly.
How event handlers work
When a panel is launched and the Flash movie starts, Fireworks will scan the movie script for the presence of event
handlers. If a handler is present, Fireworks automatically registers the function to receive the corresponding event.
Fireworks only looks at the SWF file to see if it needs any of these events when the panel opens (when the SWF file
runs).
Creating event handlers
To create an event handler, implement a function with the corresponding event name. Currently, Fireworks
supports the following events for Flash panels:
Event
Description
onFwStartMovie
Sent to the SWF file right after Fireworks has started (or restarted) the
SWF file.
onFwStopMovie
Sent to the SWF file right before Fireworks stops the file (and possibly
unloads it).
onFwUnitsChange
Sent when the user changes the type of units (inches, pixels, centimeters)
in the Info panel.
onFwPICollapseOrExpand
Sent when the user switches the PI between two rows high and four rows
high.
onFwDocumentNameChange
Sent when the name of the current document changes (for example,
when the user performs a save).
onFwCurrentFrameChange
Sent when the user selects a different frame.
onFwCurrentLayerChange
Sent when the user selects a different layer.
onFwHistoryChange
Sent when the user creates an non-scriptable history step.
onFwIdle0
Sent when Fireworks is in the first of a sequence of idle states. Because
Fireworks may often go through a sequence of idle states, triggering
functions by this event may impair application performance.
onFwIdle1
Sent when Fireworks is in the second of a sequence of idle states. Because
Fireworks may often go through a sequence of idle states, triggering
functions by this event may impair application performance.
onFwIdle2
Sent when Fireworks is in the third of a sequence of idle states. Because
Fireworks may often go through a sequence of idle states, triggering
functions by this event may impair application performance.
onFwApplicationDeactivate
Sent when the Fireworks application loses focus.
onFwApplicationActivate
Sent when the Fireworks application gains focus.
onFwSymbolLibraryChange
Sent when the symbol library changes in some way.
onFwURLListChange
Sent when a new URL is added to the document.
onFwFavoritesChange
Sent when the favorite URLs list is modified.
onFwPreferencesChange
Sent when the preferences are changed.