패키지flash.display
클래스public class SimpleButton
상속SimpleButton Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

SimpleButton 클래스를 사용하여 SWF 파일에 있는 버튼 심볼의 모든 인스턴스를 제어할 수 있습니다. 제작 도구에서 버튼 인스턴스를 만든 후 SimpleButton 클래스의 메서드와 속성을 사용하여 ActionScript에서 버튼을 조작할 수 있습니다.

속성 관리자에서 버튼에 인스턴스 이름을 부여할 수 있습니다. SimpleButton 인스턴스 이름은 무비 탐색기 및 액션 패널의 대상 경로 삽입 대화 상자에 표시됩니다.

ActionScript 3.0에서는 new SimpleButton() 생성자를 사용하여 SimpleButton 인스턴스를 만들 수 있습니다.

SimpleButton 클래스는 InteractiveObject 클래스에서 상속됩니다.

예제를 통해 확인하십시오.

참고 사항

InteractiveObject class
기본 표시 클래스


Public 속성
 속성다음에 의해 정의됨
 InheritedaccessibilityProperties : AccessibilityProperties
이 표시 객체의 현재 액세스 가능성 옵션입니다.
DisplayObject
 Inheritedalpha : Number
지정된 객체의 알파 투명도 값을 나타냅니다.
DisplayObject
 InheritedblendMode : String
사용할 블렌드 모드를 지정하는 BlendMode 클래스 값입니다.
DisplayObject
 InheritedcacheAsBitmap : Boolean
true로 설정된 경우, Flash Player는 표시 객체의 내부 비트맵 표현을 캐시합니다.
DisplayObject
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
 InheritedcontextMenu : ContextMenu
이 객체에 연결된 컨텍스트 메뉴를 지정합니다.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
이 객체에서 doubleClick 이벤트를 받을지 여부를 지정합니다.
InteractiveObject
  downState : DisplayObject
hitTestState 객체를 클릭했을 때의 상태인 버튼 "다운" 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.
SimpleButton
  enabled : Boolean
버튼의 활성 여부를 지정하는 부울 값입니다.
SimpleButton
 Inheritedfilters : Array
현재 표시 객체와 연관된 각 필터 객체가 들어 있는 인덱싱된 배열입니다.
DisplayObject
 InheritedfocusRect : Object
이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다.
InteractiveObject
 Inheritedheight : Number
표시 객체의 높이를 픽셀 단위로 나타냅니다.
DisplayObject
  hitTestState : DisplayObject
버튼의 히트 테스트 객체로 사용할 표시 객체를 지정합니다.
SimpleButton
 InheritedloaderInfo : LoaderInfo
[read-only] 이 표시 객체가 속한 파일의 로딩 정보가 포함된 LoaderInfo 객체를 반환합니다.
DisplayObject
 Inheritedmask : DisplayObject
호출하는 표시 객체는 지정된 mask 객체에 의해 마스크 처리됩니다.
DisplayObject
 InheritedmouseEnabled : Boolean
이 객체에서 마우스 메시지를 받을지 여부를 지정합니다.
InteractiveObject
 InheritedmouseX : Number
[read-only] 마우스 위치의 x 좌표를 픽셀 단위로 나타냅니다.
DisplayObject
 InheritedmouseY : Number
[read-only] 마우스 위치의 y 좌표를 픽셀 단위로 나타냅니다.
DisplayObject
 Inheritedname : String
DisplayObject의 인스턴스 이름을 나타냅니다.
DisplayObject
 InheritedopaqueBackground : Object
표시 객체를 특정 배경색으로 불투명하게 처리할지 여부를 지정합니다.
DisplayObject
  overState : DisplayObject
버튼 위에 마우스를 놓았을 때의 상태인 버튼 오버 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.
SimpleButton
 Inheritedparent : DisplayObjectContainer
[read-only] 이 표시 객체가 포함된 DisplayObjectContainer 객체를 나타냅니다.
DisplayObject
 Inheritedprototype : Object
[static] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
 Inheritedroot : DisplayObject
[read-only] 로드된 SWF 파일에 있는 표시 객체의 경우, 해당 SWF 파일이 나타내는 표시 목록의 트리 구조 부분에서 맨 위에 위치하는 표시 객체가 루트 속성이 됩니다.
DisplayObject
 Inheritedrotation : Number
DisplayObject 인스턴스가 원점으로부터 회전한 각도입니다.
DisplayObject
 Inheritedscale9Grid : Rectangle
현재 적용 중인 크기 조절 격자입니다.
DisplayObject
 InheritedscaleX : Number
등록 포인트에서 적용된 객체의 가로 크기(percentage)를 나타냅니다.
DisplayObject
 InheritedscaleY : Number
객체의 등록 포인트에서 적용된 객체의 세로 크기(percentage)를 나타냅니다.
DisplayObject
 InheritedscrollRect : Rectangle
표시 객체의 스크롤 사각형 경계입니다.
DisplayObject
  soundTransform : SoundTransform
이 버튼에 할당된 SoundTransform 객체입니다.
SimpleButton
 Inheritedstage : Stage
[read-only] 표시 객체의 Stage입니다.
DisplayObject
 InheritedtabEnabled : Boolean
이 객체가 탭 순서에 있는지 여부를 지정합니다.
InteractiveObject
 InheritedtabIndex : int
SWF 파일에서 객체의 탭 순서를 지정합니다.
InteractiveObject
  trackAsMenu : Boolean
SimpleButton 또는 MovieClip 등의 다른 표시 객체에서 마우스 놓기 이벤트를 수신할 수 있는지 여부를 나타냅니다.
SimpleButton
 Inheritedtransform : Transform
표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다.
DisplayObject
  upState : DisplayObject
버튼 위에 마우스를 놓지 않았을 때의 상태인 버튼 업 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.
SimpleButton
  useHandCursor : Boolean
true로 설정된 경우 버튼 위로 마우스를 가져가면 Flash Player에 손 모양의 커서가 표시되도록 하는 부울 값입니다.
SimpleButton
 Inheritedvisible : Boolean
표시 객체가 표시되는지 여부를 나타냅니다.
DisplayObject
 Inheritedwidth : Number
표시 객체의 폭을 픽셀 단위로 나타냅니다.
DisplayObject
 Inheritedx : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 x 좌표를 나타냅니다.
DisplayObject
 Inheritedy : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 y 좌표를 나타냅니다.
DisplayObject
Public 메서드
 메서드다음에 의해 정의됨
  
SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)
새 SimpleButton 인스턴스를 만듭니다.
SimpleButton
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
 Inherited
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace 객체의 좌표계를 기준으로 표시 객체의 영역을 정의하는 사각형을 반환합니다.
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
대상 좌표 공간 매개 변수에 의해 정의되는 좌표계를 기준으로 모양의 획을 제외하고 표시 객체의 경계를 정의하는 사각형을 반환합니다.
DisplayObject
 Inherited
Point 객체를 Stage 전역 좌표에서 표시 객체의 로컬 좌표로 변환합니다.
DisplayObject
 Inherited
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
표시 객체를 평가하여 표시 객체와 겹치거나 교차하는지 확인합니다.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
표시 객체를 평가하여 x 및 y 매개 변수에 의해 지정된 점과 겹치거나 교차하는지 확인합니다.
DisplayObject
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
Point 객체를 표시 객체의 로컬 좌표에서 Stage 전역 좌표로 변환합니다.
DisplayObject
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited Flash Player가 운영 체제에서 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
 Inherited 표시 객체를 표시 목록에 추가할 때 전달됩니다.DisplayObject
 Inherited 표시 객체가 포함된 하위 트리를 추가하거나 또는 표시 객체를 스테이지 표시 목록에 직접 추가할 때 전달됩니다.DisplayObject
 Inherited 사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 기본 버튼을 눌렀다 놓을 때 전달됩니다.InteractiveObject
 Inherited Flash Player가 운영 체제에서 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
 Inherited 객체의 doubleClickEnabled 플래그가 true로 설정되어 있는 경우 사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 기본 버튼을 연속으로 빠르게 두 번 눌렀다 놓을 때 전달됩니다.InteractiveObject
 Inherited 재생 헤드가 새 프레임에 들어갈 때 전달됩니다.DisplayObject
 Inherited 표시 객체가 포커스를 얻은 후 전달됩니다.InteractiveObject
 Inherited 표시 객체가 포커스를 잃은 후 전달됩니다.InteractiveObject
 Inherited 사용자가 키를 누를 때 전달됩니다.InteractiveObject
 Inherited 사용자가 키보드를 사용하여 포커스를 바꾸려고 할 때 전달됩니다.InteractiveObject
 Inherited 사용자가 키를 놓을 때 전달됩니다.InteractiveObject
 Inherited Flash Player 윈도우에서 InteractiveObject 인스턴스 위에서 포인팅 장치 버튼을 누를 때 전달됩니다.InteractiveObject
 Inherited 사용자가 포인팅 장치를 사용하여 포커스를 바꾸려고 할 때 전달됩니다.InteractiveObject
 Inherited 포인팅 장치가 InteractiveObject 위에 있을 때 포인팅 장치를 움직이면 전달됩니다.InteractiveObject
 Inherited 포인팅 장치를 InteractiveObject 인스턴스에서 멀리 하면 전달됩니다.InteractiveObject
 Inherited Flash Player 윈도우에서 InteractiveObject 인스턴스 위로 포인팅 장치를 옮길 때 전달됩니다.InteractiveObject
 Inherited Flash Player 윈도우에서 InteractiveObject 인스턴스 위에서 포인팅 장치 버튼을 놓을 때 전달됩니다.InteractiveObject
 Inherited Flash Player 윈도우에서 InteractiveObject 인스턴스 위에 마우스를 놓고 휠을 굴릴 때 전달됩니다.InteractiveObject
 Inherited 표시 객체를 표시 목록에서 제거하려 할 때 전달됩니다.DisplayObject
 Inherited 표시 객체가 포함된 하위 트리를 제거하거나 표시 객체가 스테이지 표시 목록에서 직접 제거하려 할 때 전달됩니다.DisplayObject
 Inherited 표시 목록을 업데이트하고 렌더링하려 할 때 전달됩니다.DisplayObject
 Inherited 포인팅 장치를 InteractiveObject 인스턴스에서 멀리 하면 전달됩니다.InteractiveObject
 Inherited 포인팅 장치를 InteractiveObject 인스턴스 위로 옮길 때 전달됩니다.InteractiveObject
 Inherited 객체의 tabChildren 플래그 값이 변경될 때 전달됩니다.InteractiveObject
 Inherited 객체의 tabEnabled 플래그가 변경될 때 전달됩니다.InteractiveObject
 Inherited 객체의 tabIndex 속성 값이 변경될 때 전달됩니다.InteractiveObject
속성 정보
downState속성
downState:DisplayObject  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

hitTestState 객체를 클릭했을 때의 상태인 버튼 "다운" 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.


구현
    public function get downState():DisplayObject
    public function set downState(value:DisplayObject):void

참고 사항

enabled속성 
enabled:Boolean  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

버튼의 활성 여부를 지정하는 부울 값입니다. 비활성화 상태인 경우, 즉 enabled 속성을 false로 설정한 경우 버튼을 볼 수는 있지만 클릭할 수는 없습니다. 기본값은 true입니다. 이 속성은 특정 부분을 탐색할 수 없게 하려는 경우에 유용합니다. 예를 들어, 현재 표시된 페이지에서 버튼을 비활성화하여 해당 버튼을 클릭할 수 없고 페이지를 다시 로드할 수 없도록 할 수 있습니다.


구현
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
hitTestState속성 
hitTestState:DisplayObject  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

버튼의 히트 테스트 객체로 사용할 표시 객체를 지정합니다. 기본 버튼의 경우, hitTestState 속성을 overState 속성과 동일한 표시 객체로 설정합니다. hitTestState 속성을 설정하지 않으면 SimpleButton이 비활성 상태가 되어 마우스 및 키보드 이벤트에 응답하지 않습니다.


구현
    public function get hitTestState():DisplayObject
    public function set hitTestState(value:DisplayObject):void

참고 사항

overState속성 
overState:DisplayObject  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

버튼 위에 마우스를 놓았을 때의 상태인 버튼 오버 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.


구현
    public function get overState():DisplayObject
    public function set overState(value:DisplayObject):void

참고 사항

soundTransform속성 
soundTransform:SoundTransform  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

이 버튼에 할당된 SoundTransform 객체입니다. SoundTransform 객체에는 볼륨, 패닝, 왼쪽 스피커 할당, 오른쪽 스피커 할당 등을 설정할 수 있는 속성이 포함되어 있습니다. 이 SoundTransform 객체는 모든 버튼 상태에 적용되며, 포함된 사운드에만 영향을 줍니다.


구현
    public function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform):void

참고 사항

trackAsMenu속성 
trackAsMenu:Boolean  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

SimpleButton 또는 MovieClip 등의 다른 표시 객체에서 마우스 놓기 이벤트를 수신할 수 있는지 여부를 나타냅니다. trackAsMenu 속성을 사용하면 메뉴를 만들 수 있습니다. 모든 SimpleButton 또는 MovieClip 객체에서 trackAsMenu 속성을 설정할 수 있습니다. trackAsMenu 속성이 존재하지 않는 경우 기본 비헤이비어는 false입니다.

trackAsMenu 속성은 언제든지 변경이 가능하며 변경된 버튼에는 즉시 새 비헤이비어가 적용됩니다.


구현
    public function get trackAsMenu():Boolean
    public function set trackAsMenu(value:Boolean):void
upState속성 
upState:DisplayObject  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

버튼 위에 마우스를 놓지 않았을 때의 상태인 버튼 업 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.


구현
    public function get upState():DisplayObject
    public function set upState(value:DisplayObject):void

참고 사항

useHandCursor속성 
useHandCursor:Boolean  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

true로 설정된 경우 버튼 위로 마우스를 가져가면 Flash Player에 손 모양의 커서가 표시되도록 하는 부울 값입니다. 이 속성이 false로 설정된 경우 화살표 모양 커서가 대신 표시됩니다. 기본값은 true입니다.

useHandCursor 속성은 언제든지 변경이 가능하며, 변경된 버튼에는 즉시 새 커서 비헤이비어가 적용됩니다.


구현
    public function get useHandCursor():Boolean
    public function set useHandCursor(value:Boolean):void
생성자 정보
SimpleButton()생성자
public function SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

새 SimpleButton 인스턴스를 만듭니다. 다양한 버튼 상태를 나타내는 표시 객체의 일부 또는 모두는 생성자에서 매개 변수로 설정될 수 있습니다.

매개 변수
upState:DisplayObject (default = null) — SimpleButton 업 상태에 대한 초기 값입니다.
 
overState:DisplayObject (default = null) — SimpleButton 오버 상태에 대한 초기 값입니다.
 
downState:DisplayObject (default = null) — SimpleButton 다운 상태에 대한 초기 값입니다.
 
hitTestState:DisplayObject (default = null) — SimpleButton hitTest 상태에 대한 초기 값입니다.
예제 예제 사용 방법
SimpleButtonExample.as

다음 예제에서는 SimpleButtonExample 클래스를 사용한 다음 CustomSimpleButton 클래스를 사용하여 4개의 ButtonDisplayState 객체를 인스턴스화합니다. 그 결과 사각형 모양의 버튼이 만들어지며 배경색은 마우스 상태(SimpleButton 클래스의 인스턴스 속성보다 우선)를 기준으로 변경됩니다. 이는 다음 단계로 이루어집니다.
  1. SimpleButtonExample() 생성자에서 SimpleButton 유형의 새 CustomSimpleButton 객체 button이 만들어져 CustomSimpleButton 생성자 메서드를 호출합니다. button 객체가 표시 목록에 추가됩니다. 버튼의 색상과 크기는 다음 단계에서 결정됩니다.
  2. CustomSimpleButton 클래스에서 인스턴스 속성을 선언합니다. 이 속성은 나중에 해당 상태를 기준으로 button의 크기와 배경색을 제어하는 데 사용됩니다. 일반 상태의 경우 주황색, 마우스를 위에 놓은 상태의 경우 어두운 노란색, 마우스를 아래에 놓은 상태의 경우 밝은 파란색입니다. button의 상태에 관계없이 해당 사각형의 크기는 size 속성을 사용하여 80픽셀로 설정됩니다.
  3. CustomSimpleButton 클래스에 대한 생성자 함수가 downState, overState, upState, hitTestStateuseHandCursor 속성을 ButtonDisplayState 클래스의 4개 인스턴스로 설정합니다.
  4. ButtonDisplayState 클래스에서 생성자가 사각형의 크기와 배경색에 대한 값을 설정하고 draw() 메서드를 호출합니다.
  5. draw() 메서드는 생성자에 설정된 크기와 배경색을 사용하여 버튼 상태를 기준으로 사각형을 다시 그립니다.
package {
    import flash.display.Sprite;

    public class SimpleButtonExample extends Sprite {
        public function SimpleButtonExample() {
            var button:CustomSimpleButton = new CustomSimpleButton();
            addChild(button);
        }
    }
}

import flash.display.DisplayObject;
import flash.display.Shape;
import flash.display.SimpleButton;

class CustomSimpleButton extends SimpleButton {
    private var upColor:uint   = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;
    private var size:uint      = 80;

    public function CustomSimpleButton() {
        downState      = new ButtonDisplayState(downColor, size);
        overState      = new ButtonDisplayState(overColor, size);
        upState        = new ButtonDisplayState(upColor, size);
        hitTestState   = new ButtonDisplayState(upColor, size * 2);
        hitTestState.x = -(size / 4);
        hitTestState.y = hitTestState.x;
        useHandCursor  = true;
    }
}

class ButtonDisplayState extends Shape {
    private var bgColor:uint;
    private var size:uint;

    public function ButtonDisplayState(bgColor:uint, size:uint) {
        this.bgColor = bgColor;
        this.size    = size;
        draw();
    }

    private function draw():void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, size, size);
        graphics.endFill();
    }
}




 

이 페이지에 의견 추가되면 전자 메일 알림 받기 | 의견 보고서

현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/display/SimpleButton.html