Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: AIR 30.0 以前, Flash Player 30.0 以前, Flash Lite 4
Flex 4.6 以前, Flash Pro CS6 以前
フィルターを非表示
fl.lang 

Locale  - AS3 Flash

パッケージx

トップレベル
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

言語エレメント

グローバル定数
グローバル関数
演算子
ステートメント、キーワード、ディレクティブ
特殊な型

付録

新機能
コンパイルエラー
コンパイラー警告
ランタイムエラー
ActionScript 3 への移行
サポートされている文字セット
MXML のみのタグ
モーション XML エレメント
Timed Text タグ
使用されなくなったエレメントのリスト
Accessibility Implementation 定数
ActionScript の例の使用方法
法律上の注意
パッケージfl.lang
クラスpublic class Locale
継承Locale Inheritance EventDispatcher Inheritance Object

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

fl.lang.Locale クラスを使用すると、SWF ファイルで表示する多言語テキストを制御できます。Flash のストリングパネルを使用すると、ダイナミックテキストフィールドでストリングリテラルの代わりにストリング ID を使用できます。これにより、特定言語の XML ファイルからロードしたテキストを表示する SWF ファイルを作成できます。この XML ファイルでは、XLIFF(XML Localization Interchange File Format:XML ローカリゼーション交換ファイル形式)を使用する必要があります。XLIFF ファイルに含まれる特定言語のストリングを表示する方法は 3 とおりあります。
  • "automatically at runtime" - Flash Player によって、ストリング ID が flash.system.capabilities.language から返されるデフォルトのシステム言語コードと一致する XML ファイルのストリングに置き換えられます。
  • "manually using stage language" - コンパイル時にストリング ID がストリングに置き換えられるので、Flash Player では変更できません。
  • "via ActionScript at runtime" - ストリング ID の置き換えを、実行時に ActionScript を使用して制御します。このオプションでは、ストリング ID を置き換えるタイミングと言語を両方とも制御できます。

このクラスのプロパティとメソッドは、「実行時に ActionScript を使用して」という方法でストリング ID を置き換える場合に使用できます。

使用可能なプロパティとメソッドはすべて静的です。つまり、fl.lang.Locale クラスのインスタンスではなく、クラス自体を使ってアクセスします。

注意: Locale クラスは Flash Authoring クラスパスにインストールされており、SWF ファイルに自動的にコンパイルされます。Locale クラスを使用すると、クラスが SWF ファイルにコンパイルされるので、SWF ファイルのサイズがわずかに大きくなります。

関連する API エレメント



パブリックプロパティ
 プロパティ定義元
  autoReplace : Boolean
[静的] XML ファイルをロードした後に自動的にストリングを置き換えるかどうかを示します。
Locale
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
  languageCodeArray : Array
[静的] [読み取り専用] 指定された言語または FLA ファイルにロードされた言語の言語コードが含まれる配列です。
Locale
  stringIDArray : Array
[静的] [読み取り専用] FLA ファイル内のストリング ID がすべて含まれる配列です。
Locale
パブリックメソッド
 メソッド定義元
  
addDelayedInstance(instance:Object, stringID:String):*
[静的] インスタンスとストリング ID のペアを内部配列に追加して、後で使用できるようにします。
Locale
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
addXMLPath(langCode:String, path:String):void
[静的] 言語コードと言語パスのペアを内部配列に追加して、後で使用できるようにします。
Locale
  
[静的] XML ファイルがロードされた場合は true、それ以外の場合は false を返します。
Locale
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
  
[静的] ストリングパネルのダイアログボックスで設定されたか、setDefaultLang() メソッドを呼び出すことで設定されたデフォルトの言語コード。
Locale
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
[静的] 使用言語を自動的に判別し、その言語の XML ファイルをロードします。
Locale
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void
[静的] 指定された言語の XML ファイルをロードします。
Locale
  
[静的] 指定されたストリング ID に関連付けられたストリング値を現在の言語で返します。
Locale
  
loadStringEx(stringID:String, languageCode:String):String
[静的] 指定されたストリング ID と言語コードに関連付けられたストリング値を返します。
Locale
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
  
[静的] デフォルトの言語コードを設定します。
Locale
  
setLoadCallback(loadCallback:Function):*
[静的] XML ファイルがロードされた後に呼び出されるコールバック関数を設定します。
Locale
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
setString(stringID:String, languageCode:String, stringValue:String):void
[静的] 指定されたストリング ID と言語コードに関連付ける新しいストリング値を設定します。
Locale
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
プロパティの詳細

autoReplace

プロパティ
autoReplace:Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

XML ファイルをロードした後に自動的にストリングを置き換えるかどうかを示します。true に設定されている場合、テキスト置き換え方法は ストリングパネルの設定 "automatically at runtime" と同じになります。つまり、Flash Player によってホスト環境のデフォルト言語が決定され、自動的にその言語でテキストが表示されます。false に設定されている場合、テキスト置き換え方法はストリングパネルの設定 "via ActionScript at runtime" と同じになります。つまり、開発者が、該当する XML ファイルをロードしてテキストを表示する必要があります。

このプロパティのデフォルト値には、ストリングパネルのダイアログボックスの「ストリングの置き換え」について選択した設定が反映されます。true"automatically at runtime"(デフォルト設定)を選択した場合の設定、false が「[実行時に ActionScript を使用して」を選択した場合の設定です。



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

例  ( この例の使用方法 )
次の例では、Locale.autoReplace プロパティを使用して、ステージ上の動的に作成された greeting_txt テキストフィールドに、英語の XML ファイル内の IDS_GREETING ストリングの内容を入力します。ストリングパネルで、「設定」ボタンをクリックして、設定ダイアログボックスを開きます。設定ダイアログボックスを使用して 2 つのアクティブな言語、つまり英語(en)およびフランス語(fr)を追加し、「ストリングの置き換え」ラジオコントロールを "via ActionScript at runtime" に設定し、「OK」をクリックします。最後に、ストリングパネルで、IDS_GREETING のストリング ID を入力し、アクティブな言語ごとにテキストを追加します。
     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

プロパティ 
languageCodeArray:Array  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

指定された言語または FLA ファイルにロードされた言語の言語コードが含まれる配列です。言語コードは、アルファベット順にソートされません。



実装
    public static function get languageCodeArray():Array

例  ( この例の使用方法 )
次の例では、ComboBox コンポーネントの現在値に基づいて、特定言語の XML ファイルをロードします。ComboBox コンポーネントをステージまでドラッグし、インスタンス名を lang_cb にします。テキストツールを使用して、ダイナミックテキストフィールドを作成し、インスタンス名を greeting_txt にします。ストリングパネルでは、少なくとも 2 つのアクティブな言語を追加し、「ストリングの置き換え」ラジオコントロールを "via ActionScript at runtime" に設定して、「OK」をクリックします。次に、ストリング ID IDS_GREETING を追加し、アクティブな言語ごとにテキストを追加します。最後に、次の ActionScript コードをメインタイムラインのフレーム 1 に追加します。
     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

プロパティ 
stringIDArray:Array  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

FLA ファイル内のストリング ID がすべて含まれる配列です。ストリング ID は、アルファベット順にソートされません。



実装
    public static function get stringIDArray():Array

例  ( この例の使用方法 )
次の例では、現在ロードされている特定言語の XML ファイルの Locale.stringIDArray プロパティを出力します。ストリングパネルで、「設定」ボタンをクリックして、設定ダイアログボックスを開きます。次に、2 つのアクティブな言語、つまり英語(en)およびフランス語(fr)を追加し、「ストリングの置き換え」ラジオコントロールを "via ActionScript at runtime" に設定し、「OK」をクリックします。ストリングパネルで、IDS_GREETING のストリング ID を入力し、アクティブな言語ごとにテキストを追加します。
     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("fr");
     function localeCallback(success:Boolean) {
      trace(success);
      trace(Locale.stringIDArray); // IDS_GREETING
      trace(Locale.loadStringEx("IDS_GREETING", "fr")); // bonjour
     }
     
メソッドの詳細

addDelayedInstance

()メソッド
public static function addDelayedInstance(instance:Object, stringID:String):*

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

インスタンスとストリング ID のペアを内部配列に追加して、後で使用できるようにします。このメソッドは主に、ストリングの置き換え方法が "automatically at runtime" である場合に Flash によって使用されます。

パラメーター

instance:Object — 設定するテキストフィールドのインスタンス名。
 
stringID:String — 言語のストリング ID。

戻り値
*

例  ( この例の使用方法 )
次の例では、autoReplace プロパティと addDelayedInstance() メソッドを使用して、ステージ上のテキストフィールドに、英語の XML ファイル内の IDS_GREETING ストリングを入力します。
     greeting_txt.autoSize = TextFieldAutoSize.LEFT;
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.loadLanguageXML("en");
     

addXMLPath

()メソッド 
public static function addXMLPath(langCode:String, path:String):void

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

言語コードと言語パスのペアを内部配列に追加して、後で使用できるようにします。このメソッドは主に、ストリングの置き換え方法が "automatically at runtime" または "via ActionScript at runtime" である場合に Flash Player によって使用されます。このメソッドを使用すると、Flash Professional によって設定されたデフォルトの場所ではなく、カスタムの場所から XML 言語ファイルをロードすることができます。Flash Professional では、デフォルトで、FLA ファイルの名前が付いたサブディレクトリ内の作業ディレクトリに、各言語の XML ファイルが作成されます。

パラメーター

langCode:String — 言語コード。
 
path:String — 追加する XML パス。


例  ( この例の使用方法 )
次の例では、関連する作業ディレクトリ内で、英語版(「en」)は「locale/locale_en.xml」ファイルに、フランス語版(「fr」)は「locale/locale_fr.xml」ファイルにそれぞれ保存されていることを Flash Player に指示します(Chris Inch による例と説明が 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

()メソッド 
public static function checkXMLStatus():Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

XML ファイルがロードされた場合は true を、それ以外の場合は false を返します。

戻り値
Boolean — XML ファイルがロードされた場合は true を、それ以外の場合は false を返します。

例  ( この例の使用方法 )
次の例では、間隔を使用して、特定言語の XML ファイルが正常にロードされたかどうかを 10 ミリ秒ごとにチェックします。XML ファイルがロードされると、ステージ上の greeting_txt テキストフィールドに、その XML ファイル内の IDS_GREETING ストリングが入力されます。
     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

()メソッド 
public static function getDefaultLang():String

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

ストリングパネルのダイアログボックスで設定されたか、setDefaultLang() メソッドを呼び出すことで設定されたデフォルトの言語コード。

戻り値
String — デフォルトの言語コードを返します。

関連する API エレメント


例  ( この例の使用方法 )
次の例では、Flash ドキュメントのデフォルトの初期言語を保持しておくために使用される defLang という変数を作成します。ストリングパネルで設定ボタンをクリックして、設定ダイアログボックスを起動します。次に、2 つのアクティブな言語、つまり英語(en)およびフランス語(fr)を追加し、「ストリングの置き換え」ラジオコントロールを "via ActionScript at runtime" に設定し、「OK」をクリックします。ストリングパネルで、IDS_GREETING のストリング ID を入力し、アクティブな言語ごとにテキストを追加します。
     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

()メソッド 
public static function initialize():void

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

使用言語を自動的に判別し、その言語の XML ファイルをロードします。このメソッドは主に、ストリングの置き換え方法が "automatically at runtime" である場合に Flash によって使用されます。


例  ( この例の使用方法 )
次の例では、initialize() メソッドを使用して、ステージ上の greeting_txtテキストフィールドに、ユーザーの現在の OS 言語を入力します。initialize() メソッドを直接使用する代わりに、ストリング置き換え方法である "automatically at runtime" を使用します。
     trace(System.capabilities.language);
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.initialize();
     

loadLanguageXML

()メソッド 
public static function loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

指定された言語の XML ファイルをロードします。

パラメーター

xmlLanguageCode:String — ロードする特定言語の XML ファイルの言語コード。
 
customXmlCompleteCallback:Function (default = null) — 特定言語の XML ファイルのロード時に呼び出されるカスタムコールバック関数。


例  ( この例の使用方法 )
次の例では、loadLanguageXML() を使用して、英語の XML ファイルをロードします。英語の XML ファイルがロードされると、localeCallback() メソッドが呼び出され、ステージ上の greeting_txt テキストフィールドに、その XML ファイル内の IDS_GREETING ストリングの内容が入力されます。
     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

()メソッド 
public static function loadString(id:String):String

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

指定されたストリング ID に関連付けられたストリング値を現在の言語で返します。

パラメーター

id:String — ロードするストリングの識別(ID)番号。

戻り値
String — 指定されたストリング ID に関連付けられたストリング値を現在の言語で返します。

関連する API エレメント


例  ( この例の使用方法 )
次の例では、間隔を使用して、特定言語の XML ファイルが正常にロードされたかどうかを 10 ミリ秒ごとにチェックします。XML ファイルがロードされると、ステージ上の greeting_txt テキストフィールドに、その XML 言語ファイル内の IDS_GREETING ストリングが入力されます。
     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

()メソッド 
public static function loadStringEx(stringID:String, languageCode:String):String

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

指定されたストリング ID と言語コードに関連付けられたストリング値を返します。予期しない XML ファイルのローディングを防止するため、loadStringEx() は、特定言語の XML ファイルがロードされていない場合にその XML ファイルをロードしません。特定言語の XML ファイルをロードする場合は、loadLanguageXML() を呼び出す適切なタイミングを決定してください。

パラメーター

stringID:String — ロードするストリングの識別(ID)番号。
 
languageCode:String — 言語コード。

戻り値
StringlanguageCode パラメーターで指定された言語による指定されたストリング ID に関連付けられたストリング値。

関連する API エレメント


例  ( この例の使用方法 )
次の例では、loadStringEx() メソッドを使用して、現在ロードされているフランス語の XML ファイルに対応する IDS_GREETING ストリングの値を出力します。
     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

()メソッド 
public static function setDefaultLang(langCode:String):void

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

デフォルトの言語コードを設定します。

パラメーター

langCode:String — 言語コードを表すストリング。

関連する API エレメント


例  ( この例の使用方法 )
次の例では、Flash ドキュメントのデフォルトの初期言語を保持しておくために使用される defLang という変数を作成します。ストリングパネルで「設定」ボタンをクリックして、設定ダイアログボックスを開きます。次に、2 つのアクティブな言語、つまり英語(en)およびフランス語(fr)を追加し、「ストリングの置き換え」ラジオコントロールを "via ActionScript at runtime" に設定し、「OK」をクリックします。ストリングパネルで、IDS_GREETING のストリング ID を入力し、アクティブな言語ごとにテキストを追加します。
     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

()メソッド 
public static function setLoadCallback(loadCallback:Function):*

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

XML ファイルがロードされた後に呼び出されるコールバック関数を設定します。

パラメーター

loadCallback:Function — 特定言語の XML ファイルのロード時に呼び出される関数。

戻り値
*

例  ( この例の使用方法 )
次の例では、間隔を使用して、特定言語の XML ファイルが正常にロードされたかどうかを 10 ミリ秒ごとにチェックします。XML ファイルがロードされると、ステージ上の greeting_txt テキストフィールドに、その XML 言語ファイル内の IDS_GREETING ストリングが入力されます。
     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

()メソッド 
public static function setString(stringID:String, languageCode:String, stringValue:String):void

言語バージョン: ActionScript 3.0
製品バージョン: Flash CS3
ランタイムバージョン: Flash Player 9, AIR 1.0

指定されたストリング ID と言語コードに関連付ける新しいストリング値を設定します。

パラメーター

stringID:String — 設定するストリングの識別(ID)番号。
 
languageCode:String — 言語コード。
 
stringValue:String — ストリング値。


例  ( この例の使用方法 )
次の例では、setString() メソッドを使用して、英語(en)とフランス語(fr)の両方の値を IDS_WELCOME ストリングに設定します。
     Locale.setString("IDS_WELCOME", "en", "hello");
     Locale.setString("IDS_WELCOME", "fr", "bonjour");
     trace(Locale.loadStringEx("IDS_WELCOME", "en")); // hello
     




[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。