| Pacchetto | fl.lang |
| Classe | public class Locale |
| Ereditarietà | Locale  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS3 |
| Versioni runtime: | Flash Player 9, AIR 1.0 |
-
"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
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| autoReplace : Boolean [statico]
Determina se le stringhe vengono sostituite automaticamente dopo il caricamento dell'XML. | Locale | ||
 | constructor : 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
| Metodo | Definito da | ||
|---|---|---|---|
[statico]
Aggiunge la coppia {instance, string ID} all'array interno per un uso successivo. | Locale | ||
| 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 | |
[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 | ||
|
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 | ||
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
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 | ||
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
[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 | ||
[statico]
Restituisce il valore di stringa associato all'identificatore di stringa specifico e al codice di lingua. | Locale | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
[statico]
Imposta il codice di lingua predefinito. | Locale | ||
[statico]
Imposta la funzione di callback che viene chiamata una volta caricato il file XML. | Locale | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
[statico]
Imposta il nuovo valore di stringa di un identificatore di stringa specifico e del codice di lingua. | Locale | ||
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
Eventi
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):voidEsempio ( 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():ArrayEsempio ( 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():ArrayEsempio ( 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.
|
* |
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.
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().
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) |
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.
|
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.
|
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.
|
* |
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
Tue Jun 12 2018, 02:44 PM Z