Flash Player 또는 브라우저에서의 스테이지의 배치를 지정하는 StageAlign 클래스의 값입니다. 사용할 수 있는 값은 다음과 같습니다.

align property는, 메인 SWF 파일인 스테이지 소유자와 같은 시큐러티 Sandbox 내에 있는 object에서만 사용할 수 있습니다. 이것을 회피하려면 , 스테이지 소유자가 Security.allowDomain() Methods 또는 Security.alowInsecureDomain() Methods를 호출해 호출원object의 도메인에 허가를 주도록(듯이) 합니다. 상세한 것에 대하여는, 「ActionScript 3.0 의 프로그래밍」의 「Flash Player 시큐러티」의 장을 참조해 주세요.

See also

키보드 포커스를 가지는 인터랙티브 object입니다. 포커스가 설정되어 있지 않은 경우, 또는 포커스가 설정된 object가 호출해 원object로부터 액세스 할 수 없는 시큐러티 Sandbox 에 속하고 있는 경우는 null 가 됩니다.

스테이지의 frame rate를 취득 또는 설정합니다. frame rate의 정의는, 1 초 쯤의 프레임수입니다. 디폴트에서는, frame rate는 최초로 로드 된 SWF 파일의 것으로 설정됩니다. frame rate의 유효 범위는, 1 초 쯤 0.01 에서 1000 프레임입니다.

메모 : 타겟 플랫폼의 프레임 설정이 대응하고 있지 않기 때문에, 또는 Flash Player 가 표시 디바이스의 수직 귀선 시간과의 동기가 잡히지 않기 때문에, Flash Player 로 높은 frame rate를 설정할 수 없는 경우가 있습니다. 수직 귀선 시간은, LCD 디바이스에서는 통상 60 Hz 입니다. CPU 사용율이 높아지는 것이 예상되는 경우, 타겟 플랫폼의 최대 frame rate를 낮게 할 수도 있습니다.

표시 object의 높이를 나타냅니다 (픽셀 단위).

object의 아이에 대해서 마우스가 유효한가 어떤가를 조사합니다. object가 사용 가능한 마우스의 경우, 마우스를 사용해 대화할 수 있습니다. 디폴트치는 true 입니다.

이 property는, SimpleButton 클래스는 아니고, Sprite 클래스의 인스턴스를 사용해 버튼을 작성할 경우에 도움이 됩니다. Sprite 인스턴스를 사용해 버튼을 작성하는 경우, 다른 Sprite 인스턴스를 추가하기 위해서 addChild() Methods를 사용해 버튼의 수식을 선택할 수 있습니다. 아이로서 추가하는 Sprite 인스턴스는, 친인스턴스를 타겟 object로 하는 것을 상정할 경우에, 마우스 이벤트의 타겟 object가 되는 경우가 있기 (위해)때문에, 마우스 이벤트에 대해 예기치 않은 동작을 일으킬 가능성이 있습니다. 친인스턴스가 확실히 마우스 이벤트의 타겟 object가 되도록(듯이) 하려면 , 친인스턴스의 mouseChildren property를 false 로 설정합니다.

이 property를 설정하면, 이벤트는 dispatch되지 않게 됩니다. 인터랙티브인 기능을 작성하려면 ,addEventListener() Methods를 사용할 필요가 있습니다.

이 object의 아이의 수를 돌려줍니다.

Flash Player 가 사용하는 렌더링 품질을 지정하는 StageQuality 클래스의 값입니다. 사용할 수 있는 값은 다음과 같습니다.

• StageQuality.LOW—낮은 렌더링 품질. 그래픽은 에일리어징 제거 처리되지 않고, 비트 맵은 스무딩 되지 않습니다.
• StageQuality.MEDIUM—보통 렌더링 품질. 그래픽은 2 × 2 픽셀 격자를 사용해 에일리어징 제거 처리됩니다만, 비트 맵은 스무딩 되지 않습니다. 이 설정은, 텍스트를 포함하지 않는 무비에 적절하고 있습니다.
• StageQuality.HIGH—높은 렌더링 품질. 그래픽은 4 × 4 픽셀 격자를 사용해 에일리어징 제거 처리됩니다. 비트 맵은, 무비가 정적인 것인 경우는, 스무딩 됩니다. 이것은, Flash Player 가 사용하는 디폴트의 렌더링 품질 설정입니다.
• StageQuality.BEST—매우 높은 렌더링 품질. 그래픽은 4 × 4 픽셀 격자를 사용해 에일리어징 제거 처리되어 비트 맵은 항상 스무딩 됩니다.

See also

사용하는 확대·축소 모드를 지정하는 StageScaleMode 클래스의 값입니다. 사용할 수 있는 값은 다음과 같습니다.

• StageScaleMode.EXACT_FIT— 지정된 영역내에 Flash 어플리케이션 전체가, 어플리케이션의 원의 종횡비를 유지한 채로 비뚤어지지 않고 표시됩니다. 다만, 어플리케이션의 양측으로 경계범위가 표시되는 일이 있습니다.
• StageScaleMode.SHOW_ALL— 지정된 area에 막 들어가도록(듯이) Flash 어플리케이션 전체가 표시됩니다만, 원의 종횡비는 유지되지 않습니다. 일그러짐이 발생하는 경우도 있습니다.
• StageScaleMode.NO_BORDER— 지정된 area 가득 Flash 어플리케이션 전체가 비뚤어지지 않고 표시됩니다. 다만, 어플리케이션의 원의 종횡비를 유지하기 위해서(때문에), 어느 정도 트리밍 되는 일이 있습니다.
• StageScaleMode.NO_SCALE— Flash 어플리케이션의 전체의 크기가 고정되어 플레이어 윈도우의 크기가 변경되었을 경우에서도, 크기가 유지됩니다. 플레이어 윈도우가 컨텐츠보다 작은 경우는, 트리밍 되는 일이 있습니다.

See also

Flash Player 의 context menu에 디폴트의 항목을 표시할지 어떨지를 지정합니다.

showDefaultContextMenu property를 true 로 설정하면, 모든 context menu 항목이 표시됩니다. 이것이 디폴트입니다. showDefaultContextMenu property를 false 로 설정하면, 메뉴 항목으로서 [설정] 및 [Adobe Flash Player 에 대해] 만이 표시됩니다.

object가 포커스를 가지는 경우에 강조 표시된 경계선을 표시할지 어떨지를 지정합니다.

현재의 스테이지의 높이 (픽셀수)입니다.

Stage.scaleMode property의 값이 StageScaleMode.NO_SCALE 로 설정되는 경우,stageHeight property는 Flash Player 윈도우의 높이를 나타냅니다. Stage.scaleMode 의 값이 StageScaleMode.NO_SCALE 로 설정되어 있지 않은 경우, stageHeight 는 SWF 파일의 높이가 됩니다.

See also

스테이지의 현재의 폭을 픽셀 단위로 지정합니다.

scaleMode property의 값이 StageScaleMode.NO_SCALE 로 설정되는 경우,stageWidth property는 Flash Player 의 폭을 나타냅니다. 이것은, Flash Player 윈도우의 크기를 변경하는 것에 응해 stageWidth property가 여러가지로 변화하는 것을 의미합니다. scaleMode property의 값이 StageScaleMode.NO_SCALE 이외에 설정되어 있는 경우,stageWidth property는 오쏘링시에 [문서 property] 다이알로그 박스로 설정한 SWF 파일의 폭을 나타냅니다. 즉, Flash Player 의 윈도우의 크기를 변경해도 stageWidth property의 값은 일정입니다.

See also

object의 아이에 대해서 탭이 유효한가 어떤가를 조사합니다. object의 아이에 대해서 탭을 유효 또는 무효로 합니다.

이 DisplayObjectContainer 인스턴스의 TextSnapshot object를 돌려줍니다.

표시 object의 폭을 나타냅니다 (픽셀 단위).

이 DisplayObjectContainer 인스턴스에 child DisplayObject 인스턴스를 추가합니다. child 인스턴스는, 이 DisplayObjectContainer 인스턴스에 있는 다른 모든 아이의 앞 (위)에 추가됩니다. 특정의 인덱스 위치에 아이를 추가하는 경우는,addChildAt() Methods를 사용합니다.

이미 다른 표시 object 컨테이너를 부모에게 가지는 child object를 추가하는 경우는, 이제(벌써) 한편 display object 컨테이너의 child 리스트로부터 그 object가 삭제됩니다.

See also

이 DisplayObjectContainer 인스턴스에 child DisplayObject 인스턴스를 추가합니다. child 인스턴스는, 지정된 인덱스 위치에 추가됩니다. 인덱스 0 은, 이 DisplayObjectContainer object 보기 리스트의 배경 또는 맨 밑을 나타냅니다.

예를 들어, a, b, d 라고 하는 label의 3 개 display object를 인덱스 위치 0, 2, 1 에 각각 배치하면, 이하와 같이 됩니다.

이미 다른 표시 object 컨테이너를 부모에게 가지는 child object를 추가하는 경우는, 이제(벌써) 한편 display object 컨테이너의 child 리스트로부터 그 object가 삭제됩니다.

See also

event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다. event listener는, 특정의 타입의 이벤트, 단계, 및 우선도에 관한 표시 리스트내의 모든 노드에 등록할 수 있습니다.

event listener가 정상적으로 등록된 후에,addEventListener() 를 한층 더 호출해 우선도를 변경할 수 없습니다. listener의 우선도를 변경하려면 , 최초로 removeListener() 를 호출할 필요가 있습니다. 그 후, 같은 listener를 새로운 우선도 레벨로 재차 등록할 수 있습니다.

listener가 등록된 후에,type 또는 useCapture 에 다른 값을 설정해 재차 addEventListener() 를 호출하면, 다른 listener 등록이 작성되는 것에 주의해 주세요. 예를 들어, 최초로 listener를 등록할 경우에 useCapture 를 true 로 설정하면, 그 listener는 capther 단계만으로 리스닝 합니다. useCapture 에 false 를 설정해, 같은 listener objects를 사용해 재차 addEventListener() 를 호출하면, 다른 2 살의 listener가 등록됩니다. 1 개은 capther 단계에서 리스닝 하는 listener로, 이제(벌써) 1 개은 타겟 단계와 바브 링 단계에서 리스닝 하는 listener입니다.

타겟 단계 또는 바브 링 단계만을 대상으로 하는 event listener를 등록할 수 없습니다. 등록시에 이러한 단계가 짜 합쳐지는 것은, 바브 링은 타겟 노드의 조상 밖에 적용되지 않기 때문입니다.

event listener가 불필요하게 되었을 경우는,removeEventListener() 를 호출해, event listener를 삭제합니다. 삭제하지 않는 경우, 메모리의 문제가 발생할 가능성이 있습니다. 가베지 컬렉터는 참조를 가지는 object를 삭제하지 않기 때문에, 등록되어 있는 event listener에 관계한 object는 메모리로부터 자동적으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도, 거기에 관련지을 수 있고 있는 event listener는 복사되지 않습니다. 새롭게 작성한 노드에 event listener가 필요한 경우는, 노드를 작성한 후에, listener를 관련지을 필요가 있습니다. 다만, EventDispatcher 인스턴스를 이동했을 경우는, 관련지을 수 있고 있는 event listener도 함께 이동됩니다.

이벤트가 노드로 처리될 때, event listener가 그 노드에 등록중이면, event listener는 현재의 단계에서는 방아쇠 되지 않습니다. 다만, 바브 링 단계 등, event 플로우(flow)의 뒤의 단계에서 방아쇠 할 수가 있습니다.

이벤트가 노드로 처리되고 있을 때 event listener가 노드로부터 삭제되었을 경우에서도, 이벤트는 현재의 액션에 의해 방아쇠 됩니다. 삭제된 후는, 그 후의 처리로 다시 등록되지 않는 이상 event listener는 두 번 다시 불려 가지 않습니다.

See also

이벤트를 event 플로우(flow)에 dispatch합니다. event 타겟은 EventDispatcher object입니다. 이것에 대해서 dispatchEvent() Methods가 불려 갑니다.

EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다. 이것에 의해, EventDispatcher object가 event 타입의 처리를 event 플로우(flow) 계층의 어디서 변경했는지를 판단할 수 있습니다. 특정의 event 타입이 실제로 event listener를 방아쇠 할지 어떨지를 판별하려면 ,willTrigger() 를 사용합니다.

hasEventListener() 와 willTrigger() 의 차이는,hasEventListener() 에서는 자신이 속하는 object만 검증되어willTrigger() 에서는 type Parameters로 지정된 이벤트의 event 플로우(flow) 전체가 검증되는 것입니다.

hasEventListener() 가 LoaderInfo object로부터 불려 갔을 경우는, 호출측을 액세스 할 수 있는 listener만 고려됩니다.

invalidate() Methods는, 표시 리스트를 렌더링 할 필요가 있는 다음의 기회에, 표시 object에 경고하도록(듯이) Flash Player 에 통지합니다. 예를 들어, 재생 헤드를 새로운 프레임에 진행하는 경우 등입니다. invalidate() Methods를 호출하면, 표시 리스트가 다음에 렌더링 될 때,render 이벤트를 받도록(듯이) 등록되어 있는 각 표시 object에 대해서, Flash Player 로부터 render 이벤트가 dispatch됩니다. Flash Player 에 render 이벤트를 dispatch시키고 싶은 경우에는, 그때마다 invalidate() Methods를 호출할 필요가 있습니다.

render 이벤트에 의해, 실제로 표시되기 직전에 표시 리스트로 변경을 더할 수가 있습니다. 이렇게 하는 것으로, 표시 리스트에의 갱신을 끝까지 늦추는 것이 가능합니다. 이 방법에서는, 화면의 갱신을 불필요하게 실시하지 않아 좋기 때문에, 퍼포먼스를 향상시킬 수가 있습니다.

render 이벤트는,stage.invalidate() Methods를 호출하는 코드와 같은 시큐러티 도메인내 display object, 또는 Security.allowDomain() Methods로 허가가 주어지고 있는 시큐러티 도메인 display object 에 대해서만, dispatch됩니다.

See also

Stage.focus property가 시큐러티상의 이유로써 null 를 돌려줄지 어떨지를 결정합니다. 즉, 포커스를 가지는 object가, SWF 파일이 액세스 할 수 없는 시큐러티 Sandbox 에 속하고 있는 경우,isFocusInaccessible 는 true 를 돌려줍니다.

DisplayObjectContainer 의 child 리스트의 지정된 index 위치로부터 child DisplayObject 를 삭제합니다. 삭제된 아이의 parent property는 null 로 설정됩니다. 그 아이에 대한 참조가 존재하지 않는 경우, 그 object는 가베지 콜렉션에 의해 수집됩니다. DisplayObjectContainer 의 아이보다 상위에 있는 표시 object의 인덱스 위치는 1 개 내립니다.

가베지 컬렉터란, Flash Player 가 미사용의 메모리 스페이스를 재할인 맞히고 하는 처리입니다. 변수 또는 object가 액티브하게 참조되지 않게 되어, 임의의 장소에 보존되어 있지 않은 경우, 가베지 컬렉터에 의해 메모리내가 탐색되어 그것들에 대한 참조가 존재하지 않으면 메모리 스페이스를 점유 하고 있는 변수 또는 object가 일소 됩니다.

표시 object 컨테이너의 기존의 아이의 위치를 변경합니다. 이것은, child object의 layer에 영향을 줍니다. 예를 들어, a, b, c 라고 하는 label의 3 개 display object를 인덱스 위치 0, 1, 2 에 각각 배치하면, 이하와 같이 됩니다.

setChildIndex() Methods를 사용해, 벌써 사용되고 있는 인덱스 위치를 지정하는 경우, 그 위치를 사용하고 있는 아이와 child 리스트로 그 아이보다 상위에 있는 모든 object는, 리스트상의 위치가 1 개 오릅니다. 예를 들어, 상기의 View the examples object 컨테이너의 이름이 container 인 경우, 다음에 나타내는 코드를 호출하는 것에 의해, a 및 b 라고 하는 label를 붙일 수 있었던 표시 object의 위치를 바꿔 넣을 수가 있습니다.

container.setChildIndex(container.getChildAt(1), 0);

이 코드에 의해, 다음에 나타내는 것 같은 object의 배치가 됩니다.

아이 리스트내의 지정된 인덱스 위치에 해당하는 2 살의 child object의 z 순서 (겹침순서)를 바꿔 넣습니다. 표시 object 컨테이너의 다른 모든 child object는, 같은 인덱스 위치에 남겨집니다.

지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다. 지정된 타입의 이벤트가 이 EventDispatcher object 또는 그 자손에게 dispatch되었을 때에, event listener가 event 플로우(flow)의 임의의 단계에서 방아쇠 되는 경우, 이 Methods는 true 를 돌려줍니다.

hasEventListener() Methods와 willTrigger() Methods의 차이는,hasEventListener() 에서는 자신이 속하는 object만 검증되어willTrigger() Methods에서는 type Parameters로 지정된 이벤트의 event 플로우(flow) 전체가 검증되는 것입니다.

willTrigger() 가 LoaderInfo object로부터 불려 갔을 경우는, 호출측을 액세스 할 수 있는 listener만 고려됩니다.

마우스 포인터가 Flash Player 의 윈도우 영역으로부터 멀어졌을 때에, Stage object에 의해 dispatch됩니다.

mouseLeave event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

Stage object의 scaleMode property가 StageScaleMode.NO_SCALE 로 설정되어 SWF 파일의 크기가 변경되었을 때에 dispatch됩니다.

resize event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

1. 최초로 클래스 constructor　 　 은, Flash Player 의 윈도우의 크기에 관계없이, 고정하는 Flash 어플리케이션을 설정해, 그 후 activateHandler() Methods 및 resizeHandler() Methods를 사용해 2 개의 event listener를 추가합니다.
2. 마우스의 왼쪽 버튼을 클릭하면,activateHandler() Methods가 실행됩니다.
3. 스테이지의 크기를 변경하면,resizeHandler() Methods가 실행됩니다.

package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.Event;

    public class StageExample extends Sprite {

        public function StageExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            stage.addEventListener(Event.ACTIVATE, activateHandler);
            stage.addEventListener(Event.RESIZE, resizeHandler);
        }

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

        private function resizeHandler(event:Event) :void {
            trace("resizeHandler: " + event);
            trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight);
        }
    }
}