ITeye博客

flex ToolTip汇总

demojava · 2011-09-27 20:55 · Adobe · Web前端 · Markdown

flex ToolTip

1.toolTip换行符 <mx:Button id="btn1" toolTip="在工具条提示中 使用换行符"/>

2.设定工具条提示的样式

<mx:Style>
	ToolTip
	{
		fontSize:19;
		color:#FF6699;
	}
</mx:Style>

3.设定工具提示宽度


<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="init()">
<mx:Script>
	<![cdata[
		import mx.controls.tooltip;
		public function init():void
		{
			tooltip.maxwidth=100;
		}
		]]>
</mx:Script>

3.使用工具条提示事件 toolTipCrate toolTipEnd toolTipHide toolTipShow toolTipShown toolTipStart


<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="init()">
<mx:Script>
	<![cdata[
		import mx.events.tooltipevent;
		import flash.media.sound;
		[embed(source="demo.mp3")]
		private var beepSound:Class;
		private var myClip:Sound;
		public function init():void
		{
			TooTip.maxWidth=100;
		}

		public function playSoune():void
		{
			myClip.play();
		}

		public function myListener(event:ToolTipEvent):void
		{
			playSoune();
		}
		
		public function init():void
		{
			lbl.addEventListener(ToolTipEvent.TOOL_TIP_SHOW,myListener);
			myClip=new beepSound();
		}
		]]>
</mx:Script>
<mx:Label id="lbl" toolTip="demo ToolTip" text="mouse over here" />

4.ToolTip Manager ToolTip Manager 类用来管理toolTip属性,包含在mx.managers包中 使用ToolTip Manager 延迟工具条显示的时间,在工具条上使用行为效果 建立动态的工具条提示,使用自定义的工具条提示

公共属性 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 创建工具提示要用到的类。

1.控制工具条的显示隐藏 ToolTip Manager enabled属性来定义工具条提示状态,默认为true,设定为false就表示禁用 2.延迟工具条的提示时间 showDelay 默认为500毫秒 当鼠标在控件之间移动时,flex等待显示工具条提示的时间长度 hideDelay 默认值为10000毫秒 如果设定hideDelay属性值为0,flex不显示工具条提示,如果设定为Infinity,flex则一致显示工具提示 直到下一个动作,或者鼠标离开主键 例如: ToolTipManager.showDelay=0;//立即显示 ToolTipManager.hideDelay=3000;//3s秒后隐藏 3.在工具条上使用动画效果



<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="init()">
<mx:Script>
	<![cdata[
		import mx.managers.tooltipmanager;
		import mx.events.tooltipevent;
		import flash.media.sound;
		[embed(source="demo.mp3")]
		private var beepSound:Class;
		private var myClip:Sound;
		public function init():void
		{
			TooTip.maxWidth=100;
			ToolTipManager.showEffect=fadeIn;
		}
		]]>
</mx:Script>
<mx:Label id="lbl" toolTip="demo ToolTip" text="mouse over here" />
<mx:Fade id="fadeIn" alphaFrom="0" alphaTo="1" duration="1000" />
<mx:Panel >
	<mx:Button id="btn" toolTip="demoasdf" />
</mx:Panel >

4.建立动态工具条体提示 ToolTipManager有两种方法,即:createToolTip()和destroyToolTip() 建立一个工具条提示对象时,可以定义其属性,样式,事件和效果。 crateToolTip()方法结构 createToolTip(text:String, x:Number, y:Number, errorTipBorderStyle:String = null, context:IUIComponent = null):IToolTip 使用指定的文本创建 ToolTip 类的实例,然后在舞台坐标中的指定位置显示此实例。 ToolTipManager destroyToolTip(toolTip:IToolTip):void 销毁由 createToolTip() 方法创建的指定 ToolTip。 例如: <mx:Label id="lbl" toolTip="demo ToolTip" text="mouse over here" /> <mx:Button id="btn1" toolTip="填写的是{lbl.text}"/>

5.建立用户自定义的工具条提示



<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" >
<mx:Script>
	<![cdata[
		import mx.managers.tooltipmanager;
		import mx.events.tooltip;
		public var mytip:tooltip;

		public function init():void
		{
			var s:string ="保存,应用,退出";
			myTip=ToolTipManager.createToolTip(s,10,10) as ToolTip;
			myTip.setStyle("backgroundColor",0xFFCC00);
			myTip.width=300;
			myTip.height=40;
		}

		public funciton destroyBigTip():void
		{
			ToolTipManager.destroyToolTip(myTip);
		}
		]]>
</mx:Script>
	<mx:Button id="btn" toolTip="test toolTip" rollOver="init()" rollOut="destroyBigTip()"/>

6.使用错误信息提示工具条

<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" > mx:Script <!

7.重写工具条皮肤 ToolTip皮肤存在mx.skins.ToolTipBorder.as文件中 当然需要重写的时候就可以 ToolTipBorder 类继承的类就可以了 例如:

package
{
	import mx.skins.RectangularBorder;

	public class MyToolTipBorder extends RectangularBorder
	{
		public function MyToolTipBorder()
		{
			super();
		}
		
		override protected function updateDisplayList(unscaledWidth:Number,
                                                  unscaledHeight:Number):void
	    {
	    	
	    }
	    
	     override   public function layoutBackgroundImage():void {
	        	
	        }
	}
}mxml中使用
<mx:Style>
	ToolTip
	{
		borderSkin:ClassReference("MyToolTipBorder");
	}
</mx:Style>


自定义皮肤 参见:http://demojava.iteye.com/blog/1175446

简单DateGird Item ToolTip 1.使用 dataTipFunction函数 <mx:DataGrid id="dg" width="100%" height="100%" rowHeight="22" dataTipFunction="buildToolTip">


private function buildToolTip(item:Object):String{ 
mx.styles.StyleManager.getStyleDeclaration("ToolTip").setStyle("fontSize",12);
   var myString:String = ""; 
    if(item != null) 
   { 
   myString = myString + "Firstname : "+item.firstname+ "/n"; 
   myString = myString + "Lastname : " + item.lastname+"/n"
   } 
   return myString; 
   }

2.DataGridColumn 上设置: <mx:DataGridColumn headerText="Text" dataField="text" dataTipField="text" showDataTips="true" />

自定义DateGird Item ToolTip 效果图: 自定义ToolTip

renderers.MenuToolTipRenderer as 实现接口 IMenuItemRenderer, IDataRenderer, IListItemRenderer


package renderers
{
import flash.events.Event;
import flash.events.MouseEvent;
import flash.text.TextFieldAutoSize;

import mx.controls.Alert;
import mx.controls.LinkButton;
import mx.controls.Menu;
import mx.controls.listClasses.IListItemRenderer;
import mx.controls.menuClasses.IMenuItemRenderer;
import mx.core.EdgeMetrics;
import mx.core.IDataRenderer;
import mx.core.UIComponent;
import mx.core.UITextField;
import mx.events.FlexEvent;


public class MenuToolTipRenderer extends UIComponent implements IMenuItemRenderer, IDataRenderer, IListItemRenderer
{
	

	private var textField:UITextField;
	private var clickText:LinkButton;
	public function get measuredTypeIconWidth():Number//类型图标(单选/复选)的宽度 
	{
		return 33;
	}
	public function get measuredBranchIconWidth():Number//分支图标的宽度 
	{
		return 33;
	}
	public function get measuredIconWidth():Number//图标的宽度
	{
		return 33;
	}

	
	//-------------------------------------------------------------------------
	
	public function MenuToolTipRenderer()
	{
		super();
		this.addEventListener(FlexEvent.DATA_CHANGE, renderComponent);
		this.setStyle("cornerRadius", 5);
		this.maxWidth = 250;

	}
	
	//-------------------------------------------------------------------------
	
	// Internal variable for the property value.
	private var _menu:Menu;

	public function get menu():Menu
	{
		return _menu;
	}

	public function set menu(value:Menu):void
	{
		_menu = value;
	}
	
	//-------------------------------------------------------------------------
	

    private var _data:Object;
    

    [bindable("datachange")]
    public function get data():Object {
	return _data;
    }

    public function set data(value:Object):void {
	_data = value;
    
	dispatchEvent(new FlexEvent(FlexEvent.DATA_CHANGE));
    }
    
    //-------------------------------------------------------------------------
	
	private function get borderMetrics():EdgeMetrics
	{
		return EdgeMetrics.EMPTY;
	}
	
	//-------------------------------------------------------------------------
	
	private function renderComponent(event:FlexEvent):void
	{
		if(_data != null && _data != "null")
		{
			textField.htmlText = data.label;
			invalidateProperties();
			invalidateSize();
			invalidateDisplayList();
			
		}
	}
	
	//-------------------------------------------------------------------------
	
	private function buttonClick(event:Event):void
	{
		mx.controls.Alert.show("button click");
	}
	
	//-------------------------------------------------------------------------
	
	override protected function createChildren():void
	{
		super.createChildren();

		// Create the TextField that displays the tooltip text.
		if (!textField)
		{
			textField = new UITextField();
			textField.autoSize = TextFieldAutoSize.LEFT;
			textField.mouseEnabled = false;
			textField.multiline = true;
			textField.selectable = false;
			textField.wordWrap = true;
			textField.styleName = this;
			addChild(textField);	
		}
	}
	
	//-------------------------------------------------------------------------
	
	
	override protected function measure():void
	{
		super.measure();

		var bm:EdgeMetrics = borderMetrics;

		var leftInset:Number = bm.left + getStyle("paddingLeft");
		var topInset:Number = bm.top + getStyle("paddingTop");
		var rightInset:Number = bm.right + getStyle("paddingRight");
		var bottomInset:Number = bm.bottom + getStyle("paddingBottom");

		var widthSlop:Number = leftInset + rightInset;
		var heightSlop:Number = topInset + bottomInset;

		textField.wordWrap = false;

		if (textField.textWidth + widthSlop > this.maxWidth)
		{
			textField.width = this.maxWidth - widthSlop;
			textField.wordWrap = true;
		}

		measuredWidth = textField.width + widthSlop;
		measuredHeight = textField.height + heightSlop;
		
		this.parent.parent.height = this.parent.height = this.height = measuredHeight + 25;
		this.parent.parent.width = this.parent.width = this.width = measuredWidth;
		
		createAdditionalContent(measuredWidth, measuredHeight);
	}
	
	private function createAdditionalContent(measuredWidth:Number, measuredHeight:Number):void
	{
		clickText = new LinkButton();
		clickText.label = "More Info";
		clickText.width = 70;
		clickText.height = 18;
		clickText.setStyle("fontSize", 9);
		clickText.setStyle("color", "blue");
		clickText.buttonMode = true;
		clickText.visible = true;
		clickText.y = measuredHeight;
		clickText.x = measuredWidth - clickText.width - 8;
		
		clickText.addEventListener(MouseEvent.CLICK, dispatchClick);

		addChild(clickText);
	}
	
	private function dispatchClick(e:Event):void
	{
		this.dispatchEvent(new Event("buttonClicked", true))
	}
}
}

Application.xml


<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" initialize="init()" 
			viewSourceURL="srcview/index.html" width="600" height="300">

<mx:DataGrid id="dg" dataProvider="{tmpArray}" width="550"
			 mouseOut="dgMouseOut(event)" mouseOver="dgMouseOver(event)" mouseMove="dgMouseMove(event)">
	<mx:columns>
		<mx:Array>
			<mx:DataGridColumn headerText="Label" dataField="label" showDataTips="true" />
			<mx:DataGridColumn headerText="Data" dataField="data" />
		</mx:Array>
	</mx:columns>
</mx:DataGrid>

<mx:Style>
	
	.menuToolTip {
		   backgroundAlpha: 1;
		   backgroundColor: #ffffcc;
		   useRollOver: false;
		   borderStyle: solid;
		   borderThickness: 0;
		   borderColor: #000000;
		   selectionColor: #7fcdfe;
		   dropShadowEnabled: true;
		   cornerRadius: 5;
		   paddingLeft: 3; paddingRight: 3; paddingTop: 3; paddingBottom: 3;
		   
		}
	
</mx:Style>

<mx:Script>
	<![cdata[
		import mx.automation.delegates.controls.listbasecontentholderautomationimpl;
		import mx.controls.listclasses.listbase;
		import renderers.menutooltiprenderer;
		import mx.controls.datagridclasses.datagriditemrenderer;
		
		import mx.managers.tooltipmanager;
		import mx.controls.menu;
		import mx.events.menuevent;
		import flash.geom.point;
		
		[bindable] private var dgMouseX:Number = 0;
		[bindable] private var dgMouseY:Number = 0;
		
		private var toolTipMenu:Menu;
		private var toolTipTimer:Timer;
		
		[bindable]
		public var tmpArray:Array = [{label: '<b>mary</b> had a little lamb', data: 55, link:'http://www.meutzner.com/blog'}, 
								     {label: 'all the kings men, and all the kings horses', data: 56, link:'http://www.meutzner.com/blog'}, 
								     {label: 'baa baa black sheep, have you any wool', data: 57, link:'http://www.meutzner.com/blog'}, 
								     {label: 'jack and jill went up the hill', data: 58, link:'http://www.meutzner.com/blog'}, 
								     {label: 'little miss muffet, sat on a tuffet, eating her curds and whey', data: 59, link:'http://www.meutzner.com/blog'}
								    ];
		
		//-------------------------------------------------------------------------
		
		public function init():void
		{
			ToolTipManager.enabled = false;
		}
		
		//-------------------------------------------------------------------------
		
		private function createMenu(data:Object):void 
    {
	toolTipTimer.stop();
	var menuData:Array = [{label: data.label, link: data.link}];
	
	
	
	toolTipMenu = Menu.createMenu(this, menuData, false);
	toolTipMenu.labelField="label";
	toolTipMenu.width = 250;
	toolTipMenu.setStyle("fontSize", 10);
	toolTipMenu.setStyle("themeColor", 0xFF9900);
	toolTipMenu.itemRenderer = new ClassFactory(renderers.MenuToolTipRenderer);
	toolTipMenu.data = data;
	toolTipMenu.selectable = false;
	toolTipMenu.setStyle("styleName", "menuToolTip");
	toolTipMenu.setStyle("openDuration", 0);

	//toolTipMenu.setStyle("selectionEasingFunction", myEasingFunction);
	toolTipMenu.addEventListener(MouseEvent.ROLL_OUT, hideToolTip);
	toolTipMenu.addEventListener("buttonClicked", catchButtonClick);
	
	var pt1:Point = new Point(this.dgMouseX, this.dgMouseY);
			pt1 = dg.localToGlobal(pt1);
			//offset this for now to fix slight bug where immediate mouseover of tooltip causes it to hide
	toolTipMenu.show(pt1.x+10, pt1.y+0);
	
    }
    
    //-------------------------------------------------------------------------
    
    private function hideToolTip(event:MouseEvent):void
    {
	//trace("MENU --- " + event.relatedObject + " - " + event.target + " - " + event.currentTarget);
	toolTipMenu.hide();
    }
    
    //-------------------------------------------------------------------------
    
    private function dgMouseMove(event:MouseEvent):void
    {
	this.dgMouseX = dg.mouseX;
	this.dgMouseY = dg.mouseY;
    }
    
    
    //-------------------------------------------------------------------------
    
    private function dgMouseOver(event:MouseEvent):void
    {
	this.dgMouseX = dg.mouseX;
	this.dgMouseY = dg.mouseY;
	//trace("DATAGRID OVER --- " + event.target + " - " + event.currentTarget + " - " + event.relatedObject);
	if(event.target is DataGridItemRenderer)
	{
		if(toolTipMenu != null)
		{
			if(toolTipMenu.visible && toolTipMenu.data == event.target.data) 
				return;
		}
		if(!DataGridItemRenderer(event.target).styleName.showDataTips)
			return;
			
		toolTipTimer = new Timer(1000, 0);
		toolTipTimer.addEventListener(TimerEvent.TIMER, function():void 
																 { 
																	createMenu(event.target.data);
																 } 
									  );
		toolTipTimer.start();
	}
    }
    
    //-------------------------------------------------------------------------
    
    private function dgMouseOut(event:MouseEvent):void
    {
	if(toolTipTimer) toolTipTimer.stop();
	//trace("DATAGRID OUT --- " + event.target + " - " + event.currentTarget + " - " + event.relatedObject);
	if(event.relatedObject is mx.controls.listClasses.ListBaseContentHolder || event.relatedObject is MenuToolTipRenderer)
	{
		return;
	}
	if(event.target is DataGridItemRenderer)
	{
		if(event.relatedObject is Menu || !event.relatedObject is MenuToolTipRenderer) return;
		if(toolTipMenu != null) toolTipMenu.hide();
	    }
    }
    
    //-------------------------------------------------------------------------
    
    private function catchButtonClick(e:Event):void 
		{
	mx.controls.Alert.show(e.target.data.label + " was clicked to take you to " + e.target.data.link);
    }

		
	]]>
</mx:Script>

</mx:Application>

附件为源文件

  1. 设置ToolTip风格(通过css来设置) ToolTip {
    fontFamily: "Arial";
    fontSize: 13;
    fontStyle: "italic";
    color: #FF6699;
    backgroundColor: #33CC99;
    } 当然这个可以通过css来动态设置例如: StyleManager.getStyleDeclaration("ToolTip").setStyle("fontStyle","italic");
  2. 错误提示errotTip errorTip { border-style:"errorTipRight"; } 其中border-style其对应的格式决定小三角的方位,可选值: <mx:TextInput x="85" y="118" text="021-阿萨德发送" errorString="输入有误!" /> 如果想修改源码,改变小三角的大小或者位置的话就需要自定义border-skin ToolTip { border-skin:ClassReference("com.MyToolTipBorder"); } 其中 com.MyToolTipBorder其中是一个继承了RectangularBorder的类,源码参见附件, ToolTip默认的skin-class路径在sdk sdks\3.0.0\frameworks\projects\framework\src\mx\skins\halo\ToolTipBorder 引入包的路径:import mx.skins.halo.ToolTipBorder; 笔者发现 ToolTipBorder 的类对于4个方向支持不是很好,其中最右边的提示,也就是小三角在右边的没有,把源码修改了下(附件中有MyToolTipBorder) 改变默认的错误提示的背景色设置4个方向的提示

  1. 使用ToolTipManager动态创建自定义的tooltip; 使用ToolTipManager管理器类能够让你设置基本的ToolTip功能。比如显示延迟,以及控制是否显示ToolTip信息内容。 你可以在程序中激活和停止使用ToolTips. 可以使用enabled这个属性来激活或者停止使用ToolTips,如果停止使用,在鼠标移到到组件上方的时候就不会用ToolTips的框显示出来,不管那个组件是否设置了toolTip这个属性值 设置ToolTipManager的常用属性介绍 ToolTipManager.enabled = true;//鼠标移入控件自动显示工具提示 ToolTipManager.showDelay = 0; //flex 等待tooltip出现的时间单位毫秒默认500 ToolTipManager. hideDelay=3000; //flex 隐藏tooltip所需的事件等待量 单位毫秒,默认500 ToolTipManager.showEffect= fadeIn; //显示tooltip的特效 ToolTipManager. hideEffect= fadeIn; //隐藏 tooltip的特效 <mx:Fade id="fadeIn" alphaFrom="0" alphaTo="1" duration="1000"/>
  2. 使用ToolTipManager createToolTip,destroyToolTip来动态创建自定义tooltip 一般自定义tooltip都是在控件的 MouseEvent. ROLL_OVER(rollOver) MouseEvent. MOUSE_OVER (mouseOver) 控制自定义tooltip的显示 MouseEvent. ROLL_OUT (rollOut) MouseEvent. MOUSE_OUT (mouseOut) 控制自定义tooltip的隐藏 现已rollOver结合ToolTipManager实现自定义tooltip

<mx:Script>
	<![cdata[
import mx.managers.tooltipmanager;
public var mytip:tooltip;
private function showtip(event:mouseevent,type:string):void
{
tip=ToolTipManager.createToolTip(str,event.stageX,event.stageY) as ToolTip;
//根据需要动态设置tooltip的style属性
myTip.move(event.stageX,event.stageY);
}
private function hideTip():void
	{
		ToolTipManager.destroyToolTip(myTip);
	}
	]]>
</mx:Script>

  1. 实现mx.core.IToolTip接口自定义toolTip的外观(可选as实现该接口,mxml实现该接口) 现已mxml实现该接口为例(简单), MyPanelToolTip.mxml

<mx:Panel xmlns:mx="http://www.adobe.com/2006/mxml"  
    implements="mx.core.IToolTip"  
    width="212"  
    borderThickness="2"  
   backgroundColor="0xCCCCCC"  
   dropShadowEnabled="true"  
   borderColor="black"  
   roundedBottomCorners="true"
    height="90">   
   <mx:Script>
   <![cdata[  
   //注意 panel 中的  implements="mx.core.IToolTip"  
   [Bindable]   
   private var _text:String="";  
   public function get text():String {  
   return _text ;
   }  
   public function set text(value:String):void {
   		this._text=value;  
   }  
   ]]></mx:Script>  
   <mx:Text text="{text}" percentWidth="100"/>  
   </mx:Panel>

使用时: private function createCustomTip(title:String, body:String, event:ToolTipEvent):void { var pan:MyPanelToolTip = new MyPanelToolTip(); pan.title = title; pan.text=body; event.toolTip = pan; } <mx:Button id="btn3" label="button" x="275.5" toolTip="demo" toolTipCreate="createCustomTip('自定义tooltip','该tooltip实现mx.core.IToolTip接口,注意是控件必须设置toolTip属性的值',event)" y="187"/> 6. 自定义组件(继承UIComponent)结合mouseover事件形式
效果图:

评论(1)

  1. #1 楼 · zlbdexiaohao · 2015-07-17 15:28

    :idea: :idea: 棒棒的

评论功能维护中,当前仅展示历史评论。