This page was saved using jaction on 2006-09-04 8:34:08.
Address: http://flexdocs.kr/docs/flex2/langref/mx/managers/ToolTipManager.html
Title: mx.managers.ToolTipManager (Flex™ 2 레퍼런스 가이드)  •  Size: 40399
Packagemx.managers
Classpublic class ToolTipManager
InheritanceToolTipManager Inheritance EventDispatcher Inheritance Object

ToolTipManager 를 사용하면, 표시의 지연 시간이나 툴 힌트의 무효화 등, 툴 힌트나 에러 힌트의 기본적인 기능을 설정할 수 있습니다.

See also

mx.controls.ToolTip
mx.validators.Validator
툴 힌트 매니저의 사용
다이나믹 툴 힌트 텍스트의 사용


Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  currentTarget : DisplayObject
[static] 현재 툴 힌트를 표시하고 있는 UIComponent 입니다. 표시되고 있는 툴 힌트가 없는 경우는 null 가 됩니다.
ToolTipManager
  currentToolTip : IToolTip
[static] 현재 표시되고 있는 ToolTip object입니다. 표시되고 있는 ToolTip object가 없는 경우는 null 가 됩니다.
ToolTipManager
  enabled : Boolean = true
[static] true 의 경우, 유저가 마우스 포인터를 컴퍼넌트상으로 이동하면, ToolTipManager 가 자동적으로 툴 힌트를 표시합니다.
ToolTipManager
  hideDelay : Number = 10000
[static] 표시된 툴 힌트를 비표시로 하기까지 Flex 가 대기하는 시간 (밀리 세컨드)입니다.
ToolTipManager
  hideEffect : Effect
[static] 툴 힌트를 비표시로 할 경우에 재생하는 effect입니다. effect를 사용하지 않고 툴 힌트를 비표시로 하는 경우는 null 가 됩니다.
ToolTipManager
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  scrubDelay : Number = 100
[static] 유저가 컨트롤간에 마우스 포인터를 이동했을 때에, Flex 가 다음의 툴 힌트를 표시할 때까지의 시간 (showDelay 로 지정된 시간)을 재차 대기할 때까지의 시간 (밀리 세컨드)입니다.
ToolTipManager
  showDelay : Number = 500
[static] 툴 힌트를 가지는 컴퍼넌트상에 마우스를 이동했을 때, 툴 힌트 박스를 표시시키기까지 Flex 가 대기하는 시간 (밀리 세컨드)입니다.
ToolTipManager
  showEffect : Effect
[static] 툴 힌트를 표시할 경우에 재생하는 effect입니다. effect를 사용하지 않고 툴 힌트를 표시하는 경우는 null 가 됩니다.
ToolTipManager
  toolTipClass : Class
[static] 툴 힌트의 작성에 사용하는 클래스입니다.
ToolTipManager
Public Methods
 Methods정의
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
  createToolTip (text:String , x:Number , y:Number , errorTipBorderStyle:String = null, context:IUIComponent = null):ToolTip
[static] 지정된 텍스트를 사용한 ToolTip 클래스의 인스턴스를 작성해, 스테이지 좌표의 지정된 위치에 표시합니다.
ToolTipManager
  destroyToolTip (toolTip:IToolTip ):void
[static] createToolTip() Methods로 작성된 특정의 ToolTip 를 파기합니다.
ToolTipManager
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 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
property의 상세
currentTargetproperty
public static var currentTarget:DisplayObject

현재 툴 힌트를 표시하고 있는 UIComponent 입니다. 표시되고 있는 툴 힌트가 없는 경우는 null 가 됩니다.

currentToolTipproperty 
public static var currentToolTip:IToolTip

현재 표시되고 있는 ToolTip object입니다. 표시되고 있는 ToolTip object가 없는 경우는 null 가 됩니다.

enabledproperty 
public static var enabled:Boolean = true

true 의 경우, 유저가 마우스 포인터를 컴퍼넌트상으로 이동하면, ToolTipManager 가 자동적으로 툴 힌트를 표시합니다. false 의 경우, 툴 힌트는 표시되지 않습니다.

디폴트치true.

hideDelayproperty 
public static var hideDelay:Number = 10000

표시된 툴 힌트를 비표시로 하기까지 Flex 가 대기하는 시간 (밀리 세컨드)입니다. 툴 힌트가 비표시가 된 후, 다시 툴 힌트를 표시하려면 , 일단 컴퍼넌트의 외측에 마우스를 이동해, 재차 그 컴퍼넌트에 마우스를 거듭할 필요가 있습니다. hideDelay property를 Infinity 로 설정했을 경우, 마우스를 컴퍼넌트의 외측으로 이동하는 등, 유저가 어떠한 이벤트를 방아쇠 할 때까지 툴 힌트는 표시된 채로 있습니다.

디폴트치10000.

hideEffectproperty 
public static var hideEffect:Effect

툴 힌트를 비표시로 할 경우에 재생하는 effect입니다. effect를 사용하지 않고 툴 힌트를 비표시로 하는 경우는 null 가 됩니다.

디폴트치null.

scrubDelayproperty 
public static var scrubDelay:Number = 100

유저가 컨트롤간에 마우스 포인터를 이동했을 때에, Flex 가 다음의 툴 힌트를 표시할 때까지의 시간 (showDelay 로 지정된 시간)을 재차 대기할 때까지의 시간 (밀리 세컨드)입니다.

이 설정은, 유저가 컨트롤간에 마우스를 재빠르게 이동했을 경우에 도움이 됩니다. 예를 들어, Flex 가 최초의 툴 힌트를 표시한 후, 대기하지 않고 곧바로 다른 툴 힌트를 표시하도록 할 수 있습니다. scrubDelay 의 설정이 짧을 정도(수록), 유저가 다음의 툴 힌트가 표시 될 때까지 showDelay 로 지정된 시간을 대기하는 필요성이 높아집니다. 이 property는, 툴바에 복수의 버튼이 있어, 유저가 각각의 간결한 설명을 봐 재빠르게 그러한 기능을 파악하는 경우에 유효합니다.

디폴트치100.

showDelayproperty 
public static var showDelay:Number = 500

툴 힌트를 가지는 컴퍼넌트상에 마우스를 이동했을 때, 툴 힌트 박스를 표시시키기까지 Flex 가 대기하는 시간 (밀리 세컨드)입니다. 툴 힌트를 즉시에 표시하려면 ,showDelay 를 0 으로 설정합니다.

디폴트치500.

showEffectproperty 
public static var showEffect:Effect

툴 힌트를 표시할 경우에 재생하는 effect입니다. effect를 사용하지 않고 툴 힌트를 표시하는 경우는 null 가 됩니다.

디폴트치null.

toolTipClassproperty 
public static var toolTipClass:Class

툴 힌트의 작성에 사용하는 클래스입니다.

디폴트치mx.controls.ToolTip.

Methods의 상세
createToolTip()Methods
public static function createToolTip(text:String , x:Number , y:Number , errorTipBorderStyle:String = null, context:IUIComponent = null):ToolTip

지정된 텍스트를 사용한 ToolTip 클래스의 인스턴스를 작성해, 스테이지 좌표의 지정된 위치에 표시합니다.

툴 힌트는, 커서를 제외한 모든 엘리먼트의 상부에 독자적인 층에서 표시됩니다.

툴 힌트의 표준적인 사용 방법은,toolTip property가 설정된 object상에 유저가 마우스를 이동했을 때에, ToolTipManager 에 의해 자동적으로 툴 힌트가 표시 및 비표시되도록(듯이) 하는 것입니다. ToolTipManager 의 enabled property를 false 로 설정하면, 이 자동 툴 힌트 관리를 무효로 할 수 있습니다.

한편, 이 Methods (hideToolTip())를 사용하면, 툴 힌트를 프로그램으로 제어할 수 있습니다. 툴 힌트를 언제, 어디에 표시하는지를 선택하는 것이 가능해, 한층 더 필요에 따라서 복수의 툴 힌트를 표시할 수도 있습니다. (ToolTipManager 로 이러한 조작을 실시할 것은 없습니다. 이것을 실시하면, 통상은 유저를 혼란시키게 되기 (위해)때문에입니다).

이 Methods는 툴 힌트의 새로운 인스턴스를 작성하고 나서,addChild() Methods를 호출해, 이 인스턴스를 SystemManager 의 toolTips 층에 배치합니다. 에러 힌트를 표시하는 경우는, 이 Methods가 적절한 스타일을 설정합니다. 다음에, 툴 힌트의 텍스트를 설정해, 그 텍스트에 근거해 툴 힌트의 크기를 설정해, 지정된 장소에 배치합니다.

이 Methods가 돌려주는 툴 힌트에의 참조를 보존해,hideToolTip() Methods에 건네줄 수 있도록(듯이) 할 필요가 있습니다.

Parameters
text:String — 툴 힌트의 인스턴스에 표시하는 텍스트입니다.
 
x:Number — 툴 힌트의 스테이지 좌표에서의 수평 좌표. 복수의 단계가 있는 경우는,context 인수로부터 현재 관련하고 있을 단계를 판별할 수 있습니다.
 
y:Number — 툴 힌트의 스테이지 좌표에서의 수직 좌표. 복수의 단계가 있는 경우는,context 인수로부터 현재 관련하고 있을 단계를 판별할 수 있습니다.
 
errorTipBorderStyle:String (default = null) — 에러 힌트의 경계선 스타일. 이 Methods의 Parameters는, null,"errorTipRight","errorTipAbove", 또는 "errorTipBelow" 의 어느 쪽인가에 됩니다. null 의 경우,createToolTip() Methods는 표준 툴 힌트를 작성합니다. "errorTipRight","errorTipAbove", 또는 "errorTipBelow" 의 경우,createToolTip() Methods는 에러 힌트를 작성해, 이 Parameters에 의해 에러 힌트의 화살표가 어디를 가리킬지가 결정됩니다 (에러의 타겟). 예를 들어,"errorTipRight" 를 건네주면, Flex 에서는 에러 힌트를 에러 타겟의 우측으로 배치합니다 (x 및 y Parameters를 사용). 화살표는, 에러 힌트의 좌단에 있습니다.
 
context:IUIComponent (default = null) — 이 property는 현재 사용되고 있지 않습니다.

반환값
ToolTip — 새롭게 작성된 툴 힌트입니다.
destroyToolTip()Methods 
public static function destroyToolTip(toolTip:IToolTip ):void

createToolTip() Methods로 작성된 특정의 ToolTip 를 파기합니다.

이 Methods는 removeChild() Methods를 호출해, 지정된 툴 힌트를 SystemManager 의 ToolTips 층으로부터 삭제합니다. 이 툴 힌트에의 참조를 유지하지 않는 한, 툴 힌트는 가베지 콜렉션 됩니다.

이 Methods는, ToolTipManager 의 currentToolTip 로 사용해 되지 않습니다.

Parameters
toolTip:IToolTip — 파기하는 툴 칩의 인스턴스입니다.






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/managers/ToolTipManager.html