This page was saved using jaction on 2006-09-04 8:34:03.
Address: http://flexdocs.kr/docs/flex2/langref/flash/display/SimpleButton.html
Title: flash.display.SimpleButton (Flex™ 2 레퍼런스 가이드)  •  Size: 86701
Packageflash.display
Classpublic class SimpleButton
InheritanceSimpleButton Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
SubclassesFlexSimpleButton

SimpleButton 클래스를 사용하면, SWF 파일내의 버튼 심볼의 모든 인스턴스를 제어할 수가 있습니다. authoring tool내의 버튼의 인스턴스를 작성한 후는, SimpleButton 클래스의 Methods와 property를 사용해, ActionScript 로 버튼을 조작할 수 있습니다.

프로파티인스페크타에서도 버튼에 인스턴스명을 붙일 수가 있습니다. SimpleButton 인스턴스의 이름은, 무비 익스플로러에 표시됩니다. [액션] 패널의 [타겟 패스의 삽입] 다이알로그 박스에도 표시됩니다.

ActionScript 3.0 에서는,new SimpleButton() constructor    을 사용해 다음과 같이 SimpleButton 인스턴스를 작성할 수도 있습니다.

 var myButton:SimpleButton = new SimpleButton();
 var downSprite:Sprite = new Sprite();
 downSprite.graphics.lineStyle(2, 0x202020);
 downSprite.graphics.beginFill(0x00FF00);
 downSprite.graphics.drawRect(10, 10, 50, 50);
 
 var upSprite:Sprite = new Sprite();
 upSprite.graphics.lineStyle(2, 0x202020);
 upSprite.graphics.beginFill(0xFFFF00);
 upSprite.graphics.drawRect(10, 10, 50, 50);
 
 myButton.upState = upSprite;
 myButton.overState = upSprite;
 myButton.downState = downSprite;
 myButton.useHandCursor = true;
 myButton.hitTestState = upSprite;
 
 this.addChild(myButton);
 

SimpleButton 클래스는, InteractiveObject 클래스로부터 Inheritance합니다.

View the examples

See also

InteractiveObject class
표시 아키텍쳐에 대해
SimpleButton object의 조작


Public property
 property정의
 InheritedaccessibilityProperties : AccessibilityProperties
이 표시 object의 현재의 accessibility options입니다.
DisplayObject
 Inheritedalpha : Number
지정된 object의 알파 투명도 값을 나타냅니다.
DisplayObject
 InheritedblendMode : String
사용하는 브렌드 모드를 지정하는 BlendMode 클래스의 값입니다.
DisplayObject
 InheritedcacheAsBitmap : Boolean
true 로 설정되어 있는 경우, 표시 object의 내부 비트 맵 표현이 Flash Player 에 캐쉬됩니다.
DisplayObject
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 InheritedcontextMenu : ContextMenu
이 object에 관련지을 수 있었던 context menu를 지정합니다.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
object가 doubleClick 이벤트를 받을지 어떨지를 지정합니다.
InteractiveObject
  downState : DisplayObject
버튼의 "다운" 상태용의 비주얼 object로서 사용되는 표시 object를 지정합니다. 다운 상태와는, 유저가 hitTestState object를 클릭했을 때의 버튼 상태입니다.
SimpleButton
  enabled : Boolean
버튼이 유효한가 무효인지를 지정하는 불리언 값입니다.
SimpleButton
 Inheritedfilters : Array
표시 object에 현재 관련지을 수 있고 있는 각 필터 object가 포함되고 있는 인덱스 첨부의 배열입니다.
DisplayObject
 InheritedfocusRect : Object
이 object가 포커스 구형을 표시할지 어떨지를 지정합니다.
InteractiveObject
 Inheritedheight : Number
표시 object의 높이를 나타냅니다 (픽셀 단위).
DisplayObject
  hitTestState : DisplayObject
버튼의 히트 테스트 object로서 사용하는 표시 object를 지정합니다.
SimpleButton
 InheritedloaderInfo : LoaderInfo
이 표시 object가 속하는 파일의 로드 정보를 포함한 LoaderInfo object를 돌려줍니다.
DisplayObject
 Inheritedmask : DisplayObject
호출원 display object는, 지정된 mask object에 의해 마스크 됩니다.
DisplayObject
 InheritedmouseEnabled : Boolean
이 object가 마우스 메세지를 받아들일지 어떨지를 지정합니다.
InteractiveObject
 InheritedmouseX : Number
마우스 위치의 x 좌표를 나타냅니다 (픽셀 단위).
DisplayObject
 InheritedmouseY : Number
마우스 위치의 y 좌표를 나타냅니다 (픽셀 단위).
DisplayObject
 Inheritedname : String
DisplayObject 의 인스턴스명을 나타냅니다.
DisplayObject
 InheritedopaqueBackground : Object
표시 object가 특정의 배경색으로 불투명한지 어떤지를 지정합니다.
DisplayObject
  overState : DisplayObject
버튼의 오버 상태용의 비주얼 object로서 사용되는 표시 object를 지정합니다. 오버 상태란, 버튼 위에 마우스 포인터가 놓여져 있는 상태입니다.
SimpleButton
 Inheritedparent : DisplayObjectContainer
이 표시 object를 포함한 DisplayObjectContainer object를 나타냅니다.
DisplayObject
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
 Inheritedroot : DisplayObject
로드 된 SWF 파일내 display object의 경우,root property는 그 SWF 파일이 나타내는 표시 리스트의 트리 구조 부분의 맨 위에 있는 표시 object가 됩니다.
DisplayObject
 Inheritedrotation : Number
DisplayObject 인스턴스의 원래의 위치로부터의 회전각을 번단위로 가리킵니다.
DisplayObject
 Inheritedscale9Grid : Rectangle
현재 유효한 확대 / 축소 격자입니다.
DisplayObject
 InheritedscaleX : Number
기준점으로부터 적용되는 object의 수평 스케일 (percentage)을 나타냅니다.
DisplayObject
 InheritedscaleY : Number
object의 기준점으로부터 적용되는 object의 수직 스케일 (percentage)을 나타냅니다.
DisplayObject
 InheritedscrollRect : Rectangle
표시 object의 스크롤 구형의 경계.
DisplayObject
  soundTransform : SoundTransform
이 버튼에 할당할 수 있었던 SoundTransform object.
SimpleButton
 Inheritedstage : Stage
표시 object의 스테이지.
DisplayObject
 InheritedtabEnabled : Boolean
이 object가 탭 순서순서에 포함될지 어떨지를 지정합니다.
InteractiveObject
 InheritedtabIndex : int
SWF 파일내의 object의 탭 순서를 지정합니다.
InteractiveObject
  trackAsMenu : Boolean
SimpleButton 또는 MovieClip object인 다른 표시 object가 마우스 해방 이벤트를 받을 수가 있을지 어떨지를 나타냅니다.
SimpleButton
 Inheritedtransform : Transform
표시 object의 매트릭스, 칼라 변환, 픽셀 경계에 관계하는 property를 가지는 object입니다.
DisplayObject
  upState : DisplayObject
버튼의 업 상태용의 비주얼 object로서 사용되는 표시 object를 지정합니다. 업 상태란, 버튼 위에 마우스 포인터가 놓여지지 않은 상태입니다.
SimpleButton
  useHandCursor : Boolean
마우스가 버튼상으로 이동했을 때에, 핸드 커서를 표시할지 어떨지를 나타내는 불리언 값입니다. true 로 설정되면, 핸드 커서를 표시합니다.
SimpleButton
 Inheritedvisible : Boolean
표시 object가 가시인가 어떤가를 나타냅니다.
DisplayObject
 Inheritedwidth : Number
표시 object의 폭을 나타냅니다 (픽셀 단위).
DisplayObject
 Inheritedx : Number
친 DisplayObjectContainer 의 로컬 좌표를 기준으로 한 DisplayObject 인스턴스의 x 좌표를 나타냅니다.
DisplayObject
 Inheritedy : Number
친 DisplayObjectContainer 의 로컬 좌표를 기준으로 한 DisplayObject 인스턴스의 y 좌표를 나타냅니다.
DisplayObject
Public Methods
 Methods정의
  SimpleButton (upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)
새로운 SimpleButton 인스턴스를 작성합니다.
SimpleButton
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedgetBounds (targetCoordinateSpace:DisplayObject ):Rectangle
targetCoordinateSpace object의 좌표계를 기준으로 해, 표시 object의 area를 정의하는 구형을 돌려줍니다.
DisplayObject
 InheritedgetRect (targetCoordinateSpace:DisplayObject ):Rectangle
셰이프상의 선을 제외해,targetCoordinateSpace Parameters에 의해 정의된 좌표계에 근거해, 표시 object의 경계를 정의하는 구형을 돌려줍니다.
DisplayObject
 InheritedglobalToLocal (point:Point ):Point
point object를 스테이지 (글로벌) 좌표로부터 표시 object의 (로컬) 좌표로 변환합니다.
DisplayObject
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedhitTestObject (obj:DisplayObject ):Boolean
표시 object를 평가해,obj 표시 object와 중복 또는 교차할지 어떨지를 조사합니다.
DisplayObject
 InheritedhitTestPoint (x:Number , y:Number , shapeFlag:Boolean = false):Boolean
표시 object를 평가해,xy Parameters로 지정된 포인트와 중복 또는 교차할지 어떨지를 조사합니다.
DisplayObject
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedlocalToGlobal (point:Point ):Point
point object를 표시 object의 (로컬) 좌표로부터 스테이지 (글로벌) 좌표로 변환합니다.
DisplayObject
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
이벤트
 이벤트일람정의
 Inheritedactivate Flash Player 가 operating system의 포커스를 취득해, 액티브하게 되었을 때에 dispatch됩니다. DisplayObject
 Inheritedadded 표시 object가 표시 리스트에 추가되었을 때에 dispatch됩니다. DisplayObject
 Inheritedclick 유저가 같은 InteractiveObject 상에서 pointing device의 메인 버튼을 눌러 떼어 놓으면 dispatch됩니다. InteractiveObject
 Inheriteddeactivate Flash Player 가 operating system의 포커스를 잃어, 비액티브하게 되었을 때에 dispatch됩니다. DisplayObject
 InheriteddoubleClick object의 doubleClickEnabled 플래그가 true 로 설정되어 있는 경우에는, 유저가 같은 InteractiveObject 상에서 pointing device의 메인 버튼을 2 회 계속해 재빠르게 눌러 떼어 놓으면 dispatch됩니다. InteractiveObject
 InheritedenterFrame 재생 헤드가 새로운 프레임에 들어갈 때 dispatch됩니다. DisplayObject
 InheritedfocusIn 표시 object가 포커스를 취득한 후에dispatch됩니다. InteractiveObject
 InheritedfocusOut 표시 object가 포커스를 잃은 후에dispatch됩니다. InteractiveObject
 InheritedkeyDown 유저가 키를 눌렀을 때에 dispatch됩니다. InteractiveObject
 InheritedkeyFocusChange 유저가 키보드 조작에 의해 포커스를 변경하려고 하면 dispatch됩니다. InteractiveObject
 InheritedkeyUp 유저가 키를 떼어 놓았을 때에 dispatch됩니다. InteractiveObject
 InheritedmouseDown Flash Player 윈도우의 InteractiveObject 인스턴스 위에서, 유저가 pointing device의 버튼을 눌렀을 때에 dispatch됩니다. InteractiveObject
 InheritedmouseFocusChange 유저가 pointing device로 포커스를 변경하려고 하면 dispatch됩니다. InteractiveObject
 InheritedmouseMove InteractiveObject 위에서, 유저가 pointing device를 움직였을 때에 dispatch됩니다. InteractiveObject
 InheritedmouseOut 유저가 InteractiveObject 인스턴스로부터 pointing device를 떼어 놓았을 때에 dispatch됩니다. InteractiveObject
 InheritedmouseOver 유저가 Flash Player 윈도우의 InteractiveObject 인스턴스에, pointing device를 맞추었을 때에 dispatch됩니다. InteractiveObject
 InheritedmouseUp 유저가 Flash Player 윈도우의 InteractiveObject 인스턴스 위에서 pointing device의 버튼을 떼어 놓았을 때에 dispatch됩니다. InteractiveObject
 InheritedmouseWheel Flash Player 윈도우의 InteractiveObject 인스턴스 위에서, 마우스 휠을 회전시켰을 때에 dispatch됩니다. InteractiveObject
 Inheritedremoved 표시 object가 표시 리스트로부터 삭제 되려고 하고 있을 때 dispatch됩니다. DisplayObject
 Inheritedrender 표시 리스트가 갱신 및 렌더링 되려고 하고 있을 때 dispatch됩니다. DisplayObject
 InheritedrollOut 유저가 InteractiveObject 인스턴스로부터 pointing device를 떼어 놓았을 때에 dispatch됩니다. InteractiveObject
 InheritedrollOver 유저가 InteractiveObject 인스턴스에 pointing device를 맞추었을 때에 dispatch됩니다. InteractiveObject
 InheritedtabChildrenChange object의 tabChildren 플래그의 값이 변경되었을 때에 dispatch됩니다. InteractiveObject
 InheritedtabEnabledChange object의 tabEnabled 플래그가 변경되었을 때에 dispatch됩니다. InteractiveObject
 InheritedtabIndexChange object의 tabIndex property의 값이 변경되었을 때에 dispatch됩니다. InteractiveObject
property의 상세
downStateproperty
downState:DisplayObject   [read-write]

버튼의 "다운" 상태용의 비주얼 object로서 사용되는 표시 object를 지정합니다. 다운 상태와는, 유저가 hitTestState object를 클릭했을 때의 버튼 상태입니다.

Implements
    public function get downState():DisplayObject
    public function set downState(value:DisplayObject ):void

See also

enabledproperty 
enabled:Boolean   [read-write]

버튼이 유효한가 무효인지를 지정하는 불리언 값입니다. 버튼이 무효가 되어 있을 때 (enabled property가 false 로 설정되어 있을 때), 버튼은 표시됩니다만, 클릭할 수 없습니다. 디폴트치는 true 입니다. 이 property는, 네비게이션의 일부를 무효로 하는 경우에 편리합니다. 예를 들어, 현재 표시되고 있는 페이지의 버튼을 무효로 해 클릭할 수 없게 하는 것으로, 페이지의 리로드를 금지할 수 있습니다.

Implements
    public function get enabled():Boolean
    public function set enabled(value:Boolean ):void
hitTestStateproperty 
hitTestState:DisplayObject   [read-write]

버튼의 히트 테스트 object로서 사용하는 표시 object를 지정합니다. 기본적인 버튼에서는,hitTestState property를 overState property와 같은 표시 object로 설정합니다. hitTestState property를 설정하지 않는 경우, SimpleButton 는 비액티브하게 됩니다. 즉, 마우스 이벤트나 키보드 이벤트에 반응하지 않습니다.

Implements
    public function get hitTestState():DisplayObject
    public function set hitTestState(value:DisplayObject ):void

See also

overStateproperty 
overState:DisplayObject   [read-write]

버튼의 오버 상태용의 비주얼 object로서 사용되는 표시 object를 지정합니다. 오버 상태란, 버튼 위에 마우스 포인터가 놓여져 있는 상태입니다.

Implements
    public function get overState():DisplayObject
    public function set overState(value:DisplayObject ):void

See also

soundTransformproperty 
soundTransform:SoundTransform   [read-write]

이 버튼에 할당할 수 있었던 SoundTransform object. SoundTransform object에는, 볼륨, 빵, 왼쪽 스피커의 할당 , 및 오른쪽 스피커의 할당을 설정하는 property가 포함됩니다. 이 SoundTransform object는 버튼의 모든 상태에 적용됩니다. 이 SoundTransform object는 포함(Embed)되어 있는 사운드에만 영향을 줍니다.

Implements
    public function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform ):void

See also

trackAsMenuproperty 
trackAsMenu:Boolean   [read-write]

SimpleButton 또는 MovieClip object인 다른 표시 object가 마우스 해방 이벤트를 받을 수가 있을지 어떨지를 나타냅니다. trackAsMenu property를 사용해 메뉴를 작성할 수 있습니다. trackAsMenu property는, 임의의 SimpleButton 또는 MovieClip object에 대해서 설정할 수 있습니다. trackAsMenu property가 없는 경우, 디폴트의 동작은 false 입니다.

trackAsMenu property는 필요에 따라서 언제라도 변경할 수 있습니다. 변경은 즉석에서 반영됩니다.

Implements
    public function get trackAsMenu():Boolean
    public function set trackAsMenu(value:Boolean ):void
upStateproperty 
upState:DisplayObject   [read-write]

버튼의 업 상태용의 비주얼 object로서 사용되는 표시 object를 지정합니다. 업 상태란, 버튼 위에 마우스 포인터가 놓여지지 않은 상태입니다.

Implements
    public function get upState():DisplayObject
    public function set upState(value:DisplayObject ):void

See also

useHandCursorproperty 
useHandCursor:Boolean   [read-write]

마우스가 버튼상으로 이동했을 때에, 핸드 커서를 표시할지 어떨지를 나타내는 불리언 값입니다. true 로 설정되면, 핸드 커서를 표시합니다. 이 property를 false 로 설정하면, 대신에 화살표 커서가 표시됩니다. 디폴트치는 true 입니다.

useHandCursor property는 필요에 따라서 언제라도 변경할 수 있습니다. 변경된 버튼에서는 새로운 커서의 동작이 즉석에서 사용됩니다.

Implements
    public function get useHandCursor():Boolean
    public function set useHandCursor(value:Boolean ):void
constructor    의 상세
SimpleButton()constructor   
public 함수 SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)

새로운 SimpleButton 인스턴스를 작성합니다. 다양한 버튼 상태를 나타내는 표시 object의 언젠가 또는 모든 것을, constructor    내의 Parameters로서 설정할 수가 있습니다.

Parameters
upState:DisplayObject (default = null) — SimpleButton 의 업 상태용의 초기치입니다.
 
overState:DisplayObject (default = null) — SimpleButton 의 오버 상태용의 초기치입니다.
 
downState:DisplayObject (default = null) — SimpleButton 의 다운 상태용의 초기치입니다.
 
hitTestState:DisplayObject (default = null) — SimpleButton 의 hitTest 상태용의 초기치입니다.
Examples

다음의 예에서는, SimpleButtonExample 클래스를 사용합니다. 이것은, CustomSimpleButton 클래스를 사용해, 다음에 이 클래스는 4 개의 ButtonDisplayState object를 인스턴스화합니다. 그 결과적으로 작성되는 버튼은, 형상이 사각형으로, 배경색이 마우스 상태에 응해 바뀝니다. 이것은, SimpleButton 클래스의 property를 재정의(override) 하는 것에 의해 행해집니다. 여기에서는 이하의 순서를 실행합니다.
  1. SimpleButtonExample() constructor    으로,button 라고 한다 타입 SimpleButton 의 CustomSimpleButton object가 작성됩니다. 이것은,CustomSimpleButton constructor    Methods를 호출합니다. button object가 표시 리스트에 추가됩니다. 버튼의 색과 크기는 다음의 순서로 결정됩니다.
  2. CustomSimpleButton 클래스에서, 인스턴스의 property가 선언됩니다. 이것들은, 후에 button 의 크기와 배경색을 제어하기 위해서 사용됩니다. 그 제어는, 버튼 상태에 근거해 행해져 통상 상태에서는 오렌지, 마우스 포인터가 놓여진 상태에서는 어두운 황색, mouse button가 밀린 상태에서는 밝은 청색이 됩니다. button 가 어느 상태에 있을 때에도, 사각형의 크기는 80 픽셀로 설정됩니다. 이 설정은, size property를 사용해 행해집니다.
  3. CustomSimpleButton 클래스의 constructor    함수에서는, downState, overState, upState, hitTestState, 및 useHandCursor 의 property에, ButtonDisplayState 클래스의 4 개의 인스턴스를 설정합니다.
  4. ButtonDisplayState 클래스의 constructor    에서는, 사각형의 크기와 배경색의 값을 설정해,draw() Methods를 호출합니다.
  5. draw() Methods는, 버튼 상태에 근거해, constructor    으로 설정되었다 크기와 배경색으로 사각형을 재묘화 합니다.
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://flexdocs.kr/docs/flex2/langref/flash/display/SimpleButton.html