load() Methods를 사용해 로드 된 SWF 파일 또는 이미지 (JPG, PNG, 또는 GIF) 파일의 루트 표시 object가 포함됩니다.

See also

로드 되고 있는 object에 대응하는 LoaderInfo object를 돌려줍니다. LoaderInfo object는 Loader object와 로드 된 컨텐츠 object와의 사이에 공유됩니다. LoaderInfo object는, 로드의 진행 상황에 관한 정보와 로드 된 파일에 관한 통계를 제공합니다.

See also

SWF, JPEG, GIF, 또는 PNG 파일등의 파일을 로드하는데 사용할 수 있는 Loader object를 작성합니다. Assets을 Loader 인스턴스의 아이로서 로드하려면 ,load() Methods를 호출합니다. 그 후, Loader object를 표시 리스트에 추가할 수 있습니다. 예를 들어, DisplayObjectContainer 인스턴스의 addChild() Methods를 사용해 추가합니다. Assets은 로드 되면 스테이지에 표시됩니다.

Loader 인스턴스를 "리스트외" 에서, 즉, 표시 리스트상 display object 컨테이너에 추가하지 않고 사용할 수도 있습니다. 이 모드의 경우, Loader 인스턴스를 사용해, 어플리케이션의 추가 모듈을 포함한 SWF 파일을 로드할 수가 있습니다.

SWF 파일의 로드가 완료한 것을 검출하려면 , Loader object의 contentLoaderInfo property에 관련지을 수 있었던 LoaderInfo object의 이벤트를 사용할 수 있습니다. 그 시점에서, 모듈 SWF 파일내의 코드를 실행해, 모듈을 초기화해, 개시할 수가 있습니다. 리스트외 모드에서는, Loader 인스턴스를 사용해, 컴퍼넌트 또는 미디어 Assets을 포함한 SWF 파일을 로드할 수도 있습니다. 이 경우도, LoaderInfo object의 event 통지를 사용해, 컴퍼넌트의 로드가 완료한 것을 검출할 수 있습니다. 그 시점에서, 어플리케이션은 SWF 파일의 프로그램 라이브러리내의 컴퍼넌트와 미디어 Assets의 사용을 개시할 수 있습니다. 이것은, 그러한 컴퍼넌트와 Assets을 나타내는 ActionScript 3.0 클래스를 인스턴스화하는 것에 의해 실시합니다.

Loader object 상태를 판별하려면 , Loader object의 contentLoaderInfo property에 관련지을 수 있었던 LoaderInfo object의 다음의 이벤트를 감시합니다.

• open 이벤트는, 로드가 개시했을 때에 dispatch됩니다.
• ioError 또는 securityError 이벤트는, 파일을 로드할 수 없는 경우, 혹은 로드 처리중에 에러가 발생했을 경우에 dispatch됩니다.
• progress 이벤트는, 파일이 로드 되고 있는 동안, 계속적으로 발생합니다.
• complete 이벤트는, 파일의 다운로드가 완료했을 때에 dispatch됩니다. 다만, 이 시점에서는, 로드 된 무비 클립의 Methods와 property는 아직 사용할 수 없습니다.
• init 이벤트는, 로드 된 SWF 파일의 property 및 Methods에 액세스 할 수 있게 되면, dispatch됩니다. 그 때문에, 로드 된 SWF 파일에 대해서 각종의 조작을 개시할 수 있습니다. 이 이벤트는,complete 핸들러의 전에 dispatch됩니다. 스트리밍 SWF 파일의 경우,init 이벤트는 complete 이벤트보다 꽤 전에 발생하는 일이 있습니다. 대부분의 경우,init 핸들러를 사용합니다.

See also

Loader 인스턴스에 대해서 현재 진행중의 load() Methods의 처리를 캔슬합니다.

See also

SWF, JPEG, 프로그래시브 JPEG, 비애니메이션 GIF, 또는 PNG 파일을, 이 Loader object의 아이인 object에 로드합니다. 애니메이션 GIF 파일을 읽어들이면, 선두의 프레임만 표시됩니다. Loader object에는 아이를 1 살밖에 포함할 수가 없기 때문에, 후속의 load() 요구를 발행하면 직전의 요구 (보류중이면)를 종료해, 새롭게 로드를 개시합니다.

Loader object에 로드한 SWF 파일 또는 이미지는, 그 Loader object의 부모 display object의 위치, 회전, 및 확대/축소의 각 property를 Inheritance합니다.

이 Methods를 사용해 로드 된 무비 또는 이미지를 삭제하거나 진행중의 로드 처리를 캔슬하려면 ,unload() Methods를 사용합니다.

load() Methods를 사용할 때는, Flash Player 시큐러티 모델을 고려해 주세요.

• 컨텐츠는, 액세스 할 수 있는 소스이면 어느 소스로부터에서도 로드할 수 있습니다.
• 호출원 SWF 파일이 네트워크상의 샌드 박스에 있어, 로드하는 파일이 로컬에 있는 경우, 로드할 수 없습니다.
• 로드 된 컨텐츠가 SWF 파일의 경우, 다른 시큐러티 Sandbox 에 있는 SWF 파일로 그것을 스크립트 처리할 수 없습니다. 다만, 로드 된 컨텐츠 파일로,Security.allowDomain() Methods의 호출에 의해 크로스 스크립트에 관한 결정이 승인되고 있었을 경우는 가능합니다.
• ActionScript 1.0 또는 2.0 으로 작성된 SWF 파일 (AVM1Movie object로서 로드 된다)은, ActionScript 3.0 으로 작성된 SWF 파일 (Sprite 또는 MovieClip object로서 로드 된다)을 크로스 스크립트 할 수 없습니다. LocalConnection 클래스를 사용해, 이러한 파일이 서로 통신하도록 할 수 있습니다.
• 로드 된 컨텐츠가 이미지의 경우, 시큐러티 Sandbox 의 밖에 있는 SWF 파일로부터 그 데이터에 액세스 할 수 없습니다. 다만, 그 SWF 파일의 도메인이 이미지의 원의 도메인에 있는 크로스 도메인 policy 파일에 포함되어 있었을 경우는 가능합니다.
• 로컬 파일 시스템의 샌드 박스에 있는 무비 클립에서는, 네트워크 접속한 로컬의 샌드 박스에 있는 무비 클립을 크로스 스크립트 할 수 없습니다. 그 역도 같습니다.

상세한 것에 대하여는, 다음의 주제를 참조해 주세요.

• 「ActionScript 3.0 의 프로그래밍」의시큐러티의 장과 LiveDocs 의 최신 코멘트
• Flash Player 9 시큐러티에 관한 화이트 페이퍼

See also

ByteArray object에 보관되고 있는 바이너리 데이터로부터 로드합니다.

See also

load() Methods를 사용해 로드 된, 이 Loader object의 아이를 삭제합니다. 관련한 LoaderInfo object의 property 는 null 에 리셋트 됩니다. 다른 object가 참조하고 있을 가능성이 있기 (위해)때문에, 아이는 반드시 파기된다고는 할 수 없습니다. 그러나, Loader object의 아이는 아니게 됩니다.

아이 SWF 파일을 언로드하기 전에, LocalConnection, NetConnection, NetStream, Sound object 등, child SWF 파일의 object내의 스트림(Stream)을 모두 명시적으로 닫아 두는 것을 추천합니다. 그렇게 하지 않았던 경우는, child SWF 파일이 언로드된 후도, child SWF 파일의 오디오의 재생이 계속되는 경우가 있습니다. child SWF 파일의 스트림(Stream)을 닫으려면 ,unload 이벤트를 받는 아이에게 event listener를 추가합니다. 부모가 Loader.unload() 를 호출하면,unload 이벤트가 아이에 대해서 dispatch됩니다. 다음의 코드는, 이러한 처리를 실시하는 예를 나타냅니다.

function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

See also

1. url property를 작성합니다. 이것은 이미지 파일의 장소와 이름입니다.
2. LoaderExample constructor　 　 에서는,loader 라는 이름의 새로운 Loader object가 작성되어 순서 3 으로 설명하는 configureListeners() Methods에게 건네집니다.
3. constructor　 　 은 URLRequest object의 새로운 인스턴스, request 를 작성해, 파일명과 장소를 알 수 있도록(듯이),url 를 건네줍니다.
4. request object가 loader object의 load() Methods에게 건네집니다. 이것에 의해, 이미지가 표시 리스트에 로드 됩니다.
5. clickHandler event listener가 로더의 click 이벤트에 대해서 등록됩니다. 마우스를 클릭하면, 로드 된 이미지는 언로드됩니다.
6. configureListeners() Methods는, 다음의 Methods를 사용해, 7 개의 event listener를 추가합니다.
• completeHandler() Methods는, 이미지의 로드가 완료했을 때에 실행됩니다.
• httpStatusHandler() Methods는, 이미지가 로컬에 로드 되지 않는 경우로, 네트워크 요구를 실시할 수가 있어 Flash Player 가 그것을 검출할 수 있는 경우에게만 실행됩니다.
• initHandler() Methods는,completeHandler() Methods의 전, 한편 progressHandler() Methods의 뒤에 실행됩니다. 통상, SWF 파일을 로드하는 경우는 init 이벤트가 편리합니다.
• ioErrorHandler() Methods는, 이미지 파일을 사용할 수 없는지, 이미지 파일에 액세스 할 수 없는 경우에 실행됩니다.
• openHandler() Methods는, 이미지 파일이 최초로 열렸을 때에 실행됩니다.
• progressHandler() Methods는, 이미지 파일의 로드가 개시했을 때에 실행되어 이미지의 로드가 완료했을 때에 다시 실행됩니다.
• unLoadHandler() Methods는, 유저가 이미지를 클릭했을 때에 unload() Methods를 사용해 이미지가 언로드되었을 경우에 실행됩니다.

다음의 요건에 주의해 주세요.

• 이 예에서는, Image.gif 라는 이름의 파일이 컴파일이 끝난 SWF 파일과 같은 디렉토리에 배치되고 있을 필요가 있습니다. 메인 SWF 파일의 크기내에 들어가는 area를 가지는 이미지를 사용합니다.
• 이 예는, LoaderInfo object로 사용 가능한 모든 이벤트를 이용합니다만, 대부분의 경우, 필요하게 되는 것은 1 개의 부분집합만입니다. 특히, 이미지 파일을 로드할 뿐(만큼)의 경우는, 로컬 이미지를 로드할 때의 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();
        }
    }
}