| 패키지 | fl.display |
| 클래스 | public class ProLoaderInfo |
| 상속 | ProLoaderInfo  EventDispatcher Object |
| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
childSandboxBridge 및 parentSandboxBridge 같은 이 클래스의 일부 멤버는 특정 버전의 Flash Player 및 AIR에서 지원되지 않습니다. 이러한 속성은 제작한 AIR 또는 Flash Player 버전에서 지원하는 경우에만 호출하십시오. 이러한 속성을 다른 컨텍스트에서 호출하면 런타임 오류가 발생합니다.
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| actionScriptVersion : uint [읽기 전용]
로드된 SWF 파일의 ActionScript 버전입니다. | ProLoaderInfo | ||
| applicationDomain : ApplicationDomain [읽기 전용]
외부 SWF 파일을 로드할 때, 로드된 클래스에 포함된 모든 ActionScript 3.0 정의는 applicationDomain 속성에 저장됩니다. | ProLoaderInfo | ||
| bytes : ByteArray [읽기 전용]
ProLoaderInfo 객체와 연결된 바이트입니다. | ProLoaderInfo | ||
| bytesLoaded : uint [읽기 전용]
해당 미디어에 대해 로드된 바이트 수입니다. | ProLoaderInfo | ||
| bytesTotal : uint [읽기 전용]
이 객체의 ProLoader 객체가 첫 번째 progress 이벤트를 전달하기 전에 bytesTotal은 0입니다. | ProLoaderInfo | ||
| childAllowsParent : Boolean [읽기 전용]
내용(자식)의 ProLoader(부모)에 대한 신뢰 관계를 표현합니다. | ProLoaderInfo | ||
| childSandboxBridge : Object
로드된 내용의 코드로 설정하여 속성을 표시할 수 있는 객체이며 ProLoader 객체의 샌드박스에 있는 코드로 액세스할 수 있는 메서드입니다. | ProLoaderInfo | ||
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| content : DisplayObject [읽기 전용]
이 ProLoaderInfo 객체와 연관하여 로드된 객체입니다. | ProLoaderInfo | ||
| contentType : String [읽기 전용]
로드된 파일의 MIME 유형입니다. | ProLoaderInfo | ||
| frameRate : Number [읽기 전용]
로드된 SWF 파일의 공칭 프레임 속도(초당 프레임 수)입니다. | ProLoaderInfo | ||
| height : int [읽기 전용]
로드된 파일의 공칭 높이입니다. | ProLoaderInfo | ||
| isURLInaccessible : Boolean [읽기 전용]
ProLoaderInfo.url 속성이 잘렸는지 여부를 나타냅니다. | ProLoaderInfo | ||
| loader : ProLoader [읽기 전용]
이 ProLoaderInfo 객체와 연관된 ProLoader 객체입니다. | ProLoaderInfo | ||
| loaderURL : String [읽기 전용]
이 ProLoaderInfo 객체가 설명하는 미디어의 로딩을 시작한 SWF 파일의 URL입니다. | ProLoaderInfo | ||
| parameters : Object [읽기 전용]
로드된 SWF 파일에 제공된 매개 변수를 나타내는 이름 값 쌍이 포함된 객체입니다. | ProLoaderInfo | ||
| parentAllowsChild : Boolean [읽기 전용]
ProLoader(부모)의 내용(자식)에 대한 신뢰 관계를 표현합니다. | ProLoaderInfo | ||
| parentSandboxBridge : Object
ProLoader 객체의 샌드박스에 있는 코드로 설정하여 속성을 표시할 수 있는 객체이며 로드된 내용의 코드로 액세스할 수 있는 메서드입니다. | ProLoaderInfo | ||
| sameDomain : Boolean [읽기 전용]
로더와 내용 간의 도메인 관계를 표현합니다. 원래 도메인이 동일하면 true이고, 그렇지 않으면 false입니다. | ProLoaderInfo | ||
| sharedEvents : EventDispatcher [읽기 전용]
RSL을 미리 로드하는 내용을 로드할 때의 타이밍 문제로 인해 init 이벤트를 받을 때까지 기다린 후에 이벤트 리스너를 sharedEvents 객체에 추가하거나, init 이벤트를 받을 때 다시 추가하는 것이 좋습니다. | ProLoaderInfo | ||
| swfVersion : uint [읽기 전용]
로드된 SWF 파일의 파일 형식 버전입니다. | ProLoaderInfo | ||
| url : String [읽기 전용]
로드 중인 미디어의 URL입니다. | ProLoaderInfo | ||
| width : int [읽기 전용]
로드된 내용의 공칭 폭입니다. | ProLoaderInfo | ||
actionScriptVersion | 속성 |
actionScriptVersion:uint [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
로드된 SWF 파일의 ActionScript 버전입니다. 언어 버전은 ActionScriptVersion.ACTIONSCRIPT2 및 ActionScriptVersion.ACTIONSCRIPT3과 같이 ActionScriptVersion 클래스의 열거 유형을 사용하여 지정됩니다.
참고: 이 속성은 항상 ActionScriptVersion.ACTIONSCRIPT2 또는 ActionScriptVersion.ACTIONSCRIPT3 중 하나를 값으로 갖습니다. ActionScript 1.0 및 2.0 모두 ActionScriptVersion.ACTIONSCRIPT2(버전 2.0)로 보고됩니다. 이 속성에서는 ActionScript 1.0 및 2.0을 ActionScript 3.0과 구분할 뿐입니다.
구현
public function get actionScriptVersion():uint관련 API 요소
applicationDomain | 속성 |
applicationDomain:ApplicationDomain [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
외부 SWF 파일을 로드할 때, 로드된 클래스에 포함된 모든 ActionScript 3.0 정의는 applicationDomain 속성에 저장됩니다.
SWF 파일의 모든 코드는 응용 프로그램 도메인에 존재하도록 정의됩니다. 현재 응용 프로그램 도메인은 주 응용 프로그램이 실행되는 위치입니다. 시스템 도메인에는 현재 도메인과 Flash Player 또는 Adobe AIR에서 사용되는 모든 클래스를 비롯하여 모든 응용 프로그램 도메인이 들어 있습니다.
시스템 도메인을 제외한 모든 응용 프로그램 도메인에는 연관된 부모 도메인이 있습니다. 기본 응용 프로그램 applicationDomain의 부모 도메인은 시스템 도메인입니다. 로드된 클래스는 부모에서 아직 정의되지 않은 경우에만 정의됩니다. 로드된 클래스 정의를 새 정의를 사용하여 재정의할 수는 없습니다.
응용 프로그램 도메인 사용법 관련 예제는 ActionScript 3.0 개발자 가이드의 "클라이언트 시스템 환경" 장을 참조하십시오.
구현
public function get applicationDomain():ApplicationDomain관련 API 요소
bytes | 속성 |
bytesLoaded | 속성 |
bytesTotal | 속성 |
childAllowsParent | 속성 |
childAllowsParent:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
내용(자식)의 ProLoader(부모)에 대한 신뢰 관계를 표현합니다. 자식이 부모의 액세스를 허용한 경우 true이며, 그렇지 않으면 false입니다. 이 속성이 true로 설정되는 경우는 자식 객체가 allowDomain() 메서드를 호출하여 부모 도메인에게 권한을 부여한 경우 또는 자식 도메인에서 URL 정책이 로드되어 부모 도메인에게 권한이 부여된 경우입니다. 부모와 자식이 같은 도메인에 있으면 이 속성은 true로 설정됩니다.
보안에 대한 자세한 내용은 Flash Player 개발자 센터 항목: 보안을 참조하십시오.
구현
public function get childAllowsParent():Boolean관련 API 요소
childSandboxBridge | 속성 |
childSandboxBridge:Object| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0 |
로드된 내용의 코드로 설정하여 속성을 표시할 수 있는 객체이며 ProLoader 객체의 샌드박스에 있는 코드로 액세스할 수 있는 메서드입니다. 이 샌드박스 브리지를 사용하면 비응용 프로그램 도메인의 내용으로 AIR 응용 프로그램 샌드박스의 스크립트에 대한 액세스를 제어할 수 있으며 반대로도 가능합니다. 샌드박스 브리지는 응용 프로그램과 비응용 프로그램 보안 샌드박스 간에 명시적 상호 작용을 제공하며 샌드박스 간의 게이트웨이 역할을 합니다.
구현
public function get childSandboxBridge():Object public function set childSandboxBridge(value:Object):void오류
SecurityError — 로드된 내용의 샌드박스에 있는 내용만이 이 속성을 설정할 수 있습니다.
|
관련 API 요소
content | 속성 |
content:DisplayObject [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
이 ProLoaderInfo 객체와 연관하여 로드된 객체입니다.
구현
public function get content():DisplayObject관련 API 요소
contentType | 속성 |
contentType:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
로드된 파일의 MIME 유형입니다. 유형을 결정하기에 충분할 만큼 파일이 로드되지 않은 경우 이 값은 null입니다. 다음 목록에 나열된 값을 가질 수 있습니다.
"application/x-shockwave-flash""image/jpeg""image/gif""image/png"
구현
public function get contentType():String관련 API 요소
frameRate | 속성 |
frameRate:Number [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
로드된 SWF 파일의 공칭 프레임 속도(초당 프레임 수)입니다. 이 숫자는 정수인 경우가 많지만 반드시 정수일 필요는 없습니다.
이 값은 실제 사용 중인 프레임 속도와 다를 수 있습니다. Flash Player 또는 Adobe AIR에서는 모든 로드된 SWF 파일에 대해 한 번에 하나의 프레임 속도만 사용하며, 이 프레임 속도는 기본 SWF 파일의 공칭 프레임 속도에 의해 결정됩니다. 또한 하드웨어, 사운드 동기화 및 기타 요인에 의해 기본 프레임 속도에 도달하지 못할 수도 있습니다.
구현
public function get frameRate():Number관련 API 요소
height | 속성 |
isURLInaccessible | 속성 |
isURLInaccessible:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 10.1, AIR 2 |
ProLoaderInfo.url 속성이 잘렸는지 여부를 나타냅니다. isURLInaccessible 값이 true이면 ProLoaderInfo.url 값은 내용이 로드된 최종 URL의 도메인만을 나타냅니다. 예를 들어 내용이 http://www.adobe.com/assets/hello.swf에서 로드되고 ProLoaderInfo.url 속성의 값이 http://www.adobe.com인 경우 속성이 잘립니다. isURLInaccessible 값은 다음이 모두 해당될 때만 true입니다.
- 내용을 로드하는 동안 HTTP 리디렉션이 발생한 경우
ProLoader.load()를 호출하는 SWF 파일이 내용의 최종 URL과 다른 도메인의 파일입니다.ProLoader.load()를 호출하는 SWF 파일이 내용에 액세스할 권한이 없습니다. 내용에 액세스하는 권한을 부여하는 방식은BitmapData.draw()에 대한 권한을 부여하는 방식과 같습니다. SWF 파일은Security.allowDomain()을 호출하여 액세스하고 SWF 파일이 아닌 내용은 정책 파일을 설정하고LoaderContext.checkPolicyFile속성을 사용합니다.
참고: isURLInaccessible 속성은 Flash Player 10.1 및 AIR 2.0을 지원할 목적으로 추가되었지만 Flash 런타임이 지원하는 경우 모든 버전의 SWF 파일에서 이 속성을 사용할 수 있습니다. 따라서 "엄격 모드"에서 일부 제작 도구를 사용하면 컴파일 오류가 발생합니다. 이 오류를 해결하려면 간접 구문 myLoaderInfo["isURLInaccessible"]을 사용하거나 엄격 모드를 해제합니다. Flash Professional CS5 또는 Flex SDK 4.1을 사용하는 경우 Flash Player 10.1 및 AIR 2 이전에 릴리스된 런타임에 대해 이 API를 사용 및 컴파일할 수 있습니다.
AIR에 포함된 응용 프로그램 내용의 경우 이 속성의 값은 항상 false입니다.
구현
public function get isURLInaccessible():Boolean관련 API 요소
loader | 속성 |
loaderURL | 속성 |
parameters | 속성 |
parameters:Object [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
로드된 SWF 파일에 제공된 매개 변수를 나타내는 이름 값 쌍이 포함된 객체입니다.
for-in 루프를 사용하여 parameters 객체에서 모든 이름 및 값을 추출할 수 있습니다.
매개 변수의 두 가지 소스는 기본 SWF 파일 URL의 쿼리 문자열과 FlashVars HTML 매개 변수 값(기본 SWF 파일에만 영향을 미침)입니다.
parameters 속성은 ActionScript 1.0 및 2.0에서 SWF 파일 매개 변수를 기본 타임라인의 속성으로 제공하는 기법을 대체합니다.
ActionScript 1.0 또는 2.0을 사용하는 SWF 파일이 포함된 ProLoader 객체의 경우 parameters 속성 값이 null입니다. ActionScript 3.0을 사용하는 SWF 파일이 포함된 ProLoader 객체의 경우에만 이 값이 null이 아닙니다.
구현
public function get parameters():Object관련 API 요소
parentAllowsChild | 속성 |
parentAllowsChild:Boolean [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
ProLoader(부모)의 내용(자식)에 대한 신뢰 관계를 표현합니다. 부모가 자식의 액세스를 허용한 경우 true이며, 그렇지 않으면 false입니다. 이 속성이 true로 설정되는 경우는 부모 객체가 allowDomain() 메서드를 호출하여 자식 도메인에게 권한을 부여한 경우 또는 부모 도메인에서 URL 정책 파일이 로드되어 자식 도메인에게 권한이 부여된 경우입니다. 부모와 자식이 같은 도메인에 있으면 이 속성은 true로 설정됩니다.
보안에 대한 자세한 내용은 Flash Player 개발자 센터 항목: 보안을 참조하십시오.
구현
public function get parentAllowsChild():Boolean오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않았을 때 발생합니다.
|
관련 API 요소
parentSandboxBridge | 속성 |
parentSandboxBridge:Object| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0 |
ProLoader 객체의 샌드박스에 있는 코드로 설정하여 속성을 표시할 수 있는 객체이며 로드된 내용의 코드로 액세스할 수 있는 메서드입니다. 이 샌드박스 브리지를 사용하면 비응용 프로그램 도메인의 내용으로 AIR 응용 프로그램 샌드박스의 스크립트에 대한 액세스를 제어할 수 있으며 반대로도 가능합니다. 샌드박스 브리지는 응용 프로그램과 비응용 프로그램 보안 샌드박스 간에 명시적 상호 작용을 제공하며 샌드박스 간의 게이트웨이 역할을 합니다.
구현
public function get parentSandboxBridge():Object public function set parentSandboxBridge(value:Object):void오류
SecurityError — ProLoader 객체의 샌드박스에 있는 내용만이 이 속성을 설정할 수 있습니다.
|
관련 API 요소
sameDomain | 속성 |
sharedEvents | 속성 |
sharedEvents:EventDispatcher [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
RSL을 미리 로드하는 내용을 로드할 때의 타이밍 문제로 인해 init 이벤트를 받을 때까지 기다린 후에 이벤트 리스너를 sharedEvents 객체에 추가하거나, init 이벤트를 받을 때 다시 추가하는 것이 좋습니다.
구현
public function get sharedEvents():EventDispatcher관련 API 요소
swfVersion | 속성 |
url | 속성 |
url:String [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Lite 4 |
로드 중인 미디어의 URL입니다.
이 ProLoaderInfo 객체의 ProLoader 객체가 첫 번째 progress 이벤트를 전달하기 전에는 ProLoader 객체의 load() 메서드를 호출할 때 지정된 초기 URL만 url 속성 값에 반영될 수 있습니다. 첫 번째 progress 이벤트가 발생한 후 url 속성은 모든 리디렉션 및 상대 URL이 처리된 후 미디어의 최종 URL을 반영합니다.
경우에 따라 url 속성의 값이 잘리기도 합니다. 자세한 내용은 isURLInaccessible 속성을 참조하십시오.
구현
public function get url():Stringwidth | 속성 |
Tue Jun 12 2018, 03:17 PM Z