Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
fl.lang 

Locale  - AS3 Flash

Pacchettix

Primo livello
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementi del linguaggio

Costanti globali
Funzioni globali
Operatori
Istruzioni, parole chiave e direttive
Tipi speciali

Appendici

Novità
Errori del compilatore
Avvisi del compilatore
Errori runtime
Migrazione a ActionScript 3
Set di caratteri supportati
Tag solo di MXML
Elementi XML di Motion
Tag Timed Text
Elenco degli elementi obsoleti
Costanti di implementazione dell’accessibilità
Utilizzare gli esempi ActionScript
Note legali
Pacchettofl.lang
Classepublic class Locale
EreditarietàLocale Inheritance EventDispatcher Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

La classe fl.lang.Locale consente di controllare il modo in cui il testo multilingua viene visualizzato in un file SWF. Il pannello Stringhe di Flash consente di utilizzare gli identificatori di stringa anziché i valori letterali nei campi di testo dinamici. In questo modo potete creare un file SWF che visualizza il testo caricato da un file XML specifico di una lingua. Il file XML deve utilizzare il formato XML Localization Interchange File Format (XLIFF). Sono disponibili tre modi per visualizzare le stringhe specifiche per le lingue contenute nei file XLIFF:
  • "automaticamente in fase di runtime" -- Flash Player sostituisce gli identificatori di stringa con le stringhe del file XML che corrisponde al codice di lingua di sistema predefinito restituito da flash.system.capabilities.language.
  • "manualmente mediante la lingua dello stage" -- Gli identificatori di stringa vengono sostituiti dalle stringhe in fase di compilazione e non possono essere modificati da Flash Player.
  • "mediante ActionScript in fase di runtime" -- La sostituzione degli identificatori di stringa viene controllata mediante ActionScript in fase di runtime. Questa opzione vi permette di controllare sia i tempi che la lingua della sostituzione degli identificatori di stringa.

Potete utilizzare le proprietà e i metodi di questa classe quando desiderate sostituire gli identificatori di stringa "mediante ActionScript in fase di runtime".

Tutte le proprietà e tutti i metodi sono statici, in altre parole sono accessibili direttamente mediante la classe fl.lang.Locale anziché mediante una sua istanza.

Nota: la classe Locale è installata nel percorso di classe dello strumento di creazione di Flash e viene compilata automaticamente nei file SWF. L'utilizzo della classe Locale aumenta sensibilmente la dimensione del file SWF, in quanto la classe viene compilata in questo file.

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
  autoReplace : Boolean
[statico] Determina se le stringhe vengono sostituite automaticamente dopo il caricamento dell'XML.
Locale
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  languageCodeArray : Array
[statico] [sola lettura] Un array che contiene i codici di lingua per le lingue specificate o caricate nel file FLA.
Locale
  stringIDArray : Array
[statico] [sola lettura] Un array che contiene tutti gli identificatori di stringa nel file FLA.
Locale
Metodi pubblici
 MetodoDefinito da
  
addDelayedInstance(instance:Object, stringID:String):*
[statico] Aggiunge la coppia {instance, string ID} all'array interno per un uso successivo.
Locale
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.
EventDispatcher
  
addXMLPath(langCode:String, path:String):void
[statico] Aggiunge la coppia {languageCode, languagePath} all'array interno per un uso successivo.
Locale
  
[statico] Restituisce true se il file XML viene caricato, false in caso contrario.
Locale
 Inherited
Invia un evento nel flusso di eventi.
EventDispatcher
  
[statico] Il codice di lingua predefinito impostato nella finestra di dialogo del pannello Stringhe o mediante una chiamata al metodo setDefaultLang().
Locale
 Inherited
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.
EventDispatcher
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
[statico] Determina automaticamente la lingua da utilizzare e carica il file XML della lingua.
Locale
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void
[statico] Carica il file XML della lingua specificato.
Locale
  
[statico] Restituisce il valore di stringa associato all'identificatore di stringa specifico nella lingua corrente.
Locale
  
loadStringEx(stringID:String, languageCode:String):String
[statico] Restituisce il valore di stringa associato all'identificatore di stringa specifico e al codice di lingua.
Locale
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Rimuove un listener dall'oggetto EventDispatcher.
EventDispatcher
  
[statico] Imposta il codice di lingua predefinito.
Locale
  
setLoadCallback(loadCallback:Function):*
[statico] Imposta la funzione di callback che viene chiamata una volta caricato il file XML.
Locale
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
setString(stringID:String, languageCode:String, stringValue:String):void
[statico] Imposta il nuovo valore di stringa di un identificatore di stringa specifico e del codice di lingua.
Locale
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
 Inherited
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.
EventDispatcher
Eventi
 Evento Riepilogo Definito da
 Inherited[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.EventDispatcher
 Inherited[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.EventDispatcher
Descrizione delle proprietà

autoReplace

proprietà
autoReplace:Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Determina se le stringhe vengono sostituite automaticamente dopo il caricamento dell'XML. Se è impostata su true, il metodo di sostituzione del testo equivale all'impostazione "automaticamente in fase di runtime" del pannello Stringhe. Ciò significa che Flash Player determina la lingua predefinita dell'ambiente host e visualizza automaticamente il testo in tale lingua. Se è impostata su false, il metodo di sostituzione del testo equivale all'impostazione "mediante ActionScript in fase di runtime" del pannello Stringhe. Ciò significa che spetta a voi caricare il file XML corretto per visualizzare il testo.

Il valore predefinito di questa proprietà dipende dall'impostazione selezionata per l'opzione Sostituisci stringhe nella finestra di dialogo del pannello Stringhe: true per "automaticamente in fase di runtime" (l'impostazione predefinita) e false per "mediante ActionScript in fase di runtime".



Implementazione
    public static function get autoReplace():Boolean
    public static function set autoReplace(value:Boolean):void

Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzata la proprietà Locale.autoReplace per compilare il campo di testo greeting_txt creato dinamicamente sullo stage con il contenuto della stringa IDS_GREETING del file XML dell'inglese. Nel pannello Stringhe, fate clic sul pulsante Impostazioni per aprire la finestra di dialogo Impostazioni. In questa finestra, aggiungete due lingue attive, l'inglese (en) e il francese (fr), impostate il pulsante di opzione delle stringhe di sostituzione su mediante ActionScript in fase di runtime, quindi fate clic su OK. Infine, immettete l'identificatore di stringa IDS_GREETING nel pannello Stringhe e aggiungete testo per ogni lingua attiva.
     var greeting_txt:TextField = new TextField();
     greeting_txt.x = 40;
     greeting_txt.y = 40;
     greeting_txt.width = 200;
     greeting_txt.height = 20;
     greeting_txt.autoSize = TextFieldAutoSize.LEFT;
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.loadLanguageXML("en");
     

languageCodeArray

proprietà 
languageCodeArray:Array  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Un array che contiene i codici di lingua per le lingue specificate o caricate nel file FLA. I codici di lingua non sono ordinati alfabeticamente.



Implementazione
    public static function get languageCodeArray():Array

Esempio  ( Come utilizzare questo esempio )
Nell'esempio che segue viene caricato un file XML della lingua in base al valore corrente di un componente ComboBox. Trascinate un componente ComboBox nello stage e assegnate ad esso il nome di istanza lang_cb. Con lo strumento Testo, create un campo di testo dinamico e assegnate ad esso il nome di istanza greeting_txt. Nel pannello Stringhe, aggiungete almeno due lingue attive, impostate il pulsante di opzione delle stringhe di sostituzione su "mediante ActionScript in fase runtime", quindi fate clic su OK. Successivamente aggiungete l'identificatore di stringa IDS_GREETING e immettete il testo per ogni lingua attiva. Infine, aggiungete il codice ActionScript seguente al fotogramma 1 della linea temporale principale:
     Locale.setLoadCallback(localeListener);
     lang_cb.dataProvider = Locale.languageCodeArray.sort();
     lang_cb.addEventListener("change", langListener);
     
     function langListener(eventObj:Object):void {
      Locale.loadLanguageXML(eventObj.target.value);
     }
     function localeListener(success:Boolean):void {
      if (success) {
          greeting_txt.text = Locale.loadString("IDS_GREETING");
      } else {
          greeting_txt.text = "unable to load language XML file.";
      }
     }
     

stringIDArray

proprietà 
stringIDArray:Array  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Un array che contiene tutti gli identificatori di stringa nel file FLA. Gli identificatori di stringa non sono ordinati alfabeticamente.



Implementazione
    public static function get stringIDArray():Array

Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene analizzata la proprietà Locale.stringIDArray del file XML della lingua attualmente caricato. Nel pannello Stringhe, fate clic sul pulsante Impostazioni per aprire la finestra di dialogo Impostazioni. A questo punto, aggiungete due lingue attive, l'inglese (en) e il francese (fr), impostate il pulsante di opzione delle stringhe di sostituzione su mediante ActionScript in fase di runtime, quindi fate clic su OK. Nel pannello Stringhe, aggiungete l'identificatore di stringa IDS_GREETING, quindi il testo per ogni lingua attiva.
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("fr");
     function localeCallback(success:Boolean) {
      trace(success);
      trace(Locale.stringIDArray); // IDS_GREETING
      trace(Locale.loadStringEx("IDS_GREETING", "fr")); // bonjour
     }
     
Descrizione dei metodi

addDelayedInstance

()metodo
public static function addDelayedInstance(instance:Object, stringID:String):*

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Aggiunge la coppia {instance, string ID} all'array interno per un uso successivo. Viene utilizzato da Flash principalmente quando il metodo di sostituzione delle stringhe è "automaticamente in fase di runtime".

Parametri

instance:Object — Nome di istanza del campo di testo da compilare.
 
stringID:String — Identificatore di stringa della lingua.

Restituisce
*

Esempio  ( Come utilizzare questo esempio )
L'esempio seguente utilizza la proprietà autoReplace e il metodo addDelayedInstance() per compilare un campo di testo sullo stage con la stringa IDS_GREETING del file XML della lingua inglese.
     greeting_txt.autoSize = TextFieldAutoSize.LEFT;
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.loadLanguageXML("en");
     

addXMLPath

()metodo 
public static function addXMLPath(langCode:String, path:String):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Aggiunge la coppia {languageCode, languagePath} all'array interno per un uso successivo. Viene utilizzato principalmente da Flash Player quando il metodo di sostituzione delle stringhe è "automaticamente in fase di runtime" o "mediante ActionScript in fase di runtime". Questo metodo consente di caricare i file delle lingue XML da una posizione personalizzata anziché dalla posizione predefinita impostata da Flash Professional. Pe impostazione predefinita, Flash Professional crea un file XML per ogni lingua nella vostra directory di lavoro, in una sottodirectory il cui nome corrisponde a quello del file FLA.

Parametri

langCode:String — Il codice di lingua.
 
path:String — Il percorso XML da aggiungere.


Esempio  ( Come utilizzare questo esempio )
L'esempio seguente indica a Flash Player che le traduzioni inglesi ("en") si trovano nel file "locale/locale_en.xml" e quelle francesi ("fr") nel file "locale/locale_fr.xml" relativo alla directory di lavoro (esempio e descrizione forniti da Chris Inch, di http://www.chrisinch.com):
     Locale.addXMLPath("en", "locale/locale_en.xml");
     Locale.addXMLPath("fr", "locale/locale_fr.xml");
     Locale.setLoadCallback(Delegate.create(this, languageLoaded));
     Locale.loadLanguageXML("en");
     
     private function languageLoaded(success:Boolean):Void {
        trace(Locale.loadString("IDS_HELLO");
     
     

checkXMLStatus

()metodo 
public static function checkXMLStatus():Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Restituisce true se il file XML viene caricato, false in caso contrario.

Restituisce
Boolean — Restituisce true se il file XML viene caricato, false in caso contrario.

Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzato un intervallo per verificare ogni dieci secondi se il file della lingua è stato caricato. Una volta caricato il file XML, l'istanza del campo di testo greeting_txt sullo stage viene popolata con la stringa IDS_GREETING del file XML della lingua.
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("en");
     // create interval to check if language XML file is loaded
     var locale_int:Number = setInterval(checkLocaleStatus, 10);
     function checkLocaleStatus():void {
      if (Locale.checkXMLStatus()) {
          clearInterval(locale_int);
          trace("clearing interval @ " + getTimer() + " ms");
      }
     }
     // callback function for Locale.setLoadCallback()
     function localeCallback(success:Boolean):void {
      greeting_txt.text = Locale.loadString("IDS_GREETING");
     }
     

getDefaultLang

()metodo 
public static function getDefaultLang():String

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Il codice di lingua predefinito impostato nella finestra di dialogo del pannello Stringhe o mediante una chiamata al metodo setDefaultLang().

Restituisce
String — Restituisce il codice di lingua predefinito.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene creata una variabile denominata defLang, che viene utilizzata per gestire la lingua predefinita iniziale del documento Flash. Nel pannello Stringhe, fate clic sul pulsante Impostazioni per avviare la finestra di dialogo Impostazioni. A questo punto aggiungete due lingue attive, l'inglese (en) e il francese (fr), impostate il pulsante di opzione delle stringhe di sostituzione su mediante ActionScript in fase di runtime, quindi fate clic su OK. Nel pannello Stringhe, aggiungete l'identificatore di stringa IDS_GREETING, quindi il testo per ogni lingua attiva.
     var defLang:String = "fr";
     Locale.setDefaultLang(defLang);
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML(Locale.getDefaultLang());
     function localeCallback(success:Boolean) {
      if (success) {
          trace(Locale.stringIDArray); // IDS_GREETING
          trace(Locale.loadString("IDS_GREETING"));
      } else {
          trace("unable to load XML");
      }
     }
     

initialize

()metodo 
public static function initialize():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Determina automaticamente la lingua da utilizzare e carica il file XML della lingua. Viene utilizzato da Flash principalmente quando il metodo di sostituzione delle stringhe è "automaticamente in fase di runtime".


Esempio  ( Come utilizzare questo esempio )
In questo esempio viene illustrato come utilizzare il metodo initialize() per compilare automaticamente il campo di testo greeting_txt sullo stage con la lingua del sistema operativo corrente dell'utente. Anziché impiegare direttamente il metodo initialize(), utilizzate il metodo di sostituzione delle stringhe "automaticamente in fase di runtime".
     trace(System.capabilities.language);
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.initialize();
     

loadLanguageXML

()metodo 
public static function loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Carica il file XML della lingua specificato.

Parametri

xmlLanguageCode:String — Il codice di lingua del file XML della lingua da caricare.
 
customXmlCompleteCallback:Function (default = null) — La funzione di callback personalizzata da chiamare al caricamento del file XML della lingua.


Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzato il metodo loadLanguageXML() per caricare il file XML della lingua inglese (en). Una volta caricato il file della lingua, viene chiamato il metodo localeCallback() per popolare il campo di testo greeting_txt sullo stage con il contenuto della stringa IDS_GREETING del file XML.
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("en");
     // create interval to check if language XML file is loaded
     var locale_int:Number = setInterval(checkLocaleStatus, 10);
     function checkLocaleStatus():void {
      if (Locale.checkXMLStatus()) {
          clearInterval(locale_int);
          trace("clearing interval @ " + getTimer() + " ms");
      }
     }
     // callback function for Locale.setLoadCallback()
     function localeCallback(success:Boolean):void {
      greeting_txt.text = Locale.loadString("IDS_GREETING");
     }
     

loadString

()metodo 
public static function loadString(id:String):String

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Restituisce il valore di stringa associato all'identificatore di stringa specifico nella lingua corrente.

Parametri

id:String — Il numero di identificazione (ID) della stringa da caricare.

Restituisce
String — Il valore di stringa associato all'identificatore di stringa specifico nella lingua corrente.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzato un intervallo per verificare ogni dieci secondi se il file della lingua è stato caricato. Una volta caricato il file XML, l'istanza del campo di testo greeting_txt sullo stage viene popolata con la stringa IDS_GREETING del file XML della lingua.
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("en");
     // create interval to check if language XML file is loaded
     var locale_int:Number = setInterval(checkLocaleStatus, 10);
     function checkLocaleStatus():void {
      if (Locale.checkXMLStatus()) {
          clearInterval(locale_int);
          trace("clearing interval @ " + getTimer() + " ms");
      }
     }
     // callback function for Locale.setLoadCallback()
     function localeCallback(success:Boolean):void {
      greeting_txt.text = Locale.loadString("IDS_GREETING");
     }
     

loadStringEx

()metodo 
public static function loadStringEx(stringID:String, languageCode:String):String

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Restituisce il valore di stringa associato all'identificatore di stringa specifico e al codice di lingua. Per evitare il caricamento imprevisto del file XML, loadStringEx() non carica il file XML della lingua se non è stato già caricato. È opportuno determinare il momento giusto per chiamare il metodo loadLanguageXML() se desiderate caricare un file XML della lingua.

Parametri

stringID:String — Il numero di identificazione (ID) della stringa da caricare.
 
languageCode:String — Il codice di lingua.

Restituisce
String — Il valore di stringa associato all'identificatore di stringa specifico nella lingua specificata dal parametro languageCode.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzato il metodo loadStringEx() per analizzare il valore della stringa IDS_GREETING del file XML della lingua francese attualmente caricato.
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("fr");
     function localeCallback(success:Boolean) {
      trace(success);
      trace(Locale.stringIDArray); // IDS_GREETING
      trace(Locale.loadStringEx("IDS_GREETING", "fr")); // bonjour
     }
     

setDefaultLang

()metodo 
public static function setDefaultLang(langCode:String):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Imposta il codice di lingua predefinito.

Parametri

langCode:String — Una stringa che rappresenta un codice di lingua.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene creata una variabile denominata defLang, che viene utilizzata per gestire la lingua predefinita iniziale del documento Flash. Nel pannello Stringhe, fate clic sul pulsante Impostazioni per aprire la finestra di dialogo Impostazioni. A questo punto aggiungete due lingue attive, l'inglese (en) e il francese (fr), impostate il pulsante di opzione delle stringhe di sostituzione su mediante ActionScript in fase di runtime, quindi fate clic su OK. Nel pannello Stringhe, aggiungete l'identificatore di stringa IDS_GREETING, quindi il testo per ogni lingua attiva.
     var defLang:String = "fr";
     Locale.setDefaultLang(defLang);
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML(Locale.getDefaultLang());
     function localeCallback(success:Boolean) {
      if (success) {
          trace(Locale.stringIDArray); // IDS_GREETING
          trace(Locale.loadString("IDS_GREETING"));
      } else {
          trace("unable to load XML");
      }
     }
     

setLoadCallback

()metodo 
public static function setLoadCallback(loadCallback:Function):*

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Imposta la funzione di callback che viene chiamata una volta caricato il file XML.

Parametri

loadCallback:Function — La funzione da chiamare al caricamento del file XML della lingua.

Restituisce
*

Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzato un intervallo per verificare ogni dieci secondi se il file della lingua è stato caricato. Una volta caricato il file XML, l'istanza del campo di testo greeting_txt sullo stage viene popolata con la stringa IDS_GREETING del file XML della lingua.
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("en");
     // create interval to check if language XML file is loaded
     var locale_int:Number = setInterval(checkLocaleStatus, 10);
     function checkLocaleStatus():void {
      if (Locale.checkXMLStatus()) {
          clearInterval(locale_int);
          trace("clearing interval @ " + getTimer() + " ms");
      }
     }
     // callback function for Locale.setLoadCallback()
     function localeCallback(success:Boolean):void {
      greeting_txt.text = Locale.loadString("IDS_GREETING");
     }
     

setString

()metodo 
public static function setString(stringID:String, languageCode:String, stringValue:String):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Imposta il nuovo valore di stringa di un identificatore di stringa specifico e del codice di lingua.

Parametri

stringID:String — Il numero di identificazione (ID) della stringa da impostare.
 
languageCode:String — Il codice di lingua.
 
stringValue:String — Un valore di stringa.


Esempio  ( Come utilizzare questo esempio )
Nell'esempio riportato di seguito viene utilizzato il metodo setString() per impostare la stringa IDS_WELCOME dell'inglese (en) e del francese (fr).
     Locale.setString("IDS_WELCOME", "en", "hello");
     Locale.setString("IDS_WELCOME", "fr", "bonjour");
     trace(Locale.loadStringEx("IDS_WELCOME", "en")); // hello
     




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.