Adobe 38039927 Extended User Guide - Page 293

Flex Component Definitions for MXML and Images Export

Page 293 highlights

ADOBE FIREWORKS CS3 289 Extending Guide Flex Component Definitions for MXML and Images Export When exporting a Fireworks document with the MXML and Image export, Fireworks checks each element's customData property for definitions that dictate how that element should appear in the resulting MXML. If no MXML-related definitions are found, the element is exported as an image. Each Flex component found in the Fireworks common library already has unique customData definitions that allow it to be exported as MXML. If you wish to have elements within your document export as their own custom MXML tags you can do so with the following customData definitions. flexClassName Flex component symbols are associated as being Flex Components by the MXML and Images import through a customData property called flexClassName. Format flexClassName = "WhichClass"; When this property is present in a Fireworks element, the MXML and Images export process exports the element as a specific MXML tag and not as an image. Its value indicates the tag name of the MXML class generated. Example element.customData["flexClassName"] = "ComboBox"; The above line indicates that the element object is a Flex component whose MXML class is ComboBox. For rich symbols this code should be placed within the setDefaultValues block of code (Widget.opCode == 1) that initially defines the rich symbol. Example function setDefaultValues() { Widget.elem.customData["flexClassName"] = "ComboBox"; // additional code... } switch (Widget.opCode) { case 1: setDefaultValues(); // additional code... } break; All Flex widgets provided with Fireworks already have this property defined. The class name used determines the behavior of each of those components as determined internally within the MXML and Images export. When you create a custom rich symbol, you must define the flexClassName property if you want the MXML and Images export to treat the rich symbol as an MXML tag and not an exported image. The class name you decide to use will be used in the resulting MXML tag. For example, if you defined flexClassName as "Foo" the resulting MXML tag is . flexClassDefinition In addition to the flexClassName property, there is an additional, optional customData property flexClassDefinition, which can be used to further influence the resulting MXML export. Format flexClassDefinition = classDefinitionObject;

  • 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
289
Flex Component Definitions for MXML and Images Export
When exporting a Fireworks document with the MXML and Image export, Fireworks checks each element’s
customData
property for definitions that dictate how that element should appear in the resulting MXML. If no
MXML-related definitions are found, the element is exported as an image. Each Flex component found in the
Fireworks common library already has unique
customData
definitions that allow it to be exported as MXML. If you
wish to have elements within your document export as their own custom MXML tags you can do so with the
following
customData
definitions.
flexClassName
Flex component symbols are associated as being Flex Components by the MXML and Images import through a
customData
property called
flexClassName
.
Format
flexClassName = "WhichClass";
When this property is present in a Fireworks element, the MXML and Images export process exports the element
as a specific MXML tag and not as an image. Its value indicates the tag name of the MXML class generated.
Example
element.customData["flexClassName"] = "ComboBox";
The above line indicates that the element object is a Flex component whose MXML class is ComboBox. For rich
symbols this code should be placed within the
setDefaultValues
block of code (
Widget.opCode == 1
) that
initially defines the rich symbol.
Example
function setDefaultValues() {
Widget.elem.customData["flexClassName"] = "ComboBox";
// additional code...
}
switch (Widget.opCode) {
case 1: setDefaultValues();
break;
// additional code...
}
All Flex widgets provided with Fireworks already have this property defined. The class name used determines the
behavior of each of those components as determined internally within the MXML and Images export.
When you create a custom rich symbol, you must define the
flexClassName
property if you want the MXML and
Images export to treat the rich symbol as an MXML tag and not an exported image. The class name you decide to
use will be used in the resulting MXML tag. For example, if you defined
flexClassName
as “Foo” the resulting
MXML tag is
<mx:Foo … />
.
flexClassDefinition
In addition to the
flexClassName
property, there is an additional, optional
customData
property
flexClassDef-
inition
, which can be used to further influence the resulting MXML export.
Format
flexClassDefinition = classDefinitionObject;