패키지 | mx.preloaders |
클래스 | public class SparkDownloadProgressBar |
상속 | SparkDownloadProgressBar Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
구현 | IPreloaderDisplay |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The download progress bar displays information about two different phases of the application: the download phase and the initialization phase.
In the Application container, use the
the preloader
property to specify the name of your subclass.
You can implement a custom download progress bar component by creating a subclass of the SparkDownloadProgressBar class. Do not implement a download progress bar as an MXML component because it loads too slowly.
기타 예제
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
이 InteractiveObject 인스턴스에 대한 현재 액세스 가능성 구현(AccessibilityImplementation)입니다. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
이 표시 객체의 현재 액세스 가능성 옵션입니다. | DisplayObject | ||
alpha : Number
지정된 객체의 알파 투명도 값을 나타냅니다. | DisplayObject | ||
backgroundAlpha : Number
Alpha level of the SWF file or image defined by
the backgroundImage property, or the color defined by
the backgroundColor property. | SparkDownloadProgressBar | ||
backgroundColor : uint
Background color of a download progress bar. | SparkDownloadProgressBar | ||
backgroundImage : Object
The background image of the application,
which is passed in by the preloader. | SparkDownloadProgressBar | ||
backgroundSize : String
Scales the image specified by backgroundImage
to different percentage sizes. | SparkDownloadProgressBar | ||
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 | ||
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 | ||
preloader : Sprite [쓰기 전용]
The Preloader class passes in a reference to itself to the display class
so that it can listen for events from the preloader. | SparkDownloadProgressBar | ||
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 | ||
stageHeight : Number
The height of the stage,
which is passed in by the Preloader class. | SparkDownloadProgressBar | ||
stageWidth : Number
The width of the stage,
which is passed in by the Preloader class. | SparkDownloadProgressBar | ||
tabChildren : Boolean
객체의 자식에서 탭 기능을 사용할 수 있는지 여부를 결정합니다. | DisplayObjectContainer | ||
tabEnabled : Boolean
이 객체가 탭 순서에 있는지 여부를 지정합니다. | InteractiveObject | ||
tabIndex : int
SWF 파일에서 객체의 탭 순서를 지정합니다. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [읽기 전용]
이 DisplayObjectContainer 인스턴스에 대한 TextSnapshot 객체를 반환합니다. | DisplayObjectContainer | ||
transform : flash.geom:Transform
표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다. | DisplayObject | ||
useHandCursor : Boolean
buttonMode 속성이 true로 설정된 스프라이트 위로 포인터를 움직일 때 손 모양(손 모양 커서)을 표시할지 여부를 나타내는 부울 값입니다. | Sprite | ||
visible : Boolean [재정의]
Specifies whether the download progress bar is visible. | SparkDownloadProgressBar | ||
width : Number
표시 객체의 폭을 픽셀 단위로 나타냅니다. | DisplayObject | ||
x : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 x 좌표를 나타냅니다. | DisplayObject | ||
y : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 y 좌표를 나타냅니다. | DisplayObject | ||
z : Number
3D parent 컨테이너를 기준으로 DisplayObject 인스턴스의 z축에 있는 z 좌표 위치를 나타냅니다. | DisplayObject |
속성 | 정의 주체 | ||
---|---|---|---|
initProgressTotal : uint = 6
The total number of validation events you expect to get
in the initializing phase. | SparkDownloadProgressBar |
메서드 | 정의 주체 | ||
---|---|---|---|
Constructor. | SparkDownloadProgressBar | ||
이 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 | ||
지정된 표시 객체가 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 | ||
Called by the Preloader after the download progress bar
has been added as a child of the Preloader. | SparkDownloadProgressBar | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
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 | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
메서드 | 정의 주체 | ||
---|---|---|---|
Event listener for the Event.COMPLETE event. | SparkDownloadProgressBar | ||
Creates the subcomponents of the display. | SparkDownloadProgressBar | ||
Event listener for the FlexEvent.INIT_COMPLETE event. | SparkDownloadProgressBar | ||
Event listener for the FlexEvent.INIT_PROGRESS event. | SparkDownloadProgressBar | ||
Event listener for the ProgressEvent.PROGRESS event. | SparkDownloadProgressBar | ||
Event listener for the RSLEvent.RSL_COMPLETE event. | SparkDownloadProgressBar | ||
Event listener for the RSLEvent.RSL_ERROR event. | SparkDownloadProgressBar | ||
Event listener for the RSLEvent.RSL_PROGRESS event. | SparkDownloadProgressBar | ||
Updates the outer portion of the download progress bar to
indicate download progress. | SparkDownloadProgressBar | ||
Updates the inner portion of the download progress bar to
indicate initialization progress. | SparkDownloadProgressBar | ||
Defines the algorithm for determining whether to show
the download progress bar while in the download phase. | SparkDownloadProgressBar | ||
Defines the algorithm for determining whether to show the download progress bar
while in the initialization phase, assuming that the display
is not currently visible. | SparkDownloadProgressBar |
backgroundAlpha | 속성 |
backgroundAlpha:Number
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Alpha level of the SWF file or image defined by
the backgroundImage
property, or the color defined by
the backgroundColor
property.
Valid values range from 0 to 1.0.
Override this property to set your own value in a custom class.
You can specify either a backgroundColor
or a backgroundImage
, but not both.
기본값: 1.0.
구현
public function get backgroundAlpha():Number
public function set backgroundAlpha(value:Number):void
backgroundColor | 속성 |
backgroundColor:uint
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Background color of a download progress bar. Override this property to set your own value in a custom class.
You can specify either a backgroundColor
or a backgroundImage
, but not both.
구현
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
backgroundImage | 속성 |
backgroundImage:Object
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The background image of the application, which is passed in by the preloader. Override this property to set your own value in a custom class.
You can specify either a backgroundColor
or a backgroundImage
, but not both.
A value of null means "not set".
If this style and the backgroundColor
style are undefined,
the component has a transparent background.
The preloader does not display embedded images. You can only use images loaded at runtime.
기본값: null.
구현
public function get backgroundImage():Object
public function set backgroundImage(value:Object):void
backgroundSize | 속성 |
backgroundSize:String
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Scales the image specified by backgroundImage
to different percentage sizes.
A value of "100%"
stretches the image
to fit the entire component.
To specify a percentage value, you must include the percent sign (%).
A value of "auto"
, maintains
the original size of the image.
기본값: "auto".
구현
public function get backgroundSize():String
public function set backgroundSize(value:String):void
initProgressTotal | 속성 |
protected var initProgressTotal:uint = 6
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The total number of validation events you expect to get in the initializing phase. This should be an integer greater or equal to 4 (and note that if it is greater than 4 you might have an inefficiency in your initialization code)
기본값: 6.
preloader | 속성 |
stageHeight | 속성 |
stageWidth | 속성 |
visible | 속성 |
visible:Boolean
[재정의] 언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Specifies whether the download progress bar is visible.
When the Preloader control determines that the progress bar should be displayed,
it sets this value to true
. When the Preloader control determines that
the progress bar should be hidden, it sets the value to false
.
A subclass of the SparkDownloadProgressBar class should never modify this property. Instead, you can override the setter method to recognize when the Preloader control modifies it, and perform any necessary actions.
기본값: false.
구현
override public function get visible():Boolean
override public function set visible(value:Boolean):void
SparkDownloadProgressBar | () | 생성자 |
public function SparkDownloadProgressBar()
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Constructor.
completeHandler | () | 메서드 |
createChildren | () | 메서드 |
protected function createChildren():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Creates the subcomponents of the display.
initCompleteHandler | () | 메서드 |
initialize | () | 메서드 |
public function initialize():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Called by the Preloader after the download progress bar has been added as a child of the Preloader. This should be the starting point for configuring your download progress bar.
initProgressHandler | () | 메서드 |
progressHandler | () | 메서드 |
protected function progressHandler(event:ProgressEvent):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Event listener for the ProgressEvent.PROGRESS
event.
This implementation updates the progress bar
with the percentage of bytes downloaded.
매개 변수
event:ProgressEvent — The event object.
|
rslCompleteHandler | () | 메서드 |
rslErrorHandler | () | 메서드 |
rslProgressHandler | () | 메서드 |
setDownloadProgress | () | 메서드 |
protected function setDownloadProgress(completed:Number, total:Number):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Updates the outer portion of the download progress bar to indicate download progress.
매개 변수
completed:Number — Number of bytes of the application SWF file
that have been downloaded.
| |
total:Number — Size of the application SWF file in bytes.
|
setInitProgress | () | 메서드 |
protected function setInitProgress(completed:Number, total:Number):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Updates the inner portion of the download progress bar to indicate initialization progress.
매개 변수
completed:Number — Number of initialization steps that
have been completed
| |
total:Number — Total number of initialization steps
|
showDisplayForDownloading | () | 메서드 |
protected function showDisplayForDownloading(elapsedTime:int, event:ProgressEvent):Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Defines the algorithm for determining whether to show the download progress bar while in the download phase.
매개 변수
elapsedTime:int — Number of milliseconds that have elapsed
since the start of the download phase.
| |
event:ProgressEvent — The ProgressEvent object that contains
the bytesLoaded and bytesTotal properties.
|
Boolean — If the return value is true , then show the
download progress bar.
The default behavior is to show the download progress bar
if more than 700 milliseconds have elapsed
and if Flex has downloaded less than half of the bytes of the SWF file.
|
showDisplayForInit | () | 메서드 |
protected function showDisplayForInit(elapsedTime:int, count:int):Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Defines the algorithm for determining whether to show the download progress bar while in the initialization phase, assuming that the display is not currently visible.
매개 변수
elapsedTime:int — Number of milliseconds that have elapsed
since the start of the download phase.
| |
count:int — number of times that the initProgress event
has been received from the application.
|
Boolean — If true , then show the download progress bar.
|
Tue Jun 12 2018, 03:17 PM Z