Adobe 38039481 User Guide - Page 294

Multilanguage text and ActionScript

Page 294 highlights

FLASH CS3 288 User Guide See also "Publishing overview" on page 418 Multilanguage text and ActionScript Use ActionScript to load external files To load existing XML data, or use a different format for the XML file, use the loadVariables action, the getURL action, the LoadVars object, or the XML object to create a document that contains multilanguage text by placing the text in an external text or XML file and loading the file into the movie clip at runtime. Save the external file in UTF-8 (recommended), UTF-16BE, or UTF-16LE format, using an application that supports the format. If you are using UTF-16BE or UTF-16LE format, the file must begin with a BOM to identify the encoding format to Flash Player. The following table lists the BOM to include to identify the encoding: Note: Most text editors that can save files in UTF-16BE or LE automatically add the BOMs to the files. UTF Format UTF-16BE UTF-16LE First Byte OxFE OxFF Second Byte OxFF OxFE Note: If the external file is an XML file, you cannot use an XML encoding tag to change the file encoding. Save the file in a supported Unicode format. 1 In the Flash authoring application, create a dynamic or input text field to show the text in the document. 2 In the Property inspector, with the text field selected, assign an instance name to the text field. 3 Outside of Flash, create a text or XML file that defines the value for the text field variable. 4 Save the XML file in UTF-8 (recommended), UTF-16BE, or UTF-16LE format. 5 Use one of the following ActionScript procedures to reference the external file and load it into the dynamic or input text field: • Use the loadVariables action to load an external file. • Use the getURL action to load an external file from a specified URL. • Use the LoadVars object (a predefined client-server object) to load an external text file from a specified URL. • Use the XML object (a predefined client-server object) to load an external XML file from a specified URL. For more information, see XML in the ActionScript 2.0 Language Reference. See also "Using the XMLConnector component to connect to external XML files" on page 290 "Unicode and Flash Player" on page 280 "Working with text" on page 260 Create multilanguage documents using the #include action To create a document that contains multiple languages, use the #include action.

  • 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
  • 499
  • 500
  • 501
  • 502
  • 503
  • 504
  • 505
  • 506
  • 507
  • 508
  • 509
  • 510
  • 511
  • 512
  • 513
  • 514
  • 515
  • 516
  • 517
  • 518
  • 519
  • 520
  • 521
  • 522
  • 523
  • 524
  • 525
  • 526

FLASH CS3
User Guide
288
See also
“Publishing overview” on page
418
Multilanguage text and ActionScript
Use ActionScript to load external files
To load existing XML data, or use a different format for the XML file, use the
loadVariables
action, the
getURL
action, the
LoadVars
object, or the
XML
object to create a document that contains multilanguage text by placing the
text in an external text or XML file and loading the file into the movie clip at runtime.
Save the external file in UTF-8 (recommended), UTF-16BE, or UTF-16LE format, using an application that supports
the format. If you are using UTF-16BE or UTF-16LE format, the file must begin with a BOM to identify the encoding
format to Flash Player. The following table lists the BOM to include to identify the encoding:
Note:
Most text editors that can save files in UTF-16BE or LE automatically add the BOMs to the files.
Note:
If the external file is an XML file, you cannot use an XML encoding tag to change the file encoding. Save the file
in a supported Unicode format.
1
In the Flash authoring application, create a dynamic or input text field to show the text in the document.
2
In the Property inspector, with the text field selected, assign an instance name to the text field.
3
Outside of Flash, create a text or XML file that defines the value for the text field variable.
4
Save the XML file in UTF-8 (recommended), UTF-16BE, or UTF-16LE format.
5
Use one of the following ActionScript procedures to reference the external file and load it into the dynamic or
input text field:
Use the
loadVariables
action to load an external file.
Use the
getURL
action to load an external file from a specified URL.
Use the
LoadVars
object (a predefined client-server object) to load an external text file from a specified URL.
Use the
XML
object (a predefined client-server object) to load an external XML file from a specified URL. For more
information, see XML in the
ActionScript 2.0 Language Reference
.
See also
“Using the XMLConnector component to connect to external XML files” on page
290
“Unicode and Flash Player” on page
280
“Working with text” on page
260
Create multilanguage documents using the #include action
To create a document that contains multiple languages, use the
#include
action.
UTF Format
First Byte
Second Byte
UTF-16BE
OxFE
OxFF
UTF-16LE
OxFF
OxFE