load() 또는 loadBytes() 메서드를 사용하여 로드된 SWF 파일 또는 이미지(JPG, PNG 또는 GIF) 파일의 루트 표시 객체를 포함합니다.

참고 사항

로드 중인 객체에 해당하는 LoaderInfo 객체를 반환합니다. LoaderInfo 객체는 Loader 객체와 로드된 내용 객체 간에 공유되며, 로드된 파일에 대한 로드 진행률 정보 및 통계를 제공합니다.

해당 로드와 연관된 이벤트는 Loader 객체의 contentLoaderInfo 속성에서 참조하는 LoaderInfo 객체에 의해 전달됩니다. contentLoaderInfo 속성을 유효한 LoaderInfo 객체로 설정하면 이벤트 수신자를 로드보다 먼저 객체에 추가할 수 있습니다.

참고 사항

SWF, JPEG, GIF 또는 PNG 파일 등을 로드하는 데 사용할 수 있는 Loader 객체를 만듭니다. load() 메서드를 호출하여 해당 에셋을 Loader 인스턴스의 자식으로 로드합니다. 그런 다음, Loader 객체를 표시 목록에 추가할 수 있습니다(예: DisplayObjectContainer 인스턴스의 addChild() 메서드 사용). 에셋은 자신이 로드되는 Stage에 나타납니다.

표시 목록의 표시 객체 컨테이너에 해당 객체를 추가하지 않는 Loader 인스턴스의 "오프리스트(offlist)" 모드를 사용할 수도 있습니다. 이 모드에서 Loader 인스턴스는 응용 프로그램의 추가 모듈을 포함하는 SWF 파일을 로드하는 데 사용될 수 있습니다.

SWF 파일 로드가 완료되는 시점을 감지하기 위해 Loader 객체의 contentLoaderInfo 속성과 관련된 LoaderInfo 객체의 이벤트를 사용할 수 있습니다. 이때 모듈 SWF 파일의 코드가 실행되어 모듈을 초기화하고 시작할 수 있습니다. offlist 모드에서 Loader 인스턴스는 구성 요소 또는 미디어 에셋을 포함하는 SWF 파일을 로드하는 데 사용될 수 있습니다. 앞에서와 마찬가지로, LoaderInfo 객체 이벤트 알림을 사용하여 구성 요소가 로드를 완료하는 시점을 감지할 수 있습니다. 이때 응용 프로그램은 SWF 파일의 라이브러리에 있는 구성 요소와 미디어 에셋을 나타내는 ActionScript 3.0 클래스를 인스턴스화함으로써 해당 구성 요소와 에셋을 사용할 수 있습니다.

Loader 객체의 상태를 확인하려면 Loader 객체의 contentLoaderInfo 속성과 연관된 LoaderInfo 객체의 다음과 같은 이벤트를 모니터링합니다.

• open 이벤트 - 로드가 시작될 때 전달됩니다.
• ioError 또는 securityError 이벤트 - 파일을 로드할 수 없는 경우 또는 로드 프로세스 중 오류가 발생한 경우 전달됩니다.
• progress 이벤트 - 파일이 로드되는 동안 계속해서 발생합니다.
• complete 이벤트 - 파일 다운로드가 완료된 후, 로드된 무비 클립의 메서드와 속성이 사용 가능한 상태가 되기 전에 전달됩니다.
• init 이벤트 - 로드된 SWF 파일을 조작할 수 있도록, 로드된 SWF 파일의 속성과 메서드가 액세스 가능한 상태가 된 후에 전달됩니다. 이 이벤트는 complete 핸들러에 앞서 전달됩니다. 스트리밍 SWF 파일의 경우 init 이벤트는 complete 이벤트보다 훨씬 더 이전에 발생할 수 있습니다. 대부분의 경우에는 init 핸들러를 사용합니다.

참고 사항

현재 Loader 인스턴스에 대해 진행 중인 load() 메서드 작업을 취소합니다.

참고 사항

SWF, JPEG, 점진적 JPEG, 비애니메이션 GIF 또는 PNG 파일을 이 Loader 객체의 자식 객체로 로드합니다. 애니메이션 GIF 파일을 로드하는 경우 첫 번째 프레임만 표시됩니다. Loader 객체는 하나의 자식만을 포함할 수 있기 때문에 후속 load() 요청을 발생시키면 이전 요청(여전히 대기 중인 경우)이 종료되고 새 로드가 시작됩니다.

Loader 객체로 로드된 SWF 파일 또는 이미지는 Loader 객체의 부모 표시 객체로부터 위치, 회전 및 크기 조절 속성을 상속합니다.

이 메서드로 로드한 무비 또는 이미지를 제거하거나 진행 중인 로드 작업을 취소하려면 unload() 메서드를 사용합니다.

load() 메서드를 사용할 경우 다음과 같은 Flash Player 보안 모델을 고려해 볼 수 있습니다.

• 액세스 가능한 임의의 소스에서 내용을 로드할 수 있습니다.
• 호출하는 SWF 파일은 네트워크 샌드박스에 있고 로드할 파일은 로컬인 경우, 로딩이 허용되지 않습니다.
• 로드된 내용이 SWF 파일인 경우, 로드된 내용 파일에서 Security.allowDomain() 메서드 호출을 통해 크로스 스크립팅 배열이 승인되지 않는 한 다른 보안 샌드박스의 SWF 파일은 로드된 내용을 스크립팅할 수 없습니다.
• ActionScript 1.0 또는 2.0에서 작성된 SWF 파일(AVM1Movie 객체로 로드됨)은 ActionScript 3.0에서 작성된 SWF 파일(Sprite 또는 MovieClip 객체로 로드됨)을 크로스 스크립팅할 수 없습니다. 하지만 LocalConnection 클래스를 사용하여 이러한 파일 간에 통신은 가능합니다.
• 로드된 내용이 이미지인 경우, 해당 SWF 파일의 도메인이 이미지의 원래 도메인에 있는 크로스 도메인 정책 파일에 포함되지 않았다면 보안 샌드박스 외부의 SWF 파일은 로드된 데이터에 액세스할 수 없습니다.
• local-with-file-system 샌드박스의 무비 클립은 local-with-networking 샌드박스의 무비 클립을 크로스 스크립팅할 수 없으며, 그 반대의 경우도 마찬가지입니다.
• SWF 내용을 포함하는 HTML 페이지에서 object 및 embed 태그의 allowNetworking 매개 변수를 설정하여 SWF 파일에서 이 메서드를 사용하지 못하도록 할 수 있습니다.

자세한 내용은 다음을 참조하십시오.

• 보안 장(ActionScript 3.0 프로그래밍 설명서) 및 LiveDocs의 최신 의견
• Flash Player 9 보안 백서

매개 변수

참고 사항

ByteArray 객체에 저장된 이진 데이터에서 로드합니다.

매개 변수

참고 사항

load() 메서드를 사용하여 로드된 이 Loader 객체의 자식을 제거합니다. 관련된 LoaderInfo 객체의 property는 null로 재설정됩니다. 해당 자식은 다른 객체에서 참조할 수 있기 때문에 반드시 삭제되지는 않지만, 더 이상 Loader 객체의 자식이 아닙니다.

자식 SWF 파일을 언로드하기 전에 해당 자식 SWF 파일의 객체(예: LocalConnection, NetConnection, NetStream 및 Sound)에 있는 모든 스트림을 확실하게 닫는 것이 좋습니다. 그렇지 않으면 자식 SWF 파일이 언로드된 경우에도 자식 SWF 파일의 오디오가 계속해서 재생될 수 있습니다. 자식 SWF 파일의 스트림을 닫으려면 이벤트 리스너를 unload 이벤트에 대해 수신하는 자식에 추가합니다. 부모가 Loader.unload()를 호출하면 unload 이벤트가 자식에 전달됩니다. 다음 코드는 이렇게 하는 방법을 보여 줍니다.

function closeAllStreams(evt:Event) { myNetStream.close(); mySound.close(); myNetConnection.close(); myLocalConnection.close(); } myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

참고 사항

1. 이미지 파일의 이름과 위치를 나타내는 url 속성이 만들어집니다.
2. LoaderExample 생성자에서 loader라는 새 Loader 객체를 만든 후 단계 3에 설명된 configureListeners() 메서드에 전달합니다.
3. 생성자가 파일 이름 및 위치를 나타내도록 전달된 url이 있는 새 URLRequest 객체 request를 만듭니다.
4. request 객체가 loader 객체의 load() 메서드로 전달되며, 이 메서드는 이미지를 표시 목록으로 로드합니다.
5. clickHandler 이벤트 리스너가 로더에서 click 이벤트에 대해 등록됩니다. 마우스를 클릭하면 로드된 이미지가 언로드됩니다.
6. configureListeners() 메서드가 다음 메서드를 사용하여 일곱 개의 이벤트 리스너를 추가합니다.
   • completeHandler() 메서드는 이미지 로드가 완료되면 실행됩니다.
   • httpStatusHandler() 메서드는 이미지가 로컬에 로드되지 않은 경우 네트워크 요청이 사용 가능하게 되고 Flash Player에서 해당 요청을 감지할 수 있을 때만 실행됩니다.
   • initHandler() 메서드는 completeHandler() 메서드 이전 및 progressHandler() 메서드 이후에 실행됩니다. 일반적으로 SWF 파일을 로드할 경우에는 init 이벤트가 더 유용합니다.
   • ioErrorHandler() 메서드는 이미지 파일을 사용할 수 없거나 액세스할 수 없는 경우 실행됩니다.
   • openHandler() 메서드는 이미지 파일을 처음 열 때 실행됩니다.
   • progressHandler() 메서드는 이미지 파일을 로드하기 시작할 때 실행되며 이미지 로드가 완료되면 다시 한 번 실행됩니다.
   • unLoadHandler() 메서드는 사용자가 이미지를 클릭할 때 unload() 메서드를 사용하여 이미지가 언로드되면 실행됩니다.

검토를 진행할 때는 다음과 같은 요구 사항을 염두에 두어야 합니다.

• 이 예제에서는 컴파일된 SWF 파일과 같은 디렉토리에 Image.gif 파일이 있어야 합니다. 기본 SWF 파일의 크기에 알맞은 영역이 있는 이미지를 사용합니다.
• 이 예제에서는 LoaderInfo 객체에 사용 가능한 모든 이벤트를 활용하지만, 대부분의 경우 하위 세트만 필요합니다. 특히, 이미지 파일만을 로드할 경우 complete 이벤트(또는 ioError 이벤트)만 있으면 로컬 이미지를 로드하는 데는 충분합니다.

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

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

        public function LoaderExample() {
            var loader:Loader = new Loader();
            configureListeners(loader.contentLoaderInfo);
            loader.addEventListener(MouseEvent.CLICK, clickHandler);

            var request:URLRequest = new URLRequest(url);
            loader.load(request);

            addChild(loader);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(Event.INIT, initHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(Event.UNLOAD, unLoadHandler);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function initHandler(event:Event):void {
            trace("initHandler: " + event);
        }

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

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler: bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function unLoadHandler(event:Event):void {
            trace("unLoadHandler: " + event);
        }

        private function clickHandler(event:MouseEvent):void {
            trace("clickHandler: " + event);
            var loader:Loader = Loader(event.target);
            loader.unload();
        }
    }
}