包 | mx.managers |
类 | public class ToolTipManager |
继承 | ToolTipManager EventDispatcher Object |
另请参见
属性 | 定义方 | ||
---|---|---|---|
constructor : 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 | ||
prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | ||
scrubDelay : Number [静态] 在 Flex 再次等待 showDelay 持续显示工具提示之前,用户在各控件间移动鼠标时可以花费的时间(以毫秒为单位)。 | ToolTipManager | ||
showDelay : Number [静态] 当用户将鼠标移至具有工具提示的组件上方时,Flex 等待 ToolTip 框出现所需的时间(以毫秒为单位)。 | ToolTipManager | ||
showEffect : IAbstractEffect [静态] 显示工具提示时播放的效果;如果工具提示在显示时不应显示任何效果,则为 null。 | ToolTipManager | ||
toolTipClass : Class [静态] 创建工具提示要用到的类。 | ToolTipManager |
方法 | 定义方 | ||
---|---|---|---|
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 | ||
将事件调度到事件流中。 | EventDispatcher | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
指示对象是否已经定义了指定的属性。 | Object | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
设置循环操作动态属性的可用性。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | 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 实例。 |