패키지 | flash.events |
클래스 | public class ProgressEvent |
상속 | ProgressEvent Event Object |
하위 클래스 | ModuleEvent, ResourceEvent, RSLEvent, StyleEvent, VideoProgressEvent |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
ProgressEvent.PROGRESS
유형과 ProgressEvent.SOCKET_DATA
유형이 있습니다. 또한 AIR ProgressEvent에서의 객체는 NativeProcess 클래스를 사용하여 데이터가 하위 프로세스로 들어가거나 나올 때 전달됩니다.
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
bubbles : Boolean [읽기 전용]
이벤트가 버블링 이벤트인지 여부를 나타냅니다. | Event | ||
bytesLoaded : Number
리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다. | ProgressEvent | ||
bytesTotal : Number
로드 프로세스가 완료되면 로드될 총 바이트 수 또는 항목 수입니다. | ProgressEvent | ||
cancelable : Boolean [읽기 전용]
해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다. | Event | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
currentTarget : Object [읽기 전용]
이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. | Event | ||
eventPhase : uint [읽기 전용]
이벤트 흐름에서 현재 단계입니다. | Event | ||
target : Object [읽기 전용]
이벤트 대상입니다. | Event | ||
type : String [읽기 전용]
이벤트 유형입니다. | Event |
메서드 | 정의 주체 | ||
---|---|---|---|
ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0)
진행률 이벤트에 대한 정보가 포함된 Event 객체를 만듭니다. | ProgressEvent | ||
[재정의]
ProgressEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다. | ProgressEvent | ||
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다. | Event | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다. | Event | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다. | Event | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | ||
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
[재정의]
ProgressEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. | ProgressEvent | ||
지정된 객체의 프리미티브 값을 반환합니다. | 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 | 속성 |
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_PROGRESS 및 ProgressEvent.STANDARD_OUTPUT_DATA 가 있습니다.
| |
bubbles:Boolean (default = false ) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 결정합니다.
| |
cancelable:Boolean (default = false ) — Event 객체를 취소할 수 있는지 여부를 결정합니다.
| |
bytesLoaded:Number (default = 0 ) — 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
| |
bytesTotal:Number (default = 0 ) — 로드 프로세스가 완료되면 로드될 총 바이트 수 또는 항목 수입니다.
|
clone | () | 메서드 |
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]
String — ProgressEvent 객체의 속성이 모두 포함된 문자열입니다.
|
PROGRESS | 상수 |
public static const PROGRESS:String = "progress"
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
progress
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
bytesLoaded | 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다. |
bytesTotal | 로드 프로세스가 완료되면 최종적으로 로드될 총 바이트 수 또는 항목 수입니다. |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
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
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 현재 이벤트를 처리하고 있는 객체입니다. |
bytesLoaded | 리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다. |
bytesTotal | 0: 이 속성은 socketData 이벤트 객체에서 사용되지 않습니다. |
target | 진행률을 보고하는 소켓입니다. |
관련 API 요소
STANDARD_ERROR_DATA | 상수 |
public static const STANDARD_ERROR_DATA:String = "standardErrorData"
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2, Flash Lite 4 |
standardErrorData
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 현재 이벤트를 처리하고 있는 객체입니다. |
bytesLoaded | 이 이벤트로 인해 NativeProcessObject.error가 버퍼링하는 오류 데이터의 바이트 수입니다. |
bytesTotal | 0. 이 속성은 standardErrorData 이벤트 객체에서 사용되지 않습니다. |
target | NativeProcess 객체 보고 오류 데이터입니다. |
관련 API 요소
STANDARD_INPUT_PROGRESS | 상수 |
public static const STANDARD_INPUT_PROGRESS:String = "standardInputProgress"
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2, Flash Lite 4 |
standardInputProgress
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 현재 이벤트를 처리하고 있는 객체입니다. |
bytesLoaded | 이 이벤트로 인해 NativeProcessObject.error가 버퍼링하는 오류 데이터의 바이트 수입니다. |
bytesTotal | 0. 이 속성은 standardInputProgress 이벤트 객체에서 사용되지 않습니다. |
target | NativeProcess 객체 보고 오류 데이터입니다. |
관련 API 요소
STANDARD_OUTPUT_DATA | 상수 |
public static const STANDARD_OUTPUT_DATA:String = "standardOutputData"
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2, Flash Lite 4 |
standardOutputData
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 현재 이벤트를 처리하고 있는 객체입니다. |
bytesLoaded | 이 이벤트로 인해 NativeProcessObject.output이 버퍼링하는 출력 데이터의 바이트 수입니다. |
bytesTotal | 0. 이 속성은 standardOutputData 이벤트 객체에서 사용되지 않습니다. |
target | NativeProcess 객체 보고 출력 데이터입니다. |
관련 API 요소
ProgressEventExample
클래스를 사용하여 파일을 다운로드할 때 다양한 이벤트 리스너를 사용하는 방법을 보여 줍니다. 이는 다음 단계로 이루어집니다.
- 다운로드 파일의 위치와 이름을 나타내는
downloadURL
및fileName
속성이 만들어집니다. ProgressEventExample
생성자에서file
이라는 새 FileReference 객체가 만들어진 후configureListeners()
메서드로 전달됩니다.downloadURL
및fileName
속성이file.download()
로 전달되어 파일을 다운로드할 위치를 묻는 메시지가 표시됩니다.configureListeners()
메서드에서 다음과 같은 일곱 개의 이벤트 리스너 및 연관된 구독자를 추가합니다.cancel
/cancelHandler()
는 파일 다운로드가 취소되면 전달됩니다.complete
/complereHandler()
는 다운로드 프로세스가 완료되면 전달됩니다.ioError
/ioErrorHandler()
는 다운로드 파일을 사용할 수 없거나 액세스할 수 없는 경우 전달됩니다.open
/openHandler()
는 다운로드 작업이 시작되면 전달됩니다.progress
/progressHandler()
는 다운로드 프로세스가 시작되면 전달되며, 종료될 때 다시 전달됩니다.securityError
/securityErrorHandler
는 로컬 재생 보안 설정이 다운로드 파일의 데이터 액세스 유형과 일치하지 않는 경우(로컬 대 네트워크) 전달됩니다(아래 참고 내용 참조).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); } } }
Tue Jun 12 2018, 03:17 PM Z