SystemTrayIcon - Adobe ActionScript® 3 (AS3 ) API 참조 설명서

패키지	flash.desktop
클래스	public class SystemTrayIcon
상속	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

SystemTrayIcon 클래스는 Windows^® 작업 표시줄 알림 영역(시스템 트레이) 스타일 아이콘을 나타냅니다.

AIR 프로파일 지원: 이 기능은 데스크톱 운영 체제에서는 지원되지만 휴대 장치나 AIR for TV 장치에서는 지원되지 않습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.

모든 데스크톱 운영 체제에 시스템 트레이 아이콘이 있는 것은 아닙니다. NativeApplication.supportsSystemTrayIcon을 확인하여 현재 시스템에서 시스템 트레이 아이콘이 지원되는지를 알아봅니다.

SystemTrayIcon 클래스의 인스턴스를 만들 수 없습니다. "전역" NativeApplication 객체의 icon 속성에서 시스템 트레이 아이콘을 나타내는 객체를 가져옵니다.

시스템 트레이 아이콘이 지원되면 아이콘 유형은 SystemTrayIcon이 됩니다. 시스템 트레이 아이콘이 지원되지 않으면 icon의 유형은 InteractiveIcon의 또 다른 하위 클래스(일반적으로 DockIcon)입니다.

중요: AIR에서 시스템 트레이 아이콘을 지원하지 않는 운영 체제의 NativeApplication.icon 객체에 SystemTrayIcon 클래스 메서드를 호출하려고 하면 런타임 예외가 발생합니다.

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		bitmaps : Array [재정의] 크기가 다른 BitmapData 객체 배열의 아이콘 이미지입니다.	SystemTrayIcon
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		height : int [재정의] [읽기 전용] 아이콘의 현재 표시 높이(픽셀)입니다.	SystemTrayIcon
		menu : NativeMenu 시스템 트레이 아이콘 메뉴입니다.	SystemTrayIcon
		tooltip : String 시스템 트레이 아이콘에 대해 표시되는 도구 설명입니다.	SystemTrayIcon
		width : int [재정의] [읽기 전용] 아이콘의 현재 표시 폭(픽셀)입니다.	SystemTrayIcon

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
click	마우스 왼쪽 버튼을 클릭할 때 이 SystemTrayIcon 객체에 의해 전달됩니다.	SystemTrayIcon
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
mouseDown	마우스 왼쪽 버튼을 누른 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.	SystemTrayIcon
mouseUp	마우스 왼쪽 버튼을 누르지 않은 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.	SystemTrayIcon
rightClick	마우스 오른쪽 버튼을 클릭할 때 이 SystemTrayIcon 객체에 의해 전달됩니다.	SystemTrayIcon
rightMouseDown	마우스 오른쪽 버튼을 누른 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.	SystemTrayIcon
rightMouseUp	마우스 오른쪽 버튼을 누르지 않은 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.	SystemTrayIcon

공용 상수

	상수		정의 주체
		MAX_TIP_LENGTH : Number = 63 [정적] 시스템 트레이 아이콘 도구 설명에 대해 허용되는 길이입니다.	SystemTrayIcon

속성 세부 정보

bitmaps

속성

bitmaps:Array[재정의]

런타임 버전:

AIR 1.0

크기가 다른 BitmapData 객체 배열의 아이콘 이미지입니다.

특정 운영 체제 컨텍스트에서 아이콘이 표시될 때 표시된 크기와 가장 비슷한 배열의 비트맵이 사용됩니다(필요할 경우 크기가 조절됨). 일반적인 크기는 16x16, 32x32, 48x48 및 128x128입니다. 조만간 일부 운영 체제 아이콘에 512x512 픽셀 아이콘을 사용할 수 있습니다.

일부 컨텍스트에서는 bitmaps 속성에 아무것도 지정되지 않았을 때 운영 체제가 기본 시스템 아이콘을 사용할 수 있습니다. 다른 컨텍스트에서는 아이콘이 표시되지 않습니다.

아이콘 모양을 설정하거나 변경하려면 BitmapData 객체의 배열을 bitmaps 속성에 지정합니다.

     icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);

bitmaps 배열을 직접 수정하는 것은 아무런 효과가 없습니다.

아이콘 이미지를 지우려면 빈 배열을 bitmaps 속성에 지정합니다.

참고: 아이콘의 이미지 파일을 로드할 때 일반적으로 PNG 파일 형식이 가장 좋은 알파 블렌딩을 제공합니다. GIF 형식은 on 또는 off 투명도만 지원합니다(블렌딩 없음). JPG 형식은 투명도를 아예 지원하지 않습니다.

구현
override public function get bitmaps():Array
override public function set bitmaps(value:Array):void

height

속성

height:int [읽기 전용] [재정의]

런타임 버전:

AIR 1.0

아이콘의 현재 표시 높이(픽셀)입니다.

일부 아이콘 컨텍스트는 동적 크기를 지원합니다. height 속성은 현재 컨텍스트에 대해 bitmaps 배열에서 선택된 아이콘의 높이를 나타냅니다. 운영 체제에서 아이콘의 크기를 조절한 경우에는 실제 표시 높이가 다를 수 있습니다.

구현
override public function get height():int

tooltip

속성

tooltip:String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

시스템 트레이 아이콘에 대해 표시되는 도구 설명입니다. 문자열이 SystemTrayIcon.MAX_TIP_LENGTH보다 길면 설명이 잘립니다.

구현
public function get tooltip():String
public function set tooltip(value:String):void

width

속성

width:int [읽기 전용] [재정의]

런타임 버전:

AIR 1.0

아이콘의 현재 표시 폭(픽셀)입니다.

일부 아이콘 컨텍스트는 동적 크기를 지원합니다. width 속성은 현재 컨텍스트에 대해 bitmaps 배열에서 선택된 아이콘의 폭을 나타냅니다. 운영 체제에서 아이콘의 크기를 조절한 경우에는 실제 표시 폭이 다를 수 있습니다.

구현
override public function get width():int

이벤트 세부 정보

click

이벤트

이벤트 객체 유형: flash.events.ScreenMouseEvent
속성 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

런타임 버전:

AIR 1.0

마우스 왼쪽 버튼을 클릭할 때 이 SystemTrayIcon 객체에 의해 전달됩니다.

ScreenMouseEvent.CLICK 상수는 click 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 관련 속성이 있습니다.

속성	값
`buttonDown`	마우스 기본 버튼이 눌러져 있으면 `true`이고, 그렇지 않으면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`commandKey`	Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`screenX`	화면 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.
`screenY`	화면 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.
`target`	포인팅 장치 아래에 있는 SystemTrayIcon 객체입니다.

mouseDown

이벤트

이벤트 객체 유형: flash.events.ScreenMouseEvent
속성 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

런타임 버전:

AIR 1.0

마우스 왼쪽 버튼을 누른 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.

ScreenMouseEvent.MOUSE_DOWN 상수는 mouseDown 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 관련 속성이 있습니다.

속성	값
`buttonDown`	마우스 기본 버튼이 눌러져 있으면 `true`이고, 그렇지 않으면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`commandKey`	Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`screenX`	화면 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.
`screenY`	화면 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.
`target`	포인팅 장치 아래에 있는 SystemTrayIcon 객체입니다.

mouseUp

이벤트

이벤트 객체 유형: flash.events.ScreenMouseEvent
속성 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

런타임 버전:

AIR 1.0

마우스 왼쪽 버튼을 누르지 않은 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.

ScreenMouseEvent.MOUSE_UP 상수는 mouseUp 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 관련 속성이 있습니다.

속성	값
`buttonDown`	마우스 기본 버튼이 눌러져 있으면 `true`이고, 그렇지 않으면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`commandKey`	Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`screenX`	화면 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.
`screenY`	화면 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.
`target`	포인팅 장치 아래에 있는 SystemTrayIcon 객체입니다.

rightClick

이벤트

이벤트 객체 유형: flash.events.ScreenMouseEvent
속성 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

런타임 버전:

AIR 1.0

마우스 오른쪽 버튼을 클릭할 때 이 SystemTrayIcon 객체에 의해 전달됩니다.

ScreenMouseEvent.RIGHT_CLICK 상수는 rightClick 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 관련 속성이 있습니다.

속성	값
`buttonDown`	마우스 기본 버튼이 눌러져 있으면 `true`이고, 그렇지 않으면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`commandKey`	Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`screenX`	화면 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.
`screenY`	화면 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.
`target`	포인팅 장치 아래에 있는 SystemTrayIcon 객체입니다.

rightMouseDown

이벤트

이벤트 객체 유형: flash.events.ScreenMouseEvent
속성 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

런타임 버전:

AIR 1.0

마우스 오른쪽 버튼을 누른 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.

ScreenMouseEvent.RIGHT_MOUSE_DOWN 상수는 rightMouseDown 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 관련 속성이 있습니다.

속성	값
`buttonDown`	마우스 기본 버튼이 눌러져 있으면 `true`이고, 그렇지 않으면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`commandKey`	Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`screenX`	화면 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.
`screenY`	화면 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.
`target`	포인팅 장치 아래에 있는 SystemTrayIcon 객체입니다.

rightMouseUp

이벤트

이벤트 객체 유형: flash.events.ScreenMouseEvent
속성 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

런타임 버전:

AIR 1.0

마우스 오른쪽 버튼을 누르지 않은 상태에서 이 SystemTrayIcon 객체에 의해 전달됩니다.

ScreenMouseEvent.RIGHT_MOUSE_UP 상수는 rightMouseUp 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 관련 속성이 있습니다.

속성	값
`buttonDown`	마우스 기본 버튼이 눌러져 있으면 `true`이고, 그렇지 않으면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`commandKey`	Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`screenX`	화면 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다.
`screenY`	화면 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다.
`target`	포인팅 장치 아래에 있는 SystemTrayIcon 객체입니다.

상수 세부 정보

MAX_TIP_LENGTH

상수

public static const MAX_TIP_LENGTH:Number = 63

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

시스템 트레이 아이콘 도구 설명에 대해 허용되는 길이입니다.

법적 고지 사항 | 온라인 개인 정보 보호 정책

SystemTrayIcon - AS3

패키지x

언어 요소

부록

패키지 flash.desktop

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH