| 패키지 | flash.globalization |
| 클래스 | public final class LocaleID |
| 상속 | LocaleID  Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
추가 정보
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| lastOperationStatus : String [읽기 전용]
이 LocaleID 객체에서 수행한 가장 최근 작업의 상태입니다. | LocaleID | ||
| name : String [읽기 전용]
좀 더 "정규화된" 로캘 식별자를 반환합니다. | LocaleID | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
지정된 로캘 이름으로 새 LocaleID 객체를 생성합니다. | LocaleID | ||
determinePreferredLocales(want:Vector.<String>, have:Vector.<String>, keyword:String = "userinterface"):Vector.<String> [정적]
원하는 로캘 목록과 현재 지원되는 로캘 목록을 기반으로 사용 가능한 로캘 목록을 반환합니다. | LocaleID | ||
LocaleID 객체의 키와 값 쌍을 모두 포함하는 객체를 반환합니다. | LocaleID | ||
로캘 ID 이름에서 지정한 언어 코드를 반환합니다. | LocaleID | ||
로캘 ID 이름에서 지정한 지역 코드를 반환합니다. | LocaleID | ||
로캘 ID 이름에서 지정한 스크립트 코드를 반환합니다. | LocaleID | ||
로캘 ID 이름에서 지정한 언어 변형 코드를 반환합니다. | LocaleID | ||
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
지정된 로캘의 텍스트 방향이 오른쪽에서 왼쪽인지 지정합니다. | LocaleID | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
lastOperationStatus | 속성 |
name | 속성 |
name:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
좀 더 "정규화된" 로캘 식별자를 반환합니다.
이 메서드는 로캘 ID 이름에 대해 다음 변환을 수행하여 좀 더 정규화된 형식을 제공합니다.
- 모든 구성 요소에 적절한 대/소문자 구분이 적용됩니다.
- 밑줄이 대시로 변환됩니다.
추가 처리가 수행되지 않습니다. 예를 들어 별칭이 대체되지 않으며 어떤 요소도 추가되거나 제거되지 않습니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
구현
public function get name():StringLocaleID | () | 생성자 |
public function LocaleID(name:String)| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
지정된 로캘 이름으로 새 LocaleID 객체를 생성합니다. 로캘 이름은 유니코드 기술 표준 #35(http://unicode.org/reports/tr35/)에서 정의된 구문을 따라야 합니다.
생성자가 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
요청된 로캘 ID 이름이 지원되지 않으면 lastOperationStatus가 다음 중 하나로 설정됩니다.
LastOperationStatus.USING_FALLBACK_WARNINGLastOperationStatus.USING_DEFAULT_WARNING
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
위에 나열된 경고 및 lastOperationStatus 속성의 다른 가능한 값에 대한 자세한 내용은 LastOperationStatus 클래스의 설명을 참조하십시오.
name:String — 로캘 ID 이름입니다. 이 이름에는 필요한 경우 데이터 정렬 문자열이 포함될 수도 있습니다. 예: "en-US" 또는 "de-DE@collation=phonebook"
|
오류
ArgumentError — 이름이 null인 경우
|
관련 API 요소
determinePreferredLocales | () | 메서드 |
public static function determinePreferredLocales(want:Vector.<String>, have:Vector.<String>, keyword:String = "userinterface"):Vector.<String>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
원하는 로캘 목록과 현재 지원되는 로캘 목록을 기반으로 사용 가능한 로캘 목록을 반환합니다.
결과 목록이 환경 설정 순으로 정렬됩니다.
이 메서드의 일반적인 사용 예는 다음과 같습니다.
- 사용자가 이해하는 언어 목록을 지정합니다. 이 목록은 사용자 프로파일, 브라우저 설정 또는 쿠키에 저장됩니다. 사용자가 가장 잘 이해하는 언어를 첫 번째로 나열하므로 목록에서 언어의 순서가 관련이 있습니다. 이 목록은 "want" 목록입니다.
- 응용 프로그램이 여러 가지 언어로 지역화됩니다. 이 목록은 "have" 목록입니다.
determinePreferredLocales()메서드는 사용자의 기본 언어가 처음에 오도록 정렬된 두 목록의 교차 목록을 반환합니다.
이 기능이 현재 운영 체제에서 지원되지 않는 경우 이 메서드는 null 값을 반환합니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
매개 변수
want:Vector.<String> — 환경 설정 순으로 정렬된 사용자의 기본 로캘 목록입니다.
| |
have:Vector.<String> — 해당 응용 프로그램에서 사용 가능한 로캘 목록입니다. 이 목록의 순서는 중요하지 않습니다.
| |
keyword:String (default = "userinterface") |
Vector.<String> — 사용자의 환경 설정에 따라 정렬되는 사용 가능한 로캘의 하위 집합입니다.
|
관련 API 요소
getKeysAndValues | () | 메서드 |
public function getKeysAndValues():Object| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
LocaleID 객체의 키와 값 쌍을 모두 포함하는 객체를 반환합니다.
반환된 객체는 해시 테이블 또는 연관 배열로 구성되며, 여기서 각 속성 이름은 키와 해당 키의 값인 속성의 값을 나타냅니다. 예를 들어 다음 코드는 getKeysAndValues() 메서드를 사용하여 LocaleID 객체에서 가져온 모든 키와 값을 나열합니다.
var myLocale:LocaleID = new LocaleID("fr-CA");
var localeData:Object = myLocale.getKeysAndValues();
for (var propertyName:String in localeData)
{
trace(propertyName + " = " + localeData[propertyName]);
}
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
Object — 연관 배열 또는 해시 테이블로 구성된 LocaleID 객체의 모든 키와 값을 포함하는 객체입니다.
|
관련 API 요소
getLanguage | () | 메서드 |
public function getLanguage():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
로캘 ID 이름에서 지정한 언어 코드를 반환합니다.
로캘 이름을 올바르게 파싱할 수 없으면 언어 코드는 전체 로캘 이름과 같아집니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
String — 로캘 ID 이름을 파싱하여 얻은 2자리 언어 코드입니다.
|
관련 API 요소
getRegion | () | 메서드 |
public function getRegion():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
로캘 ID 이름에서 지정한 지역 코드를 반환합니다.
이 메서드는 지역 코드를 파싱하거나 추측할 수 없는 경우 빈 문자열을 반환합니다. "xy" 같은 알 수 없거나 불완전한 로캘 ID 이름이 사용된 경우가 이에 해당됩니다. 지역 코드는 고정된 목록에 대해 유효성이 검사되지 않습니다. 예를 들어 "xx-YY"의 로캘 ID 이름에 대해 지역 코드 "YY"가 반환됩니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
지정된 로캘 이름에 해당 지역이 속하지 않으면 해당 로캘에 대해 가장 근접한 지역 코드가 "추측"되고 lastOperationStatus 속성이 LastOperationStatus.USING_FALLBACK_WARNING으로 설정됩니다.
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
String — 2자리 지역 코드이거나, 지역 코드를 파싱할 수 없거나 로캘 이름에서 결정할 수 없는 경우 빈 문자열입니다.
|
관련 API 요소
getScript | () | 메서드 |
public function getScript():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
로캘 ID 이름에서 지정한 스크립트 코드를 반환합니다.
이 메서드는 스크립트 코드를 파싱하거나 추측할 수 없는 경우 빈 문자열을 반환합니다. "xy" 같은 알 수 없거나 불완전한 로캘 ID 이름이 사용된 경우가 이에 해당됩니다. 스크립트 코드는 고정된 목록에 대해 유효성이 검사되지 않습니다. 예를 들어 "xx-Abcd-YY"의 로캘 ID 이름에 대해 스크립트 코드 "Abcd"가 반환됩니다.
언어뿐 아니라 지역도 반환 값에 영향을 줄 수 있습니다. 예를 들어 "mn-MN"(몽골어-몽골)에 대한 스크립트 코드는 "Cyrl"(키릴어)이 되고 "mn-CN"(몽골어-중국)에 대한 스크립트 코드는 "Mong"(몽골어)이 됩니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
지정된 로캘 이름에 해당 스크립트 코드가 속하지 않으면 가장 근접한 스크립트 코드가 "추측"되고lastOperationStatus 속성이 LastOperationStatus.USING_FALLBACK_WARNING으로 설정됩니다.
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
String — 4자리 스크립트 코드이거나, 스크립트 코드를 파싱할 수 없거나 로캘 이름에서 결정할 수 없는 경우 빈 문자열입니다.
|
관련 API 요소
getVariant | () | 메서드 |
public function getVariant():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
로캘 ID 이름에서 지정한 언어 변형 코드를 반환합니다.
이 메서드는 지정된 로캘 ID 이름에 언어 변형 코드가 없는 경우 빈 문자열을 반환합니다. 언어 변형을 필요로 하거나 포함하는 로캘은 드물기 때문에 추측이 필요하지 않습니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
String — 언어 변형 코드이거나, 로캘 ID 이름에 언어 변형 코드가 포함되지 않은 경우 빈 문자열입니다.
|
관련 API 요소
isRightToLeft | () | 메서드 |
public function isRightToLeft():Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
지정된 로캘의 텍스트 방향이 오른쪽에서 왼쪽인지 지정합니다.
이 결과는 Flash 텍스트 엔진에서 텍스트 방향을 결정하거나, 현재 텍스트 방향을 지원하기 위해 사용자 인터페이스를 미러링해야 하는지 여부를 결정하는 데 사용할 수 있습니다.
이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.
LastOperationStatus.NO_ERROR
또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.
Boolean — 텍스트 줄의 일반적인 텍스트 흐름이 오른쪽에서 왼쪽으로 진행되면 true이고, 그렇지 않으면 false
|
관련 API 요소
DEFAULT | 상수 |
public static const DEFAULT:String = "i-default"| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
사용자의 운영 체제 설정에 지정된 기본 언어 설정을 사용하도록 나타냅니다. 예를 들어 이러한 환경 설정은 대개 "제어판"(Windows) 또는 "시스템 환경 설정"(Mac OS X)을 사용하여 설정됩니다.
LocaleID.DEFAULT 설정을 사용하면 작업 유형별로 서로 다른 로캘 ID 이름이 사용될 수 있습니다. 예를 들어 정렬 및 서식 지정에서 서로 다른 로캘이 사용될 수 있습니다. 이러한 유연성으로 인해 사용자 환경 설정을 유지할 수 있으며 해당 클래스는 이러한 방식으로 동작하도록 설계되었습니다.
이 로캘 식별자는 사용하기에 가장 적절한 식별자가 아닐 수 있습니다. 브라우저에서 실행되는 응용 프로그램의 경우 브라우저의 기본 로캘이 더 적절할 수 있습니다. 따라서 일반적으로 사용자가 기본 로캘 ID 이름 설정을 변경하고 해당 환경 설정을 사용자 프로파일, 쿠키 또는 공유 객체에 유지할 수 있도록 하는 것이 좋습니다.
이 예제에서는 아랍어(사우디 아라비아), 영어(미국), 영어(미국, POSIX 변형), 중국어(중국), 중국어(대만), 중국어(한자), 중국어(중국 및 여러 키와 값) 로캘을 사용합니다.
이 예제에서는 목록의 각 로캘에 대해 다음 작업을 수행합니다.
- 새 LocaleID 객체를 만듭니다.
- 다양한 LocaleID 속성을 표시합니다. 표시되는 값은 운영 체제 및 사용자 환경 설정에 따라 달라집니다.
- 해당 LocaleID의 전체 키 및 값 집합을 표시합니다.
package
{
import flash.display.Sprite;
import flash.globalization.LocaleID;
public class LocaleIDExample extends Sprite
{
public function LocaleIDExample()
{
var localeNames:Array = ["ar-SA", "EN_us", "en-US-POSIX", "zh-CH", "zh-TW", "zh-Hans", "zh-CH@collation=pinyin;calendar=chinese;currency=RMB"];
for ( var i:int = 0; i < localeNames.length; i++ )
{
var locID:LocaleID = new LocaleID( localeNames[i] as String );
trace('\n\n' + "LocaleID requested: " + locID.requestedLocaleIDName
+ "; actual: " + locID.actualLocaleIDName);
trace( "Last Operation Status after new LocaleID: " + locID.lastOperationStatus);
trace("name: " + locID.name);
trace("language: " + locID.getLanguage() + "; status: " + locID.lastOperationStatus);
trace("script: " + locID.getScript() + "; status: " + locID.lastOperationStatus);
trace("region: " + locID.getRegion() + "; status: " + locID.lastOperationStatus);
trace("variant: " + locID.getVariant() + "; status: " + locID.lastOperationStatus);
trace("isRightToLeft: ", locID.isRightToLeft(), "; status: " + locID.lastOperationStatus);
var keysAndValues:Object = locID.getKeysAndValues();
var key:String;
for (key in keysAndValues)
{
trace("key: ", key + " value: " + keysAndValues[ key ]);
}
trace( "Last Operation Status after getKeysAndValues(): " + locID.lastOperationStatus);
}
}
}
}
Tue Jun 12 2018, 03:17 PM Z