Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
 |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: 서버에서 데이터를 검색하는 중...
서버에서 데이터를 검색하는 중...
flash.events 

ProgressEvent  - AS3

패키지flash.events
클래스public class ProgressEvent
상속ProgressEvent Inheritance Event Inheritance Object
하위 클래스 ModuleEvent, ResourceEvent, RSLEvent, StyleEvent, VideoProgressEvent

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

로드 작업이 시작되었거나 소켓에 데이터가 수신될 때 ProgressEvent 객체가 전달됩니다. 이 이벤트는 보통 SWF 파일, 이미지 또는 데이터가 응용 프로그램에 로드될 때 생성됩니다. 진행률 이벤트에는 ProgressEvent.PROGRESS 유형과 ProgressEvent.SOCKET_DATA 유형이 있습니다. 또한 AIR ProgressEvent에서의 객체는 NativeProcess 클래스를 사용하여 데이터가 하위 프로세스로 들어가거나 나올 때 전달됩니다.

예제 보기

관련 API 요소



공용 속성
 속성정의 주체
 Inheritedbubbles : Boolean
[읽기 전용] 이벤트가 버블링 이벤트인지 여부를 나타냅니다.
Event
  bytesLoaded : Number
리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
ProgressEvent
  bytesTotal : Number
로드 프로세스가 완료되면 로드될 총 바이트 수 또는 항목 수입니다.
ProgressEvent
 Inheritedcancelable : Boolean
[읽기 전용] 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.
Event
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
 InheritedcurrentTarget : Object
[읽기 전용] 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
Event
 InheritedeventPhase : uint
[읽기 전용] 이벤트 흐름에서 현재 단계입니다.
Event
 Inheritedtarget : Object
[읽기 전용] 이벤트 대상입니다.
Event
 Inheritedtype : String
[읽기 전용] 이벤트 유형입니다.
Event
공용 메서드
 메서드정의 주체
  
ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0)
진행률 이벤트에 대한 정보가 포함된 Event 객체를 만듭니다.
ProgressEvent
  
[재정의] ProgressEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.
ProgressEvent
 Inherited
formatToString(className:String, ... arguments):String
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.
Event
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.
Event
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.
Event
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
 Inherited
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
 Inherited
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
Object
  
[재정의] ProgressEvent 객체의 속성이 모두 포함된 문자열을 반환합니다.
ProgressEvent
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
공용 상수
 상수정의 주체
  PROGRESS : String = "progress"
[정적] progress 이벤트 객체의 type 속성 값을 정의합니다.
ProgressEvent
  SOCKET_DATA : String = "socketData"
[정적] socketData 이벤트 객체의 type 속성 값을 정의합니다.
ProgressEvent
  STANDARD_ERROR_DATA : String = "standardErrorData"
[정적] standardErrorData 이벤트 객체의 type 속성 값을 정의합니다.
ProgressEvent
  STANDARD_INPUT_PROGRESS : String = "standardInputProgress"
[정적] standardInputProgress 이벤트 객체의 type 속성 값을 정의합니다.
ProgressEvent
  STANDARD_OUTPUT_DATA : String = "standardOutputData"
[정적] standardOutputData 이벤트 객체의 type 속성 값을 정의합니다.
ProgressEvent
속성 세부 정보

bytesLoaded

속성
bytesLoaded:Number

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

리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.



구현
    public function get bytesLoaded():Number
    public function set bytesLoaded(value:Number):void

bytesTotal

속성 
bytesTotal:Number

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

로드 프로세스가 완료되면 로드될 총 바이트 수 또는 항목 수입니다. progress 이벤트가 Socket 객체에 전달되거나 연결되면 생성자의 bytesTotal 매개 변수에 값을 지정하지 않은 경우 bytesTotal은 항상 0입니다. 전송 및 수신되는 실제 바이트 수는 설정되어 있지 않으며 응용 프로그램 개발자가 결정합니다.



구현
    public function get bytesTotal():Number
    public function set bytesTotal(value:Number):void
생성자 세부 정보

ProgressEvent

()생성자
public function ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0)

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

진행률 이벤트에 대한 정보가 포함된 Event 객체를 만듭니다. Event 객체는 매개 변수로 이벤트 리스너에 전달됩니다.

매개 변수
type:String — 이벤트 유형입니다. 다음 값을 사용할 수 있습니다.ProgressEvent.PROGRESS, ProgressEvent.SOCKET_DATA, ProgressEvent.STANDARD_ERROR_DATA, ProgressEvent.STANDARD_INPUT_PROGRESSProgressEvent.STANDARD_OUTPUT_DATA가 있습니다.
 
bubbles:Boolean (default = false) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 결정합니다.
 
cancelable:Boolean (default = false) — Event 객체를 취소할 수 있는지 여부를 결정합니다.
 
bytesLoaded:Number (default = 0) — 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
 
bytesTotal:Number (default = 0) — 로드 프로세스가 완료되면 로드될 총 바이트 수 또는 항목 수입니다.
메서드 세부 정보

clone

()메서드
override public function clone():Event

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

ProgressEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.

반환값
Event — 원본과 동일한 속성 값을 갖는 새 ProgressEvent 객체입니다.

toString

()메서드 
override public function toString():String

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

ProgressEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.

[ProgressEvent type=value bubbles=value cancelable=value bytesLoaded=value bytesTotal=value]

반환값
StringProgressEvent 객체의 속성이 모두 포함된 문자열입니다.
상수 세부 정보

PROGRESS

상수
public static const PROGRESS:String = "progress"

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

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

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

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

관련 API 요소

SOCKET_DATA

상수 
public static const SOCKET_DATA:String = "socketData"

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

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

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

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget현재 이벤트를 처리하고 있는 객체입니다.
bytesLoaded리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
bytesTotal0: 이 속성은 socketData 이벤트 객체에서 사용되지 않습니다.
target진행률을 보고하는 소켓입니다.

관련 API 요소

STANDARD_ERROR_DATA

상수 
public static const STANDARD_ERROR_DATA:String = "standardErrorData"

언어 버전: ActionScript 3.0
런타임 버전: AIR 2, Flash Lite 4

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

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

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget현재 이벤트를 처리하고 있는 객체입니다.
bytesLoaded이 이벤트로 인해 NativeProcessObject.error가 버퍼링하는 오류 데이터의 바이트 수입니다.
bytesTotal0. 이 속성은 standardErrorData 이벤트 객체에서 사용되지 않습니다.
targetNativeProcess 객체 보고 오류 데이터입니다.

관련 API 요소

STANDARD_INPUT_PROGRESS

상수 
public static const STANDARD_INPUT_PROGRESS:String = "standardInputProgress"

언어 버전: ActionScript 3.0
런타임 버전: AIR 2, Flash Lite 4

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

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

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget현재 이벤트를 처리하고 있는 객체입니다.
bytesLoaded이 이벤트로 인해 NativeProcessObject.error가 버퍼링하는 오류 데이터의 바이트 수입니다.
bytesTotal0. 이 속성은 standardInputProgress 이벤트 객체에서 사용되지 않습니다.
targetNativeProcess 객체 보고 오류 데이터입니다.

관련 API 요소

STANDARD_OUTPUT_DATA

상수 
public static const STANDARD_OUTPUT_DATA:String = "standardOutputData"

언어 버전: ActionScript 3.0
런타임 버전: AIR 2, Flash Lite 4

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

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

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget현재 이벤트를 처리하고 있는 객체입니다.
bytesLoaded이 이벤트로 인해 NativeProcessObject.output이 버퍼링하는 출력 데이터의 바이트 수입니다.
bytesTotal0. 이 속성은 standardOutputData 이벤트 객체에서 사용되지 않습니다.
targetNativeProcess 객체 보고 출력 데이터입니다.

관련 API 요소

ProgressEventExample.as

다음 예제에서는 ProgressEventExample 클래스를 사용하여 파일을 다운로드할 때 다양한 이벤트 리스너를 사용하는 방법을 보여 줍니다. 이는 다음 단계로 이루어집니다.
  1. 다운로드 파일의 위치와 이름을 나타내는 downloadURLfileName 속성이 만들어집니다.
  2. ProgressEventExample 생성자에서 file이라는 새 FileReference 객체가 만들어진 후 configureListeners() 메서드로 전달됩니다.
  3. downloadURLfileName 속성이 file.download()로 전달되어 파일을 다운로드할 위치를 묻는 메시지가 표시됩니다.
  4. configureListeners() 메서드에서 다음과 같은 일곱 개의 이벤트 리스너 및 연관된 구독자를 추가합니다.
    1. cancel / cancelHandler()는 파일 다운로드가 취소되면 전달됩니다.
    2. complete / complereHandler()는 다운로드 프로세스가 완료되면 전달됩니다.
    3. ioError / ioErrorHandler()는 다운로드 파일을 사용할 수 없거나 액세스할 수 없는 경우 전달됩니다.
    4. open / openHandler()는 다운로드 작업이 시작되면 전달됩니다.
    5. progress / progressHandler()는 다운로드 프로세스가 시작되면 전달되며, 종료될 때 다시 전달됩니다.
    6. securityError / securityErrorHandler는 로컬 재생 보안 설정이 다운로드 파일의 데이터 액세스 유형과 일치하지 않는 경우(로컬 대 네트워크) 전달됩니다(아래 참고 내용 참조).
    7. select / selectHandler()는 다운로드 객체가 선택되면 전달됩니다.

참고:

  • "로컬 재생 보안"을 "네트워크 파일만 액세스"로 설정하여 SWF 파일을 컴파일해야 합니다.
  • 이 예제를 실행하려면 SomeFile.pdf라는 파일이 있어야 합니다.
  • 이 예제에서는 FileReference 객체에 사용할 수 있는 모든 이벤트를 활용하지만 대부분의 상황에서는 일부만 필요합니다.

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

    public class ProgressEventExample extends Sprite {
        private var downloadURL:String = "http://www.[yourDomain].com/SomeFile.pdf";
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function ProgressEventExample() {
            var request:URLRequest = new URLRequest(downloadURL);
            file = new FileReference();
            configureListeners(file);
            file.download(request, fileName);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
        }

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

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + 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 {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL);
        }
    }
}




[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.