패키지 | flash.display |
클래스 | public class SimpleButton |
상속 | SimpleButton InteractiveObject DisplayObject EventDispatcher Object |
하위 클래스 | FlexSimpleButton |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Professional의 경우 속성 관리자에서 버튼에 인스턴스 이름을 부여할 수 있습니다. SimpleButton 인스턴스 이름은 동영상 탐색기 및 [액션] 패널의 [대상 경로 삽입] 대화 상자에 표시됩니다. Flash Professional에서 버튼 인스턴스를 만든 후 SimpleButton 클래스의 메서드와 속성을 사용하여 ActionScript로 버튼을 조작할 수 있습니다.
ActionScript 3.0에서는 new SimpleButton()
생성자를 사용하여 SimpleButton 인스턴스를 만들 수 있습니다.
SimpleButton 클래스는 InteractiveObject 클래스에서 상속됩니다.
Player 버전 11.2/AIR 버전 3.2부터는 쿼리 시 parent
속성(SimpleButton
객체의 상태)이 null
을 보고합니다.
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
이 InteractiveObject 인스턴스에 대한 현재 액세스 가능성 구현(AccessibilityImplementation)입니다. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
이 표시 객체의 현재 액세스 가능성 옵션입니다. | DisplayObject | ||
alpha : Number
지정된 객체의 알파 투명도 값을 나타냅니다. | DisplayObject | ||
blendMode : String
사용할 블렌드 모드를 지정하는 BlendMode 클래스 값입니다. | DisplayObject | ||
blendShader : Shader [쓰기 전용]
전경 및 배경을 블렌딩하는 데 사용되는 셰이더를 설정합니다. | DisplayObject | ||
cacheAsBitmap : Boolean
true로 설정된 경우 Flash 런타임은 표시 객체의 내부 비트맵 표현을 캐시합니다. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
null이 아닌 경우 이 Matrix 객체는 cacheAsBitmap이 true로 설정될 때 표시 객체가 렌더링되는 방법을 정의합니다. | DisplayObject | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
contextMenu : NativeMenu
이 객체에 연결된 컨텍스트 메뉴를 지정합니다. | InteractiveObject | ||
doubleClickEnabled : Boolean
이 객체에서 doubleClick 이벤트를 받을지 여부를 지정합니다. | InteractiveObject | ||
downState : DisplayObject
사용자가 hitTestState 객체를 선택할 때의 버튼 상태인 버튼 "다운" 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다. | SimpleButton | ||
enabled : Boolean
버튼의 활성 여부를 지정하는 부울 값입니다. | SimpleButton | ||
filters : Array
현재 표시 객체와 연관된 각 필터 객체가 들어 있는 인덱싱된 배열입니다. | DisplayObject | ||
focusRect : Object
이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다. | InteractiveObject | ||
height : Number
표시 객체의 높이를 픽셀 단위로 나타냅니다. | DisplayObject | ||
hitTestState : DisplayObject
버튼의 히트 테스트 객체로 사용할 표시 객체를 지정합니다. | SimpleButton | ||
loaderInfo : LoaderInfo [읽기 전용]
이 표시 객체가 속한 파일의 로딩 정보가 포함된 LoaderInfo 객체를 반환합니다. | DisplayObject | ||
mask : DisplayObject
호출하는 표시 객체는 지정된 mask 객체에 의해 마스크 처리됩니다. | DisplayObject | ||
metaData : Object
PlaceObject4 태그를 통해 SWF 파일에 해당 DisplayObject의 인스턴스와 함께 메타데이터가 저장된 경우 DisplayObject 인스턴스의 메타데이터 객체를 가져옵니다. | DisplayObject | ||
mouseEnabled : Boolean
이 객체가 마우스 또는 기타 사용자 입력, 메시지를 수신할지 여부를 지정합니다. | InteractiveObject | ||
mouseX : Number [읽기 전용]
마우스 또는 사용자 입력 장치 위치의 x 좌표를 픽셀로 나타냅니다. | DisplayObject | ||
mouseY : Number [읽기 전용]
마우스 또는 사용자 입력 장치 위치의 y 좌표를 픽셀로 나타냅니다. | DisplayObject | ||
name : String
DisplayObject의 인스턴스 이름을 나타냅니다. | DisplayObject | ||
needsSoftKeyboard : Boolean
이 InteractiveObject 인스턴스가 포커스를 받을 때 가상 키보드(화면의 소프트웨어 키보드)를 표시할지 여부를 지정합니다. | InteractiveObject | ||
opaqueBackground : Object
표시 객체를 특정 배경색으로 불투명하게 처리할지 여부를 지정합니다. | DisplayObject | ||
overState : DisplayObject
버튼 위에 포인터를 놓았을 때의 버튼 상태인 버튼 오버 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다. | SimpleButton | ||
parent : DisplayObjectContainer [읽기 전용]
이 표시 객체가 포함된 DisplayObjectContainer 객체를 나타냅니다. | DisplayObject | ||
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
이 버튼에 할당된 SoundTransform 객체입니다. | SimpleButton | ||
stage : Stage [읽기 전용]
표시 객체의 Stage입니다. | DisplayObject | ||
tabEnabled : Boolean
이 객체가 탭 순서에 있는지 여부를 지정합니다. | InteractiveObject | ||
tabIndex : int
SWF 파일에서 객체의 탭 순서를 지정합니다. | InteractiveObject | ||
trackAsMenu : Boolean
SimpleButton 또는 MovieClip 등의 다른 표시 객체에서 사용자 입력 릴리스 이벤트를 수신할 수 있는지 여부를 나타냅니다. | SimpleButton | ||
transform : flash.geom:Transform
표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다. | DisplayObject | ||
upState : DisplayObject
버튼 위에 포인터를 놓지 않았을 때의 버튼 상태인 버튼 업 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다. | SimpleButton | ||
useHandCursor : Boolean
true로 설정된 경우 버튼 위로 포인터를 가져가면 손 모양 커서가 표시되도록 하는 부울 값입니다. | SimpleButton | ||
visible : Boolean
표시 객체가 표시되는지 여부를 나타냅니다. | DisplayObject | ||
width : Number
표시 객체의 폭을 픽셀 단위로 나타냅니다. | DisplayObject | ||
x : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 x 좌표를 나타냅니다. | DisplayObject | ||
y : Number
부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 y 좌표를 나타냅니다. | DisplayObject | ||
z : Number
3D parent 컨테이너를 기준으로 DisplayObject 인스턴스의 z축에 있는 z 좌표 위치를 나타냅니다. | DisplayObject |
메서드 | 정의 주체 | ||
---|---|---|---|
SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)
새 SimpleButton 인스턴스를 만듭니다. | SimpleButton | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
targetCoordinateSpace 객체의 좌표계를 기준으로 표시 객체의 영역을 정의하는 사각형을 반환합니다. | DisplayObject | ||
대상 좌표 공간 매개 변수에 의해 정의되는 좌표계를 기준으로 모양의 획을 제외하고 표시 객체의 경계를 정의하는 사각형을 반환합니다. | DisplayObject | ||
Point 객체를 Stage 전역 좌표에서 표시 객체의 로컬 좌표로 변환합니다. | DisplayObject | ||
Stage(전역) 좌표의 2차원 점을 3차원 표시 객체(로컬) 좌표로 변환합니다. | DisplayObject | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
표시 객체의 경계 상자를 평가하여 obj 표시 객체의 경계 상자와 겹치거나 교차하는지 확인합니다. | DisplayObject | ||
표시 객체를 평가하여 x 및 y 매개 변수에 의해 지정된 점과 겹치거나 교차하는지 확인합니다. | DisplayObject | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
3차원 표시 객체의 로컬 좌표에 있는 3차원 점을 Stage 전역 좌표의 2차원 점으로 변환합니다. | DisplayObject | ||
Point 객체를 표시 객체의 로컬 좌표에서 Stage 전역 좌표로 변환합니다. | DisplayObject | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
가상 키보드를 표시합니다. | InteractiveObject | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
downState | 속성 |
downState:DisplayObject
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
사용자가 hitTestState
객체를 선택할 때의 버튼 상태인 버튼 "다운" 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.
구현
public function get downState():DisplayObject
public function set downState(value:DisplayObject):void
관련 API 요소
enabled | 속성 |
enabled:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
버튼의 활성 여부를 지정하는 부울 값입니다. 비활성화 상태인 경우, 즉 enabled 속성을 false
로 설정한 경우 버튼을 볼 수는 있지만 클릭할 수는 없습니다. 기본값은 true
입니다. 이 속성은 특정 부분을 탐색할 수 없게 하려는 경우에 유용합니다. 예를 들어 현재 표시된 페이지에서 버튼을 비활성화하여 해당 버튼을 클릭할 수 없고 페이지를 다시 로드할 수 없도록 할 수 있습니다.
참고: 버튼의 mouseClick을 방지하려면 enabled
와 mouseEnabled
속성을 모두 false
로 설정합니다.
구현
public function get enabled():Boolean
public function set enabled(value:Boolean):void
hitTestState | 속성 |
hitTestState:DisplayObject
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
버튼의 히트 테스트 객체로 사용할 표시 객체를 지정합니다. 기본 버튼의 경우, hitTestState
속성을 overState
속성과 동일한 표시 객체로 설정합니다. hitTestState
속성을 설정하지 않으면 SimpleButton이 비활성 상태가 되어 사용자 입력 이벤트에 응답하지 않습니다.
구현
public function get hitTestState():DisplayObject
public function set hitTestState(value:DisplayObject):void
관련 API 요소
overState | 속성 |
overState:DisplayObject
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
버튼 위에 포인터를 놓았을 때의 버튼 상태인 버튼 오버 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.
구현
public function get overState():DisplayObject
public function set overState(value:DisplayObject):void
관련 API 요소
soundTransform | 속성 |
soundTransform:flash.media:SoundTransform
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9 |
이 버튼에 할당된 SoundTransform 객체입니다. SoundTransform 객체에는 볼륨, 패닝, 왼쪽 스피커 할당, 오른쪽 스피커 할당 등을 설정할 수 있는 속성이 포함되어 있습니다. 이 SoundTransform 객체는 모든 버튼 상태에 적용되며, 포함된 사운드에만 영향을 줍니다.
구현
public function get soundTransform():flash.media:SoundTransform
public function set soundTransform(value:flash.media:SoundTransform):void
관련 API 요소
trackAsMenu | 속성 |
trackAsMenu:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, 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
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
버튼 위에 포인터를 놓지 않았을 때의 버튼 상태인 버튼 업 상태를 나타내는 시각적 객체로 사용할 표시 객체를 지정합니다.
구현
public function get upState():DisplayObject
public function set upState(value:DisplayObject):void
관련 API 요소
useHandCursor | 속성 |
useHandCursor:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9 |
true
로 설정된 경우 버튼 위로 포인터를 가져가면 손 모양 커서가 표시되도록 하는 부울 값입니다. 이 속성이 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 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
새 SimpleButton 인스턴스를 만듭니다. 다양한 버튼 상태를 나타내는 표시 객체의 일부 또는 모두는 생성자에서 매개 변수로 설정될 수 있습니다.
매개 변수upState:DisplayObject (default = null ) — SimpleButton 업 상태에 대한 초기 값입니다.
| |
overState:DisplayObject (default = null ) — SimpleButton 오버 상태에 대한 초기 값입니다.
| |
downState:DisplayObject (default = null ) — SimpleButton 다운 상태에 대한 초기 값입니다.
| |
hitTestState:DisplayObject (default = null ) — SimpleButton hitTest 상태에 대한 초기 값입니다.
|
SimpleButtonExample()
생성자에서 SimpleButton 유형의 새 CustomSimpleButton 객체button
이 만들어져CustomSimpleButton
생성자 메서드를 호출합니다.button
객체가 표시 목록에 추가됩니다. 버튼의 색상과 크기는 다음 단계에서 결정됩니다.- CustomSimpleButton 클래스에서 인스턴스 속성을 선언합니다. 이 속성은 나중에 해당 상태를 기준으로
button
의 크기와 배경색을 제어하는 데 사용됩니다. 일반 상태의 경우 주황색, 마우스를 위에 놓은 상태의 경우 어두운 노란색, 마우스를 아래에 놓은 상태의 경우 밝은 파란색입니다.button
의 상태에 관계없이 해당 사각형의 크기는size
속성을 사용하여 80픽셀로 설정됩니다. - CustomSimpleButton 클래스에 대한 생성자 함수가
downState
,overState
,upState
,hitTestState
및useHandCursor
속성을 ButtonDisplayState 클래스의 4개 인스턴스로 설정합니다. - ButtonDisplayState 클래스에서 생성자가 사각형의 크기와 배경색에 대한 값을 설정하고
draw()
메서드를 호출합니다. 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(); } }
Tue Jun 12 2018, 03:17 PM Z