패키지flash.display
클래스public class LoaderInfo
상속LoaderInfo Inheritance EventDispatcher Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

LoaderInfo 클래스는 로드된 SWF 파일 또는 로드된 이미지 파일(JPEG, GIF, PNG)에 대한 정보를 제공합니다. LoaderInfo 객체는 어떤 표시 객체에서도 사용할 수 있습니다. 제공되는 정보에는 로드 진행률, 로더의 URL 및 로드된 내용, 해당 미디어의 총 바이트 수, 미디어의 공칭 높이 및 폭이 포함됩니다.

두 가지 방법으로 LoaderInfo 객체에 액세스할 수 있습니다.

Loader 객체의 contentLoaderInfo 속성은 Loader 객체가 로드 중인 내용에 대한 정보를 제공하는 반면, DisplayObject 의 loaderInfo 속성은 해당 표시 객체의 루트 SWF 파일에 대한 정보를 제공합니다.

Loader 객체를 사용하여 SWF 파일이나 비트맵 등의 표시 객체를 로드할 때 표시 객체의 loaderInfo 속성은 Loader 객체의 contentLoaderInfo 속성과 같습니다. 즉 DisplayObject.loaderInfo = Loader.contentLoaderInfo입니다. SWF 파일의 기본 클래스 인스턴스에 Loader 객체가 없으므로 loaderInfo 속성이 SWF 파일 기본 클래스 인스턴스의 LoaderInfo에 액세스할 수 있는 유일한 방법입니다.

다음 다이어그램에서는 LoaderInfo 객체의 여러 가지 용도, 즉 SWF 파일의 기본 클래스 인스턴스, Loader 객체의 contentLoaderInfo 속성, 로드된 객체의 loaderInfo 속성으로 사용되는 것을 보여 줍니다.

여러 가지 LoaderInfo 상황의 이미지

로딩 작업이 완료되지 않았을 때 Loader 객체의 contentLoaderInfo 속성에서 일부 속성은 사용할 수 없습니다. bytesLoaded, bytesTotal, url, loaderURLapplicationDomain과 같은 일부 속성은 얻을 수 있습니다. loaderInfo 객체가 init 이벤트를 전달할 때 loaderInfo 객체 및 로드된 이미지 또는 SWF 파일의 모든 속성에 액세스할 수 있습니다.

참고: LoaderInfo 객체의 모든 속성은 읽기 전용입니다.

EventDispatcher.dispatchEvent() 메서드는 LoaderInfo 객체에 적용할 수 없습니다. LoaderInfo 객체에서 dispatchEvent()를 호출하면 IllegalOperationError 예외가 발생합니다.

예제 보기

참고 사항

flash.display.Loader
flash.display.Loader.content
flash.display.DisplayObject
flash.display.DisplayObject.loaderInfo
Loading display content dynamically
Monitoring loading progress


Public 속성
 속성다음에 의해 정의됨
  actionScriptVersion : uint
[읽기 전용] 로드된 SWF 파일의 ActionScript 버전입니다.
LoaderInfo
  applicationDomain : ApplicationDomain
[읽기 전용] 외부 SWF 파일을 로드할 때, 로드된 클래스에 포함된 모든 ActionScript 3.0 정의는 applicationDomain 속성에 저장됩니다.
LoaderInfo
  bytes : ByteArray
[읽기 전용] LoaderInfo 객체와 연관된 바이트입니다.
LoaderInfo
  bytesLoaded : uint
[읽기 전용] 해당 미디어에 대해 로드된 바이트 수입니다.
LoaderInfo
  bytesTotal : uint
[읽기 전용] 전체 미디어 파일에서 압축된 바이트 수입니다.
LoaderInfo
  childAllowsParent : Boolean
[읽기 전용] 내용(자식)의 로더(부모)에 대한 신뢰 관계를 표현합니다.
LoaderInfo
  AIR-only childSandboxBridge : Object
로드된 내용의 코드로 설정하여 속성을 표시할 수 있는 객체이며 Loader 객체의 샌드박스에 있는 코드로 액세스할 수 있는 메서드입니다.
LoaderInfo
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  content : DisplayObject
[읽기 전용] 이 LoaderInfo 객체와 연관된 로드된 객체입니다.
LoaderInfo
  contentType : String
[읽기 전용] 로드된 파일의 MIME 유형입니다.
LoaderInfo
  frameRate : Number
[읽기 전용] 로드된 SWF 파일의 공칭 프레임 속도(초당 프레임 수)입니다.
LoaderInfo
  height : int
[읽기 전용] 로드된 파일의 공칭 높이입니다.
LoaderInfo
  loader : Loader
[읽기 전용] 이 LoaderInfo 객체와 연관된 Loader 객체입니다.
LoaderInfo
  loaderURL : String
[읽기 전용] 이 LoaderInfo 객체가 설명하는 미디어의 로딩을 시작한 SWF 파일의 URL입니다.
LoaderInfo
  parameters : Object
[읽기 전용] 로드된 SWF 파일에 제공된 매개 변수를 나타내는 이름 값 쌍이 포함된 객체입니다.
LoaderInfo
  parentAllowsChild : Boolean
[읽기 전용] Loader(부모)의 내용(자식)에 대한 신뢰 관계를 표현합니다.
LoaderInfo
  AIR-only parentSandboxBridge : Object
Loader 객체의 샌드박스에 있는 코드로 설정하여 속성을 표시할 수 있는 객체이며 로드된 내용의 코드로 액세스할 수 있는 메서드입니다.
LoaderInfo
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  sameDomain : Boolean
[읽기 전용] 로더와 내용 간의 도메인 관계를 표현합니다. 원래 도메인이 동일하면 true이고, 그렇지 않으면 false입니다.
LoaderInfo
  sharedEvents : EventDispatcher
[읽기 전용] 보안 경계선 너머로 이벤트를 교환하는 데 사용할 수 있는 EventDispatcher 인스턴스입니다.
LoaderInfo
  swfVersion : uint
[읽기 전용] 로드된 SWF 파일의 파일 형식 버전입니다.
LoaderInfo
  url : String
[읽기 전용] 로드 중인 미디어의 URL입니다.
LoaderInfo
  width : int
[읽기 전용] 로드된 내용의 공칭 폭입니다.
LoaderInfo
Public 메서드
 메서드다음에 의해 정의됨
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
  
[정적] 객체로 정의된 SWF 파일과 연관된 LoaderInfo 객체를 반환합니다.
LoaderInfo
 Inherited
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
  데이터가 성공적으로 로드되면 전달됩니다.LoaderInfo
 Inherited[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
  HTTP를 통해 네트워크 요청이 이루어지고 HTTP 상태 코드를 감지할 수 있을 때 전달됩니다.LoaderInfo
  로드된 SWF 파일의 속성 및 메서드에 액세스할 수 있으며 사용할 준비가 되었을 때 전달됩니다.LoaderInfo
  로드 작업 실패를 유발하는 입력 또는 출력 오류가 발생할 때 전달됩니다.LoaderInfo
  로드 작업이 시작될 때 전달됩니다.LoaderInfo
  다운로드 작업이 진행되어 데이터가 수신될 때 전달됩니다.LoaderInfo
  Loader 객체의 unload() 메서드를 사용하여 로드된 객체를 제거할 때마다, 또는 동일한 Loader 객체가 두 번째 로드를 실행하기 위해 먼저 원본 내용을 제거할 때 LoaderInfo 객체에 의해 전달됩니다.LoaderInfo
속성 정보
actionScriptVersion속성
actionScriptVersion:uint  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 SWF 파일의 ActionScript 버전입니다. 언어 버전은 ActionScriptVersion.ACTIONSCRIPT2ActionScriptVersion.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

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않은 경우입니다.
 
Error — 파일이 SWF 파일이 아닌 경우입니다.

참고 사항

applicationDomain속성 
applicationDomain:ApplicationDomain  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

외부 SWF 파일을 로드할 때, 로드된 클래스에 포함된 모든 ActionScript 3.0 정의는 applicationDomain 속성에 저장됩니다.

SWF 파일의 모든 코드는 응용 프로그램 도메인에 존재하도록 정의됩니다. 현재 응용 프로그램 도메인은 주 응용 프로그램이 실행되는 위치입니다. 시스템 도메인에는 현재 도메인과 Flash Player 또는 Adobe AIR에서 사용되는 모든 클래스를 비롯하여 모든 응용 프로그램 도메인이 들어 있습니다.

시스템 도메인을 제외한 모든 응용 프로그램 도메인에는 연관된 부모 도메인이 있습니다. 기본 응용 프로그램 applicationDomain의 부모 도메인은 시스템 도메인입니다. 로드된 클래스는 부모에서 아직 정의되지 않은 경우에만 정의됩니다. 로드된 클래스 정의를 새 정의를 사용하여 재정의할 수는 없습니다.

응용 프로그램 도메인 사용법 관련 예제는 ActionScript 3.0 프로그래밍의 "클라이언트 시스템 환경" 장을 참조하십시오.



구현
    public function get applicationDomain():ApplicationDomain

오류
SecurityError — 호출자의 이 보안 샌드박스는 이 ApplicationDomain에 액세스할 수 없습니다.

참고 사항

bytes속성 
bytes:ByteArray  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.115.0

LoaderInfo 객체와 연관된 바이트입니다.



구현
    public function get bytes():ByteArray

오류
SecurityError — 이 API에 액세스하는 객체가 보안 제한 사항 때문에 로드된 객체에 액세스할 수 없는 경우입니다. 예를 들어, Loader 객체가 contentLoaderInfo.content 속성에 대한 액세스를 시도하는데 로드된 내용에 액세스할 수 있는 보안 권한이 부여되지 않은 경우에 해당됩니다.

자세한 내용은 ActionScript 3.0 프로그래밍의 "Flash Player 보안" 장을 참조하십시오.

bytesLoaded속성 
bytesLoaded:uint  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

해당 미디어에 대해 로드된 바이트 수입니다. 이 숫자가 bytesTotal 값과 동일하면 모든 바이트가 로드된 것입니다.



구현
    public function get bytesLoaded():uint
bytesTotal속성 
bytesTotal:uint  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

전체 미디어 파일에서 압축된 바이트 수입니다.

이 LoaderInfo 객체의 Loader 객체가 첫 번째 progress 이벤트를 전달하기 전에 bytesTotal은 0입니다. Loader 객체에서 첫 번째 progress 이벤트 발생 후 bytesTotal에서 다운로드할 실제 바이트 수가 반영됩니다.



구현
    public function get bytesTotal():uint

참고 사항

childAllowsParent속성 
childAllowsParent:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

내용(자식)의 로더(부모)에 대한 신뢰 관계를 표현합니다. 자식이 부모의 액세스를 허용한 경우 true이며, 그렇지 않으면 false입니다. 이 속성이 true로 설정되는 경우는 자식 객체가 allowDomain() 메서드를 호출하여 부모 도메인에게 권한을 부여한 경우 또는 자식 도메인에서 URL 정책이 로드되어 부모 도메인에게 권한이 부여된 경우입니다. 부모와 자식이 같은 도메인에 있으면 이 속성은 true로 설정됩니다.

자세한 내용은 ActionScript 3.0 프로그래밍의 "Flash Player 보안" 장을 참조하십시오.



구현
    public function get childAllowsParent():Boolean

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않았을 때 발생합니다.
AIR-only childSandboxBridge속성 
childSandboxBridge:Object  [읽기/쓰기]

런타임 버전: AIR 1.0

로드된 내용의 코드로 설정하여 속성을 표시할 수 있는 객체이며 Loader 객체의 샌드박스에 있는 코드로 액세스할 수 있는 메서드입니다. 이 샌드박스 브리지를 사용하면 비응용 프로그램 도메인의 내용으로 AIR 응용 프로그램 샌드박스의 스크립트에 대한 액세스를 제어할 수 있으며 반대로도 가능합니다. 샌드박스 브리지는 응용 프로그램과 비응용 프로그램 보안 샌드박스 간에 명시적 상호 작용을 제공하며 샌드박스 간의 게이트웨이 역할을 합니다.



구현
    public function get childSandboxBridge():Object
    public function set childSandboxBridge(value:Object):void

오류
SecurityError — 로드된 내용의 샌드박스에 있는 내용만이 이 속성을 설정할 수 있습니다.

참고 사항

content속성 
content:DisplayObject  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

이 LoaderInfo 객체와 연관된 로드된 객체입니다.



구현
    public function get content():DisplayObject

오류
SecurityError — 이 API에 액세스하는 객체가 보안 제한 사항 때문에 로드된 객체에 액세스할 수 없는 경우입니다. 예를 들어, Loader 객체가 contentLoaderInfo.content 속성에 대한 액세스를 시도하는데 로드된 내용에 액세스할 수 있는 보안 권한이 부여되지 않은 경우에 해당됩니다.

자세한 내용은 ActionScript 3.0 프로그래밍의 "Flash Player 보안" 장을 참조하십시오.

contentType속성 
contentType:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 파일의 MIME 유형입니다. 유형을 결정하기에 충분할 만큼 파일이 로드되지 않은 경우 이 값은 null입니다. 다음 목록에 나열된 값을 가질 수 있습니다.



구현
    public function get contentType():String
frameRate속성 
frameRate:Number  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 SWF 파일의 공칭 프레임 속도(초당 프레임 수)입니다. 이 숫자는 정수인 경우가 많지만 반드시 정수일 필요는 없습니다.

이 값은 실제 사용 중인 프레임 속도와 다를 수 있습니다. Flash Player 또는 Adobe AIR에서는 모든 로드된 SWF 파일에 대해 한 번에 하나의 프레임 속도만 사용하며, 이 프레임 속도는 기본 SWF 파일의 공칭 프레임 속도에 의해 결정됩니다. 또한 하드웨어, 사운드 동기화 및 기타 요인에 의해 기본 프레임 속도에 도달하지 못할 수도 있습니다.



구현
    public function get frameRate():Number

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않은 경우입니다.
 
Error — 파일이 SWF 파일이 아닌 경우입니다.
height속성 
height:int  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 파일의 공칭 높이입니다. 이 값은 내용이 표시되는 실제 높이와 다를 수 있습니다. 로드된 내용 또는 그 부모 표시 객체의 크기가 조절될 수 있기 때문입니다.



구현
    public function get height():int

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않은 경우입니다.
loader속성 
loader:Loader  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

이 LoaderInfo 객체와 연관된 Loader 객체입니다. 이 LoaderInfo 객체가 SWF 파일 기본 클래스 인스턴스의 loaderInfo 속성이면 연관된 Loader 객체가 없습니다.



구현
    public function get loader():Loader

오류
SecurityError — 이 API에 액세스하는 객체가 보안 제한 사항 때문에 Loader 객체에 액세스할 수 없는 경우입니다. 예를 들어, 로드된 SWF 파일이 loaderInfo.loader 속성에 대한 액세스를 시도하는데 로드 중인 SWF 파일에 액세스할 수 있는 보안 권한이 부여되지 않은 경우에 해당됩니다.

자세한 내용은 ActionScript 3.0 프로그래밍의 "Flash Player 보안" 장을 참조하십시오.

loaderURL속성 
loaderURL:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

이 LoaderInfo 객체가 설명하는 미디어의 로딩을 시작한 SWF 파일의 URL입니다. SWF 파일 기본 클래스의 인스턴스에서 이 URL은 SWF 파일 자체의 URL과 동일합니다.



구현
    public function get loaderURL():String
parameters속성 
parameters:Object  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 SWF 파일에 제공된 매개 변수를 나타내는 이름 값 쌍이 포함된 객체입니다.

for-in 루프를 사용하여 parameters 객체에서 모든 이름 및 값을 추출할 수 있습니다.

매개 변수의 두 가지 소스는 기본 SWF 파일 URL의 쿼리 문자열과 FlashVars HTML 매개 변수 값(기본 SWF 파일에만 영향을 미침)입니다.

parameters 속성은 ActionScript 1.0 및 2.0에서 SWF 파일 매개 변수를 기본 타임라인의 속성으로 제공하는 기법을 대체합니다.

ActionScript 1.0 또는 2.0을 사용하는 SWF 파일이 포함된 Loader 객체의 경우 parameters 속성 값이 null입니다. ActionScript 3.0을 사용하는 SWF 파일이 포함된 Loader 객체의 경우에만 이 값이 null이 아닙니다.



구현
    public function get parameters():Object
parentAllowsChild속성 
parentAllowsChild:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Loader(부모)의 내용(자식)에 대한 신뢰 관계를 표현합니다. 부모가 자식의 액세스를 허용한 경우 true이며, 그렇지 않으면 false입니다. 이 속성이 true로 설정되는 경우는 부모 객체가 allowDomain() 메서드를 호출하여 자식 도메인에게 권한을 부여한 경우 또는 부모 도메인에서 URL 정책 파일이 로드되어 자식 도메인에게 권한이 부여된 경우입니다. 부모와 자식이 같은 도메인에 있으면 이 속성은 true로 설정됩니다.

자세한 내용은 ActionScript 3.0 프로그래밍의 "Flash Player 보안" 장을 참조하십시오.



구현
    public function get parentAllowsChild():Boolean

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않았을 때 발생합니다.
AIR-only parentSandboxBridge속성 
parentSandboxBridge:Object  [읽기/쓰기]

런타임 버전: AIR 1.0

Loader 객체의 샌드박스에 있는 코드로 설정하여 속성을 표시할 수 있는 객체이며 로드된 내용의 코드로 액세스할 수 있는 메서드입니다. 이 샌드박스 브리지를 사용하면 비응용 프로그램 도메인의 내용으로 AIR 응용 프로그램 샌드박스의 스크립트에 대한 액세스를 제어할 수 있으며 반대로도 가능합니다. 샌드박스 브리지는 응용 프로그램과 비응용 프로그램 보안 샌드박스 간에 명시적 상호 작용을 제공하며 샌드박스 간의 게이트웨이 역할을 합니다.



구현
    public function get parentSandboxBridge():Object
    public function set parentSandboxBridge(value:Object):void

오류
SecurityError — Loader 객체의 샌드박스에 있는 내용만이 이 속성을 설정할 수 있습니다.

참고 사항

sameDomain속성 
sameDomain:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로더와 내용 간의 도메인 관계를 표현합니다. 원래 도메인이 동일하면 true이고, 그렇지 않으면 false입니다.



구현
    public function get sameDomain():Boolean

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않았을 때 발생합니다.
sharedEvents속성 
sharedEvents:EventDispatcher  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

보안 경계선 너머로 이벤트를 교환하는 데 사용할 수 있는 EventDispatcher 인스턴스입니다. Loader 객체 및 로드된 내용이 서로 신뢰하지 않는 보안 도메인에서 시작되더라도 둘 다 sharedEvents에 액세스할 수 있고 이 객체를 통해 이벤트를 송수신할 수 있습니다.



구현
    public function get sharedEvents():EventDispatcher
swfVersion속성 
swfVersion:uint  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 SWF 파일의 파일 형식 버전입니다. 파일 형식은 SWFVersion.FLASH7SWFVersion.FLASH9와 같이 SWFVersion 클래스의 열거 유형을 사용하여 지정됩니다.



구현
    public function get swfVersion():uint

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않은 경우입니다.
 
Error — 파일이 SWF 파일이 아닌 경우입니다.

참고 사항

url속성 
url:String  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드 중인 미디어의 URL입니다.

이 LoaderInfo 객체의 Loader 객체가 첫 번째 progress 이벤트를 전달하기 전에는 Loader 객체의 load() 메서드를 호출할 때 지정된 초기 URL만 url 속성 값에 반영될 수 있습니다. 첫 번째 progress 이벤트가 발생한 후 url 속성은 모든 리디렉션 및 상대 URL이 처리된 후 미디어의 최종 URL을 반영합니다.



구현
    public function get url():String

참고 사항

width속성 
width:int  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 내용의 공칭 폭입니다. 이 값은 내용이 표시되는 실제 폭과 다를 수 있습니다. 로드된 내용 또는 그 부모 표시 객체의 크기가 조절될 수 있기 때문입니다.



구현
    public function get width():int

오류
Error — 요청한 정보를 검색할 수 있을 만큼 파일이 다운로드되지 않은 경우입니다.
메서드 정보
getLoaderInfoByDefinition()메서드
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9.0.115.0

객체로 정의된 SWF 파일과 연관된 LoaderInfo 객체를 반환합니다.

매개 변수

object:Object — 연관된 LoaderInfo 객체를 가져올 객체입니다.

반환값
LoaderInfo — 연관된 LoaderInfo 객체입니다. 디버거가 아닌 빌드에서 호출한 경우(디버깅이 활성화되지 않은 경우) 또는 참조된 object에 연결된 LoaderInfo 객체(예: AIR 런타임에서 사용된 일부 객체)가 없을 경우 null을 반환합니다.

오류
SecurityError — 호출자가 신뢰할 수 있는 로컬 샌드박스에서 실행되고 있지 않습니다.
이벤트 정보
complete 이벤트
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.COMPLETE

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

데이터가 성공적으로 로드되면 전달됩니다. 즉, 모든 내용을 다운로드하여 로드가 끝났을 때 전달됩니다. complete 이벤트는 항상 init 이벤트보다 이후에 전달됩니다. init 이벤트는 객체에 액세스할 수 있을 때 전달되지만 내용은 여전히 다운로드중일 수 있습니다.

Event.COMPLETE 상수는 complete 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target 로드가 완료된 네트워크 객체입니다.

참고 사항

httpStatus 이벤트  
이벤트 객체 유형: flash.events.HTTPStatusEvent
속성 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

HTTP를 통해 네트워크 요청이 이루어지고 HTTP 상태 코드를 감지할 수 있을 때 전달됩니다.

HTTPStatusEvent.HTTP_STATUS 상수는 httpStatus 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
status 서버에 의해 반환된 HTTP 상태 코드입니다.
target HTTP 상태 코드를 수신하는 네트워크 객체입니다.

참고 사항

init 이벤트  
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.INIT

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드된 SWF 파일의 속성 및 메서드에 액세스할 수 있으며 사용할 준비가 되었을 때 전달됩니다. 그러나 내용은 여전히 다운로드중일 수 있습니다. 다음 조건에 해당하면 LoaderInfo 객체는 init 이벤트를 전달합니다.

예를 들어 무비나 애니메이션의 첫 번째 프레임이 로드되면 Event.INIT가 전달됩니다. 그러면 무비에 액세스할 수 있고 표시 목록에 무비를 추가할 수 있습니다. 그러나 전체 무비는 여전히 다운로드중일 수 있습니다. Event.COMPLETE는 전체 무비가 다운로드된 후에만 전달됩니다.

init 이벤트는 항상 complete 이벤트 이전에 전달됩니다.

Event.INIT 상수는 init 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target 로드 중인 SWF 파일과 연관된 LoaderInfo 객체입니다.

참고 사항

ioError 이벤트  
이벤트 객체 유형: flash.events.IOErrorEvent
속성 IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드 작업 실패를 유발하는 입력 또는 출력 오류가 발생할 때 전달됩니다.

ioError 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 현재 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
errorID 특정 오류와 연결된 참조 번호입니다(AIR만 해당).
target 입력/출력 오류가 발생한 네트워크 객체입니다.
text 오류 메시지로 표시될 텍스트입니다.

참고 사항

open 이벤트  
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.OPEN

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

로드 작업이 시작될 때 전달됩니다.

Event.OPEN 상수는 open 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target 연결을 설정한 네트워크 객체입니다.

참고 사항

progress 이벤트  
이벤트 객체 유형: flash.events.ProgressEvent
속성 ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

다운로드 작업이 진행되어 데이터가 수신될 때 전달됩니다.

progress 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
bytesLoaded 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
bytesTotal 로드 프로세스가 완료되면 최종적으로 로드될 총 바이트 수 또는 항목 수입니다.
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target 진행률을 보고하는 객체입니다.

참고 사항

unload 이벤트  
이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.UNLOAD

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

Loader 객체의 unload() 메서드를 사용하여 로드된 객체를 제거할 때마다, 또는 동일한 Loader 객체가 두 번째 로드를 실행하기 위해 먼저 원본 내용을 제거할 때 LoaderInfo 객체에 의해 전달됩니다.

Event.UNLOAD 상수는 unload 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
target 언로드하거나 교체할 SWF 파일과 연관된 LoaderInfo 객체입니다.

참고 사항

예제 예제 사용 방법
LoaderInfoExample.as

다음 예제에서는 LoaderInfoExample 클래스를 사용하여 스테이지에 이미지를 표시합니다. 이는 다음 단계로 이루어집니다.
  1. 이미지의 이름과 위치를 나타내는 url 속성이 만들어집니다.
  2. 클래스 생성자가 loader라는 이름의 Loader 객체를 생성합니다.
  3. loader 객체가 이미지를 제대로 로드하기 위해 이벤트 리스너를 인스턴스화합니다.
  4. 생성자가 파일 이름 및 위치를 나타내도록 전달된 url이 있는 새 URLRequest 객체 request를 만듭니다.
  5. 그런 다음 request 객체가 loader 객체의 load() 메서드로 전달되며, 이 메서드는 이미지를 표시 목록으로 로드합니다.

중요: 이 예제에서는 컴파일된 SWF 파일과 같은 디렉토리에 Image.gif 파일이 있어야 합니다. 기본 SWF 파일의 크기에 알맞은 영역이 있는 이미지를 사용합니다.

package {
    import flash.display.Loader;
    import flash.display.LoaderInfo;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}