Adobe 65036570 User Guide - Page 236

List component parameters, Customizing the List component, Using styles with the List component

Page 236 highlights

ADOBE DIRECTOR 11.0 225 User Guide List component parameters You can set the following authoring parameters for each List component instance in the Property inspector or in the Component Inspector panel: data an array of values that populate the data of the list. The default value is [] (an empty array). There is no equivalent runtime property. labels an array of text values that populate the label values of list. The default value is [] (an empty array). There is no equivalent runtime property. multipleSelection a Boolean value that indicates whether you can select multiple values (true) or not (false). The default value is false. rowHeight indicates the height, in pixels, of each row. The default value is 20. Setting a font does not change the height of a row. You can write scripts to set additional options for List instances using its methods, properties, and events. For more information, see "List class" in the Flash documentation. Customizing the List component You can transform a List component horizontally and vertically both while authoring and at runtime. When a list is resized, the rows of the list shrink horizontally, clipping any text within them. Vertically, the list adds or removes rows as needed. Scroll bars position themselves automatically. Using styles with the List component Set style properties to change the appearance of a List component. A List component uses the following Halo styles: Style Description alternatingRowColors Specifies colors for rows in an alternating pattern. The value can be an array of two or more colors, for example, 0xFF00FF, 0xCC6699, and 0x996699. backgroundColor The background color of the list. This style is defined on a class style declaration, ScrollSelectList. borderColor The black section of a three-dimensional border or the color section of a two-dimensional border. borderStyle The bounding box style. The possible values are: "none", "solid", "inset", and "outset". This style is defined on a class style declaration, ScrollSelectList. defaultIcon Name of the default icon to use for list rows. The default value is undefined. rollOverColor The color of a rolled over row. selectionColor The color of a selected row. selectionEasing A reference to an easing equation (function) used for controlling programmatic tweening. disabledColor The disabled color for text. textRollOverColor The color of text when the pointer rolls over it. textSelectedColor The color of text when selected.

  • 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
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457
  • 458
  • 459
  • 460
  • 461
  • 462
  • 463
  • 464
  • 465
  • 466
  • 467
  • 468
  • 469
  • 470
  • 471
  • 472
  • 473
  • 474
  • 475
  • 476
  • 477
  • 478
  • 479
  • 480
  • 481
  • 482
  • 483
  • 484
  • 485
  • 486
  • 487
  • 488
  • 489
  • 490
  • 491
  • 492
  • 493
  • 494
  • 495
  • 496
  • 497
  • 498

ADOBE DIRECTOR 11.0
User Guide
225
List component parameters
You can set the following authoring parameters for each List component instance in the Property inspector or in the
Component Inspector panel:
data
an array of values that populate the data of the list. The default value is [] (an empty array). There is no equiv-
alent runtime property.
labels
an array of text values that populate the label values of list. The default value is [] (an empty array). There is
no equivalent runtime property.
multipleSelection
a Boolean value that indicates whether you can select multiple values (true) or not (false). The
default value is false.
rowHeight
indicates the height, in pixels, of each row. The default value is 20. Setting a font does not change the
height of a row.
You can write scripts to set additional options for List instances using its methods, properties, and events. For more
information, see “List class” in the Flash documentation.
Customizing the List component
You can transform a List component horizontally and vertically both while authoring and at runtime.
When a list is resized, the rows of the list shrink horizontally, clipping any text within them. Vertically, the list adds
or removes rows as needed. Scroll bars position themselves automatically.
Using styles with the List component
Set style properties to change the appearance of a List component.
A List component uses the following Halo styles:
Style
Description
alternatingRowColors
Specifies colors for rows in an alternating pattern. The value can be an array of two or
more colors, for example, 0xFF00FF, 0xCC6699, and 0x996699.
backgroundColor
The background color of the list. This style is defined on a class style declaration, ScrollSe-
lectList.
borderColor
The black section of a three-dimensional border or the color section of a two-dimen-
sional border.
borderStyle
The bounding box style. The possible values are: “none”, “solid”, “inset”, and “outset”. This
style is defined on a class style declaration, ScrollSelectList.
defaultIcon
Name of the default icon to use for list rows. The default value is undefined.
rollOverColor
The color of a rolled over row.
selectionColor
The color of a selected row.
selectionEasing
A reference to an easing equation (function) used for controlling programmatic
tweening.
disabledColor
The disabled color for text.
textRollOverColor
The color of text when the pointer rolls over it.
textSelectedColor
The color of text when selected.