| 패키지 | fl.display |
| 클래스 | public class ProLoader |
| 상속 | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0, Flash Player 9 |
참고 ProLoader는 flash.display.Loader의 하위 클래스가 아닙니다. ProLoader를 사용하려면 모든 Loader 유형 참조를 ProLoader로 변경해야 합니다.
ProLoader는 일관된 로드 환경을 구현합니다. 특히 RSL 미리 로드를 사용하는 SWF 파일에 유용합니다. 예를 들어 TLF 텍스트가 사용된 SWF 파일에서는 기본적으로 RSL 미리 로드가 사용됩니다. 이러한 경우 ProLoaderInfo는 RSL 미리 로드가 완료되고 실제 내용을 사용할 수 있게 될 때까지 INIT 또는 COMPLETE 이벤트의 전송을 지연시킵니다. 그러면 이를 통해 content 속성이 실제 내용에 액세스할 수 있게 됩니다. 또한 ProLoader는 다음과 같은 문제를 방지하는 데에도 도움이 됩니다.
- 추가
addedToStage및removedFromStage이벤트 - 한 프레임의 잘못된 부모로 로드되는 내용(Flash Professional CS5.5 이상을 사용하여 Flash Player 10.2 이상으로 제작된 내용에 해당)
경고 특정 ProLoader 멤버는 일부 런타임 버전을 지원하지 않습니다. 제작한 AIR 또는 Flash Player 버전에서 지원하는 경우에만 이러한 멤버에 액세스하십시오. 그렇지 않은 경우 이러한 API에서 런타임 오류를 발생시킵니다. 다음과 같은 메서드와 속성이 포함된 멤버는 런타임이 제한적으로 지원됩니다.
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
각 API의 런타임 지원 여부를 확인하려면 해당 API에 대한 참조 항목을 참조하십시오.
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
이 InteractiveObject 인스턴스에 대한 현재 액세스 가능성 구현(AccessibilityImplementation)입니다. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
이 표시 객체의 현재 액세스 가능성 옵션입니다. | DisplayObject | |
| alpha : Number
지정된 객체의 알파 투명도 값을 나타냅니다. | DisplayObject | |
| blendMode : String
사용할 블렌드 모드를 지정하는 BlendMode 클래스 값입니다. | DisplayObject | |
| blendShader : Shader [쓰기 전용]
전경 및 배경을 블렌딩하는 데 사용되는 셰이더를 설정합니다. | DisplayObject | |
| buttonMode : Boolean
이 Sprite의 버튼 모드를 지정합니다. | Sprite | |
| cacheAsBitmap : Boolean
true로 설정된 경우 Flash 런타임은 표시 객체의 내부 비트맵 표현을 캐시합니다. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
null이 아닌 경우 이 Matrix 객체는 cacheAsBitmap이 true로 설정될 때 표시 객체가 렌더링되는 방법을 정의합니다. | DisplayObject | |
| constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| content : DisplayObject [읽기 전용]
load() 또는 loadBytes() 메서드를 사용하여 로드된 SWF 파일 또는 이미지(JPG, PNG 또는 GIF) 파일의 루트 표시 객체를 포함합니다. | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [읽기 전용]
로드 중인 객체에 해당하는 ProLoaderInfo 객체를 반환합니다. | ProLoader | ||
| contextMenu : NativeMenu
이 객체에 연결된 컨텍스트 메뉴를 지정합니다. | InteractiveObject | |
| doubleClickEnabled : Boolean
이 객체에서 doubleClick 이벤트를 받을지 여부를 지정합니다. | InteractiveObject | |
| dropTarget : DisplayObject [읽기 전용]
드래그하는 Sprite 아래의 표시 객체 또는 Sprite를 드래그해 놓은 표시 객체를 지정합니다. | Sprite | |
| filters : Array
현재 표시 객체와 연관된 각 필터 객체가 들어 있는 인덱싱된 배열입니다. | DisplayObject | |
| focusRect : Object
이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다. | InteractiveObject | |
| graphics : Graphics [읽기 전용]
벡터 드로잉 명령을 내릴 수 있는 이 Sprite에 속한 Graphics 객체를 지정합니다. | Sprite | |
| height : Number
표시 객체의 높이를 픽셀 단위로 나타냅니다. | DisplayObject | |
| hitArea : Sprite
Sprite의 히트 영역으로 사용할 다른 Sprite를 지정합니다. | Sprite | |
| loaderInfo : LoaderInfo [읽기 전용]
이 표시 객체가 속한 파일의 로딩 정보가 포함된 LoaderInfo 객체를 반환합니다. | DisplayObject | |
| mask : DisplayObject
호출하는 표시 객체는 지정된 mask 객체에 의해 마스크 처리됩니다. | DisplayObject | |
| metaData : Object
PlaceObject4 태그를 통해 SWF 파일에 해당 DisplayObject의 인스턴스와 함께 메타데이터가 저장된 경우 DisplayObject 인스턴스의 메타데이터 객체를 가져옵니다. | DisplayObject | |
| mouseChildren : Boolean
해당 객체의 자식에서 마우스 또는 사용자 입력 장치가 사용하도록 설정되어 있는지 여부를 결정합니다. | DisplayObjectContainer | |
| mouseEnabled : Boolean
이 객체가 마우스 또는 기타 사용자 입력, 메시지를 수신할지 여부를 지정합니다. | InteractiveObject | |
| mouseX : Number [읽기 전용]
마우스 또는 사용자 입력 장치 위치의 x 좌표를 픽셀로 나타냅니다. | DisplayObject | |
| mouseY : Number [읽기 전용]
마우스 또는 사용자 입력 장치 위치의 y 좌표를 픽셀로 나타냅니다. | DisplayObject | |
| name : String
DisplayObject의 인스턴스 이름을 나타냅니다. | DisplayObject | |
| needsSoftKeyboard : Boolean
이 InteractiveObject 인스턴스가 포커스를 받을 때 가상 키보드(화면의 소프트웨어 키보드)를 표시할지 여부를 지정합니다. | InteractiveObject | |
| numChildren : int [읽기 전용]
이 객체의 자식 수를 반환합니다. | DisplayObjectContainer | |
| opaqueBackground : Object
표시 객체를 특정 배경색으로 불투명하게 처리할지 여부를 지정합니다. | DisplayObject | |
| parent : DisplayObjectContainer [읽기 전용]
이 표시 객체가 포함된 DisplayObjectContainer 객체를 나타냅니다. | DisplayObject | |
| root : DisplayObject [읽기 전용]
로드된 SWF 파일에 있는 표시 객체의 경우, 해당 SWF 파일이 나타내는 표시 목록의 트리 구조 부분에서 맨 위에 위치하는 표시 객체가 루트 속성이 됩니다. | DisplayObject | |
| rotation : Number
DisplayObject 인스턴스가 원점으로부터 회전한 각도입니다. | DisplayObject | |
| rotationX : Number
DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 x축 회전한 각도를 나타냅니다. | DisplayObject | |
| rotationY : Number
DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 y축 회전한 각도를 나타냅니다. | DisplayObject | |
| rotationZ : Number
DisplayObject 인스턴스가 3D parent 컨테이너를 기준으로 원점으로부터 z축 회전한 각도를 나타냅니다. | DisplayObject | |
| scale9Grid : Rectangle
현재 적용 중인 크기 조절 격자입니다. | DisplayObject | |
| scaleX : Number
등록 포인트에서 적용된 객체의 가로 크기(백분율)를 나타냅니다. | DisplayObject | |
| scaleY : Number
객체의 등록 포인트에서 적용된 객체의 세로 크기(백분율)를 나타냅니다. | DisplayObject | |
| scaleZ : Number
객체의 등록 포인트에서 적용된 객체의 깊이 크기(백분율)를 나타냅니다. | DisplayObject | |
| scrollRect : Rectangle
표시 객체의 스크롤 사각형 경계입니다. | DisplayObject | |
| softKeyboard : String
소프트 키보드의 모양을 제어합니다. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
소프트 키보드가 표시될 때 화면에서 그대로 유지되는 영역을 정의합니다(iOS에서는 사용할 수 없음). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
이 Sprite 내에서 사운드를 제어합니다. | Sprite | |
| stage : Stage [읽기 전용]
표시 객체의 Stage입니다. | DisplayObject | |
| tabChildren : Boolean
객체의 자식에서 탭 기능을 사용할 수 있는지 여부를 결정합니다. | DisplayObjectContainer | |
| tabEnabled : Boolean
이 객체가 탭 순서에 있는지 여부를 지정합니다. | InteractiveObject | |
| tabIndex : int
SWF 파일에서 객체의 탭 순서를 지정합니다. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [읽기 전용]
이 DisplayObjectContainer 인스턴스에 대한 TextSnapshot 객체를 반환합니다. | DisplayObjectContainer | |
| transform : flash.geom:Transform
표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [읽기 전용]
이 ProLoader 객체의 SWF 파일 코드에서 처리되지 않은 오류가 발생하는 경우 uncaughtError 이벤트를 전달하는 객체입니다. | ProLoader | ||
| useHandCursor : Boolean
buttonMode 속성이 true로 설정된 스프라이트 위로 포인터를 움직일 때 손 모양(손 모양 커서)을 표시할지 여부를 나타내는 부울 값입니다. | Sprite | |
| visible : Boolean
표시 객체가 표시되는지 여부를 나타냅니다. | DisplayObject | |
| width : Number
표시 객체의 폭을 픽셀 단위로 나타냅니다. | DisplayObject | |
| x : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 x 좌표를 나타냅니다. | DisplayObject | |
| y : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 y 좌표를 나타냅니다. | DisplayObject | |
| z : Number
3D parent 컨테이너를 기준으로 DisplayObject 인스턴스의 z축에 있는 z 좌표 위치를 나타냅니다. | DisplayObject | |
| 메서드 | 정의 주체 | ||
|---|---|---|---|
SWF, JPEG, GIF 또는 PNG 파일 등을 로드하는 데 사용할 수 있는 ProLoader 객체를 만듭니다. | ProLoader | ||
|
이 DisplayObjectContainer 인스턴스에 자식 DisplayObject 인스턴스를 추가합니다. | DisplayObjectContainer | |
|
이 DisplayObjectContainer 인스턴스에 자식 DisplayObject 인스턴스를 추가합니다. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
|
지정된 point 점으로 DisplayObjectContainer.getObjectsUnderPoint() 메서드를 호출하여 반환된 목록에서 임의의 표시 객체가 보안 제한 사항으로 인해 생략되는지 여부를 나타냅니다. | DisplayObjectContainer | |
현재 ProLoader 인스턴스에 대해 진행 중인 load() 메서드 작업을 취소합니다. | ProLoader | ||
|
지정된 표시 객체가 DisplayObjectContainer 인스턴스의 자식인지 아니면 인스턴스 자체인지를 확인합니다. | DisplayObjectContainer | |
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
|
targetCoordinateSpace 객체의 좌표계를 기준으로 표시 객체의 영역을 정의하는 사각형을 반환합니다. | DisplayObject | |
|
지정된 인덱스에 존재하는 자식 표시 객체 인스턴스를 반환합니다. | DisplayObjectContainer | |
|
지정된 이름을 가진 자식 표시 객체를 반환합니다. | DisplayObjectContainer | |
|
자식 DisplayObject 인스턴스의 인덱스 위치를 반환합니다. | DisplayObjectContainer | |
|
이 DisplayObjectContainer 인스턴스의 자식(또는 손자 등)으로서 지정된 점 아래에 있는 객체의 배열을 반환합니다. | DisplayObjectContainer | |
|
대상 좌표 공간 매개 변수에 의해 정의되는 좌표계를 기준으로 모양의 획을 제외하고 표시 객체의 경계를 정의하는 사각형을 반환합니다. | DisplayObject | |
|
Point 객체를 Stage 전역 좌표에서 표시 객체의 로컬 좌표로 변환합니다. | DisplayObject | |
|
Stage(전역) 좌표의 2차원 점을 3차원 표시 객체(로컬) 좌표로 변환합니다. | DisplayObject | |
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
표시 객체의 경계 상자를 평가하여 obj 표시 객체의 경계 상자와 겹치거나 교차하는지 확인합니다. | DisplayObject | |
|
표시 객체를 평가하여 x 및 y 매개 변수에 의해 지정된 점과 겹치거나 교차하는지 확인합니다. | DisplayObject | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
SWF, JPEG, 점진적 JPEG, 비애니메이션 GIF 또는 PNG 파일을 이 ProLoader 객체의 자식 객체로 로드합니다. | ProLoader | ||
ByteArray 객체에 저장된 이진 데이터에서 로드합니다. | ProLoader | ||
promise 매개 변수를 통해 IFilePromise 인스턴스를 로드합니다. | ProLoader | ||
|
3차원 표시 객체의 로컬 좌표에 있는 3차원 점을 Stage 전역 좌표의 2차원 점으로 변환합니다. | DisplayObject | |
|
Point 객체를 표시 객체의 로컬 좌표에서 Stage 전역 좌표로 변환합니다. | DisplayObject | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
지정된 자식 DisplayObject 인스턴스를 DisplayObjectContainer 인스턴스의 자식 목록에서 제거합니다. | DisplayObjectContainer | |
|
DisplayObjectContainer 자식 목록에서 지정된 인덱스 위치에 있는 자식 DisplayObject를 제거합니다. | DisplayObjectContainer | |
|
모든 자식 DisplayObject 인스턴스를 DisplayObjectContainer 인스턴스의 자식 목록에서 제거합니다. | DisplayObjectContainer | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
|
가상 키보드를 표시합니다. | InteractiveObject | |
|
표시 객체 컨테이너에서 기존 자식의 위치를 변경합니다. | DisplayObjectContainer | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
지정된 Sprite를 드래그할 수 있도록 합니다. | Sprite | |
|
터치 지원 장치에서 지정된 스프라이트를 드래그할 수 있도록 합니다. | Sprite | |
|
이 객체가 루트로 지정된 모든 MovieClip의 타임라인 실행을 재귀적으로 중지합니다. | DisplayObjectContainer | |
|
startDrag() 메서드를 종료합니다. | Sprite | |
|
startTouchDrag() 메서드를 종료합니다. 터치 지원 장치에서 사용합니다. | Sprite | |
|
지정된 두 개의 자식 객체의 z 순서(전후 순서)를 맞바꿉니다. | DisplayObjectContainer | |
|
자식 목록에서 지정된 두 곳의 인덱스 위치에 있는 자식 객체의 z 순서(전후 순서)를 맞바꿉니다. | DisplayObjectContainer | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
load() 메서드를 사용하여 로드된 이 ProLoader 객체의 자식을 제거합니다. | ProLoader | ||
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
content | 속성 |
content:DisplayObject [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0, Flash Player 9 |
load() 또는 loadBytes() 메서드를 사용하여 로드된 SWF 파일 또는 이미지(JPG, PNG 또는 GIF) 파일의 루트 표시 객체를 포함합니다.
구현
public function get content():DisplayObject오류
SecurityError — 로드된 SWF 파일 또는 이미지 파일이 사용자가 액세스할 수 없는 보안 샌드박스에 속해 있습니다. 로드된 SWF 파일의 경우, load() 또는 loadBytes() 메서드를 호출할 때 해당 파일에서 Security.allowDomain() 메서드를 호출함으로써 또는 로드하는 파일에서 SecurityDomain.currentDomain으로 설정된 securityDomain 속성을 사용하여 loaderContext 매개 변수를 지정함으로써 이러한 상황을 피할 수 있습니다.
|
contentLoaderInfo | 속성 |
contentLoaderInfo:ProLoaderInfo [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0, Flash Player 9 |
로드 중인 객체에 해당하는 ProLoaderInfo 객체를 반환합니다. ProLoaderInfo 객체는 ProLoader 객체와 로드된 내용 객체 간에 공유되며, 로드된 파일에 대한 로드 진행률 정보 및 통계를 제공합니다.
해당 로드와 연관된 이벤트는 ProLoader 객체의 contentLoaderInfo 속성에서 참조하는 ProLoaderInfo 객체에 의해 전달됩니다. contentLoaderInfo 속성을 유효한 ProLoaderInfo 객체로 설정하면 내용이 로드되기 전이라도 이벤트 수신자를 로드보다 먼저 객체에 추가할 수 있습니다.
로드된 SWF에서 발생한 포착되지 않는 오류를 검색하려면 ProLoader.contentLoaderInfo.uncaughtErrorEvents 속성이 아닌 ProLoader.uncaughtErrorEvents 속성을 사용합니다.
참고 contentLoaderInfo 속성은 ProLoaderInfo 객체를 반환합니다. ProLoaderInfo는 LoaderInfo의 하위 클래스가 아니므로 수퍼 클래스로 암시적으로 변환할 수 없습니다. 따라서 반드시 유형 선언을 LoaderInfo에서 ProLoaderInfo로 변경해야 합니다.
구현
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | 속성 |
uncaughtErrorEvents:EventDispatcher [읽기 전용] | 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 10.1, AIR 2.0 |
이 ProLoader 객체의 SWF 파일 코드에서 처리되지 않은 오류가 발생하는 경우 uncaughtError 이벤트를 전달하는 객체입니다. try..catch 블록 밖에서 오류가 발생하는 경우 또는 리스너가 등록되지 않은 상태로 ErrorEvent 객체가 전달되는 경우 포착되지 않는 오류가 발생합니다.
이 속성은 이 객체와 연결된 SWF가 모두 로드되면 만들어집니다. 로드가 완료되기 전에는 uncaughtErrorEvents 속성이 null입니다. ActionScript 전용 프로젝트에서 이 속성은 SWF 파일의 기본 클래스 생성자 함수가 실행되는 동안이나 실행된 후에 액세스할 수 있습니다.
이 ProLoader 속성을 지원하지 않는 플레이어에서 속성에 액세스하면 오류가 발생합니다. 지원하지 않는 플레이어에서 오류가 발생되지 않도록 하려면 UncaughtErrorEvents 객체 대신 EventDispatcher 객체를 반환합니다.
구현
public function get uncaughtErrorEvents():EventDispatcher관련 API 요소
ProLoader | () | 생성자 |
public function ProLoader()| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0, Flash Player 9 |
SWF, JPEG, GIF 또는 PNG 파일 등을 로드하는 데 사용할 수 있는 ProLoader 객체를 만듭니다. load() 메서드를 호출하여 해당 에셋을 ProLoader 인스턴스의 자식으로 로드합니다. 그런 다음 ProLoader 객체를 표시 목록에 추가할 수 있습니다(예: DisplayObjectContainer 인스턴스의 addChild() 메서드 사용). 에셋은 자신이 로드되는 Stage에 나타납니다.
표시 목록의 표시 객체 컨테이너에 해당 객체를 추가하지 않는 ProLoader 인스턴스의 "오프리스트(offlist)" 모드를 사용할 수도 있습니다. 이 모드에서 Loader 인스턴스는 응용 프로그램의 추가 모듈을 포함하는 SWF 파일을 로드하는 데 사용될 수 있습니다.
SWF 파일 로드가 완료되는 시점을 감지하기 위해 ProLoader 객체의 contentLoaderInfo 속성과 관련된 ProLoaderInfo 객체의 이벤트를 사용할 수 있습니다. 이때 모듈 SWF 파일의 코드가 실행되어 모듈을 초기화하고 시작할 수 있습니다. 오프리스트 모드에서 ProLoader 인스턴스는 구성 요소 또는 미디어 에셋을 포함하는 SWF 파일을 로드하는 데 사용될 수 있습니다. 앞에서와 마찬가지로 ProLoaderInfo 객체 이벤트 알림을 사용하여 구성 요소가 로드를 완료하는 시점을 감지할 수 있습니다. 이때 응용 프로그램은 SWF 파일의 라이브러리에 있는 구성 요소와 미디어 에셋을 나타내는 ActionScript 3.0 클래스를 인스턴스화함으로써 해당 구성 요소와 에셋을 사용할 수 있습니다.
ProLoader 객체의 상태를 확인하려면 ProLoader 객체의 contentLoaderInfo 속성과 연관된 ProLoaderInfo 객체의 다음과 같은 이벤트를 모니터링합니다.
open이벤트 - 로드가 시작될 때 전달됩니다.ioError또는securityError이벤트 - 파일을 로드할 수 없는 경우 또는 로드 프로세스 중 오류가 발생한 경우 전달됩니다.progress이벤트 - 파일이 로드되는 동안 계속해서 발생합니다.complete이벤트 - 파일 다운로드가 완료된 후, 로드된 동영상 클립의 메서드와 속성이 사용 가능한 상태가 되기 전에 전달됩니다. 로드된 SWF 파일에서 RSL 미리 로드를 사용하는 경우 이 이벤트는 RSL 미리 로드가 완료된 후에 전달됩니다. 이때 실제 내용은content속성에서 사용할 수 있습니다.init이벤트 - 로드된 SWF 파일을 조작할 수 있도록, 로드된 SWF 파일의 속성과 메서드가 액세스 가능한 상태가 된 후에 전달됩니다. 이 이벤트는complete핸들러에 앞서 전달됩니다. 스트리밍 SWF 파일의 경우init이벤트는complete이벤트보다 훨씬 더 이전에 발생할 수 있습니다. 대부분의 경우에는init핸들러를 사용합니다. 로드된 SWF 파일에서 RSL 미리 로드를 사용하는 경우 이 이벤트는 RSL 미리 로드가 완료된 후에 전달됩니다. 이때 실제 내용은content속성에서 사용할 수 있습니다.
관련 API 요소
close | () | 메서드 |
public function close():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0, Flash Player Player - 9 |
현재 ProLoader 인스턴스에 대해 진행 중인 load() 메서드 작업을 취소합니다.
load | () | 메서드 |
public function load(request:URLRequest, context:LoaderContext = null):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
SWF, JPEG, 점진적 JPEG, 비애니메이션 GIF 또는 PNG 파일을 이 ProLoader 객체의 자식 객체로 로드합니다. 애니메이션 GIF 파일을 로드하는 경우 첫 번째 프레임만 표시됩니다. ProLoader 객체는 하나의 자식만을 포함할 수 있기 때문에 후속 load() 요청을 발생시키면 이전 요청(여전히 대기 중인 경우)이 종료되고 새 로드가 시작됩니다.
참고: AIR 1.5 및 Flash Player 10에서는 로드된 이미지의 최대 크기가 8,191픽셀(폭 또는 높이)이며 총 픽셀 수는 16,777,215픽셀을 초과할 수 없습니다. 따라서 로드된 이미지의 폭이 8,191픽셀이면 높이가 2,048픽셀 이하여야 합니다. Flash Player 9 이전 버전 및 AIR 1.1 이전 버전에서는 이 제한이 높이 2,880픽셀 및 폭 2,880픽셀입니다.
ProLoader 객체로 로드된 SWF 파일 또는 이미지는 ProLoader 객체의 부모 표시 객체로부터 위치, 회전 및 크기 조절 속성을 상속합니다.
이 메서드를 사용하여 로드한 동영상 또는 이미지를 제거하거나 진행 중인 로드 작업을 취소하려면 unload() 메서드를 사용합니다.
SWF 내용이 들어 있는 HTML 페이지에서 allowNetworking 매개 변수(object 및 embed 태그)를 설정하여 SWF 파일에서 이 메서드를 사용하지 않게 할 수 있습니다.
이 메서드를 사용할 때는 ProLoader 클래스 설명에 나와 있는 Flash Player 보안 모델을 고려해야 합니다.
Flash Player 10 이상에서는 multipart Content-Type(예: "multipart/form-data")을 사용하고 POST 본문 내 "content-disposition" 헤더에 "filename" 매개 변수를 지정하여 업로드를 처리하는 경우 POST 작업이 업로드에 적용되는 보안 규칙의 영향을 받을 수 있습니다.
- POST 작업은 마우스 클릭이나 키 누르기 같은 사용자 동작에 대한 응답으로 수행됩니다.
- POST 작업이 크로스 도메인인 경우, 즉 POST 대상이 POST 요청을 보내는 SWF 파일과 같은 서버에 없는 경우 대상 서버는 크로스 도메인 액세스를 허용하는 URL 정책 파일을 제공해야 합니다.
또한 multipart Content-Type의 경우 구문이 RFC2046 표준에 따라 유효해야 합니다. 구문이 유효하지 않은 경우 POST 작업은 업로드에 적용되는 보안 규칙의 영향을 받을 수 있습니다.
보안에 대한 자세한 내용은 Flash Player 개발자 센터 항목: 보안을 참조하십시오.
매개 변수
request:URLRequest — 로드할 SWF, JPEG, GIF 또는 PNG 파일의 절대 또는 상대 URL입니다. 상대 경로는 기본 SWF 파일에 상대적이어야 하며, 절대 URL은 프로토콜 참조(예: http:// 또는 file:///)를 포함해야 합니다. 파일 이름에는 디스크 드라이브 이름을 포함할 수 없습니다.
| |
context:LoaderContext (default = null)
자세한 내용은 LoaderContext 클래스의 속성에 대한 설명을 참조하십시오. |
이벤트
asyncError: — LoaderContext.requestedContentParent 속성이 지정되어 있고 로드된 내용을 지정된 DisplayObjectContainer에 자식으로 추가할 수 없는 경우 contentLoaderInfo 객체에 의해 전달됩니다. 이는 로드된 내용이 flash.display.AVM1Movie이거나 addChild()의 requestedContentParent 호출에 오류가 발생할 때 일어납니다.
| |
complete: — 파일 로드가 완료되면 contentLoaderInfo 객체에서 전달됩니다. complete 이벤트는 항상 init 이벤트 이후에 전달됩니다.
| |
httpStatus: — HTTP를 통해 네트워크 요청이 수행되고 Flash Player가 해당 HTTP 상태 코드를 감지할 수 있을 때 contentLoaderInfo 객체에서 전달됩니다.
| |
init: — 로드된 SWF 파일의 속성 및 메서드에 액세스할 수 있을 때 contentLoaderInfo 객체에서 전달됩니다. init 이벤트는 항상 complete 이벤트 이전에 전달됩니다.
| |
ioError: — 로드 작업 실패를 유발하는 입력 또는 출력 오류가 발생할 때 contentLoaderInfo 객체에서 전달됩니다.
| |
open: — 로드 작업이 시작될 때 contentLoaderInfo 객체에서 전달됩니다.
| |
progress: — 로드 작업이 진행되는 동안 데이터가 수신될 때 contentLoaderInfo 객체에서 전달됩니다.
| |
securityError: — local-with-filesystem 샌드박스의 SWF 파일이 local-with-networking 샌드박스의 내용을 로드하려고 하거나 그 반대의 경우 contentLoaderInfo 객체에서 전달됩니다.
| |
securityError: — LoaderContext.requestedContentParent 속성이 지정되어 있고 LoaderContext.requestedContentParent의 보안 샌드박스가 로드된 SWF에 액세스할 수 없는 경우 contentLoaderInfo 객체에 의해 전달됩니다.
| |
unload: — 로드된 객체가 제거될 때 contentLoaderInfo 객체에서 전달됩니다.
|
오류
IOError — request 객체의 digest 속성이 null이 아닙니다. SWZ 파일(Adobe 플랫폼 구성 요소)을 로드할 때는 URLRequest 객체가 URLLoader.load() 메서드 호출에 사용되는 경우에만 URLRequest 객체의 digest 속성을 설정해야 합니다.
| |
SecurityError — LoaderContext.securityDomain의 값이 null 또는 SecurityDomain.currentDomain이어야 합니다. 이는 로드된 미디어를 원본 보안 샌드박스 또는 사용자 고유의 보안 샌드박스(정책 파일 필요)에만 배치할 수 있음을 의미합니다.
| |
SecurityError — 로컬 SWF 파일이 LoaderContext.securityDomain을 null 이외의 다른 값으로 설정할 수 없습니다. 로컬에 위치하지 않은 미디어를 로컬 샌드박스로 가져오거나, 다른 로컬 미디어를 원본 샌드박스가 아닌 다른 위치에 배치하는 것은 허용되지 않습니다.
| |
SecurityError — 일반적으로 예약된 포트에 연결할 수 없습니다. 차단된 포트의 전체 목록은 ActionScript 3.0 개발자 안내서의 "제한적 네트워킹 API"를 참조하십시오.
| |
SecurityError — context 매개 변수의 applicationDomain 또는 securityDomain 속성이 허용되지 않는 도메인에 대한 속성인 경우입니다.
| |
SecurityError — 로컬 SWF 파일이 context 매개 변수의 securityDomain 속성을 사용하려는 경우입니다.
| |
IllegalOperationError — context 매개 변수의 requestedContentParent 속성이 ProLoader인 경우입니다.
| |
IllegalOperationError — LoaderContext.parameters 매개 변수가 null이 아니면서 문자열이 아닌 값을 가질 경우입니다.
|
관련 API 요소
loadBytes | () | 메서드 |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | Flash Player 9, AIR 1.0, Flash Player 9 |
ByteArray 객체에 저장된 이진 데이터에서 로드합니다.
loadBytes() 메서드는 비동기적입니다. 로드된 객체의 속성에 액세스하기 전에 "init" 이벤트가 발생할 때까지 기다려야 합니다.
이 메서드를 사용할 때는 ProLoader 클래스 설명에 나와 있는 Flash Player 보안 모델을 고려해야 합니다.
매개 변수
bytes:ByteArray — ByteArray 객체입니다. ByteArray의 내용은 ProLoader 클래스에서 지원되는 파일 형식(SWF, GIF, JPEG 또는 PNG)일 수 있습니다.
| |
context:LoaderContext (default = null)applicationDomain 속성만 적용되며, LoaderContext 객체의 checkPolicyFile 및 securityDomain 속성은 적용되지 않습니다.
보안에 대한 자세한 내용은 Flash Player 개발자 센터 항목: 보안을 참조하십시오. |
이벤트
asyncError: — LoaderContext.requestedContentParent 속성이 지정되어 있고 로드된 내용을 지정된 DisplayObjectContainer에 자식으로 추가할 수 없는 경우 contentLoaderInfo 객체에 의해 전달됩니다. 이는 로드된 내용이 flash.display.AVM1Movie이거나 addChild()의 requestedContentParent 호출에 오류가 발생할 때 일어납니다.
| |
complete: — 작업이 완료될 때 contentLoaderInfo 객체에 의해 전달됩니다. complete 이벤트는 항상 init 이벤트 이후에 전달됩니다.
| |
init: — 로드된 데이터의 속성 및 메서드에 액세스할 수 있을 때 contentLoaderInfo 객체에 의해 전달됩니다. init 이벤트는 항상 complete 이벤트 이전에 전달됩니다.
| |
ioError: — 런타임이 바이트 배열의 데이터를 구문 분석할 수 없을 때 contentLoaderInfo 객체에 의해 전달됩니다.
| |
open: — 작업이 시작될 때 contentLoaderInfo 객체에 의해 전달됩니다.
| |
progress: — 데이터가 메모리에서 전송될 때 contentLoaderInfo 객체에 의해 전달됩니다.
| |
securityError: — LoaderContext.requestedContentParent 속성이 지정되어 있고 LoaderContext.requestedContentParent의 보안 샌드박스가 로드된 SWF에 액세스할 수 없는 경우 contentLoaderInfo 객체에 의해 전달됩니다.
| |
unload: — 로드된 객체가 제거될 때 contentLoaderInfo 객체에서 전달됩니다.
|
오류
ArgumentError — ByteArray 객체의 length 속성이 0보다 작거나 같은 경우입니다.
| |
IllegalOperationError — context 매개 변수의 checkPolicyFile 또는 securityDomain 속성이 null이 아닌 경우입니다.
| |
IllegalOperationError — context 매개 변수의 requestedContentParent 속성이 ProLoader인 경우입니다.
| |
IllegalOperationError — LoaderContext.parameters 매개 변수가 null이 아니면서 문자열이 아닌 값을 가질 경우입니다.
| |
SecurityError — 제공된 context 속성의 applicationDomain 속성이 허용되지 않는 도메인에 대한 속성인 경우입니다.
| |
SecurityError — 일반적으로 예약된 포트에 연결할 수 없습니다. 차단된 포트의 전체 목록은 ActionScript 3.0 개발자 안내서의 "제한적 네트워킹 API"를 참조하십시오.
|
관련 API 요소
loadFilePromise | () | 메서드 |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 2.5, AIR 2.0, Flash Player 9 |
promise 매개 변수를 통해 IFilePromise 인스턴스를 로드합니다. promise 매개 변수 유형에서는 다른 플레이어에서의 오류를 방지하기 위해 IFilePromise 대신 Object 수퍼 클래스를 사용합니다.
loadFilePromise 메서드는 IFilePromise 객체를 사용하고 이진 데이터를 로드합니다. 데이터가 점진적 문자열(예: 비디오)인 경우 "init" 또는 progress 이벤트를 기다린 후에 로드된 객체의 속성에 액세스합니다. 그렇지 않으면 complete 이벤트를 기다려서 데이터가 완전히 로드되었는지를 확인합니다.
이 메서드를 사용할 때는 ProLoader 클래스 설명에 나와 있는 Flash Player 보안 모델을 고려해야 합니다.
매개 변수
promise:Object — IFilePromise 객체입니다. 객체의 데이터 소스는 ProLoader 클래스에서 지원되는 파일 형식(SWF, GIF, JPEG 또는 PNG)일 수 있습니다.
| |
context:LoaderContext (default = null)applicationDomain 속성만 적용되며, LoaderContext 객체의 checkPolicyFile 및 securityDomain 속성은 적용되지 않습니다.
보안에 대한 자세한 내용은 Flash Player 개발자 센터 항목: 보안을 참조하십시오. |
이벤트
asyncError: — LoaderContext.requestedContentParent 속성이 지정되어 있고 로드된 내용을 지정된 DisplayObjectContainer에 자식으로 추가할 수 없는 경우 contentLoaderInfo 객체에 의해 전달됩니다. 이는 로드된 내용이 flash.display.AVM1Movie이거나 addChild()의 requestedContentParent 호출에 오류가 발생할 때 일어납니다.
| |
complete: — 작업이 완료될 때 contentLoaderInfo 객체에 의해 전달됩니다. complete 이벤트는 항상 init 이벤트 이후에 전달됩니다.
| |
init: — 로드된 데이터의 속성 및 메서드에 액세스할 수 있을 때 contentLoaderInfo 객체에 의해 전달됩니다. init 이벤트는 항상 complete 이벤트 이전에 전달됩니다.
| |
ioError: — 런타임에 데이터 소스에서 데이터를 구문 분석할 수 없는 경우 또는 데이터 소스 스트림을 읽을 수 없는 경우에 contentLoaderInfo 객체에 의해 전달됩니다.
| |
open: — 작업이 시작될 때 contentLoaderInfo 객체에 의해 전달됩니다.
| |
progress: — 데이터가 메모리에서 전송될 때 contentLoaderInfo 객체에 의해 전달됩니다.
| |
securityError: — LoaderContext.requestedContentParent 속성이 지정되어 있고 LoaderContext.requestedContentParent의 보안 샌드박스가 로드된 SWF에 액세스할 수 없는 경우 contentLoaderInfo 객체에 의해 전달됩니다.
| |
unload: — 로드된 객체가 제거될 때 contentLoaderInfo 객체에서 전달됩니다.
경고 AIR 응용 프로그램 이외에서 이 API에 액세스하면 오류가 발생합니다. |
오류
IllegalOperationError — 속성context 매개 변수의 requestedContentParent 속성이 ProLoader 객체인 경우입니다.
| |
IllegalOperationError — LoaderContext.parameters 매개 변수가 null이 아니면서 문자열이 아닌 값을 가질 경우입니다.
| |
ArgumentError — 매개 변수로 전달된 IFilePromise 객체가 null인 경우입니다.
|
관련 API 요소
unload | () | 메서드 |
public function unload():void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flash CS5.5 |
| 런타임 버전: | AIR 1.0, Flash Player 9 |
load() 메서드를 사용하여 로드된 이 ProLoader 객체의 자식을 제거합니다. 관련된 ProLoaderInfo 객체의 property는 null로 재설정됩니다. 해당 자식은 다른 객체에서 참조할 수 있기 때문에 반드시 삭제되지는 않지만, 더 이상 ProLoader 객체의 자식이 아닙니다.
자식 SWF 파일을 언로드하기 전에 해당 자식 SWF 파일의 객체(예: LocalConnection, NetConnection, NetStream 및 Sound)에 있는 모든 스트림을 확실하게 닫는 것이 좋습니다. 그렇지 않으면 자식 SWF 파일이 언로드된 경우에도 자식 SWF 파일의 오디오가 계속해서 재생될 수 있습니다. 자식 SWF 파일의 스트림을 닫으려면 이벤트 리스너를 unload 이벤트에 대해 수신하는 자식에 추가합니다. 부모가 ProLoader.unload()를 호출하면 unload 이벤트가 자식에 전달됩니다. 다음 코드는 이렇게 하는 방법을 보여 줍니다.
function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}
myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);
관련 API 요소
Tue Jun 12 2018, 03:17 PM Z