mx.managers
public class ToolTipManager
继承ToolTipManager Inheritance EventDispatcher Inheritance Object

通过 ToolTipManager,您可以设置基本的工具提示和错误提示功能,如显示延迟和禁用的工具提示。

另请参见

mx.controls.ToolTip
mx.validators.Validator
Using the ToolTip Manager
Using the ToolTip Manager


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  currentTarget : DisplayObject
[静态] 当前显示工具提示的 UIComponent;如果未显示工具提示,则为 null。
ToolTipManager
  currentToolTip : IToolTip
[静态] 当前可见的 ToolTip 对象;如果未显示 ToolTip 对象,则为 null。
ToolTipManager
  enabled : Boolean
[静态] 如果为 true,则当用户将鼠标指针移至组件上方时,ToolTipManager 会自动显示工具提示。
ToolTipManager
  hideDelay : Number
[静态] 自工具提示出现时起,Flex 要隐藏此提示前所需等待的时间量(以毫秒为单位)。
ToolTipManager
  hideEffect : IAbstractEffect
[静态] 隐藏工具提示时播放的效果;如果工具提示在消失时不应显示任何效果,则为 null。
ToolTipManager
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  scrubDelay : Number
[静态] 在 Flex 再次等待 showDelay 持续显示工具提示之前,用户在各控件间移动鼠标时可以花费的时间(以毫秒为单位)。
ToolTipManager
  showDelay : Number
[静态] 当用户将鼠标移至具有工具提示的组件上方时,Flex 等待 ToolTip 框出现所需的时间(以毫秒为单位)。
ToolTipManager
  showEffect : IAbstractEffect
[静态] 显示工具提示时播放的效果;如果工具提示在显示时不应显示任何效果,则为 null。
ToolTipManager
  toolTipClass : Class
[静态] 创建工具提示要用到的类。
ToolTipManager
公共方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
  
createToolTip(text:String, x:Number, y:Number, errorTipBorderStyle:String = null, context:IUIComponent = null):IToolTip
[静态] 使用指定的文本创建 ToolTip 类的实例,然后在舞台坐标中的指定位置显示此实例。
ToolTipManager
  
[静态] 销毁由 createToolTip() 方法创建的指定 ToolTip。
ToolTipManager
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 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 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
属性详细信息
currentTarget属性
currentTarget:DisplayObject  [读写]

当前显示工具提示的 UIComponent;如果未显示工具提示,则为 null



实现
    public static function get currentTarget():DisplayObject
    public function set currentTarget(value:DisplayObject):void
currentToolTip属性 
currentToolTip:IToolTip  [读写]

当前可见的 ToolTip 对象;如果未显示 ToolTip 对象,则为 null



实现
    public static function get currentToolTip():IToolTip
    public function set currentToolTip(value:IToolTip):void
enabled属性 
enabled:Boolean  [读写]

如果为 true,则当用户将鼠标指针移至组件上方时,ToolTipManager 会自动显示工具提示。如果为 false,则不会显示任何工具提示。

默认值为 true.



实现
    public static function get enabled():Boolean
    public function set enabled(value:Boolean):void
hideDelay属性 
hideDelay:Number  [读写]

自工具提示出现时起,Flex 要隐藏此提示前所需等待的时间量(以毫秒为单位)。Flex 隐藏某一工具提示后,用户必须将鼠标从该组件移开后再移回才能重新看到此工具提示。如果将 hideDelay 设为 Infinity,则只有在用户触发某个事件(如将鼠标从该组件移开)时,Flex 才会隐藏该工具提示。

默认值为 10000.



实现
    public static function get hideDelay():Number
    public function set hideDelay(value:Number):void
hideEffect属性 
hideEffect:IAbstractEffect  [读写]

隐藏工具提示时播放的效果;如果工具提示在消失时不应显示任何效果,则为 null

默认值为 null.



实现
    public static function get hideEffect():IAbstractEffect
    public function set hideEffect(value:IAbstractEffect):void
scrubDelay属性 
scrubDelay:Number  [读写]

在 Flex 再次等待 showDelay 持续显示工具提示之前,用户在各控件间移动鼠标时可以花费的时间(以毫秒为单位)。

当用户在各控件间快速移动鼠标时,此设置将非常有用;在第一个工具提示显示完毕后,Flex 将立即显示其它工具提示,而不会等待。scrubDelay 中设置的时间越短,用户越有可能必须等够 showDelay 中指定的时间才能看到下一个工具提示。当一个工具栏中有多个按钮,并且用户需要快速在这些按钮之间进行扫描以查看各个按钮的功能简述时,此属性非常适用。

默认值为 100.



实现
    public static function get scrubDelay():Number
    public function set scrubDelay(value:Number):void
showDelay属性 
showDelay:Number  [读写]

当用户将鼠标移至具有工具提示的组件上方时,Flex 等待 ToolTip 框出现所需的时间(以毫秒为单位)。若要立即显示 ToolTip 框,请将 showDelay 设为 0。

默认值为 500.



实现
    public static function get showDelay():Number
    public function set showDelay(value:Number):void
showEffect属性 
showEffect:IAbstractEffect  [读写]

显示工具提示时播放的效果;如果工具提示在显示时不应显示任何效果,则为 null

默认值为 null.



实现
    public static function get showEffect():IAbstractEffect
    public function set showEffect(value:IAbstractEffect):void
toolTipClass属性 
toolTipClass:Class  [读写]

创建工具提示要用到的类。

默认值为 mx.controls.ToolTip.



实现
    public static function get toolTipClass():Class
    public function set toolTipClass(value:Class):void
方法详细信息
createToolTip()方法
public static function createToolTip(text:String, x:Number, y:Number, errorTipBorderStyle:String = null, context:IUIComponent = null):IToolTip

使用指定的文本创建 ToolTip 类的实例,然后在舞台坐标中的指定位置显示此实例。

ToolTip 在各自层中显示时,位于光标之下、其他所有对象之上。

使用 ToolTip 的标准方式是,允许 ToolTipManager 在用户将鼠标移动到设置了 toolTip 属性的对象上方时自动显示和隐藏工具提示。通过将 ToolTipManager 的 enabled 属性设为 false,可以关闭此 ToolTip 自动管理功能。

与此相反,将此方法与 destroyToolTip() 配合使用可以以编程方式控制 ToolTip。您可以在选择的时间和位置显示工具提示,如果需要,甚至还可以同时显示多个工具提示。(ToolTipManager 绝不执行此操作,因为这样通常会使用户感到迷惑。)

此方法首先会为创建一个新的 ToolTip 实例,然后调用 addChild() 方法将此实例放到 SystemManager 的工具提示层。如果出现错误提示,它会设置正确的样式。接着,它设置 ToolTip 的文本,根据文本大小调整 ToolTip 的大小,并将其放在指定的位置。

必须保存此方法返回的对 ToolTip 的引用,以便将其传递给 destroyToolTip() 方法。

参数

text:String — 要在 ToolTip 实例中显示的文本。
 
x:Number — ToolTip 在舞台坐标中的水平坐标。如果存在多个舞台,则根据 context 参数确定相关的舞台。
 
y:Number — ToolTip 在舞台坐标中的垂直坐标。如果存在多个舞台,则根据 context 参数确定相关的舞台。
 
errorTipBorderStyle:String (default = null) — 错误提示的边框样式。此方法参数可以是 null、“errorTipRight”、“errorTipAbove”或“errorTipBelow”。如果为 null,则 createToolTip() 方法将创建一个普通的 ToolTip。如果为“errorTipRight”、“errorTipAbove”或“errorTipBelow”,则 createToolTip() 方法将创建一个错误提示,而此参数将确定错误提示箭头的指向(错误的目标)。例如,如果传递“errorTipRight”,则 Flex 会将错误提示(通过 x 参数和 y 参数)放在错误目标的右侧;箭头位于错误提示的左边缘处。
 
context:IUIComponent (default = null) — 当前并不使用此属性。

返回
IToolTip — 新创建的 ToolTip。
destroyToolTip()方法 
public static function destroyToolTip(toolTip:IToolTip):void

销毁由 createToolTip() 方法创建的指定 ToolTip。

此方法可以调用 removeChild() 方法,以从 SystemManager 的 ToolTip 层中删除指定的工具提示。如果不保留对 ToolTip 的引用,随后就会将其作为垃圾进行回收。

您不应该对 ToolTipManager 的 currentToolTip 调用此方法。

参数

toolTip:IToolTip — 要销毁的 ToolTip 实例。