AS3 CookBook学习整理(八)
1. AS3的事件机制
事件流机制即为捕获--目标--冒泡,分别对应event.eventPhase的值1(EventPhase.CAPTURING_PHASE),2(EventPhase.AT_TARGET),3(EventPhase.BUBBLING_PHASE)
假设有3个Sprite,分别为绿、蓝、黄(如图),层叠关系为绿色包含蓝色,蓝色包含黄色
情况一:最顶层的黄色有一个点击事件,另外两个没有点击事件
结果:target是--黄色方块,currentTarget是--黄色方块,阶段是--2
情况二:三个Sprite都有一个点击事件,然后点击最上层的黄色方块
结果:
target是--黄色方块,currentTarget是--黄色方块,阶段是--2
target是--黄色方块,currentTarget是--蓝色方块,阶段是--3
target是--黄色方块,currentTarget是--绿色方块,阶段是--3
可以看出来,event的target始终是指单击的目标,属于目标阶段;而currentTarget指向处理事件(即活动)的目标,属于冒泡阶段,currentTarget属性应具备两个条件,一是它注册了侦听器,二是正在处理事件
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class Sample0413 extends Sprite { private var lblInfo:TextField; public function Sample0413() { var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(100,100,200,200); greenRect.graphics.endFill(); greenRect.addEventListener(MouseEvent.CLICK,onGreenClick); greenRect.name = "绿色方块"; this.addChild(greenRect); var blueRect:Sprite = new Sprite(); blueRect.graphics.beginFill(0x0000FF); blueRect.graphics.drawRect(130,130,150,150); blueRect.graphics.endFill(); blueRect.addEventListener(MouseEvent.CLICK,onBlueClick); blueRect.name = "蓝色方块"; greenRect.addChild(blueRect); var yellowRect:Sprite = new Sprite(); yellowRect.graphics.beginFill(0xFFFF00); yellowRect.graphics.drawRect(160,160,100,100); yellowRect.graphics.endFill(); yellowRect.addEventListener(MouseEvent.CLICK,onYellowClick); yellowRect.name = "黄色方块"; blueRect.addChild(yellowRect); lblInfo = new TextField(); lblInfo.background = true; lblInfo.x = 10; lblInfo.y = 20; lblInfo.width = 400; this.addChild(lblInfo); } private function onGreenClick(event:MouseEvent):void { this.lblInfo.appendText("你单击了绿色的方块\n"); } private function onBlueClick(event:MouseEvent):void { this.lblInfo.appendText("你单击了蓝色的方块\n"); } private function onYellowClick(event:MouseEvent):void { this.lblInfo.appendText("你单击了黄色的方块\n"); //event.stopImmediatePropagation(); } private function onClick(event:MouseEvent):void { var targetStr:String = "target是:" + (event.target as Sprite).name; var curTargetStr:String = "currentTarget是:" + (event.currentTarget as Sprite).name; var phaseStr:String = "阶段是:" + event.eventPhase; this.lblInfo.appendText(targetStr + "\t" + curTargetStr + "\t" + phaseStr + "\n"); } } }
2. FocusEvent焦点事件
一共有4个焦点事件:FocusIn、FocusOut、KEY_FOCUS_CHANGE、MOUSE_FOCUS_CHANGE
当焦点改变时focusIn和focusOut 事件会同时激活,它们属于不可取消的事件
keyFocusChange和mouseFocusChange是可取消的事件,可以调用FocusEvent.preventDefault( )方法取消默认事件
FocusEvent有一个relatedObject属性,对于focusIn而言,relatedObject属性是刚才拥有焦点的对象的;对于其它三个事件,relatedObject属性是现在接收到焦点的对象
package { import flash.display.Sprite; import flash.events.FocusEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFieldType; public class Sample0414 extends Sprite { private var lblInfo:TextField; public function Sample0414() { var textBox:TextField = new TextField(); textBox.name = "文本框A"; textBox.type = TextFieldType.INPUT; textBox.background = true; textBox.width = 200; textBox.height = 20; //textBox.addEventListener(FocusEvent.FOCUS_IN,onFocusIn); //textBox.addEventListener(FocusEvent.FOCUS_OUT,onFocusOut); textBox.addEventListener(FocusEvent.KEY_FOCUS_CHANGE,onKeyFocusChange); this.addChild(textBox); textBox = new TextField(); textBox.name = "文本框B"; textBox.type = TextFieldType.INPUT; textBox.background = true; textBox.width = 200; textBox.height = 20; textBox.y = 80; //textBox.addEventListener(FocusEvent.FOCUS_IN,onFocusIn); //textBox.addEventListener(FocusEvent.FOCUS_OUT,onFocusOut); textBox.addEventListener(FocusEvent.KEY_FOCUS_CHANGE,onKeyFocusChange); this.addChild(textBox); lblInfo = new TextField(); lblInfo.y = 200; lblInfo.autoSize = TextFieldAutoSize.CENTER; this.addChild(lblInfo); } private function onFocusIn(event:FocusEvent):void { var txt:TextField = event.target as TextField; txt.text = txt.name; if(event.relatedObject!=null) { lblInfo.text = "FocusIn的relatedObject是:" + (event.relatedObject as TextField).name; } } private function onFocusOut(event:FocusEvent):void { if(event.relatedObject!=null) { lblInfo.text = "FocusOut的relatedObject是:" + (event.relatedObject as TextField).name; } } private function onKeyFocusChange(event:FocusEvent):void { var txt:TextField = event.target as TextField; if(txt.text == "") { event.preventDefault();//当field没有任何文字前,不允许使用Tab键把焦点移除 } if(event.relatedObject!=null) {
var strRelatedObj:String = (event.relatedObject as TextField).name; lblInfo.text = "KeyFocusChange的relatedObject是:" + strRelatedObj; } } } }
3. 监听用户输入的文本
通过TextEvent事件监听用户对文本框内容的修改,如删除,剪切,插入或者拷贝等操作,对文本框的每一次修改都会激活textInput事件,可以通过event.preventDefault()取消显示输入的文本
package { import flash.display.Sprite; import flash.events.TextEvent; import flash.text.TextField; import flash.text.TextFieldType; public class Sample0414 extends Sprite { private var lblInfo:TextField; public function Sample0414() { var textBox:TextField = new TextField(); textBox.type = TextFieldType.INPUT; textBox.background = true; textBox.width = 200; textBox.height = 20; textBox.addEventListener(TextEvent.TEXT_INPUT,onTextInput); this.addChild(textBox); } private function onTextInput(event:TextEvent):void { if(event.text.toLowerCase().indexOf("<script>")>-1) { event.preventDefault(); } } } }
4. 为TextField添加超链接
同设置样式一样,也有三种方式实现:直接加入标记、设置TextFormatter、设置CSS
设置TextFormatter:
var textBox:TextField = new TextField(); textBox.text = "god bless me"; var formatter:TextFormat = new TextFormat(); formatter.color = 0xFF0000; formatter.url = "http://www.baidu.com/"; formatter.target = "_blank"; textBox.setTextFormat(formatter); this.addChild(textBox);
设置CSS:
var textBox:TextField = new TextField(); textBox.htmlText = "<a href='http://www.baidu.com/' target='_blank'>I love you</a>"; var css:StyleSheet = new StyleSheet( ); css.parseCSS("a {color: #FFFF00;} a:hover {text-decoration: underline;}"); textBox.styleSheet = css; this.addChild(textBox);
5. 用超链接调用ActionScript代码
在一个链接地址前加上event:,即可以响应TextEvent.LINK事件。TextEvent.text属性就是url的地址
package { import flash.display.Sprite; import flash.events.TextEvent; import flash.text.TextField; import flash.text.TextFormat; public class Sample0414 extends Sprite { public function Sample0414() { var textBox:TextField = new TextField(); textBox.addEventListener(TextEvent.LINK,onClickLink); textBox.htmlText = "god bless me"; var formatter:TextFormat = new TextFormat(); formatter.color = 0xFF0000; formatter.url = "event:http://www.baidu.com/"; formatter.target = "_blank"; textBox.setTextFormat(formatter); textBox.addEventListener(TextEvent.LINK, onClickLink); this.addChild(textBox); } private function onClickLink(event:TextEvent):void { trace(event.text); } } }
6. 高级文本布局
TextField 类定义了一系列API用于精确控制文本布局:
getCharIndexAtPoint(x,y) -- 得到坐标(x,y)下的字符
getCharBoundaries(index) -- 得到索引index对应字符的Rectangle
numLines属性 -- 得到TextField的文本行数
getLineIndexAtPoint(x,y) -- 得到坐标(x,y)下对应的行索引
getLineIndexOfChar(index) -- 得到索引index对应字符的行索引
getLineLength(lineIndex) -- 得到索引lineIndex对应行的字符数
getLineText(lineIndex) -- 得到索引lineIndex对应行的文本
getLineOffset(lineIndex) -- 得到索引lineIndex对应行的第一个字符的索引
getLineMetrics(lineIndex) -- 得到索引lineIndex对应行的度量信息,包括x,width,leading,height,descent,ascent相关属性
getFirstCharInParagraph(index) -- 如果给定一个字符索引index,则返回同一段落中第一个字符的索引
getParagraphLength(index) -- 如果给定一个字符索引,则返回包含该字符的段落的长度
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class Sample0421 extends Sprite { private var label:TextField; public function Sample0421() { var textBox:TextField = new TextField(); textBox.type = TextFieldType.INPUT; textBox.multiline = true; textBox.htmlText = "everyone is no1"; textBox.addEventListener(MouseEvent.CLICK,onClick); textBox.background = true; textBox.wordWrap = true; this.addChild(textBox); label = new TextField(); label.background = true; label.x = 150; label.width = 250; label.height = 300; this.addChild(label); } private function onClick(event:MouseEvent):void { var txt:TextField = event.target as TextField; label.text = ""; try { label.appendText("numLines属性值是:"+txt.numLines+"\n"); label.appendText("getLineIndexAtPoint(x,y)的值是:"+
txt.getLineIndexAtPoint(mouseX,mouseY)+"\n"); label.appendText("getLineIndexOfChar(index)的值是:"+
txt.getLineIndexOfChar(20)+"\n"); label.appendText("getLineLength(lineIndex)的值是:"+txt.getLineLength(2)+"\n"); label.appendText("getLineText(lineIndex)的值是:"+txt.getLineText(2)+"\n"); label.appendText("getLineOffset(lineIndex)的值是:"+txt.getLineOffset(2)+"\n"); label.appendText("getLineMetrics()的宽度是:"+txt.getLineMetrics(2).width+"\n"); label.appendText("getFirstCharInParagraph(index)的值是:"+
txt.getFirstCharInParagraph(5)+"\n"); label.appendText("getParagraphLength(index)的值是:"+
txt.getParagraphLength(3)+"\n"); trace(txt.text.charAt(5)); } catch(ex:Error) { label.text = ex.message; } } } }
7. 高级抗锯齿
对于嵌入字体可通过设置文本框的antiAliasType属性为flash.text.AntiAliasType.ADVANCED,然后设置gridTypeFit和sharpness属性
flash.text.AntiAliasType.NORMAL -- 应用常规文本消除锯齿功能。 这与 Flash Player 7 和更早版本中使用的消除锯齿类型匹配。
应用高级消除锯齿功能,这增加了文本的可读性。 (此功能在 Flash Player 8 中可用。) 高级消除锯齿功能可以高品质呈现小尺寸的字体。 它最适合在具有大量小字号文本的应用程序中使用。 建议不要对大于 48 磅的字体使用高级消除锯齿功能
gridFitType属性用于此文本字段的网格固定类型,仅在文本字段的 flash.text.AntiAliasType 属性设置为 flash.text.AntiAliasType.ADVANCED 时才应用此属性
flash.text.GridFitType.NONE -- 指定无网格固定。 不强制根据像素网格调整字型中的水平线和垂直线。 此设置通常适合动画或大号字。
flash.text.GridFitType.PIXEL -- 指定粗水平线和垂直线适合像素网格。 此设置仅适用于左对齐文本字段。 若要使用此设置,文本字段的 flash.dispaly.AntiAliasType 属性必须设置为 flash.text.AntiAliasType.ADVANCED。 此设置通常能为左对齐文本提供最佳可读性。
flash.text.GridFitType.SUBPIXEL -- 指定粗水平线和垂直线适合 LCD 显示器上的子像素网格。 若要使用此设置,文本字段的 flash.text.AntiAliasType 属性必须设置为 flash.text.AntiAliasType.ADVANCED。 flash.text.GridFitType.SUBPIXEL 设置通常适合右对齐或居中的动态文本,有时,为了在动画与文本品质之间达到一种平衡,也可使用此设置。
sharpness 属性范围在-400 到400,默认为0 ,它决定字体外框的清晰程度。值越低越模糊,越高越锐利。当文字比较模糊时可以设置gridFitType 为PIXEL 或SUBPIXEL 以提高清晰度
8. 替换文本
使用replaceSelectedText(newText)方法替换选中的文字或用replaceText(startIndex,endIndex,newText)方法替换某一范围的文字
package { import flash.display.Sprite; import flash.events.KeyboardEvent; import flash.text.TextField; import flash.text.TextFieldType; public class Sample0422 extends Sprite { public function Sample0422() { var textBox:TextField = new TextField(); textBox.type = TextFieldType.INPUT; textBox.background = true; this.addEventListener(KeyboardEvent.KEY_DOWN,onKeyDown); this.addChild(textBox); } private function onKeyDown(event:KeyboardEvent):void { if(event.keyCode == 13) { var txt:TextField = event.target as TextField; txt.replaceSelectedText("巫妖王之怒"); txt.replaceText(0,2,"wow"); } } } }
9. 获取可用字体列表
Font.enumerateFonts(bool)方法返回可用字体列表,参数默认为false,将返回一个只包括嵌入字体的列表;为true则返回一个包括所有字体(设备字体和嵌入字体)的列表
package { import flash.display.Sprite; import flash.text.Font; [Embed(source="xjlFont.fon",fontName="xjl",mimeType="application/x-font-truetype")] public class Sample0422 extends Sprite { public function Sample0422() { var allFonts:Array = Font.enumerateFonts(true);//默认为false allFonts.sortOn("fontName", Array.CASEINSENSITIVE); for (var i:uint=0; i<allFonts.length; i++) { trace(allFonts[i].fontName); } } } }
10. 改变颜色
先获取可视化对象的obj.transform.colorTransform对象,然后修改该对象,再重新赋值给对象
设置颜色,可以直接设置ColorTransform.color属性,也可以分开设置redOffset,greenOffset,blueOffset和alphaOffset;取值范围是-255到255(alpha 值范围在0 到100,与alphaOffset是不同的)
package { import flash.display.Shape; import flash.display.Sprite; import flash.geom.ColorTransform; public class Sample0422 extends Sprite { public function Sample0422() { var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(100,100,150,100); rect.graphics.endFill(); this.addChild(rect); var ct:ColorTransform = rect.transform.colorTransform; //ct.color = 0x00FF00; ct.redOffset = 128; ct.greenOffset = 128; ct.blueOffset = 128; ct.alphaOffset = 50; rect.transform.colorTransform = ct; } } }