PageRenderTime 110ms CodeModel.GetById 24ms RepoModel.GetById 0ms app.codeStats 2ms

/frameworks/projects/playerglobal/bundles/zh_CN/docs/flash.display.xml

https://github.com/adufilie/flex-sdk
XML | 2574 lines | 1964 code | 592 blank | 18 comment | 0 complexity | 42e4558621796cd992ef93d8746a5135 MD5 | raw file
Possible License(s): Apache-2.0 
    

  1. <?xml version="1.0" encoding="UTF-8"?>
    2. 

  2. <!--
    3. 

  3. 

  4.   Licensed to the Apache Software Foundation (ASF) under one or more
    5. 

  5.   contributor license agreements.  See the NOTICE file distributed with
    6. 

  6.   this work for additional information regarding copyright ownership.
    7. 

  7.   The ASF licenses this file to You under the Apache License, Version 2.0
    8. 

  8.   (the "License"); you may not use this file except in compliance with
    9. 

  9.   the License.  You may obtain a copy of the License at
    10. 

  10. 

  11.       http://www.apache.org/licenses/LICENSE-2.0
    12. 

  12. 

  13.   Unless required by applicable law or agreed to in writing, software
    14. 

  14.   distributed under the License is distributed on an "AS IS" BASIS,
    15. 

  15.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    16. 

  16.   See the License for the specific language governing permissions and
    17. 

  17.   limitations under the License.
    18. 

  18. 

  19. -->
    20. 

  20. <apiPackage xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" id="flash.display" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiPackage/apiPackage "><apiName class="- topic/title reference/title apiRef/apiName ">flash.display</apiName><apiDetail class="- topic/body reference/refbody apiRef/apiDetail "/><apiClassifier languages="" id="flash.display:FrameLabel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">FrameLabel</apiName><shortdesc class="- topic/shortdesc ">
    21. 

  21. 	
    22. 

  22. 	FrameLabel 对象包含用来指定帧编号及相应标签名称的属性。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    23. 

  23. 	
    24. 

  24. 	FrameLabel 对象包含用来指定帧编号及相应标签名称的属性。Scene 类包括 <codeph class="+ topic/ph pr-d/codeph ">labels</codeph> 属性，该属性是场景的 FrameLabel 对象的数组。 
    25. 

  25. 	
    26. 

  26. 	</apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Scene/labels" class="- topic/link "><linktext class="- topic/linktext ">Scene.labels</linktext></link><link href="flash.display.xml#MovieClip/currentLabel" class="- topic/link "><linktext class="- topic/linktext ">MovieClip.currentLabel</linktext></link><link href="flash.display.xml#MovieClip/currentScene" class="- topic/link "><linktext class="- topic/linktext ">MovieClip.currentScene</linktext></link><link href="flash.display.xml#MovieClip/scenes" class="- topic/link "><linktext class="- topic/linktext ">MovieClip.scenes</linktext></link><link href="flash.display.xml#MovieClip/gotoAndPlay()" class="- topic/link "><linktext class="- topic/linktext ">MovieClip.gotoAndPlay()</linktext></link><link href="flash.display.xml#MovieClip/gotoAndStop()" class="- topic/link "><linktext class="- topic/linktext ">MovieClip.gotoAndStop()</linktext></link></related-links><apiValue id="flash.display:FrameLabel:frame:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">frame</apiName><shortdesc class="- topic/shortdesc ">
    27. 

  27. 		包含标签的帧编号。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    28. 

  28. 		包含标签的帧编号。
    29. 

  29. 		</apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:FrameLabel:name:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">name</apiName><shortdesc class="- topic/shortdesc ">
    30. 

  30. 		标签的名称。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    31. 

  31. 		标签的名称。
    32. 

  32. 		</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.display:InteractiveObject" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">InteractiveObject</apiName><shortdesc class="- topic/shortdesc ">
    33. 

  33.  InteractiveObject 类是用户可以使用鼠标、键盘或其他用户输入设备与之交互的所有显示对象的抽象基类。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.display:DisplayObject</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    34. 

  34.  InteractiveObject 类是用户可以使用鼠标、键盘或其他用户输入设备与之交互的所有显示对象的抽象基类。
    35. 

  35.  
    36. 

  36.  <p class="- topic/p ">不能直接实例化 InteractiveObject 类。调用 <codeph class="+ topic/ph pr-d/codeph ">new InteractiveObject()</codeph> 构造函数会引发 <codeph class="+ topic/ph pr-d/codeph ">ArgumentError</codeph> 异常。</p>
    37. 

  37.  
    38. 

  38.  <p class="- topic/p ">InteractiveObject 类本身不包含任何用于在屏幕上呈现内容的 API。要创建 InteractiveObject 类的自定义子类，请扩展具有用于在屏幕上呈现内容的 API 的一种子类，例如 Sprite、SimpleButton、TextField 或 MovieClip 类。</p>
    39. 

  39.  
    40. 

  40.  </apiDesc><example conref="examples\InteractiveObjectExample.as" class="- topic/example "> 下例使用 <codeph class="+ topic/ph pr-d/codeph ">InteractiveObjectExample</codeph> 类，该类再使用 <codeph class="+ topic/ph pr-d/codeph ">ChildSprite</codeph> 类来绘制矩形，然后基于各种鼠标事件对该矩形进行操作。执行下列步骤可完成该任务：
    41. 

  41.  <ol class="- topic/ol "><li class="- topic/li ">在 <codeph class="+ topic/ph pr-d/codeph ">InteractiveObjectExample</codeph> 构造函数中，创建一个名为 <codeph class="+ topic/ph pr-d/codeph ">child</codeph> 的 Sprite 类型的 ChildSprite 新对象，该对象调用 ChildSprite 构造函数方法来绘制形状，并为所绘制的形状添加鼠标事件（如以下步骤所示）。<codeph class="+ topic/ph pr-d/codeph ">child</codeph> 对象添加至坐标 <i class="+ topic/ph hi-d/i ">x = 0, y = 0</i> 处的显示列表顶部。  </li><li class="- topic/li ">在 <codeph class="+ topic/ph pr-d/codeph ">ChildSprite</codeph> 类中，声明以后在 <codeph class="+ topic/ph pr-d/codeph ">draw()</codeph> 方法和 MouseEvent 方法中使用的 <codeph class="+ topic/ph pr-d/codeph ">size</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">overSize</codeph> 属性。</li><li class="- topic/li ">声明各个相关属性，将背景色设置为橙色，将鼠标经过颜色设置为深黄色，将鼠标按下颜色设置为浅蓝色。</li><li class="- topic/li ">在 <codeph class="+ topic/ph pr-d/codeph ">ChildSprite</codeph> 构造函数中，通过使用 Graphics 类的方法和 <codeph class="+ topic/ph pr-d/codeph ">draw()</codeph> 方法绘制一个橙色的正方形。</li><li class="- topic/li ">构造函数添加四个 MouseEvent 事件侦听器方法：
    42. 

  42.  
    43. 

  43.      <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseOverHandler</codeph>：使用深黄色在原始坐标处重绘一个更大的 60 x 60 像素正方形。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseOutHandler</codeph>：将正方形恢复至其原始大小和颜色。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseDownHandler</codeph>：使用浅蓝色在原始坐标处重绘一个更大的 60 x 60 像素正方形。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseUpHandler</codeph>：与 <codeph class="+ topic/ph pr-d/codeph ">mouseOverHandler</codeph> 相同。</li></ul>
    44. 

  44.   </li></ol>
    45. 

  45. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    46. 

  46. 

  47. package {
    48. 

  48.     import flash.display.Sprite;
    49. 

  49. 

  50.     public class InteractiveObjectExample extends Sprite {
    51. 

  51. 

  52.         public function InteractiveObjectExample() {
    53. 

  53.             var child:Sprite = new ChildSprite();
    54. 

  54.             addChild(child);
    55. 

  55.         }
    56. 

  56.     }
    57. 

  57. }
    58. 

  58. 

  59. import flash.display.Sprite;
    60. 

  60. import flash.events.MouseEvent;
    61. 

  61. 

  62. class ChildSprite extends Sprite {
    63. 

  63.     private var size:uint = 50;
    64. 

  64.     private var overSize:uint = 60;
    65. 

  65.     private var backgroundColor:uint = 0xFFCC00;
    66. 

  66.     private var overColor:uint = 0xCCFF00;
    67. 

  67.     private var downColor:uint = 0x00CCFF;
    68. 

  68. 

  69.     public function ChildSprite() {
    70. 

  70.         buttonMode = true;
    71. 

  71.         draw(size, size, backgroundColor);
    72. 

  72.         addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
    73. 

  73.         addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
    74. 

  74.         addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
    75. 

  75.         addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
    76. 

  76.     }
    77. 

  77. 

  78.     private function draw(w:uint, h:uint, bgColor:uint):void {
    79. 

  79.         graphics.clear();
    80. 

  80.         graphics.beginFill(bgColor);
    81. 

  81.         graphics.drawRect(0, 0, w, h);
    82. 

  82.         graphics.endFill();
    83. 

  83.     }
    84. 

  84. 

  85.     public function mouseOverHandler(event:MouseEvent):void {
    86. 

  86.         trace("mouseOverHandler");
    87. 

  87.         draw(overSize, overSize, overColor);
    88. 

  88.     }
    89. 

  89. 

  90.     public function mouseOutHandler(event:MouseEvent):void {
    91. 

  91.         trace("mouseOutHandler");
    92. 

  92.         draw(size, size, backgroundColor);
    93. 

  93.     }
    94. 

  94. 

  95.     public function mouseDownHandler(event:MouseEvent):void {
    96. 

  96.         trace("mouseDownHandler");
    97. 

  97.         draw(overSize, overSize, downColor);
    98. 

  98.     }
    99. 

  99. 

  100.     public function mouseUpHandler(event:MouseEvent):void {
    101. 

  101.         trace("mouseUpHandler");
    102. 

  102.         draw(overSize, overSize, overColor);
    103. 

  103.     }
    104. 

  104. }
    105. 

  105. </codeblock></example></apiClassifierDetail><adobeApiEvent id="flash.display:InteractiveObject_flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE_softKeyboardDeactivate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">softKeyboardDeactivate</apiName><shortdesc class="- topic/shortdesc ">
    106. 

  106.  在隐藏软键盘之后立即调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.SoftKeyboardEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">在隐藏软键盘之后立即调度。
    107. 

  107.  </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    108. 

  108.  在隐藏软键盘之后立即调度。
    109. 

  109.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.events.xml#SoftKeyboardEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.SoftKeyboardEvent</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE_softKeyboardActivate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">softKeyboardActivate</apiName><shortdesc class="- topic/shortdesc ">
    110. 

  110.  在放开软键盘之后立即调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.SoftKeyboardEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">在放开软键盘之后立即调度。
    111. 

  111.  </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    112. 

  112.  在放开软键盘之后立即调度。
    113. 

  113.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.events.xml#SoftKeyboardEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.SoftKeyboardEvent</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING_softKeyboardActivating" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">softKeyboardActivating</apiName><shortdesc class="- topic/shortdesc ">
    114. 

  114.  在放开软键盘之前立即调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.SoftKeyboardEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">在放开软键盘之前立即调度。
    115. 

  115.  </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    116. 

  116.  在放开软键盘之前立即调度。
    117. 

  117.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.events.xml#SoftKeyboardEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.SoftKeyboardEvent</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TextEvent.TEXT_INPUT_textInput" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">textInput</apiName><shortdesc class="- topic/shortdesc ">
    118. 

  118.  当用户输入一个或多个文本字符时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TextEvent.TEXT_INPUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TextEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    119. 

  119.  当用户输入一个或多个文本字符时调度。各种文本输入法都可以生成此事件，包括使用标准键盘、输入法编辑器 (IME)、语音识别系统以及粘贴不带格式设置或样式信息的纯文本的操作。
    120. 

  120.  </apiDesc><example conref="examples\TextField_textInput.as" class="- topic/example "/></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.IMEEvent_imeStartComposition" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">imeStartComposition</apiName><shortdesc class="- topic/shortdesc ">
    121. 

  121. 	 此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序
    122. 

  122. 	  
    123. 

  123. 	  </shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.IMEEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    124. 

  124. 	 此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序
    125. 

  125. 	  
    126. 

  126. 	  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.CONTEXT_MENU_contextMenu" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">contextMenu</apiName><shortdesc class="- topic/shortdesc ">
    127. 

  127. 	 当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.CONTEXT_MENU</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    128. 

  128. 	 当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。
    129. 

  129. 	 
    130. 

  130. 	 </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/contextMenu" class="- topic/link "><linktext class="- topic/linktext ">contextMenu</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE_nativeDragComplete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragComplete</apiName><shortdesc class="- topic/shortdesc ">
    131. 

  131. 	 当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    132. 

  132. 	 当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。
    133. 

  133. 	 
    134. 

  134. 	 <p class="- topic/p ">该事件的 dropAction 属性表示由拖动目标对象设置的动作；“none”值 (<codeph class="+ topic/ph pr-d/codeph ">DragActions.NONE</codeph>) 表示放置动作被取消或未被接受。</p>
    135. 

  135. 	 
    136. 

  136. 	 <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">nativeDragComplete</codeph> 事件处理函数是更新启动显示对象的方便场所，例如，通过从列表中删除一个项目（针对“move”的拖动动作），或通过更改可视属性。</p>
    137. 

  137. 	 
    138. 

  138. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE_nativeDragUpdate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragUpdate</apiName><shortdesc class="- topic/shortdesc ">
    139. 

  139. 	 在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    140. 

  140. 	 在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
    141. 

  141. 	 
    142. 

  142. 	 <p class="- topic/p ">Linux 中不调度 <codeph class="+ topic/ph pr-d/codeph ">nativeDragUpdate</codeph> 事件。</p>
    143. 

  143. 	 
    144. 

  144. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_START_nativeDragStart" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragStart</apiName><shortdesc class="- topic/shortdesc ">
    145. 

  145. 	 在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_START</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    146. 

  146. 	 在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。
    147. 

  147. 	 
    148. 

  148. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_EXIT_nativeDragExit" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragExit</apiName><shortdesc class="- topic/shortdesc ">
    149. 

  149. 	 当拖动手势离开其边界时由 InteractiveObject 调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_EXIT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    150. 

  150. 	 当拖动手势离开其边界时由 InteractiveObject 调度。
    151. 

  151. 	 
    152. 

  152. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_DROP_nativeDragDrop" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragDrop</apiName><shortdesc class="- topic/shortdesc ">
    153. 

  153. 	 在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_DROP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    154. 

  154. 	 在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。
    155. 

  155. 	 
    156. 

  156. 	 <p class="- topic/p ">使用事件对象的 <codeph class="+ topic/ph pr-d/codeph ">clipboard</codeph> 属性访问放置的数据。</p>
    157. 

  157. 	 
    158. 

  158. 	 <p class="- topic/p ">此事件的处理函数应该设置 <codeph class="+ topic/ph pr-d/codeph ">DragManager.dropAction</codeph> 属性以向启动器提供有关采取了哪种拖动动作的反馈。如果未设置任何值，DragManager 将从允许动作的列表中选择一个默认值。</p>
    159. 

  159. 	 
    160. 

  160. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_OVER_nativeDragOver" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragOver</apiName><shortdesc class="- topic/shortdesc ">
    161. 

  161. 	 当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_OVER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    162. 

  162. 	 当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。
    163. 

  163. 	 
    164. 

  164. 	 <p class="- topic/p ">鼠标只要移动，就会调度 <codeph class="+ topic/ph pr-d/codeph ">nativeDragOver</codeph> 事件。在 Windows 和 Mac 中，即使不移动鼠标，每隔一小段时间也会调度这些事件。</p>
    165. 

  165. 	 
    166. 

  166. 	 <p class="- topic/p ">处理 <codeph class="+ topic/ph pr-d/codeph ">nativeDragOver</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">nativeDragEnter</codeph> 事件以允许显示对象成为放置目标。</p> 
    167. 

  167. 	 
    168. 

  168. 	 <p class="- topic/p ">要确定执行调度的显示对象是否能接受放置，请检查该事件对象的 <codeph class="+ topic/ph pr-d/codeph ">clipboard</codeph> 属性中数据的适用性，并检查 <codeph class="+ topic/ph pr-d/codeph ">allowedActions</codeph> 属性中允许的拖动动作。</p> 
    169. 

  169. 	 
    170. 

  170. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.NativeDragEvent.NATIVE_DRAG_ENTER_nativeDragEnter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">nativeDragEnter</apiName><shortdesc class="- topic/shortdesc ">
    171. 

  171. 	 当拖动手势进入其边界时由 InteractiveObject 调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.NativeDragEvent.NATIVE_DRAG_ENTER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.NativeDragEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    172. 

  172. 	 当拖动手势进入其边界时由 InteractiveObject 调度。
    173. 

  173. 	 
    174. 

  174. 	 <p class="- topic/p ">处理 <codeph class="+ topic/ph pr-d/codeph ">nativeDragEnter</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">nativeDragOver</codeph> 事件以允许显示对象成为放置目标。</p>
    175. 

  175. 	 
    176. 

  176. 	 <p class="- topic/p ">要确定执行调度的显示对象是否能接受放置，请检查该事件对象的 <codeph class="+ topic/ph pr-d/codeph ">clipboard</codeph> 属性中数据的适用性，并检查 <codeph class="+ topic/ph pr-d/codeph ">allowedActions</codeph> 属性中允许的拖动动作。</p> 
    177. 

  177. 	 
    178. 

  178. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.TAB_INDEX_CHANGE_tabIndexChange" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">tabIndexChange</apiName><shortdesc class="- topic/shortdesc ">
    179. 

  179.  对象的 tabIndex 属性值发生更改时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.TAB_INDEX_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    180. 

  180.  对象的 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性值发生更改时调度。 
    181. 

  181.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.TAB_ENABLED_CHANGE_tabEnabledChange" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">tabEnabledChange</apiName><shortdesc class="- topic/shortdesc ">
    182. 

  182.  对象的 tabEnabled 标志发生更改时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.TAB_ENABLED_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    183. 

  183.  对象的 <codeph class="+ topic/ph pr-d/codeph ">tabEnabled</codeph> 标志发生更改时调度。 
    184. 

  184.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.TAB_CHILDREN_CHANGE_tabChildrenChange" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">tabChildrenChange</apiName><shortdesc class="- topic/shortdesc ">
    185. 

  185.  对象的 tabChildren 标志值发生更改时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.TAB_CHILDREN_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    186. 

  186.  对象的 <codeph class="+ topic/ph pr-d/codeph ">tabChildren</codeph> 标志值发生更改时调度。 
    187. 

  187.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.KeyboardEvent.KEY_UP_keyUp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">keyUp</apiName><shortdesc class="- topic/shortdesc ">
    188. 

  188.  用户释放某个键时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.KeyboardEvent.KEY_UP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.KeyboardEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    189. 

  189.  用户释放某个键时调度。按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符（如中国象形文字）。该事件在 <codeph class="+ topic/ph pr-d/codeph ">keyDown</codeph> 事件之后发生，并具备以下特征：
    190. 

  190.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.KeyboardEvent.KEY_DOWN_keyDown" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">keyDown</apiName><shortdesc class="- topic/shortdesc ">
    191. 

  191.  用户按下某个键时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.KeyboardEvent.KEY_DOWN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.KeyboardEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    192. 

  192.  用户按下某个键时调度。按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符（如中国象形文字）。该事件在 <codeph class="+ topic/ph pr-d/codeph ">keyUp</codeph> 事件之前发生。
    193. 

  193.  
    194. 

  194.  <p class="- topic/p ">在 AIR 中，取消此事件会禁止将字符输入到文本字段中。</p>
    195. 

  195.  
    196. 

  196.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.RIGHT_MOUSE_UP_rightMouseUp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">rightMouseUp</apiName><shortdesc class="- topic/shortdesc ">
    197. 

  197. 	 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.RIGHT_MOUSE_UP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    198. 

  198. 	 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 
    199. 

  199. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.RIGHT_MOUSE_DOWN_rightMouseDown" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">rightMouseDown</apiName><shortdesc class="- topic/shortdesc ">
    200. 

  200. 	 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.RIGHT_MOUSE_DOWN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    201. 

  201. 	 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 
    202. 

  202. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.RIGHT_CLICK_rightClick" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">rightClick</apiName><shortdesc class="- topic/shortdesc ">
    203. 

  203. 	 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.RIGHT_CLICK</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    204. 

  204. 	 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。要使 <codeph class="+ topic/ph pr-d/codeph ">rightClick</codeph> 事件发生，该事件必须始终按照发生顺序跟在以下一系列事件之后：<codeph class="+ topic/ph pr-d/codeph ">rightMouseDown</codeph> 事件，然后是 <codeph class="+ topic/ph pr-d/codeph ">rightMouseUp</codeph>。这两个事件的目标对象必须相同，否则不会发生 <codeph class="+ topic/ph pr-d/codeph ">rightClick</codeph> 事件。在 <codeph class="+ topic/ph pr-d/codeph ">rightMouseDown</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">rightMouseUp</codeph> 事件之间可以随时发生任意数量的其他鼠标事件；<codeph class="+ topic/ph pr-d/codeph ">rightClick</codeph> 事件仍会发生。 
    205. 

  205. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MIDDLE_MOUSE_UP_middleMouseUp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">middleMouseUp</apiName><shortdesc class="- topic/shortdesc ">
    206. 

  206. 	 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MIDDLE_MOUSE_UP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    207. 

  207. 	 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 
    208. 

  208. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MIDDLE_MOUSE_DOWN_middleMouseDown" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">middleMouseDown</apiName><shortdesc class="- topic/shortdesc ">
    209. 

  209. 	 当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MIDDLE_MOUSE_DOWN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    210. 

  210. 	 当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 
    211. 

  211. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MIDDLE_CLICK_middleClick" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">middleClick</apiName><shortdesc class="- topic/shortdesc ">
    212. 

  212. 	 当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MIDDLE_CLICK</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    213. 

  213. 	 当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。要使 <codeph class="+ topic/ph pr-d/codeph ">middleClick</codeph> 事件发生，该事件必须始终按照发生顺序跟在以下一系列事件之后：<codeph class="+ topic/ph pr-d/codeph ">middleMouseDown</codeph> 事件，然后是 <codeph class="+ topic/ph pr-d/codeph ">middleMouseUp</codeph>。这两个事件的目标对象必须相同，否则不会发生 <codeph class="+ topic/ph pr-d/codeph ">middleClick</codeph> 事件。在 <codeph class="+ topic/ph pr-d/codeph ">middleMouseDown</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">middleMouseUp</codeph> 事件之间可以随时发生任意数量的其他鼠标事件；<codeph class="+ topic/ph pr-d/codeph ">middleClick</codeph> 事件仍会发生。 
    214. 

  214. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TransformGestureEvent.GESTURE_SWIPE_gestureSwipe" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">gestureSwipe</apiName><shortdesc class="- topic/shortdesc ">
    215. 

  215.  当用户在接触点处使用 InteractiveObject 实例执行滑动手势（例如，在配有触摸屏的移动电话或绘图板上用三根手指触摸屏幕，然后在一个显示对象上平行移动这三根手指）时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TransformGestureEvent.GESTURE_SWIPE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TransformGestureEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    216. 

  216.  当用户在接触点处使用 InteractiveObject 实例执行滑动手势（例如，在配有触摸屏的移动电话或绘图板上用三根手指触摸屏幕，然后在一个显示对象上平行移动这三根手指）时调度。平行移动多根手指是一种常见的滑动手势，但每种设备和每种操作系统对滑动都有自己的要求。有些设备也可能将此触摸解释为多个鼠标事件的组合。 
    217. 

  217.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动手指，然后移动多根手指，则 InteractiveObject 实例除调度 <codeph class="+ topic/ph pr-d/codeph ">gestureSwipe</codeph> 事件外，还会调度 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件（也包括其他事件），或者，如果当前环境支持，可以调度所有事件。选择处理用户交互的方式。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">gestureSwipe</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    218. 

  218.  <p class="- topic/p ">处理事件对象的属性时，请注意将 <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> 属性设置为主要接触点。<codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> 属性是与完成滑动手势的接触点之间的距离。</p>
    219. 

  219.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>使用 Mac OS 操作系统的某些设备可解释四指滑动，而此 API 仅支持三指滑动。</p>
    220. 

  220.  </apiDesc><example conref="..\events\examples\TransformGesture_swipe.as" class="- topic/example "> 以下示例将显示如何对 <codeph class="+ topic/ph pr-d/codeph ">GESTURE_SWIPE</codeph> 事件进行事件处理。当用户在启用触摸的设备上执行滑动手势时，myTextField 将使用滑动事件的唯一阶段 <codeph class="+ topic/ph pr-d/codeph ">all</codeph> 进行填充。
    221. 

  221. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    222. 

  222. Multitouch.inputMode = MultitouchInputMode.GESTURE;
    223. 

  223. 

  224. var mySprite = new Sprite();
    225. 

  225. mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
    226. 

  226. mySprite.graphics.beginFill(0x336699);
    227. 

  227. mySprite.graphics.drawRect(0, 0, 100, 80);
    228. 

  228. var myTextField = new TextField();
    229. 

  229. myTextField.y = 200;
    230. 

  230. addChild(mySprite);
    231. 

  231. addChild(myTextField);
    232. 

  232. 

  233. function onSwipe(evt:TransformGestureEvent):void {
    234. 

  234. 

  235.     if (evt.offsetX == 1 ) {
    236. 

  236.     myTextField.text = "right";
    237. 

  237.     }
    238. 

  238.     if (evt.offsetY == -1) {
    239. 

  239.     myTextField.text = "up";
    240. 

  240.     }
    241. 

  241.     myTextField.text = evt.phase;
    242. 

  242. 

  243. }
    244. 

  244. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:rollOver" class="- topic/link "><linktext class="- topic/linktext ">rollOver 事件</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">touchOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TransformGestureEvent.GESTURE_ZOOM_gestureZoom" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">gestureZoom</apiName><shortdesc class="- topic/shortdesc ">
    245. 

  245.  当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或绘图板上的显示对象上快速分开手指）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TransformGestureEvent.GESTURE_ZOOM</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TransformGestureEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    246. 

  246.  当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或绘图板上的显示对象上快速分开手指）调度。移开手指是一个常用的缩放手势，但每个设备和操作系统都会有自己表示缩放操作的要求。有些设备也可能将此触摸解释为多个鼠标事件的组合。 
    247. 

  247.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动手指，然后将手指移开，则 InteractiveObject 实例除调度 <codeph class="+ topic/ph pr-d/codeph ">gestureZoom</codeph> 事件外，还会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件（也包括其他事件），或者，如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">gestureZoom</codeph> 事件，您可以设计自己的事件处理程序，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    248. 

  248.  <p class="- topic/p ">处理事件对象的属性时，请注意将 <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> 属性设置为主要接触点。<codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> 属性是与完成缩放手势的接触点之间的距离。</p>
    249. 

  249.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>
    250. 

  250.  </apiDesc><example conref="..\events\examples\TransformGesture_zoom.as" class="- topic/example "> 以下示例将显示如何对 <codeph class="+ topic/ph pr-d/codeph ">GESTURE_ZOOM</codeph> 事件进行事件处理。当用户在启用触摸的设备上执行缩放手势时，myTextField 将使用当前的阶段进行填充。
    251. 

  251. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    252. 

  252. Multitouch.inputMode = MultitouchInputMode.GESTURE;
    253. 

  253. 

  254. var mySprite = new Sprite();
    255. 

  255. mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
    256. 

  256. mySprite.graphics.beginFill(0x336699);
    257. 

  257. mySprite.graphics.drawRect(0, 0, 100, 80);
    258. 

  258. var myTextField = new TextField();
    259. 

  259. myTextField.y = 200;
    260. 

  260. addChild(mySprite);
    261. 

  261. addChild(myTextField);
    262. 

  262. 

  263. function onZoom(evt:TransformGestureEvent):void {
    264. 

  264. 

  265.     evt.target.scaleX++;
    266. 

  266. 

  267.     if (evt.phase==GesturePhase.BEGIN) {
    268. 

  268.         myTextField.text = "Begin";
    269. 

  269.     }
    270. 

  270.     if (evt.phase==GesturePhase.UPDATE) {
    271. 

  271.         myTextField.text = "Update";
    272. 

  272.     }
    273. 

  273.     if (evt.phase==GesturePhase.END) {
    274. 

  274.         myTextField.text = "End";
    275. 

  275.     }
    276. 

  276. }
    277. 

  277. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">mouseOver 事件</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">touchOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TransformGestureEvent.GESTURE_ROTATE_gestureRotate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">gestureRotate</apiName><shortdesc class="- topic/shortdesc ">
    278. 

  278.  当用户在接触点处使用 InteractiveObject 实例执行旋转手势时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或绘图板上的显示对象上旋转这两个手指）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TransformGestureEvent.GESTURE_ROTATE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TransformGestureEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    279. 

  279.  当用户在接触点处使用 InteractiveObject 实例执行旋转手势时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或绘图板上的显示对象上旋转这两个手指）调度。两个手指旋转是一个常用的旋转手势，但每个设备和操作系统都会有自己表示旋转操作的要求。有些设备也可能将此触摸解释为多个鼠标事件的组合。 
    280. 

  280.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动手指，则 InteractiveObject 实例除调度 <codeph class="+ topic/ph pr-d/codeph ">gestureRotate</codeph> 事件外，还可调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件（也包括其他事件），或者，如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">gestureRotate</codeph> 事件，可以设计自己的事件处理函数，以响应启用触摸环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    281. 

  281.  <p class="- topic/p ">处理事件对象的属性时，请注意将 <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> 属性设置为主要接触点。<codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> 属性是与完成旋转手势的接触点之间的距离。</p>
    282. 

  282.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p> 
    283. 

  283.  </apiDesc><example conref="..\events\examples\TransformGestureEventExample.as" class="- topic/example "> 以下示例显示针对 <codeph class="+ topic/ph pr-d/codeph ">GESTURE_ROTATE</codeph> 事件的事件处理。当用户在启用触摸的设备上执行旋转手势时，mySprite 旋转，myTextField 填充为当前阶段。
    284. 

  284. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    285. 

  285. Multitouch.inputMode = MultitouchInputMode.GESTURE;
    286. 

  286. 

  287. var mySprite = new Sprite();
    288. 

  288. mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
    289. 

  289. mySprite.graphics.beginFill(0x336699);
    290. 

  290. mySprite.graphics.drawRect(0, 0, 100, 80);
    291. 

  291. var myTextField = new TextField();
    292. 

  292. myTextField.y = 200;
    293. 

  293. addChild(mySprite);
    294. 

  294. addChild(myTextField);
    295. 

  295. 

  296. function onRotate(evt:TransformGestureEvent):void {
    297. 

  297. 

  298.     evt.target.rotation -= 45;
    299. 

  299. 

  300.     if (evt.phase==GesturePhase.BEGIN) {
    301. 

  301.         myTextField.text = "Begin";
    302. 

  302.     }
    303. 

  303.     if (evt.phase==GesturePhase.UPDATE) {
    304. 

  304.         myTextField.text = "Update";
    305. 

  305.     }
    306. 

  306.     if (evt.phase==GesturePhase.END) {
    307. 

  307.         myTextField.text = "End";
    308. 

  308.     }
    309. 

  309. }
    310. 

  310. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">mouseOver 事件</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">touchOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP_gesturePressAndTap" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">gesturePressAndTap</apiName><shortdesc class="- topic/shortdesc ">
    311. 

  311.  当用户使用 InteractiveObject 实例创建接触点，然后点击启用触屏的设备时（例如，将几个手指放在显示对象上以打开菜单，然后点击一个手指在配有触摸屏的移动电话或绘图板上选择一个菜单项）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.PressAndTapGestureEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    312. 

  312.  当用户使用 InteractiveObject 实例创建接触点，然后点击启用触屏的设备时（例如，将几个手指放在显示对象上以打开菜单，然后点击一个手指在配有触摸屏的移动电话或绘图板上选择一个菜单项）调度。有些设备也可能将此触摸解释为多个鼠标事件的组合。 
    313. 

  313.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动手指，然后执行辅助点击，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件（也包括其他事件）以及 <codeph class="+ topic/ph pr-d/codeph ">gesturePressAndTap</codeph> 事件，或者如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">gesturePressAndTap</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    314. 

  314.  <p class="- topic/p ">处理事件对象的属性时，请注意将 <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> 属性设置为主要接触点（“推动”）。<codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> 属性是与辅助接触点（“点击”）之间的距离。</p>
    315. 

  315.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">mouseOver 事件</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">touchOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TransformGestureEvent.GESTURE_PAN_gesturePan" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">gesturePan</apiName><shortdesc class="- topic/shortdesc ">
    316. 

  316.  当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上的显示对象上从左向右移动手指）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TransformGestureEvent.GESTURE_PAN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TransformGestureEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    317. 

  317.  当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上的显示对象上从左向右移动手指）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph> 事件。 
    318. 

  318.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">gesturePan</codeph> 事件，或者，如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">gesturePan</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    319. 

  319.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    320. 

  320.  </apiDesc><example conref="..\events\examples\TransformGesture_pan.as" class="- topic/example "> 以下示例将显示如何对 <codeph class="+ topic/ph pr-d/codeph ">GESTURE_PAN</codeph> 事件进行事件处理。当用户在启用触摸的设备上执行平移手势时，myTextField 将使用当前的阶段进行填充。
    321. 

  321. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    322. 

  322. Multitouch.inputMode = MultitouchInputMode.GESTURE;
    323. 

  323. 

  324. var mySprite = new Sprite();
    325. 

  325. mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
    326. 

  326. mySprite.graphics.beginFill(0x336699);
    327. 

  327. mySprite.graphics.drawRect(0, 0, 100, 80);
    328. 

  328. var myTextField = new TextField();
    329. 

  329. myTextField.y = 200;
    330. 

  330. addChild(mySprite);
    331. 

  331. addChild(myTextField);
    332. 

  332. 

  333. function onPan(evt:TransformGestureEvent):void {
    334. 

  334. 

  335.     evt.target.localX++;
    336. 

  336. 

  337.     if (evt.phase==GesturePhase.BEGIN) {
    338. 

  338.         myTextField.text = "Begin";
    339. 

  339.     }
    340. 

  340.     if (evt.phase==GesturePhase.UPDATE) {
    341. 

  341.         myTextField.text = "Update";
    342. 

  342.     }
    343. 

  343.     if (evt.phase==GesturePhase.END) {
    344. 

  344.         myTextField.text = "End";
    345. 

  345.     }
    346. 

  346. }
    347. 

  347. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">mouseOver 事件</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">touchOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.GestureEvent.GESTURE_TWO_FINGER_TAP_gestureTwoFingerTap" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">gestureTwoFingerTap</apiName><shortdesc class="- topic/shortdesc ">
    348. 

  348.  当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时（例如，在配有触摸屏的移动电话或绘图板上的显示对象上按下和释放两个手指）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.GestureEvent.GESTURE_TWO_FINGER_TAP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.GestureEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    349. 

  349.  当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时（例如，在配有触摸屏的移动电话或绘图板上的显示对象上按下和释放两个手指）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件。 
    350. 

  350.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上点击两个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">gestureTwoFingerTap</codeph> 事件，或者，如果当前环境支持，可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">gestureTwoFingerTap</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    351. 

  351.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    352. 

  352.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:doubleClick" class="- topic/link "><linktext class="- topic/linktext ">doubleClick 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_TAP_touchTap" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchTap</apiName><shortdesc class="- topic/shortdesc ">
    353. 

  353.  当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时（例如，在配有触摸屏的移动电话或绘图板的显示对象上的某一点处按下并释放手指）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_TAP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    354. 

  354.  当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时（例如，在配有触摸屏的移动电话或绘图板的显示对象上的某一点处按下并释放手指）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件。 
    355. 

  355.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上点击一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchTap</codeph> 事件，或者，如果当前环境支持，可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchTap</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    356. 

  356.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    357. 

  357.  </apiDesc><example conref="..\ui\examples\Multitouch_inputMode.as" class="- topic/example "> 以下示例在启用触摸的屏幕上点击在 mySprite 上绘制的正方形时显示一条信息：
    358. 

  358. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    359. 

  359. Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
    360. 

  360. 

  361. var mySprite:Sprite = new Sprite();
    362. 

  362. var myTextField:TextField = new TextField();
    363. 

  363. 

  364. mySprite.graphics.beginFill(0x336699);
    365. 

  365. mySprite.graphics.drawRect(0,0,40,40);
    366. 

  366. addChild(mySprite);
    367. 

  367. 

  368. mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
    369. 

  369. 

  370. function taphandler(e:TouchEvent): void {
    371. 

  371.     myTextField.text = "I've been tapped";
    372. 

  372.     myTextField.y = 50;
    373. 

  373.     addChild(myTextField);
    374. 

  374. }
    375. 

  375. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:click" class="- topic/link "><linktext class="- topic/linktext ">click 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_ROLL_OVER_touchRollOver" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchRollOver</apiName><shortdesc class="- topic/shortdesc ">
    376. 

  376.  当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_ROLL_OVER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    377. 

  377.  当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件。 
    378. 

  378.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchRollOver</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchRollOver</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    379. 

  379.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    380. 

  380.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:rollOver" class="- topic/link "><linktext class="- topic/linktext ">rollOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_ROLL_OUT_touchRollOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchRollOut</apiName><shortdesc class="- topic/shortdesc ">
    381. 

  381.  当用户移动接触点，使其远离启用触摸的设备上的 InteractiveObject 实例时（例如，在配有触摸屏的移动电话或绘图板上将一个手指从显示对象上的一点移动到显示对象外的一点）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_ROLL_OUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    382. 

  382.  当用户移动接触点，使其远离启用触摸的设备上的 InteractiveObject 实例时（例如，在配有触摸屏的移动电话或绘图板上将一个手指从显示对象上的一点移动到显示对象外的一点）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件。 
    383. 

  383.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchRollOut</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchRollOut</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    384. 

  384.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    385. 

  385.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:rollOut" class="- topic/link "><linktext class="- topic/linktext ">rollOut 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_OVER_touchOver" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchOver</apiName><shortdesc class="- topic/shortdesc ">
    386. 

  386.  当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_OVER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    387. 

  387.  当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件。 
    388. 

  388.  <p class="- topic/p ">具体来说，如果用户在 InteractiveObject 上移动一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    389. 

  389.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    390. 

  390.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">mouseOver 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_OUT_touchOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchOut</apiName><shortdesc class="- topic/shortdesc ">
    391. 

  391.  当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时（例如，在配有触摸屏的移动电话或绘图板上，将手指从一个显示对象拖到另一个显示对象）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_OUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    392. 

  392.  当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时（例如，在配有触摸屏的移动电话或绘图板上，将手指从一个显示对象拖到另一个显示对象）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> 事件。 
    393. 

  393.  <p class="- topic/p ">具体来说，如果用户在触摸屏上移动一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchOut</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchOut</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    394. 

  394.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    395. 

  395.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOut" class="- topic/link "><linktext class="- topic/linktext ">mouseOut 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_MOVE_touchMove" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchMove</apiName><shortdesc class="- topic/shortdesc ">
    396. 

  396.  当用户在启用触摸的设备上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上拖动手指）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_MOVE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    397. 

  397.  当用户在启用触摸的设备上移动接触点时（例如，在配有触摸屏的移动电话或绘图板上拖动手指）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">mouseMove</codeph> 事件。 
    398. 

  398.  <p class="- topic/p ">具体来说，如果用户在触摸屏上移动一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseMove</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchMove</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseMove</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchMove</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    399. 

  399.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    400. 

  400.  </apiDesc><example conref="..\events\examples\TouchEventExample.as" class="- topic/example "> 以下示例显示针对 <codeph class="+ topic/ph pr-d/codeph ">TOUCH_BEGIN</codeph> 事件、<codeph class="+ topic/ph pr-d/codeph ">TOUCH_MOVE</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">TOUCH_END</codeph> 事件的事件处理。当接触点在屏幕上移动 (<codeph class="+ topic/ph pr-d/codeph ">onTouchMove</codeph>) 时，会跟踪相对于舞台的 X 坐标以便输出。对于 <codeph class="+ topic/ph pr-d/codeph ">onTouchBegin</codeph> 函数中的 <codeph class="+ topic/ph pr-d/codeph ">Sprite.startTouchDrag</codeph> 参数，touchPointID 的值是分配给事件对象的值。bounds 参数是定义父显示对象（bg 是包含 MySprite 的显示对象）的边界的矩形。 
    401. 

  401. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    402. 

  402. Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
    403. 

  403. 

  404. MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
    405. 

  405. MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
    406. 

  406. MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
    407. 

  407. 

  408. function onTouchBegin(eBegin:TouchEvent) {
    409. 

  409.      eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
    410. 

  410.      trace("touch begin");
    411. 

  411.  
    412. 

  412.  }
    413. 

  413. 

  414. function onTouchMove(eMove:TouchEvent) {
    415. 

  415.     trace(eMove.stageX);
    416. 

  416. }
    417. 

  417.  
    418. 

  418. function onTouchEnd(eEnd:TouchEvent) {
    419. 

  419.      eEnd.target.stopTouchDrag(eEnd.touchPointID);
    420. 

  420.      trace("touch end");
    421. 

  421. }
    422. 

  422. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseMove" class="- topic/link "><linktext class="- topic/linktext ">mouseMove 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_END_touchEnd" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchEnd</apiName><shortdesc class="- topic/shortdesc ">
    423. 

  423.  当用户移除与启用触摸的设备的接触时（例如，将手指从配有触摸屏的移动电话或绘图板上抬起）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_END</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    424. 

  424.  当用户移除与启用触摸的设备的接触时（例如，将手指从配有触摸屏的移动电话或绘图板上抬起）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph> 事件。 
    425. 

  425.  <p class="- topic/p ">具体来说，如果用户从触摸屏上抬起一个手指，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchEnd</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchEnd</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p> 
    426. 

  426.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    427. 

  427.  </apiDesc><example conref="..\events\examples\TouchEventExample.as" class="- topic/example "> 以下示例显示针对 <codeph class="+ topic/ph pr-d/codeph ">TOUCH_BEGIN</codeph> 事件、<codeph class="+ topic/ph pr-d/codeph ">TOUCH_MOVE</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">TOUCH_END</codeph> 事件的事件处理。当接触点在屏幕上移动 (<codeph class="+ topic/ph pr-d/codeph ">onTouchMove</codeph>) 时，会跟踪相对于舞台的 X 坐标以便输出。对于 <codeph class="+ topic/ph pr-d/codeph ">onTouchBegin</codeph> 函数中的 <codeph class="+ topic/ph pr-d/codeph ">Sprite.startTouchDrag</codeph> 参数，touchPointID 的值是分配给事件对象的值。bounds 参数是定义父显示对象（bg 是包含 MySprite 的显示对象）的边界的矩形。 
    428. 

  428. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    429. 

  429. Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
    430. 

  430. 

  431. MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
    432. 

  432. MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
    433. 

  433. MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
    434. 

  434. 

  435. function onTouchBegin(eBegin:TouchEvent) {
    436. 

  436.      eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
    437. 

  437.      trace("touch begin");
    438. 

  438.  
    439. 

  439.  }
    440. 

  440. 

  441. function onTouchMove(eMove:TouchEvent) {
    442. 

  442.     trace(eMove.stageX);
    443. 

  443. }
    444. 

  444.  
    445. 

  445. function onTouchEnd(eEnd:TouchEvent) {
    446. 

  446.      eEnd.target.stopTouchDrag(eEnd.touchPointID);
    447. 

  447.      trace("touch end");
    448. 

  448. }
    449. 

  449. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseUp" class="- topic/link "><linktext class="- topic/linktext ">mouseUp 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.TouchEvent.TOUCH_BEGIN_touchBegin" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">touchBegin</apiName><shortdesc class="- topic/shortdesc ">
    450. 

  450.  当用户第一次触摸启用触摸的设备时（例如，用手指触摸配有触摸屏的移动电话或绘图板）调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.TouchEvent.TOUCH_BEGIN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.TouchEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    451. 

  451.  当用户第一次触摸启用触摸的设备时（例如，用手指触摸配有触摸屏的移动电话或绘图板）调度。某些设备可能还会将此接触解释为 <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> 事件。 
    452. 

  452.  <p class="- topic/p ">具体来说，如果用户使用一个手指接触触摸屏，则 InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> 事件或 <codeph class="+ topic/ph pr-d/codeph ">touchBegin</codeph> 事件，或者，如果当前环境支持，则可同时调度这两个事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 <codeph class="+ topic/ph pr-d/codeph ">touchBegin</codeph> 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。</p>
    453. 

  453.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>有关环境兼容性的信息，请参阅 Multitouch 类。</p>  
    454. 

  454.  </apiDesc><example conref="..\events\examples\TouchEventExample.as" class="- topic/example "> 以下示例显示针对 <codeph class="+ topic/ph pr-d/codeph ">TOUCH_BEGIN</codeph> 事件、<codeph class="+ topic/ph pr-d/codeph ">TOUCH_MOVE</codeph> 事件和 <codeph class="+ topic/ph pr-d/codeph ">TOUCH_END</codeph> 事件的事件处理。当接触点在屏幕上移动 (<codeph class="+ topic/ph pr-d/codeph ">onTouchMove</codeph>) 时，会跟踪相对于舞台的 X 坐标以便输出。对于 <codeph class="+ topic/ph pr-d/codeph ">onTouchBegin</codeph> 函数中的 <codeph class="+ topic/ph pr-d/codeph ">Sprite.startTouchDrag</codeph> 参数，touchPointID 的值是分配给事件对象的值。bounds 参数是定义父显示对象（bg 是包含 MySprite 的显示对象）的边界的矩形。 
    455. 

  455. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    456. 

  456. Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
    457. 

  457. 

  458. MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
    459. 

  459. MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
    460. 

  460. MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
    461. 

  461. 

  462. function onTouchBegin(eBegin:TouchEvent) {
    463. 

  463.      eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
    464. 

  464.      trace("touch begin");
    465. 

  465.  
    466. 

  466.  }
    467. 

  467. 

  468. function onTouchMove(eMove:TouchEvent) {
    469. 

  469.     trace(eMove.stageX);
    470. 

  470. }
    471. 

  471.  
    472. 

  472. function onTouchEnd(eEnd:TouchEvent) {
    473. 

  473.      eEnd.target.stopTouchDrag(eEnd.touchPointID);
    474. 

  474.      trace("touch end");
    475. 

  475. }
    476. 

  476. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseDown" class="- topic/link "><linktext class="- topic/linktext ">mouseDown 事件</linktext></link><link href="flash.ui.xml#Multitouch" class="- topic/link "><linktext class="- topic/linktext ">flash.ui.Multitouch</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.ROLL_OVER_rollOver" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">rollOver</apiName><shortdesc class="- topic/shortdesc ">
    477. 

  477.  用户将指针设备移动到 InteractiveObject 实例上时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.ROLL_OVER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    478. 

  478.  用户将指针设备移动到 InteractiveObject 实例上时调度。事件目标为指针设备下的对象或该对象的父级。<codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 是以前在指针设备下的对象。<codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件是沿该对象的父级链向下连续调度的，从 <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 的根或始祖之外的最高父级开始，并以该对象结束。
    479. 

  479.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时，该显示对象将调度 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件。这种行为与 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件的行为不同，每次鼠标进入显示对象容器的任何子对象区域时都会调度此事件，即使鼠标已在显示对象容器的另一个子对象上也是如此。 </p>
    480. 

  480.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.ROLL_OUT_rollOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">rollOut</apiName><shortdesc class="- topic/shortdesc ">
    481. 

  481.  用户将指针设备从 InteractiveObject 实例上移开时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.ROLL_OUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    482. 

  482.  用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象或该对象的父级。<codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 是将指针设备向其移动的对象。在该对象的父级链以上连续调度 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件，以该对象为开头，并以除 <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 的根或始祖之外的最高级别的父级结束。 
    483. 

  483.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标离开显示对象区域或任何其子级区域并转到除其子级以外的对象时，显示对象调度 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件。这是与 <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> 事件行为不同的行为，因为该事件是在每次鼠标离开显示对象容器的任何子对象区域时才会被调度，即使鼠标仍保留在显示对象容器的另一个子对象上也是如此。</p>
    484. 

  484.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MOUSE_WHEEL_mouseWheel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseWheel</apiName><shortdesc class="- topic/shortdesc ">
    485. 

  485.  当鼠标滚轮滚动到 InteractiveObject 实例上时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MOUSE_WHEEL</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    486. 

  486.  当鼠标滚轮滚动到 InteractiveObject 实例上时调度。如果目标为文本字段，则作为默认行为，该文本会滚动。仅在 Microsoft Windows 操作系统中提供。
    487. 

  487.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MOUSE_UP_mouseUp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseUp</apiName><shortdesc class="- topic/shortdesc ">
    488. 

  488.  当用户在 InteractiveObject 实例上释放指针设备按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MOUSE_UP</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    489. 

  489.  当用户在 InteractiveObject 实例上释放指针设备按钮时调度。如果目标为 SimpleButton 实例，该对象会显示 <codeph class="+ topic/ph pr-d/codeph ">upState</codeph> 显示对象。如果目标为可选文本字段，则作为默认行为，该文本字段会结束选择。
    490. 

  490.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MOUSE_OVER_mouseOver" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseOver</apiName><shortdesc class="- topic/shortdesc ">
    491. 

  491.  用户将指针设备移动到 InteractiveObject 实例上时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MOUSE_OVER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    492. 

  492.  用户将指针设备移动到 InteractiveObject 实例上时调度。<codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 是以前在指针设备下的对象。如果目标为 SimpleButton 实例，作为默认行为，该对象会根据是否按下鼠标按键而显示 <codeph class="+ topic/ph pr-d/codeph ">overState</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">upState</codeph> 显示对象。
    493. 

  493.  <p class="- topic/p ">每次鼠标进入显示对象容器的任何子对象区域时都会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> 事件，即使鼠标已在显示对象容器的另一个子对象上也是如此。此行为不同于 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件的用途，此事件用于简化带有子级的显示对象容器的移出行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时，该显示对象将调度 <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件。<codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> 事件是沿该对象的父级链向下连续调度的，从 <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 的根或始祖之外的最高父级开始，并以该对象结束。</p>
    494. 

  494.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MOUSE_OUT_mouseOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseOut</apiName><shortdesc class="- topic/shortdesc ">
    495. 

  495.  用户将指针设备从 InteractiveObject 实例上移开时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MOUSE_OUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    496. 

  496.  用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象。<codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 是将指针设备向其移动的对象。如果目标为 SimpleButton 实例，作为默认行为，该按钮会显示 <codeph class="+ topic/ph pr-d/codeph ">upState</codeph> 显示对象。
    497. 

  497.  <p class="- topic/p ">每次鼠标离开显示对象容器的任何子对象区域时都会调度 <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> 事件，即使鼠标停留在显示对象容器的另一个子对象上也是如此。此行为不同于 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件的用途，此事件用于简化带有子级的显示对象容器的滑过行为的编码。当鼠标离开某个显示对象区域或任何其子级区域以转到其子级以外的对象时，该显示对象将调度 <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件。<codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> 事件是沿该对象的父级链向上连续调度的，从该对象开始，并以 <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 的根或始祖之外的最高父级结束。</p>
    498. 

  498.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MOUSE_MOVE_mouseMove" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseMove</apiName><shortdesc class="- topic/shortdesc ">
    499. 

  499.  用户移动 InteractiveObject 上的指针设备时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MOUSE_MOVE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    500. 

  500.  用户移动 InteractiveObject 上的指针设备时调度。如果目标为用户正在选择的文本字段，则作为默认行为，会更新选择。
    501. 

  501.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.MOUSE_DOWN_mouseDown" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseDown</apiName><shortdesc class="- topic/shortdesc ">
    502. 

  502.  当用户在 InteractiveObject 实例上按下指针设备按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.MOUSE_DOWN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    503. 

  503.  当用户在 InteractiveObject 实例上按下指针设备按钮时调度。如果目标为 SimpleButton 实例，作为默认行为，SimpleButton 实例会显示 <codeph class="+ topic/ph pr-d/codeph ">downState</codeph> 显示对象。如果目标为可选文本字段，作为默认行为，该文本字段会开始选择。
    504. 

  504.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.DOUBLE_CLICK_doubleClick" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">doubleClick</apiName><shortdesc class="- topic/shortdesc ">
    505. 

  505.  如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.DOUBLE_CLICK</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    506. 

  506.  如果 InteractiveObject 的 <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> 标志设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。要使 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件发生，它必在以下一系列事件后面：<codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph>、<codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph>、<codeph class="+ topic/ph pr-d/codeph ">click</codeph>、<codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph>、<codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph>。所有这些事件必须共享与 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件相同的目标。第二个 <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph> 事件代表第二次单击，该行为必须在 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件之后的指定时间段内发生。该时间段的允许长度因操作系统而异，而且通常可由用户配置。如果目标为可选文本字段，作为默认行为，会选择指针下面的单词。如果目标 InteractiveObject 未将其 <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> 标志设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，它将接收两个 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件。  
    507. 

  507.  
    508. 

  508.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> 属性默认为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。  </p>
    509. 

  509.  
    510. 

  510.  <p class="- topic/p ">TextField 对象的双击文本选择行为与 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件无关。使用 <codeph class="+ topic/ph pr-d/codeph ">TextField.doubleClickEnabled</codeph> 控制 TextField 选择。</p>
    511. 

  511.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/doubleClickEnabled" class="- topic/link "><linktext class="- topic/linktext ">doubleClickEnabled</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.MouseEvent.CLICK_click" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">click</apiName><shortdesc class="- topic/shortdesc ">
    512. 

  512.  用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MouseEvent.CLICK</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MouseEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    513. 

  513.  用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。要使单击事件发生，它必须始终在以下顺序的一系列事件后面：mouseDown 事件，然后是 mouseUp 事件。这两个事件的目标对象必须相同，否则不会发生 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件。<codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph> 事件之间的任何时间都会发生任何数量的其他鼠标事件；<codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件仍会发生。 
    514. 

  514.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.FocusEvent.MOUSE_FOCUS_CHANGE_mouseFocusChange" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">mouseFocusChange</apiName><shortdesc class="- topic/shortdesc ">
    515. 

  515.  用户尝试使用指针设备更改焦点时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.FocusEvent.MOUSE_FOCUS_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    516. 

  516.  用户尝试使用指针设备更改焦点时调度。此事件的默认行为是更改焦点并调度相应的 <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> 事件。 
    517. 

  517.  
    518. 

  518.  <p class="- topic/p ">将此事件调度到当前具有焦点的对象。如果您没有禁止默认行为，则此事件的相关对象为接收焦点的 InteractiveObject 实例。可以通过调用正确注册到目标对象的事件侦听器中的 <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> 来防止更改焦点。未使用 <codeph class="+ topic/ph pr-d/codeph ">shiftKey</codeph> 属性。默认情况下调度焦点更改和 <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> 及 <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> 事件。</p>
    519. 

  519.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.FocusEvent.KEY_FOCUS_CHANGE_keyFocusChange" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">keyFocusChange</apiName><shortdesc class="- topic/shortdesc ">
    520. 

  520.  用户尝试使用键盘导航更改焦点时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.FocusEvent.KEY_FOCUS_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    521. 

  521.  用户尝试使用键盘导航更改焦点时调度。此事件的默认行为是更改焦点并调度相应的 <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> 事件。
    522. 

  522.  
    523. 

  523.  <p class="- topic/p ">将此事件调度到当前具有焦点的对象。如果您没有禁止默认行为，则此事件的相关对象为接收焦点的 InteractiveObject 实例。可以通过调用正确注册到目标对象的事件侦听器中的 <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> 方法来防止更改焦点。默认情况下调度焦点更改和 <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> 及 <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> 事件。</p>
    524. 

  524.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.FocusEvent.FOCUS_OUT_focusOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">focusOut</apiName><shortdesc class="- topic/shortdesc ">
    525. 

  525.  显示对象失去焦点后调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.FocusEvent.FOCUS_OUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    526. 

  526.  显示对象失去焦点<i class="+ topic/ph hi-d/i ">后</i>调度。这种情况会在用户使用指针设备或键盘导航加亮显示不同的对象时发生。失去焦点的对象称为该事件的目标对象，而接收焦点的相应 InteractiveObject 实例称为相关对象。对相关对象的引用存储在目标对象的 <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 属性中。未使用 <codeph class="+ topic/ph pr-d/codeph ">shiftKey</codeph> 属性。该事件在相关对象调度 <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> 事件之前发生。
    527. 

  527.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.FocusEvent.FOCUS_IN_focusIn" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">focusIn</apiName><shortdesc class="- topic/shortdesc ">
    528. 

  528.  显示对象获得焦点后调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.FocusEvent.FOCUS_IN</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    529. 

  529.  显示对象获得焦点<i class="+ topic/ph hi-d/i ">后</i>调度。这种情况会在用户使用指针设备或键盘导航加亮显示对象时发生。该焦点的接收方称为该事件的目标对象，而因该更改而失去焦点的相应 InteractiveObject 实例称为相关对象。对相关对象的引用存储在接收对象的 <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> 属性中。未使用 <codeph class="+ topic/ph pr-d/codeph ">shiftKey</codeph> 属性。在该事件在调度前一个对象的 <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> 事件之后发生。
    530. 

  530.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.SELECT_ALL_selectAll" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">selectAll</apiName><shortdesc class="- topic/shortdesc ">
    531. 

  531.  在用户为全选操作激活特定于平台的加速键组合或选择文本上下文菜单中的“全选”时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.SELECT_ALL</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    532. 

  532.  在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是使该文本字段的所有内容处于选定状态。 
    533. 

  533.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.PASTE_paste" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">paste</apiName><shortdesc class="- topic/shortdesc ">
    534. 

  534.  在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.PASTE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    535. 

  535.  在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是将剪贴板的所有内容粘贴到该文本字段的当前插入点，替换文本字段中当前选定的所有文本。 
    536. 

  536.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.CUT_cut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cut</apiName><shortdesc class="- topic/shortdesc ">
    537. 

  537.  在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CUT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    538. 

  538.  在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是将该文本字段中当前选定的所有文本剪切到剪贴板。 
    539. 

  539.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.COPY_copy" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">copy</apiName><shortdesc class="- topic/shortdesc ">
    540. 

  540.  在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COPY</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    541. 

  541.  在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是将该文本字段中当前选定的所有文本复制到剪贴板。 
    542. 

  542.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:InteractiveObject_flash.events.Event.CLEAR_clear" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">clear</apiName><shortdesc class="- topic/shortdesc ">
    543. 

  543.  当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CLEAR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    544. 

  544.  当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是删除该文本字段中当前选定的所有文本。 
    545. 

  545.  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="flash.display:InteractiveObject:InteractiveObject" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">InteractiveObject</apiName><shortdesc class="- topic/shortdesc ">
    546. 

  546. 	调用新的 InteractiveObject() 构造函数会引发 ArgumentError 异常。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    547. 

  547. 	调用 <codeph class="+ topic/ph pr-d/codeph ">new InteractiveObject()</codeph> 构造函数会引发 <codeph class="+ topic/ph pr-d/codeph ">ArgumentError</codeph> 异常。但是，可以调用以下 InteractiveObject 的子类的构造函数：
    548. 

  548. 	
    549. 

  549. 	<ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">new SimpleButton()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">new TextField()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">new Loader()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">new Sprite()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">new MovieClip()</codeph></li></ul>
    550. 

  550. 	
    551. 

  551. 	
    552. 

  552. 	</apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.display:InteractiveObject:requestSoftKeyboard" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">requestSoftKeyboard</apiName><shortdesc class="- topic/shortdesc ">
    553. 

  553.      显示虚拟键盘。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 意味着同意软键盘请求；值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph> 意味着未显示软键盘。
    554. 

  554.     </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">如果当前上下文支持，则显示键盘。
    555. 

  555.     </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    556. 

  556.      显示虚拟键盘。
    557. 

  557.     
    558. 

  558.     <p class="- topic/p ">调用此方法将焦点设置到 InteractiveObject 实例，并且如果需要，将显示软键盘。<codeph class="+ topic/ph pr-d/codeph ">needsSoftKeyboard</codeph> 必须也为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。如果硬键盘可用，或者客户端系统不支持虚拟键盘，则不会显示键盘。</p>
    559. 

  559.     
    560. 

  560.     <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>iOS 上的 AIR 应用程序不支持此方法。</p>
    561. 

  561.     
    562. 

  562.     </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/needsSoftKeyboard" class="- topic/link "><linktext class="- topic/linktext ">needsSoftKeyboard</linktext></link></related-links></apiOperation><apiValue id="flash.display:InteractiveObject:accessibilityImplementation:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">accessibilityImplementation</apiName><shortdesc class="- topic/shortdesc ">
    563. 

  563. 	 InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.accessibility:AccessibilityImplementation</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    564. 

  564. 	 InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。
    565. 

  565. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.accessibility.xml#AccessibilityImplementation" class="- topic/link "><linktext class="- topic/linktext ">flash.accessibility.AccessibilityImplementation</linktext></link></related-links></apiValue><apiValue id="flash.display:InteractiveObject:contextMenu:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">contextMenu</apiName><shortdesc class="- topic/shortdesc "> 
    566. 

  566. 	 指定与此对象相关联的上下文菜单。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:NativeMenu</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">与此对象相关联的上下文菜单。
    567. 

  567. 	 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    568. 

  568. 	 指定与此对象相关联的上下文菜单。
    569. 

  569. 	 
    570. 

  570. 	 <p class="- topic/p ">对于在 Flash Player 中运行的内容，此属性是一个 ContextMenu 对象。在 AIR 运行时中，ContextMenu 类扩展 NativeMenu 类，但 Flash Player 只支持 ContextMenu 类，不支持 NativeMenu 类。
    571. 

  571. 	 </p>
    572. 

  572. 	 
    573. 

  573. 	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>TextField 对象的上下文菜单中始终包含剪贴板菜单。剪贴板菜单包含“剪切”、“复制”、“粘贴”、“清除”和“全选”命令。您不能从 TextField 对象的上下文菜单中删除这些命令。对于 TextField 对象，选择这些命令（或等效键盘命令）不会生成 <codeph class="+ topic/ph pr-d/codeph ">clear</codeph>、<codeph class="+ topic/ph pr-d/codeph ">copy</codeph>、<codeph class="+ topic/ph pr-d/codeph ">cut</codeph>、<codeph class="+ topic/ph pr-d/codeph ">paste</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">selectAll</codeph> 事件。</p>
    574. 

  574. 	 
    575. 

  575. 	 </apiDesc><example conref="examples\ContextMenu_custom.as" class="- topic/example "> 以下示例显示如何通过设置 ContextMenu 对象的 Sprite 的 contextMenu 属性向 Sprite 对象中添加自定义上下文菜单项。<xref href="http://actionscriptexamples.com/2009/03/05/creating-a-custom-context-menu-item-in-flash-using-actionscript-30/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref> 提供的示例。 
    576. 

  576. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    577. 

  577. var red_cmi:ContextMenuItem = new ContextMenuItem("red");
    578. 

  578. red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
    579. 

  579.  
    580. 

  580. var cm:ContextMenu = new ContextMenu();
    581. 

  581. cm.customItems.push(red_cmi);
    582. 

  582. cm.hideBuiltInItems();
    583. 

  583.  
    584. 

  584. var spr:Sprite = new Sprite();
    585. 

  585. spr.contextMenu = cm;
    586. 

  586. spr.graphics.beginFill(0x000000);
    587. 

  587. spr.graphics.drawRect(0, 0, 120, 90);
    588. 

  588. spr.graphics.endFill();
    589. 

  589. spr.x = 10;
    590. 

  590. spr.y = 10;
    591. 

  591. addChild(spr);
    592. 

  592.  
    593. 

  593. function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    594. 

  594.     spr.graphics.clear();
    595. 

  595.     spr.graphics.beginFill(0xFF0000);
    596. 

  596.     spr.graphics.drawRect(0, 0, 120, 90);
    597. 

  597.     spr.graphics.endFill();
    598. 

  598. }
    599. 

  599. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:InteractiveObject:doubleClickEnabled:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">doubleClickEnabled</apiName><shortdesc class="- topic/shortdesc "> 
    600. 

  600. 	 指定此对象是否接收 doubleClick 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">该对象是否接收双击消息。
    601. 

  601. 	 
    602. 

  602. 	  
    603. 

  603. 	 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    604. 

  604. 	 指定此对象是否接收 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件。默认值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>，这意味着在默认情况下，InteractiveObject 实例不接收 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件。如果将 <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，实例在其范围内接收 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件。InteractiveObject 实例的 <codeph class="+ topic/ph pr-d/codeph ">mouseEnabled</codeph> 属性也必须设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，以便对象能够接收 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件。
    605. 

  605. 	 
    606. 

  606. 	 <p class="- topic/p ">设置此属性不会调度任何事件。必须使用 <codeph class="+ topic/ph pr-d/codeph ">addEventListener()</codeph> 方法为 <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> 事件添加事件侦听器。</p>
    607. 

  607. 	 
    608. 

  608. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:doubleClick" class="- topic/link "><linktext class="- topic/linktext ">doubleClick</linktext></link><link href="flash.display.xml#InteractiveObject/mouseEnabled" class="- topic/link "><linktext class="- topic/linktext ">mouseEnabled</linktext></link><link href="flash.display.xml#DisplayObjectContainer/mouseChildren" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.mouseChildren</linktext></link></related-links></apiValue><apiValue id="flash.display:InteractiveObject:focusRect:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">focusRect</apiName><shortdesc class="- topic/shortdesc "> 
    609. 

  609. 	 指定此对象是否显示焦点矩形。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>FP IMD: See the AS2 MovieClip._focusRect, Button._focusRect, and 
    610. 

  610. 	 _focusRect (global property) topics for information to migrate to the ASDoc description of this 
    611. 

  611. 	 AS3 property.
    612. 

  612. 	 
    613. 

  613. 	  
    614. 

  614. 	  </internal></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Object</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    615. 

  615. 	 指定此对象是否显示焦点矩形。它可以采用三个值中的一个：<codeph class="+ topic/ph pr-d/codeph ">true</codeph>、<codeph class="+ topic/ph pr-d/codeph ">false</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。<codeph class="+ topic/ph pr-d/codeph ">true</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">false</codeph> 值按预期工作，指定是否显示焦点矩形。<codeph class="+ topic/ph pr-d/codeph ">null</codeph> 值表示此对象遵循舞台的 <codeph class="+ topic/ph pr-d/codeph ">stageFocusRect</codeph> 属性。
    616. 

  616. 	 
    617. 

  617. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:InteractiveObject:mouseEnabled:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">mouseEnabled</apiName><shortdesc class="- topic/shortdesc "> 
    618. 

  618. 	 指定此对象是否接收鼠标或其他用户输入、消息。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    619. 

  619. 	 指定此对象是否接收鼠标或其他用户输入、消息。默认值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，这表示默认情况下，显示列表上的任何 InteractiveObject 实例都会接收鼠标事件或其他用户输入事件。如果将 <codeph class="+ topic/ph pr-d/codeph ">mouseEnabled</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>，则实例将不接收任何鼠标事件（或其他用户输入事件，例如键盘事件）。显示列表上的该实例的任何子级都不会受到影响。要更改显示列表上对象的所有子级的 <codeph class="+ topic/ph pr-d/codeph ">mouseEnabled</codeph> 行为，请使用 <codeph class="+ topic/ph pr-d/codeph ">flash.display.DisplayObjectContainer.mouseChildren</codeph>。
    620. 

  620. 	 <p class="- topic/p "> 设置此属性不会调度任何事件。您必须使用 <codeph class="+ topic/ph pr-d/codeph ">addEventListener()</codeph> 方法才能创建交互式功能。</p>
    621. 

  621. 	 
    622. 

  622. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObjectContainer/mouseChildren" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.mouseChildren</linktext></link></related-links></apiValue><apiValue id="flash.display:InteractiveObject:needsSoftKeyboard:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">needsSoftKeyboard</apiName><shortdesc class="- topic/shortdesc "> 
    623. 

  623. 	 指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    624. 

  624. 	 指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。
    625. 

  625. 	 
    626. 

  626. 	 <p class="- topic/p ">默认情况下，该值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>，因此将焦点设置到 InteractiveObject 实例不会显示软键盘。如果 <codeph class="+ topic/ph pr-d/codeph ">needsSoftKeyboard</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，则当 InteractiveObject 可以接受用户输入时，运行时会显示软键盘。当以编程方式调用设置舞台的 <codeph class="+ topic/ph pr-d/codeph ">focus</codeph> 属性或用户交互（如，点击）后，InteractiveObject 实例即可以接受用户输入。如果客户端系统具有可用的硬键盘或者不支持虚拟键盘，则不会显示软键盘。</p> 
    627. 

  627. 	 
    628. 

  628. 	 <p class="- topic/p ">当显示或关闭软键盘时，InteractiveObject 实例会调度 <codeph class="+ topic/ph pr-d/codeph ">softKeyboardActivating</codeph>、<codeph class="+ topic/ph pr-d/codeph ">softKeyboardActivate</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">softKeyboardDeactivate</codeph> 事件。</p>
    629. 

  629. 	 
    630. 

  630.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>iOS 上的 AIR 应用程序不支持此属性。</p>
    631. 

  631.      
    632. 

  632. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:softKeyboardActivating" class="- topic/link "><linktext class="- topic/linktext ">softKeyboardActivating</linktext></link><link href="flash.display.xml#InteractiveObject/event:softKeyboardActivate" class="- topic/link "><linktext class="- topic/linktext ">softKeyboardActivate</linktext></link><link href="flash.display.xml#InteractiveObject/event:softKeyboardDeactivate" class="- topic/link "><linktext class="- topic/linktext ">softKeyboardDeactivate</linktext></link></related-links></apiValue><apiValue id="flash.display:InteractiveObject:softKeyboardInputAreaOfInterest:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">softKeyboardInputAreaOfInterest</apiName><shortdesc class="- topic/shortdesc "> 
    633. 

  633.      定义当显示软键盘时应在屏幕上保留的区域。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Rectangle</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">设置当软键盘打开时在屏幕上显示的区域。
    634. 

  634.      </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    635. 

  635.      定义当显示软键盘时应在屏幕上保留的区域。
    636. 

  636.      
    637. 

  637.      <p class="- topic/p ">如果 InteractiveObject 的 <codeph class="+ topic/ph pr-d/codeph ">needsSoftKeyboard</codeph> 属性为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，则当用户键入时，运行时会根据需要调整显示，以将对象保留在视图中。通常，运行时会使用从 <codeph class="+ topic/ph pr-d/codeph ">DisplayObject.getBounds()</codeph> 方法获取的对象边界。您可以通过使用此 <codeph class="+ topic/ph pr-d/codeph ">softKeyboardInputAreaOfInterest</codeph> 属性指定不同的区域。</p>
    638. 

  638.      
    639. 

  639.      <p class="- topic/p ">在舞台坐标中指定 <codeph class="+ topic/ph pr-d/codeph ">softKeyboardInputAreaOfInterest</codeph>。</p>
    640. 

  640.      
    641. 

  641.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>在 Android 的横向模式中，不遵循 <codeph class="+ topic/ph pr-d/codeph ">softKeyboardInputAreaOfInterest</codeph>。</p>
    642. 

  642.      
    643. 

  643.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/getBounds()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObject.getBounds()</linktext></link></related-links></apiValue><apiValue id="flash.display:InteractiveObject:tabEnabled:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">tabEnabled</apiName><shortdesc class="- topic/shortdesc "> 
    644. 

  644. 	 指定此对象是否遵循 Tab 键顺序。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>FP IMD: See the AS2 MovieClip.tabEnabled, Button.tabEnabled, and 
    645. 

  645. 	 TextField.tabEnabled topics for information to migrate to the ASDoc description of this 
    646. 

  646. 	 AS3 property.
    647. 

  647. 	 
    648. 

  648. 	  
    649. 

  649. 	 </internal></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">该对象是否遵循 Tab 键顺序。
    650. 

  650. 	 
    651. 

  651. 	 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    652. 

  652. 	 指定此对象是否遵循 Tab 键顺序。如果该对象遵循 Tab 键顺序，值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>；否则值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。默认情况下，值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>，但以下情况除外：
    653. 

  653.      <ul class="- topic/ul "><li class="- topic/li ">对于 SimpleButton 对象，值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。</li><li class="- topic/li ">对于具有 <codeph class="+ topic/ph pr-d/codeph ">type = "input"</codeph> 的 TextField 对象，值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。</li><li class="- topic/li ">对于具有 <codeph class="+ topic/ph pr-d/codeph ">buttonMode = true</codeph> 的 Sprite 对象或 MovieClip 对象，值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。</li></ul>
    654. 

  654. 	 
    655. 

  655. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:InteractiveObject:tabIndex:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">tabIndex</apiName><shortdesc class="- topic/shortdesc "> 
    656. 

  656.    	 指定 SWF 文件中的对象按 Tab 键顺序排列。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">该对象的 Tab 键索引。
    657. 

  657. 	 
    658. 

  658. 	  
    659. 

  659. 	 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    660. 

  660.    	 指定 SWF 文件中的对象按 Tab 键顺序排列。默认情况下，<codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性为 -1，这意味着没有为该对象设置任何 Tab 索引。
    661. 

  661. 	 
    662. 

  662.    	 <p class="- topic/p ">如果 SWF 文件中当前显示的任何对象包含 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性，则禁用 Tab 键自动排序，而使用该 SWF 文件中对象的 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性来计算 Tab 键顺序。这个自定义的 Tab 键排序仅包括指定了 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性的对象。</p>
    663. 

  663. 	 
    664. 

  664.    	 <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性可以是非负整数。这些对象按照其 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性按升序进行排序。<codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 值为 1 的对象在 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 值为 2 的对象的前面。不要对多个对象使用相同的 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 值。</p>
    665. 

  665. 	 
    666. 

  666. 	 <p class="- topic/p ">由 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性定义的自定义 Tab 键顺序为<i class="+ topic/ph hi-d/i ">平构</i>。这意味着不考虑 SWF 文件中对象的层次结构关系。SWF 文件中具有 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性的所有对象都排入 Tab 键顺序中，而 Tab 键顺序由 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 值的顺序确定。 </p>
    667. 

  667. 	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>要设置 TLFTextField 实例的 Tab 键顺序，请将 TLFTextField 的显示子对象转换为 InteractiveObject，然后设置 <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> 属性。例如：
    668. 

  668. 	 <pre xml:space="preserve" class="- topic/pre ">
    669. 

  669. 	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
    670. 

  670. 	 </pre>
    671. 

  671. 	 要将 TLFTextField 对象三个实例的 Tab 顺序从默认设置（<codeph class="+ topic/ph pr-d/codeph ">tlfInstance1</codeph>、<codeph class="+ topic/ph pr-d/codeph ">tlfInstance2</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">tlfInstance3</codeph>）转变为相反的顺序，请使用：
    672. 

  672. 	 <pre xml:space="preserve" class="- topic/pre ">
    673. 

  673. 	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
    674. 

  674. 	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
    675. 

  675. 	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
    676. 

  676. 	 </pre>
    677. 

  677. 	 </p>	 
    678. 

  678. 	 
    679. 

  679. 	 </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.display:GraphicsTrianglePath" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">GraphicsTrianglePath</apiName><shortdesc class="- topic/shortdesc ">
    680. 

  680.  定义有序的一组三角形，可以使用 (u,v) 填充坐标或普通填充来呈现这些三角形。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseInterface>flash.display:IGraphicsPath</apiBaseInterface><apiBaseInterface>flash.display:IGraphicsData</apiBaseInterface><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    681. 

  681.  定义有序的一组三角形，可以使用 (u,v) 填充坐标或普通填充来呈现这些三角形。路径中的每个三角形都由三组 (x, y) 坐标表示，其中每组坐标都是三角形的一个点。
    682. 

  682.  
    683. 

  683.  <p class="- topic/p ">
    684. 

  684.  三角形顶点不包含 z 坐标，并且不一定表示 3D 面。但是，可以使用三角形路径来支持在 2D 空间中呈现 3D 几何图形。
    685. 

  685.  </p>
    686. 

  686.  
    687. 

  687.  </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Graphics/drawTriangles()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Graphics.drawTriangles()</linktext></link></related-links><apiConstructor id="flash.display:GraphicsTrianglePath:GraphicsTrianglePath" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">GraphicsTrianglePath</apiName><shortdesc class="- topic/shortdesc ">
    688. 

  688.      创建新的 GraphicsTrianglePath 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">vertices</apiItemName><apiType value="Vector$Number" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">由数字构成的矢量，其中的每一对数字将被视为一个点（一个 x, y 对）。必需。
    689. 

  689.      
    690. 

  690.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">indices</apiItemName><apiType value="Vector$int" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个由整数或索引构成的矢量，其中每三个索引定义一个三角形。 
    691. 

  691.      
    692. 

  692.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uvtData</apiItemName><apiType value="Vector$Number" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">由用于应用纹理映射的标准坐标构成的矢量。
    693. 

  693.      
    694. 

  694.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">culling</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">none</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定是否呈现面向给定方向的三角形。用于防止呈现在当前视图中看不见的三角形。可设置为由 TriangleCulling 类定义的任何值。
    695. 

  695.      
    696. 

  696. 	 </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    697. 

  697.      创建新的 GraphicsTrianglePath 对象。
    698. 

  698.      
    699. 

  699.      </apiDesc></apiConstructorDetail><related-links class="- topic/related-links "><link href="flash.display.xml#GraphicsTrianglePath/culling" class="- topic/link "><linktext class="- topic/linktext ">culling</linktext></link><link href="flash.display.xml#TriangleCulling" class="- topic/link "><linktext class="- topic/linktext ">flash.display.TriangleCulling</linktext></link></related-links></apiConstructor><apiValue id="flash.display:GraphicsTrianglePath:indices" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">indices</apiName><shortdesc class="- topic/shortdesc ">
    700. 

  700.      一个由整数或索引构成的矢量，其中每三个索引定义一个三角形。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiType value="Vector$int" name="type" class="- topic/state reference/state apiRef/apiType "/></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    701. 

  701.      一个由整数或索引构成的矢量，其中每三个索引定义一个三角形。如果 indexes 参数为 null，则每三个顶点（vertices 矢量中的 6 对 x,y）定义一个三角形。否则，每个索引将引用一个顶点，即 vertices 矢量中的一对数字。例如，<codeph class="+ topic/ph pr-d/codeph ">indexes[1]</codeph> 引用 (<codeph class="+ topic/ph pr-d/codeph ">vertices[2]</codeph>, <codeph class="+ topic/ph pr-d/codeph ">vertices[3]</codeph>)。 
    702. 

  702. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:GraphicsTrianglePath:uvtData" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">uvtData</apiName><shortdesc class="- topic/shortdesc ">
    703. 

  703.      由用于应用纹理映射的标准坐标构成的矢量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiType value="Vector$Number" name="type" class="- topic/state reference/state apiRef/apiType "/></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    704. 

  704.      由用于应用纹理映射的标准坐标构成的矢量。每个坐标引用用于填充的位图上的一个点。每个顶点必须具有一个 UV 或一个 UVT 坐标。
    705. 

  705.      
    706. 

  706.      <p class="- topic/p ">
    707. 

  707.      对于 UV 坐标，(0,0) 是位图的左上角，(1,1) 是位图的右下角。 
    708. 

  708.      </p>
    709. 

  709.                     
    710. 

  710.      <p class="- topic/p ">
    711. 

  711.      如果此矢量的长度是 <codeph class="+ topic/ph pr-d/codeph ">vertices</codeph> 矢量长度的两倍，则使用标准坐标而不进行透视校正。
    712. 

  712.      </p>
    713. 

  713.      
    714. 

  714.      <p class="- topic/p ">
    715. 

  715.      如果此矢量的长度是 <codeph class="+ topic/ph pr-d/codeph ">vertices</codeph> 矢量长度的三倍，则将第三个坐标解释为“t”，即在视角空间中从视点到纹理的距离。这有助于呈现引擎在 3D 中映射纹理时正确应用透视。
    716. 

  716.      </p>
    717. 

  717. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:GraphicsTrianglePath:vertices" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">vertices</apiName><shortdesc class="- topic/shortdesc ">
    718. 

  718.      由数字构成的矢量，其中的每一对数字将被视为一个点（一个 x, y 对）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiType value="Vector$Number" name="type" class="- topic/state reference/state apiRef/apiType "/></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    719. 

  719.      由数字构成的矢量，其中的每一对数字将被视为一个点（一个 x, y 对）。
    720. 

  720. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:GraphicsTrianglePath:culling:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">culling</apiName><shortdesc class="- topic/shortdesc ">
    721. 

  721.      指定是否呈现面向给定方向的三角形。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    722. 

  722.      指定是否呈现面向给定方向的三角形。用于防止呈现在当前视图中看不见的三角形。 
    723. 

  723.      <p class="- topic/p ">
    724. 

  724.      可设置为由 TriangleCulling 类定义的任何值。
    725. 

  725.      </p>
    726. 

  726.      
    727. 

  727. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#TriangleCulling" class="- topic/link "><linktext class="- topic/linktext ">flash.display.TriangleCulling</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.display:DisplayObject" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">DisplayObject</apiName><shortdesc class="- topic/shortdesc ">
    728. 

  728.  DisplayObject 类是可放在显示列表中的所有对象的基类。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseInterface>flash.display:IBitmapDrawable</apiBaseInterface><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    729. 

  729.  DisplayObject 类是可放在显示列表中的所有对象的基类。该显示列表管理 Flash 运行时中显示的所有对象。使用 DisplayObjectContainer 类排列显示列表中的显示对象。DisplayObjectContainer 对象可以有子显示对象，而其他显示对象（如 Shape 和 TextField 对象）是“叶”节点，只有父级和同级，没有子级。 
    730. 

  730.  
    731. 

  731.  <p class="- topic/p ">DisplayObject 类支持基本功能（如对象的 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 位置），也支持更高级的对象属性（如它的转换矩阵）。 
    732. 

  732.  </p>
    733. 

  733.  
    734. 

  734.  <p class="- topic/p ">DisplayObject 是一种抽象基类；因此，不能直接调用 DisplayObject。调用 <codeph class="+ topic/ph pr-d/codeph ">new DisplayObject()</codeph> 会引发 <codeph class="+ topic/ph pr-d/codeph ">ArgumentError</codeph> 异常。 </p>
    735. 

  735.  
    736. 

  736.  <p class="- topic/p ">所有显示对象都继承自 DisplayObject 类。</p>
    737. 

  737.  
    738. 

  738.  <p class="- topic/p ">DisplayObject 类本身不包含任何用于在屏幕上呈现内容的 API。因此，如果要创建 DisplayObject 类的自定义子类，您将需要扩展其中一个具有在屏幕上呈现内容的 API 的子类，如 Shape、Sprite、Bitmap、SimpleButton、TextField 或 MovieClip 类。</p>
    739. 

  739.  
    740. 

  740.  <p class="- topic/p ">DisplayObject 类包含若干广播事件。通常，任何特定事件的目标均为一个特定的 DisplayObject 实例。例如，<codeph class="+ topic/ph pr-d/codeph ">added</codeph> 事件的目标是已添加到显示列表的特定 DisplayObject 实例。若只有一个目标，则会将事件侦听器限制为只能放置到该目标上（在某些情况下，可放置到显示列表中该目标的始祖上）。但是，对于广播事件，目标不是特定的 DisplayObject 实例，而是所有 DisplayObject 实例（包括那些不在显示列表中的实例）。这意味着您可以向任何 DisplayObject 实例添加侦听器来侦听广播事件。除了 DisplayObject 类的 Events 表中列出的广播事件，DisplayObject 类还从 EventDispatcher 类继承如下两个广播事件：<codeph class="+ topic/ph pr-d/codeph ">activate</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">deactivate</codeph>。</p>
    741. 

  741.  
    742. 

  742.  <p class="- topic/p ">一些以前在 ActionScript 1.0 和 2.0 MovieClip、TextField 和 Button 类中使用的属性（如 <codeph class="+ topic/ph pr-d/codeph ">_alpha</codeph>、<codeph class="+ topic/ph pr-d/codeph ">_height</codeph>、<codeph class="+ topic/ph pr-d/codeph ">_name</codeph>、<codeph class="+ topic/ph pr-d/codeph ">_width</codeph>、<codeph class="+ topic/ph pr-d/codeph ">_x</codeph>、<codeph class="+ topic/ph pr-d/codeph ">_y</codeph> 等）在 ActionScript 3.0 DisplayObject 类中有等效属性，但它们已被重命名，因此不再以下划线 (_) 字符开头。</p>
    743. 

  743.  
    744. 

  744.  <p class="- topic/p ">有关详细信息，请参阅《ActionScript 3.0 开发人员指南》<i class="+ topic/ph hi-d/i "/>中的“显示编程”一章。</p>
    745. 

  745.  
    746. 

  746.  </apiDesc><example conref="examples\DisplayObjectExample.as" class="- topic/example "> 下例使用 <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectExample</codeph> 类在舞台的角上绘制了一个橙色的正方形，然后通过显示每个事件的文本信息对事件作出响应。执行下列步骤可完成该任务：
    747. 

  747.  <ol class="- topic/ol "><li class="- topic/li ">声明用于正方形的颜色和大小的类属性。</li><li class="- topic/li ">构造函数调用 <codeph class="+ topic/ph pr-d/codeph ">draw()</codeph> 方法，在舞台上的默认坐标处 (<i class="+ topic/ph hi-d/i ">x = 0, y = 0</i>) 绘制一个橙色的正方形。</li><li class="- topic/li ">将以下事件侦听器方法附加到该正方形：
    748. 

  748.      <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addedHandler()</codeph> 侦听 <codeph class="+ topic/ph pr-d/codeph ">added</codeph> 事件，该事件在将正方形添加到显示列表中时调度。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">enterFrameHandler()</codeph> 侦听 <codeph class="+ topic/ph pr-d/codeph ">enterFrame</codeph> 事件，它在本示例中没有实际意义。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">removedHandler()</codeph> 侦听 <codeph class="+ topic/ph pr-d/codeph ">removed</codeph> 事件，该事件在将正方形从显示列表中删除（单击该正方形时会发生此情况）时调度。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 侦听 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件，该事件在单击该橙色正方形时调度。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">renderHandler()</codeph> 在显示列表更新之后侦听 <codeph class="+ topic/ph pr-d/codeph ">render</codeph> 事件。</li></ul></li></ol>
    749. 

  749. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    750. 

  750. 

  751. package {
    752. 

  752.     import flash.display.Sprite;
    753. 

  753. 

  754.     public class DisplayObjectExample extends Sprite {
    755. 

  755.         public function DisplayObjectExample() {
    756. 

  756.             var child:CustomDisplayObject = new CustomDisplayObject();
    757. 

  757.             addChild(child);
    758. 

  758.         }
    759. 

  759.     }
    760. 

  760. }
    761. 

  761. 

  762. import flash.display.DisplayObject;
    763. 

  763. import flash.display.Sprite;
    764. 

  764. import flash.display.Stage;
    765. 

  765. import flash.display.StageAlign;
    766. 

  766. import flash.display.StageScaleMode;
    767. 

  767. import flash.events.*;
    768. 

  768. 

  769. class CustomDisplayObject extends Sprite {
    770. 

  770.     private var bgColor:uint = 0xFFCC00;
    771. 

  771.     private var size:uint    = 80;
    772. 

  772. 

  773.     public function CustomDisplayObject() {
    774. 

  774.         draw();
    775. 

  775.         addEventListener(Event.ADDED, addedHandler);
    776. 

  776.         addEventListener(Event.ENTER_FRAME, enterFrameHandler);
    777. 

  777.         addEventListener(Event.REMOVED, removedHandler);
    778. 

  778.         addEventListener(MouseEvent.CLICK, clickHandler);
    779. 

  779.         addEventListener(Event.RENDER, renderHandler);
    780. 

  780.     }
    781. 

  781. 

  782.     private function draw():void {
    783. 

  783.         graphics.beginFill(bgColor);
    784. 

  784.         graphics.drawRect(0, 0, size, size);
    785. 

  785.         graphics.endFill();
    786. 

  786.     }
    787. 

  787. 

  788.     private function clickHandler(event:MouseEvent):void {
    789. 

  789.         trace("clickHandler: " + event);
    790. 

  790.         parent.removeChild(this);
    791. 

  791.     }
    792. 

  792. 

  793.     private function addedHandler(event:Event):void {
    794. 

  794.         trace("addedHandler: " + event);
    795. 

  795.         stage.scaleMode = StageScaleMode.NO_SCALE;
    796. 

  796.         stage.align = StageAlign.TOP_LEFT;
    797. 

  797.         stage.addEventListener("resize", resizeHandler);
    798. 

  798.     }
    799. 

  799. 

  800.     private function enterFrameHandler(event:Event):void {
    801. 

  801.         trace("enterFrameHandler: " + event);
    802. 

  802.         removeEventListener("enterFrame", enterFrameHandler);
    803. 

  803.     }
    804. 

  804. 

  805.     private function removedHandler(event:Event):void {
    806. 

  806.         trace("removedHandler: " + event);
    807. 

  807.         stage.removeEventListener("resize", resizeHandler);
    808. 

  808.     }
    809. 

  809. 

  810.     private function renderHandler(event:Event):void {
    811. 

  811.         trace("renderHandler: " + event);
    812. 

  812.     }
    813. 

  813. 

  814.     private function resizeHandler(event:Event):void {
    815. 

  815.         trace("resizeHandler: " + event);
    816. 

  816.     }
    817. 

  817. }
    818. 

  818. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObjectContainer" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer</linktext></link></related-links><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.RENDER_render" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">render</apiName><shortdesc class="- topic/shortdesc ">
    819. 

  819.  [广播事件] 将要更新和呈现显示列表时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.RENDER</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    820. 

  820.  [广播事件] 将要更新和呈现显示列表时调度。此事件为侦听此事件的对象在呈现显示列表之前进行更改提供了最后的机会。每次希望调度 <codeph class="+ topic/ph pr-d/codeph ">render</codeph> 事件时，必须调用 Stage 对象的 <codeph class="+ topic/ph pr-d/codeph ">invalidate()</codeph> 方法。只有当 <codeph class="+ topic/ph pr-d/codeph ">Render</codeph> 事件与调用 <codeph class="+ topic/ph pr-d/codeph ">Stage.invalidate()</codeph> 的对象互相信任时，才会将这些事件调度给某个对象。此事件为广播事件，这意味着具有注册了此事件的侦听器的所有显示对象都会调度此事件。
    821. 

  821.  
    822. 

  822.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>如果显示未呈现，则不会调度此事件。当内容最小化或遮蔽时会出现这种情况。 </p>
    823. 

  823.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.REMOVED_FROM_STAGE_removedFromStage" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">removedFromStage</apiName><shortdesc class="- topic/shortdesc ">
    824. 

  824.  在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9.0.28.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.REMOVED_FROM_STAGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    825. 

  825.  在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObjectContainer 类的以下两个方法会生成此事件：<codeph class="+ topic/ph pr-d/codeph ">removeChild()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">removeChildAt()</codeph>。 
    826. 

  826.  
    827. 

  827.  <p class="- topic/p ">如果必须删除某个对象来为新对象提供空间，则 DisplayObjectContainer 对象的下列方法也会生成此事件：<codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">addChildAt()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">setChildIndex()</codeph>。 </p>
    828. 

  828.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.REMOVED_removed" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">removed</apiName><shortdesc class="- topic/shortdesc ">
    829. 

  829.  将要从显示列表中删除显示对象时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.REMOVED</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    830. 

  830.  将要从显示列表中删除显示对象时调度。DisplayObjectContainer 类的以下两个方法会生成此事件：<codeph class="+ topic/ph pr-d/codeph ">removeChild()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">removeChildAt()</codeph>。 
    831. 

  831.  
    832. 

  832.  <p class="- topic/p ">如果必须删除某个对象来为新对象提供空间，则 DisplayObjectContainer 对象的下列方法也会生成此事件：<codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">addChildAt()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">setChildIndex()</codeph>。 </p>
    833. 

  833.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.EXIT_FRAME_exitFrame" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">exitFrame</apiName><shortdesc class="- topic/shortdesc ">
    834. 

  834.  [广播事件] 播放头退出当前帧时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.EXIT_FRAME</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    835. 

  835.  [广播事件] 播放头退出当前帧时调度。所有帧脚本已运行。如果播放头不移动，或者只有一帧，则会继续以帧速率调度此事件。此事件为广播事件，这意味着具有注册了此事件的侦听器的所有显示对象都会调度此事件。
    836. 

  836.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.FRAME_CONSTRUCTED_frameConstructed" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">frameConstructed</apiName><shortdesc class="- topic/shortdesc ">
    837. 

  837.  [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.FRAME_CONSTRUCTED</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    838. 

  838.  [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。如果播放头不移动，或者只有一帧，则会继续以帧速率调度此事件。此事件为广播事件，这意味着具有注册了此事件的侦听器的所有显示对象都会调度此事件。
    839. 

  839.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.ENTER_FRAME_enterFrame" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">enterFrame</apiName><shortdesc class="- topic/shortdesc ">
    840. 

  840.  [播放事件] 播放头进入新帧时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.ENTER_FRAME</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    841. 

  841.  [播放事件] 播放头进入新帧时调度。如果播放头不移动，或者只有一帧，则会继续以帧速率调度此事件。此事件为广播事件，这意味着具有注册了此事件的侦听器的所有显示对象都会调度此事件。
    842. 

  842.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.ADDED_TO_STAGE_addedToStage" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">addedToStage</apiName><shortdesc class="- topic/shortdesc ">
    843. 

  843.  在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9.0.28.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.ADDED_TO_STAGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    844. 

  844.  在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。以下方法会触发此事件：<codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChild()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChildAt()</codeph>。
    845. 

  845.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObjectContainer/addChild()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.addChild()</linktext></link><link href="flash.display.xml#DisplayObjectContainer/addChildAt()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.addChildAt()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.display:DisplayObject_flash.events.Event.ADDED_added" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">added</apiName><shortdesc class="- topic/shortdesc ">
    846. 

  846.  将显示对象添加到显示列表中时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.ADDED</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    847. 

  847.  将显示对象添加到显示列表中时调度。以下方法会触发此事件：<codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChild()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChildAt()</codeph>。
    848. 

  848.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObjectContainer/addChild()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.addChild()</linktext></link><link href="flash.display.xml#DisplayObjectContainer/addChildAt()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.addChildAt()</linktext></link></related-links></adobeApiEvent><apiOperation id="flash.display:DisplayObject:getBounds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getBounds</apiName><shortdesc class="- topic/shortdesc ">
    849. 

  849.      返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">定义与 <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph> 对象坐标系统相关的显示对象面积的矩形。
    850. 

  850.      
    851. 

  851.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Rectangle</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">targetCoordinateSpace</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:DisplayObject</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">定义要使用的坐标系的显示对象。
    852. 

  852.      
    853. 

  853.      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    854. 

  854.      返回一个矩形，该矩形定义相对于 <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph> 对象坐标系的显示对象区域。考虑以下代码，此代码显示了矩形的返回方式根据您传递给该方法的 <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph> 参数的不同而不同：
    855. 

  855.      
    856. 

  856.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    857. 

  857.      var container:Sprite = new Sprite();
    858. 

  858.      container.x = 100;
    859. 

  859.      container.y = 100;
    860. 

  860.      this.addChild(container);
    861. 

  861.      var contents:Shape = new Shape();
    862. 

  862.      contents.graphics.drawCircle(0,0,100);
    863. 

  863.      container.addChild(contents);
    864. 

  864.      trace(contents.getBounds(container));
    865. 

  865.       // (x=-100, y=-100, w=200, h=200)
    866. 

  866.      trace(contents.getBounds(this));
    867. 

  867.       // (x=0, y=0, w=200, h=200)
    868. 

  868.      </codeblock>
    869. 

  869.      
    870. 

  870.      
    871. 

  871.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">请注意：</b>使用 <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> 方法可以分别将显示对象的本地坐标转换为显示坐标，或将显示坐标转换为本地坐标。</p>
    872. 

  872.      
    873. 

  873.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> 方法与 <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> 方法类似；但是 <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> 方法返回的矩形包括形状的所有笔触，然而 <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> 方法返回的矩形则不包括。例如，请参阅 <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> 方法的说明。</p>
    874. 

  874.      
    875. 

  875.      </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/getRect()" class="- topic/link "><linktext class="- topic/linktext ">getRect()</linktext></link><link href="flash.display.xml#DisplayObject/globalToLocal()" class="- topic/link "><linktext class="- topic/linktext ">globalToLocal()</linktext></link><link href="flash.display.xml#DisplayObject/localToGlobal()" class="- topic/link "><linktext class="- topic/linktext ">localToGlobal()</linktext></link></related-links></apiOperation><apiOperation id="flash.display:DisplayObject:getRect" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getRect</apiName><shortdesc class="- topic/shortdesc ">
    876. 

  876.     返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">定义与 <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph> 对象坐标系统相关的显示对象面积的矩形。
    877. 

  877.     
    878. 

  878.     </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Rectangle</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">targetCoordinateSpace</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:DisplayObject</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">定义要使用的坐标系的显示对象。
    879. 

  879.     
    880. 

  880.     </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    881. 

  881.     返回一个矩形，该矩形根据 <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph> 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。<codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> 方法返回的值等于或小于由 <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> 方法返回的值。
    882. 

  882.     
    883. 

  883.     <p class="- topic/p "><b class="+ topic/ph hi-d/b ">请注意：</b>使用 <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> 方法可以分别将显示对象的本地坐标转换为舞台坐标，或将舞台坐标转换为本地坐标。</p>
    884. 

  884.     
    885. 

  885.     </apiDesc><example conref="examples\DisplayObject.getRect.1.as" class="- topic/example "> 下例显示 <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> 方法如何由于笔触占据的更多区域而比 <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> 方法返回更大的矩形。在这种情况下，<codeph class="+ topic/ph pr-d/codeph ">triangle</codeph> Sprite 包括其他笔触，因为有 <codeph class="+ topic/ph pr-d/codeph ">lineStyle()</codeph> 方法的 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">jointStyle</codeph> 参数。<codeph class="+ topic/ph pr-d/codeph ">trace()</codeph> 输出（在最后两行中）显示了 <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> 矩形之间的差异：
    886. 

  886. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    887. 

  887. 

  888. import flash.display.CapsStyle;
    889. 

  889. import flash.display.JointStyle;
    890. 

  890. import flash.display.LineScaleMode;
    891. 

  891. import flash.display.Sprite;
    892. 

  892. import flash.geom.Rectangle;
    893. 

  893. 

  894. var triangle:Sprite = new Sprite();
    895. 

  895. var color:uint = 0xFF0044;
    896. 

  896. var width:Number = 20;
    897. 

  897. var alpha:Number = 1.0;
    898. 

  898. var pixelHinting:Boolean = true;
    899. 

  899. var scaleMode:String = LineScaleMode.NORMAL;
    900. 

  900. var caps:String = CapsStyle.SQUARE;
    901. 

  901. var joints:String = JointStyle.MITER;
    902. 

  902. triangle.graphics.lineStyle(width, color, alpha, pixelHinting, scaleMode, caps, joints);
    903. 

  903. 

  904. var triangleSide:Number = 100;
    905. 

  905. triangle.graphics.moveTo(0, 0);
    906. 

  906. triangle.graphics.lineTo(0, triangleSide);
    907. 

  907. triangle.graphics.lineTo(triangleSide, triangleSide);
    908. 

  908. triangle.graphics.lineTo(0, 0);
    909. 

  909. 

  910. addChild(triangle);
    911. 

  911. 

  912. trace(triangle.getBounds(this)); // (x=-10, y=-24.1, w=134.10000000000002, h=134.1)
    913. 

  913. trace(triangle.getRect(this));     // (x=0, y=0, w=100, h=100)
    914. 

  914. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/getBounds()" class="- topic/link "><linktext class="- topic/linktext ">getBounds()</linktext></link></related-links></apiOperation><apiOperation id="flash.display:DisplayObject:globalToLocal3D" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">globalToLocal3D</apiName><shortdesc class="- topic/shortdesc ">
    915. 

  915.      将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">具有相对于三维显示对象的坐标的 Vector3D 对象。 
    916. 

  916.      
    917. 

  917.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Vector3D</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">point</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Point</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">表示全局 x 坐标和 y 坐标的二维 Point 对象。
    918. 

  918.      
    919. 

  919.      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    920. 

  920.      将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。
    921. 

  921.      
    922. 

  922.      <p class="- topic/p ">要使用此方法，请先创建 Point 类的一个实例。分配给 Point 对象的 x 和 y 值表示全局坐标，原因是这些坐标相对于主显示区域的原点 (0,0)。然后，将 Point 对象作为 <codeph class="+ topic/ph pr-d/codeph ">point</codeph> 参数传递给 <codeph class="+ topic/ph pr-d/codeph ">globalToLocal3D()</codeph> 方法。该方法会以一个 Vector3D 对象的形式返回三维坐标，该对象包含相对于三维显示对象的原点的 <codeph class="+ topic/ph pr-d/codeph ">x</codeph>、<codeph class="+ topic/ph pr-d/codeph ">y</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">z</codeph> 值。</p>
    923. 

  923.      
    924. 

  924.      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.display:DisplayObject:globalToLocal" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">globalToLocal</apiName><shortdesc class="- topic/shortdesc ">
    925. 

  925.      将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">具有相对于显示对象的坐标的 Point 对象。
    926. 

  926.      
    927. 

  927.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Point</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">point</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Point</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">用 Point 类创建的对象。 该 Point 对象指定 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 坐标作为属性。
    928. 

  928.      
    929. 

  929.      </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">将 <codeph class="+ topic/ph pr-d/codeph ">point</codeph> 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。
    930. 

  930.      
    931. 

  931.      </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    932. 

  932.      将 <codeph class="+ topic/ph pr-d/codeph ">point</codeph> 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。
    933. 

  933.      
    934. 

  934.      <p class="- topic/p ">要使用此方法，请先创建 Point 类的一个实例。您分配的 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 值表示全局坐标，因为它们是相对于主显示区域的原点 (0,0) 的。然后将 Point 实例作为参数传递给 <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> 方法。该方法会返回一个新的 Point 对象，该对象具有相对于显示对象原点（而不是舞台原点）的 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 值。</p>
    935. 

  935.      
    936. 

  936.      </apiDesc><example conref="examples\DisplayObject.hitTestPoint.1.as" class="- topic/example "> 以下代码创建一个 Shape 对象，并显示使用不同点作为参数调用 <codeph class="+ topic/ph pr-d/codeph ">hitTestPoint()</codeph> 方法的结果。<codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> 方法将点从 Stage 坐标转换到该形状的坐标空间：
    937. 

  937. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    938. 

  938. 

  939. import flash.display.Shape;
    940. 

  940. import flash.geom.Point;
    941. 

  941. 

  942. var circle:Shape = new Shape();
    943. 

  943. circle.graphics.beginFill(0x0000FF);
    944. 

  944. circle.graphics.drawCircle(40, 40, 40);
    945. 

  945. circle.x = 10;
    946. 

  946. addChild(circle);
    947. 

  947. 

  948. var point1:Point = new Point(0, 0);
    949. 

  949. trace(circle.hitTestPoint(point1.x, point1.y, true)); // false
    950. 

  950. trace(circle.hitTestPoint(point1.x, point1.y, false)); // false
    951. 

  951. trace(circle.globalToLocal(point1)); // [x=-10, y=0]
    952. 

  952. 

  953. var point2:Point = new Point(10, 1);
    954. 

  954. trace(circle.hitTestPoint(point2.x, point2.y, true)); // false
    955. 

  955. trace(circle.hitTestPoint(point2.x, point2.y, false)); // true
    956. 

  956. trace(circle.globalToLocal(point2)); // [x=0, y=1]
    957. 

  957. 

  958. var point3:Point = new Point(30, 20);
    959. 

  959. trace(circle.hitTestPoint(point3.x, point3.y, true)); // true
    960. 

  960. trace(circle.hitTestPoint(point3.x, point3.y, false)); // true
    961. 

  961. trace(circle.globalToLocal(point3)); // [x=20, y=20]
    962. 

  962. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/localToGlobal()" class="- topic/link "><linktext class="- topic/linktext ">localToGlobal()</linktext></link><link href="flash.geom.xml#Point" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.Point 类</linktext></link></related-links></apiOperation><apiOperation id="flash.display:DisplayObject:hitTestObject" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hitTestObject</apiName><shortdesc class="- topic/shortdesc ">
    963. 

  963.      计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果显示对象的边框相交，则为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>；否则为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。
    964. 

  964.      
    965. 

  965.       
    966. 

  966.       </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">obj</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:DisplayObject</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要测试的显示对象。
    967. 

  967.      
    968. 

  968.      </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">计算显示对象的边框，以确定它是否与作为参数传递的显示对象的边框重叠或相交。
    969. 

  969.      
    970. 

  970.      </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    971. 

  971.      计算显示对象的边框，以确定它是否与 <codeph class="+ topic/ph pr-d/codeph ">obj</codeph> 显示对象的边框重叠或相交。
    972. 

  972.      
    973. 

  973.      </apiDesc><example conref="examples\DisplayObject.hitTestObject.1.as" class="- topic/example "> 以下代码创建三个 Shape 对象，并显示调用 <codeph class="+ topic/ph pr-d/codeph ">hitTestObject()</codeph> 方法的结果。请注意，尽管 circle2 和 circle3 并未重叠，但它们的边框重叠。因此，circle2 和 circle3 的点击测试返回 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。
    974. 

  974. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    975. 

  975. 

  976. import flash.display.Shape;
    977. 

  977. 

  978. var circle1:Shape = new Shape();
    979. 

  979. circle1.graphics.beginFill(0x0000FF);
    980. 

  980. circle1.graphics.drawCircle(40, 40, 40);
    981. 

  981. addChild(circle1);
    982. 

  982. 

  983. var circle2:Shape = new Shape();
    984. 

  984. circle2.graphics.beginFill(0x00FF00);
    985. 

  985. circle2.graphics.drawCircle(40, 40, 40);
    986. 

  986. circle2.x = 50;
    987. 

  987. addChild(circle2);
    988. 

  988. 

  989. var circle3:Shape = new Shape();
    990. 

  990. circle3.graphics.beginFill(0xFF0000);
    991. 

  991. circle3.graphics.drawCircle(40, 40, 40);
    992. 

  992. circle3.x = 100;
    993. 

  993. circle3.y = 67;
    994. 

  994. addChild(circle3);
    995. 

  995. 

  996. trace(circle1.hitTestObject(circle2)); // true
    997. 

  997. trace(circle1.hitTestObject(circle3)); // false
    998. 

  998. trace(circle2.hitTestObject(circle3)); // true
    999. 

  999. </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.display:DisplayObject:hitTestPoint" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hitTestPoint</apiName><shortdesc class="- topic/shortdesc ">
    1000. 

  1000.      计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果显示对象与指定的点重叠或相交，则为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>；否则为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。
    1001. 

  1001.      
    1002. 

  1002.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">x</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要测试的此对象的 <i class="+ topic/ph hi-d/i ">x</i> 坐标。
    1003. 

  1003.      
    1004. 

  1004.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">y</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要测试的此对象的 <i class="+ topic/ph hi-d/i ">y</i> 坐标。
    1005. 

  1005.      
    1006. 

  1006.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">shapeFlag</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">是检查对象 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) 的实际像素，还是检查边框 (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>) 的实际像素。 
    1007. 

  1007.      
    1008. 

  1008.      </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">计算显示对象，以确定它是否与 x 和 y 指定的点重叠或相交。
    1009. 

  1009.      
    1010. 

  1010.      </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1011. 

  1011.      计算显示对象，以确定它是否与 <codeph class="+ topic/ph pr-d/codeph ">x</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 参数指定的点重叠或相交。<codeph class="+ topic/ph pr-d/codeph ">x</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 参数指定舞台的坐标空间中的点，而不是包含显示对象的显示对象容器中的点（除非显示对象容器是舞台）。
    1012. 

  1012.      
    1013. 

  1013.      </apiDesc><example conref="examples\DisplayObject.hitTestPoint.1.as" class="- topic/example "> 以下代码创建一个 Shape 对象，并显示使用不同点作为参数调用 <codeph class="+ topic/ph pr-d/codeph ">hitTestPoint()</codeph> 方法的结果。<codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> 方法将点从 Stage 坐标转换到该形状的坐标空间：
    1014. 

  1014. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1015. 

  1015. 

  1016. import flash.display.Shape;
    1017. 

  1017. import flash.geom.Point;
    1018. 

  1018. 

  1019. var circle:Shape = new Shape();
    1020. 

  1020. circle.graphics.beginFill(0x0000FF);
    1021. 

  1021. circle.graphics.drawCircle(40, 40, 40);
    1022. 

  1022. circle.x = 10;
    1023. 

  1023. addChild(circle);
    1024. 

  1024. 

  1025. var point1:Point = new Point(0, 0);
    1026. 

  1026. trace(circle.hitTestPoint(point1.x, point1.y, true)); // false
    1027. 

  1027. trace(circle.hitTestPoint(point1.x, point1.y, false)); // false
    1028. 

  1028. trace(circle.globalToLocal(point1)); // [x=-10, y=0]
    1029. 

  1029. 

  1030. var point2:Point = new Point(10, 1);
    1031. 

  1031. trace(circle.hitTestPoint(point2.x, point2.y, true)); // false
    1032. 

  1032. trace(circle.hitTestPoint(point2.x, point2.y, false)); // true
    1033. 

  1033. trace(circle.globalToLocal(point2)); // [x=0, y=1]
    1034. 

  1034. 

  1035. var point3:Point = new Point(30, 20);
    1036. 

  1036. trace(circle.hitTestPoint(point3.x, point3.y, true)); // true
    1037. 

  1037. trace(circle.hitTestPoint(point3.x, point3.y, false)); // true
    1038. 

  1038. trace(circle.globalToLocal(point3)); // [x=20, y=20]
    1039. 

  1039. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/opaqueBackground" class="- topic/link "><linktext class="- topic/linktext ">opaqueBackground</linktext></link></related-links></apiOperation><apiOperation id="flash.display:DisplayObject:local3DToGlobal" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">local3DToGlobal</apiName><shortdesc class="- topic/shortdesc ">
    1040. 

  1040.      将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个表示二维空间中的三维点的二维点。
    1041. 

  1041.      
    1042. 

  1042.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Point</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">point3d</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Vector3D</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个包含三维点或三维显示对象的坐标的 Vector3D 对象。
    1043. 

  1043.      
    1044. 

  1044.      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1045. 

  1045.      将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。
    1046. 

  1046.      
    1047. 

  1047.      <p class="- topic/p ">例如，您只能使用二维坐标 (x,y) 来通过 <codeph class="+ topic/ph pr-d/codeph ">display.Graphics</codeph> 方法进行绘制。要绘制三维对象，您需要将显示对象的三维坐标映射到二维坐标。首先，创建一个保存三维显示对象的 x、y 和 z 坐标的 Vector3D 类的实例。然后，将 Vector3D 对象作为 <codeph class="+ topic/ph pr-d/codeph ">point3d</codeph> 参数传递给 <codeph class="+ topic/ph pr-d/codeph ">local3DToGlobal()</codeph> 方法。该方法会返回一个二维的 Point 对象，可将该对象与图形 API 一起使用来绘制三维对象。</p>
    1048. 

  1048.      
    1049. 

  1049.      
    1050. 

  1050.      </apiDesc><example conref="examples\Local3DToGlobalExample.as" class="- topic/example "> 本示例使用 <codeph class="+ topic/ph pr-d/codeph ">display.Graphics</codeph> 方法在二维空间中绘制简单的三维立方体。由于 <codeph class="+ topic/ph pr-d/codeph ">this</codeph> 显示对象的位置是偏移位置，因此立方体的注册点将位于其中心。Vector3D 对象的矢量保存立方体的三维坐标。首先绘制立方体的顶部，再绘制底部，然后将顶部的四个角与底部的四个角相连。您需要在绘制立方体之前先将其添加到显示对象容器中，这样才能使用 <codeph class="+ topic/ph pr-d/codeph ">local3DToGlobal()</codeph> 方法。 
    1051. 

  1051. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1052. 

  1052. package {
    1053. 

  1053.     import flash.display.MovieClip;
    1054. 

  1054.     import flash.display.Sprite;
    1055. 

  1055.     import flash.display.Graphics;
    1056. 

  1056.     import flash.geom.*;
    1057. 

  1057. 

  1058.     public class Local3DToGlobalExample extends MovieClip {
    1059. 

  1059.         private var myCube:Sprite = new Sprite();
    1060. 

  1060.         private var v8:Vector.&lt;Vector3D> = new Vector.&lt;Vector3D>(8);
    1061. 

  1061. 

  1062.         public function Local3DToGlobalExample():void {
    1063. 

  1063.             this.x = -(this.stage.stageWidth / 2);
    1064. 

  1064.             this.y = -(this.stage.stageWidth / 2);
    1065. 

  1065. 

  1066.             v8[0] = new Vector3D(-40,-40,-40);
    1067. 

  1067.             v8[1] = new Vector3D(40,-40,-40);
    1068. 

  1068.             v8[2] = new Vector3D(40,-40,40);
    1069. 

  1069.             v8[3] = new Vector3D(-40,-40,40);
    1070. 

  1070.             v8[4] = new Vector3D(-40,100,-40);
    1071. 

  1071.             v8[5] = new Vector3D(40,100,-40);
    1072. 

  1072.             v8[6] = new Vector3D(40,100,40);
    1073. 

  1073.             v8[7] = new Vector3D(-40,100,40);
    1074. 

  1074. 

  1075.             myCube.x = (this.stage.stageWidth / 2);
    1076. 

  1076.             myCube.y = (this.stage.stageWidth / 2);
    1077. 

  1077.             myCube.z = 1;
    1078. 

  1078.             addChild(myCube);
    1079. 

  1079. 

  1080.             Cube();         
    1081. 

  1081.         }
    1082. 

  1082. 

  1083.         private function Cube():void {
    1084. 

  1084.             var ps:Point = new Point(0,0);
    1085. 

  1085. 

  1086.             myCube.graphics.lineStyle(2,0xFF0000);
    1087. 

  1087. 

  1088.             ps = myCube.local3DToGlobal(v8[0]);
    1089. 

  1089.             myCube.graphics.moveTo(ps.x, ps.y);
    1090. 

  1090.             ps = myCube.local3DToGlobal(v8[1]);
    1091. 

  1091.             myCube.graphics.lineTo(ps.x, ps.y);
    1092. 

  1092.             ps = myCube.local3DToGlobal(v8[2]);
    1093. 

  1093.             myCube.graphics.lineTo(ps.x, ps.y);
    1094. 

  1094.             ps = myCube.local3DToGlobal(v8[3]);
    1095. 

  1095.             myCube.graphics.lineTo(ps.x, ps.y);
    1096. 

  1096.             ps = myCube.local3DToGlobal(v8[0]);
    1097. 

  1097.             myCube.graphics.lineTo(ps.x, ps.y);
    1098. 

  1098. 

  1099.             ps = myCube.local3DToGlobal(v8[4]);
    1100. 

  1100.             myCube.graphics.moveTo(ps.x, ps.y);
    1101. 

  1101.             ps = myCube.local3DToGlobal(v8[5]);
    1102. 

  1102.             myCube.graphics.lineTo(ps.x, ps.y);
    1103. 

  1103.             ps = myCube.local3DToGlobal(v8[6]);
    1104. 

  1104.             myCube.graphics.lineTo(ps.x, ps.y);
    1105. 

  1105.             ps = myCube.local3DToGlobal(v8[7]);
    1106. 

  1106.             myCube.graphics.lineTo(ps.x, ps.y);
    1107. 

  1107.             ps = myCube.local3DToGlobal(v8[4]);
    1108. 

  1108.             myCube.graphics.lineTo(ps.x, ps.y);
    1109. 

  1109. 

  1110.             ps = myCube.local3DToGlobal(v8[0]);
    1111. 

  1111.             myCube.graphics.moveTo(ps.x, ps.y);
    1112. 

  1112.             ps = myCube.local3DToGlobal(v8[4]);
    1113. 

  1113.             myCube.graphics.lineTo(ps.x, ps.y);
    1114. 

  1114.             ps = myCube.local3DToGlobal(v8[1]);
    1115. 

  1115.             myCube.graphics.moveTo(ps.x, ps.y);
    1116. 

  1116.             ps = myCube.local3DToGlobal(v8[5]);
    1117. 

  1117.             myCube.graphics.lineTo(ps.x, ps.y);
    1118. 

  1118.             ps = myCube.local3DToGlobal(v8[2]);
    1119. 

  1119.             myCube.graphics.moveTo(ps.x, ps.y);
    1120. 

  1120.             ps = myCube.local3DToGlobal(v8[6]);
    1121. 

  1121.             myCube.graphics.lineTo(ps.x, ps.y);
    1122. 

  1122.             ps = myCube.local3DToGlobal(v8[3]);
    1123. 

  1123.             myCube.graphics.moveTo(ps.x, ps.y);
    1124. 

  1124.             ps = myCube.local3DToGlobal(v8[7]);
    1125. 

  1125.             myCube.graphics.lineTo(ps.x, ps.y);
    1126. 

  1126.         }
    1127. 

  1127.     }
    1128. 

  1128. }
    1129. 

  1129. </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.display:DisplayObject:localToGlobal" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">localToGlobal</apiName><shortdesc class="- topic/shortdesc ">
    1130. 

  1130.      将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">具有相对于舞台的坐标的 Point 对象。
    1131. 

  1131.      
    1132. 

  1132.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Point</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">point</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.geom:Point</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">使用 Point 类创建的点的名称或标识符，指定 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 坐标作为属性。
    1133. 

  1133.      
    1134. 

  1134.      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1135. 

  1135.      将 <codeph class="+ topic/ph pr-d/codeph ">point</codeph> 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。
    1136. 

  1136.      
    1137. 

  1137.      <p class="- topic/p ">此方法允许您将任何给定的 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 坐标从相对于特定显示对象原点 (0,0) 的值（本地坐标）转换为相对于舞台原点的值（全局坐标）。</p>
    1138. 

  1138.      
    1139. 

  1139.      <p class="- topic/p ">要使用此方法，请先创建 Point 类的一个实例。您分配的 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 的值表示本地坐标，因为它们是相对于显示对象原点的值。</p>
    1140. 

  1140.      
    1141. 

  1141.      <p class="- topic/p ">然后，您可以将创建的 Point 实例作为参数传递给 <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> 方法。该方法会返回一个新的 Point 对象，该对象具有相对于舞台原点（而不是显示对象原点）的 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 值。</p>
    1142. 

  1142.      
    1143. 

  1143.      </apiDesc><example conref="examples\DisplayObject.localToGlobal.1.as" class="- topic/example "> 以下代码可创建一个 Sprite 对象。该 Sprite 对象的 <codeph class="+ topic/ph pr-d/codeph ">mouseX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">mouseY</codeph> 属性位于显示对象的坐标空间中。此代码使用 <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> 方法将这些属性转换为全局（舞台）坐标：
    1144. 

  1144. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1145. 

  1145. 

  1146. import flash.display.Sprite;
    1147. 

  1147. import flash.events.MouseEvent;
    1148. 

  1148. import flash.geom.Point;
    1149. 

  1149. 

  1150. var square:Sprite = new Sprite();
    1151. 

  1151. square.graphics.beginFill(0xFFCC00);
    1152. 

  1152. square.graphics.drawRect(0, 0, 100, 100);
    1153. 

  1153. square.x = 100;
    1154. 

  1154. square.y = 200;
    1155. 

  1155. 

  1156. addChild(square);
    1157. 

  1157. 

  1158. square.addEventListener(MouseEvent.CLICK, traceCoordinates)
    1159. 

  1159. 

  1160. function traceCoordinates(event:MouseEvent):void {
    1161. 

  1161.     var clickPoint:Point = new Point(square.mouseX, square.mouseY);
    1162. 

  1162.     trace("display object coordinates:", clickPoint);
    1163. 

  1163.     trace("stage coordinates:", square.localToGlobal(clickPoint));
    1164. 

  1164. }
    1165. 

  1165. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/globalToLocal()" class="- topic/link "><linktext class="- topic/linktext ">globalToLocal()</linktext></link><link href="flash.geom.xml#Point" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.Point 类</linktext></link></related-links></apiOperation><apiValue id="flash.display:DisplayObject:accessibilityProperties:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">accessibilityProperties</apiName><shortdesc class="- topic/shortdesc ">
    1166. 

  1166.      此显示对象的当前辅助功能选项。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.accessibility:AccessibilityProperties</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1167. 

  1167.      此显示对象的当前辅助功能选项。如果您修改 <codeph class="+ topic/ph pr-d/codeph ">accessibilityProperties</codeph> 属性或 <codeph class="+ topic/ph pr-d/codeph ">accessibilityProperties</codeph> 内部的任何字段，则必须调用 <codeph class="+ topic/ph pr-d/codeph ">Accessibility.updateProperties()</codeph> 方法以使您的更改生效。
    1168. 

  1168.      
    1169. 

  1169.      <p class="flashonly"><b class="+ topic/ph hi-d/b ">请注意</b>：对于在 Flash 创作环境中创建的对象，将使用您在“辅助功能”面板中为该对象输入的所有信息来填充 <codeph class="+ topic/ph pr-d/codeph ">accessibilityProperties</codeph> 的值。</p>
    1170. 

  1170.      
    1171. 

  1171.      </apiDesc><example conref="examples\DisplayObject.accessibilityProperties.1.as" class="- topic/example "> 下例演示如何将简单的 AccessibilityProperties 对象附加到 TextField 实例：
    1172. 

  1172. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1173. 

  1173. 

  1174. import flash.text.TextField;
    1175. 

  1175. import flash.accessibility.AccessibilityProperties;
    1176. 

  1176. import flash.accessibility.Accessibility;
    1177. 

  1177. import flash.system.Capabilities;
    1178. 

  1178. 

  1179. var tf:TextField = new TextField();
    1180. 

  1180. tf.text = "hello";
    1181. 

  1181. 

  1182. var accessProps:AccessibilityProperties = new AccessibilityProperties();
    1183. 

  1183. accessProps.name = "Greeting";
    1184. 

  1184. 

  1185. tf.accessibilityProperties = accessProps;
    1186. 

  1186. 

  1187. if (Capabilities.hasAccessibility) {
    1188. 

  1188.     Accessibility.updateProperties();
    1189. 

  1189. }
    1190. 

  1190. 

  1191. trace(tf.accessibilityProperties.name); // Greeting
    1192. 

  1192. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.accessibility.xml#Accessibility/updateProperties()" class="- topic/link "><linktext class="- topic/linktext ">flash.accessibility.Accessibility.updateProperties()</linktext></link><link href="flash.accessibility.xml#AccessibilityProperties" class="- topic/link "><linktext class="- topic/linktext ">flash.accessibility.AccessibilityProperties</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:alpha:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">alpha</apiName><shortdesc class="- topic/shortdesc ">
    1193. 

  1193.      表示指定对象的 Alpha 透明度值。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1194. 

  1194.      表示指定对象的 Alpha 透明度值。有效值为 0（完全透明）到 1（完全不透明）。默认值为 1。<codeph class="+ topic/ph pr-d/codeph ">alpha</codeph> 设置为 0 的显示对象<i class="+ topic/ph hi-d/i ">是</i>活动的，即使它们不可见。
    1195. 

  1195.      
    1196. 

  1196.      </apiDesc><example conref="examples\DisplayObject.alpha.1.as" class="- topic/example "> 当鼠标滑过 Sprite 时，以下代码将 Sprite 的 <codeph class="+ topic/ph pr-d/codeph ">alpha</codeph> 属性设置为 50%：
    1197. 

  1197. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1198. 

  1198. import flash.display.Sprite;
    1199. 

  1199. import flash.events.MouseEvent;
    1200. 

  1200. 

  1201. var circle:Sprite = new Sprite();
    1202. 

  1202. circle.graphics.beginFill(0xFF0000);
    1203. 

  1203. circle.graphics.drawCircle(40, 40, 40);
    1204. 

  1204. addChild(circle);
    1205. 

  1205. 

  1206. circle.addEventListener(MouseEvent.MOUSE_OVER, dimObject);
    1207. 

  1207. circle.addEventListener(MouseEvent.MOUSE_OUT, restoreObject);
    1208. 

  1208. 

  1209. function dimObject(event:MouseEvent):void {
    1210. 

  1210.     event.target.alpha = 0.5;
    1211. 

  1211. }
    1212. 

  1212. 

  1213. function restoreObject(event:MouseEvent):void {
    1214. 

  1214.     event.target.alpha = 1.0;
    1215. 

  1215. }
    1216. 

  1216. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:blendMode:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">blendMode</apiName><shortdesc class="- topic/shortdesc ">
    1217. 

  1217.      BlendMode 类中的一个值，用于指定要使用的混合模式。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1218. 

  1218.      BlendMode 类中的一个值，用于指定要使用的混合模式。 内部绘制位图的方法有两种。如果启用了混合模式或外部剪辑遮罩，则将通过向矢量渲染器添加有位图填充的正方形来绘制位图。  如果尝试将此属性设置为无效值，则 Flash 运行时会将此值设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph>。
    1219. 

  1219.      
    1220. 

  1220.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性影响显示对象的每个像素。每个像素都由三种原色（红色、绿色和蓝色）组成，每种原色的值介于 0x00 和 0xFF 之间。Flash Player 或 Adobe AIR 将影片剪辑中一个像素的每种原色与背景中像素的对应颜色进行比较。例如，如果 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.LIGHTEN</codeph>，则 Flash Player 或 Adobe AIR 会将显示对象的红色值与背景的红色值进行比较，然后使用两者中较亮的一种颜色作为显示颜色的红色成分的值。</p>
    1221. 

  1221.      
    1222. 

  1222.      <p class="- topic/p ">下表将对 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 设置进行说明。BlendMode 类定义可使用的字符串值。表中的插图显示应用于交叠于显示对象 (1) 之上的圆形显示对象 (2) 的 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 值。</p>
    1223. 

  1223.      
    1224. 

  1224.      
    1225. 

  1225.      <p class="- topic/p ">
    1226. 

  1226.       <adobeimage alt="编号为 1 的正方形" href="../../images/blendMode-0a.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/><adobeimage alt="编号为 2 的圆" href="../../images/blendMode-0b.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/>
    1227. 

  1227.      
    1228. 

  1228.      </p>
    1229. 

  1229.      
    1230. 

  1230.      
    1231. 

  1231.      <adobetable class="innertable"><tgroup cols="3" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">BlendMode 常量</entry><entry class="- topic/entry ">插图</entry><entry class="- topic/entry ">说明</entry></row></thead><tbody class="- topic/tbody "><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 NORMAL" href="../../images/blendMode-1.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">该显示对象出现在背景前面。显示对象的像素值将覆盖背景的像素值。在显示对象为透明的区域，背景是可见的。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.LAYER</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 LAYER" href="../../images/blendMode-2.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">强制为该显示对象创建一个透明度组。这意味着首先在临时缓冲区中预构建显示对象，然后再进行下一步处理。如果显示对象是使用位图缓存进行预缓存的，或显示对象是至少带有一个子对象（具有 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph> 以外的 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 设置）的显示对象容器，则这将自动完成。在 GPU 呈现下不支持。
    1232. 

  1232.      </entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.MULTIPLY</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 MULTIPLY" href="../../images/blendMode-3.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">将显示对象原色的值与背景颜色的值相乘，然后通过除以 0xFF 进行标准化，从而得到较暗的颜色。此设置通常用于阴影和深度效果。
    1233. 

  1233.      
    1234. 

  1234.      <p class="- topic/p ">例如，如果显示对象中一个像素的某个原色（例如红色）与背景中对应的像素颜色的值均为 0x88，则相乘结果为 0x4840。除以 0xFF 将得到该原色的值 0x48，这是比显示对象或背景颜色暗的阴影。</p></entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.SCREEN</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 SCREEN" href="../../images/blendMode-4.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">将显示对象颜色的补色（反色）与背景颜色的补色相乘，会产生漂白效果。此设置通常用于产生加亮效果或用来删除显示对象的黑色区域。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.LIGHTEN</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 LIGHTEN" href="../../images/blendMode-5.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">在显示对象原色和背景颜色中选择相对较亮的颜色（具有较大值的颜色）。此设置通常用于叠加类型。
    1235. 

  1235.      
    1236. 

  1236.      <p class="- topic/p ">例如，如果显示对象的某个像素的 RGB 值为 0xFFCC33，背景像素的 RGB 值为 0xDDF800，则显示像素的结果 RGB 值为 0xFFF833（因为 0xFF > 0xDD，0xCC &lt; 0xF8，且 0x33 > 0x00 = 33）。在 GPU 呈现下不支持。</p></entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.DARKEN</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 DARKEN" href="../../images/blendMode-6.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">在显示对象原色和背景颜色中选择相对较暗的颜色（具有较小值的颜色）。此设置通常用于叠加类型。
    1237. 

  1237.      
    1238. 

  1238.      <p class="- topic/p ">例如，如果显示对象的某个像素的 RGB 值为 0xFFCC33，背景像素的 RGB 值为 0xDDF800，则显示像素的结果 RGB 值为 0xDDCC00（因为 0xFF > 0xDD，0xCC &lt; 0xF8，且 0x33 > 0x00 = 33）。在 GPU 呈现下不支持。</p></entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.DIFFERENCE</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 DIFFERENCE" href="../../images/blendMode-7.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">将显示对象的原色与背景颜色进行比较，然后从较亮的原色值中减去较暗的原色值。此设置通常用于得到更明亮的颜色。
    1239. 

  1239.      
    1240. 

  1240.      <p class="- topic/p ">例如，如果显示对象的某个像素的 RGB 值为 0xFFCC33，背景像素的 RGB 值为 0xDDF800，则显示像素的结果 RGB 值为 0x222C33（因为 0xFF - 0xDD = 0x22，0xF8 - 0xCC = 0x2C，且 0x33 - 0x00 = 0x33）。</p></entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.ADD</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 ADD" href="../../images/blendMode-8.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">将显示对象的原色值添加到它的背景颜色中，上限值为 0xFF。此设置通常用于使两个对象间的加亮溶解产生动画效果。
    1241. 

  1241.      
    1242. 

  1242.      <p class="- topic/p ">例如，如果显示对象的某个像素的 RGB 值为 0xAAA633，背景像素的 RGB 值为 0xDD2200，则显示像素的结果 RGB 值为 0xFFC833（因为 0xAA + 0xDD > 0xFF，0xA6 + 0x22 = 0xC8，且 0x33 + 0x00 = 0x33）。</p></entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.SUBTRACT</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 SUBTRACT" href="../../images/blendMode-9.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">从背景颜色的值中减去显示对象原色的值，下限值为 0。此设置通常用于使两个对象间的变暗溶解产生动画效果。
    1243. 

  1243.      
    1244. 

  1244.      <p class="- topic/p ">例如，如果显示对象的某个像素的 RGB 值为 0xAA2233，背景像素的 RGB 值为 0xDDA600，则显示像素的结果 RGB 值为 0x338400（因为 0xDD - 0xAA = 0x33，0xA6 - 0x22 = 0x84 且 0x00 - 0x33 &lt; 0x00）。</p></entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.INVERT</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 INVERT" href="../../images/blendMode-10.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">反转背景。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.ALPHA</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 ALPHA" href="../../images/blendMode-11.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">将显示对象的每个像素的 Alpha 值应用于背景。这要求将父显示对象的 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 设置设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.LAYER</codeph>。例如，在此插图中，父显示对象是一个白色背景，它具有 <codeph class="+ topic/ph pr-d/codeph ">blendMode = BlendMode.LAYER</codeph>。在 GPU 呈现下不支持。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.ERASE</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 ERASE" href="../../images/blendMode-12.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">根据显示对象的 Alpha 值擦除背景。这要求将父显示对象的 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.LAYER</codeph>。例如，在此插图中，父显示对象是一个白色背景，它具有 <codeph class="+ topic/ph pr-d/codeph ">blendMode = BlendMode.LAYER</codeph>。在 GPU 呈现下不支持。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.OVERLAY</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 OVERLAY" href="../../images/blendMode-13.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">根据背景的暗度调整每个像素的颜色。如果背景灰度值高于 50%，则显示对象和背景颜色进行叠加，从而产生较亮的颜色。如果背景灰度值低于 50%，则颜色相乘，从而产生较暗的颜色。此设置通常用于获得阴影效果。在 GPU 呈现下不支持。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.HARDLIGHT</codeph></entry><entry class="- topic/entry "><adobeimage alt="混合模式 HARDLIGHT" href="../../images/blendMode-14.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">根据显示对象的暗度调整每个像素的颜色。如果显示对象灰度值高于 50%，则显示对象和背景颜色进行叠加，从而产生较亮的颜色。如果显示对象灰度值低于 50%，则颜色相乘，从而产生较暗的颜色。此设置通常用于获得阴影效果。在 GPU 呈现下不支持。</entry></row><row valign="top" class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph></entry><entry align="center" valign="middle" class="- topic/entry ">不适用</entry><entry class="- topic/entry ">使用自定义着色器例程调整颜色。将使用的着色器指定为赋予 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性的 Shader 实例。如果将显示对象的 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性设置为 Shader 实例，则会将显示对象的 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性自动设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>。如果在未首先设置 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性的情况下将 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>，则 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性会设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph>。在 GPU 呈现下不支持。</entry></row></tbody></tgroup></adobetable>
    1245. 

  1245.      
    1246. 

  1246.      </apiDesc><example conref="examples\DisplayObject.blendMode.1.as" class="- topic/example "> 以下代码创建两个 Sprite 对象，一个正方形和一个圆形，并在鼠标指针滑过圆形时将圆形（在前景中）的混合模式设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SUBTRACT</codeph>：
    1247. 

  1247. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1248. 

  1248. import flash.display.Sprite;
    1249. 

  1249. import flash.display.BlendMode;
    1250. 

  1250. import flash.events.MouseEvent;
    1251. 

  1251. 

  1252. var square:Sprite = new Sprite();
    1253. 

  1253. square.graphics.beginFill(0xFF88CC);
    1254. 

  1254. square.graphics.drawRect(0, 0, 80, 80);
    1255. 

  1255. addChild(square);
    1256. 

  1256. 

  1257. var circle:Sprite = new Sprite();
    1258. 

  1258. circle.graphics.beginFill(0xAA0022);
    1259. 

  1259. circle.graphics.drawCircle(40, 40, 40);
    1260. 

  1260. addChild(circle);
    1261. 

  1261. 

  1262. circle.addEventListener(MouseEvent.MOUSE_OVER, dimObject);
    1263. 

  1263. circle.addEventListener(MouseEvent.MOUSE_OUT, restoreObject);
    1264. 

  1264. 

  1265. function dimObject(event:MouseEvent):void {
    1266. 

  1266.     event.target.blendMode = BlendMode.SUBTRACT;
    1267. 

  1267. }
    1268. 

  1268. 

  1269. function restoreObject(event:MouseEvent):void {
    1270. 

  1270.     event.target.blendMode = BlendMode.NORMAL;
    1271. 

  1271. }
    1272. 

  1272. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#BlendMode" class="- topic/link "><linktext class="- topic/linktext ">flash.display.BlendMode</linktext></link><link href="flash.display.xml#DisplayObject/blendShader" class="- topic/link "><linktext class="- topic/linktext ">blendShader</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:cacheAsBitmapMatrix:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">cacheAsBitmapMatrix</apiName><shortdesc class="- topic/shortdesc ">
    1273. 

  1273.      如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Matrix</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">呈现此显示对象的位图的缓存版本时使用的转换矩阵。
    1274. 

  1274.      </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1275. 

  1275.      如果为非 null，则 Matrix 对象会定义显示对象在 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 时的呈现方式。应用程序使用此矩阵作为呈现显示对象的位图版本时应用的转换矩阵。
    1276. 

  1276.      
    1277. 

  1277.      <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>移动设备支持此功能，但桌面操作系统不支持此功能。另外，它对于用于电视的 AIR 设备只有有限的支持。具体而言，在用于电视的 AIR 设备上，仅支持缩放和平移转换，但是不支持旋转和倾斜。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。</p>
    1278. 

  1278.      
    1279. 

  1279.      <p class="- topic/p ">使用 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> 设置，应用程序将保留经过各种 2D 变形的缓存位图图像，包括平移、旋转和缩放。如果应用程序使用硬件加速，则对象将作为纹理存储在视频内存中。这样可允许 GPU 对对象应用受支持的变形。GPU 执行这些转换的速度比 CPU 快。</p>
    1280. 

  1280.      
    1281. 

  1281.      
    1282. 

  1282.      <p class="- topic/p ">要使用硬件加速功能，请在 Flash Professional CS5 中的“iPhone 设置”对话框的“常规”选项卡上将“呈现”设置为 GPU。或在应用程序描述符文件中将 <codeph class="+ topic/ph pr-d/codeph ">renderMode</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">gpu</codeph>。请注意，用于电视的 AIR 设备将自动使用硬件加速（如果可用）。</p>
    1283. 

  1283.      
    1284. 

  1284.      <p class="- topic/p ">例如，以下代码将显示对象的未转换的位图表示形式发送到 GPU：</p>
    1285. 

  1285.      
    1286. 

  1286.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">matrix:Matrix = new Matrix(); // creates an identity matrix 
    1287. 

  1287.      mySprite.cacheAsBitmapMatrix = matrix; 
    1288. 

  1288.      mySprite.cacheAsBitmap = true;</codeblock>
    1289. 

  1289.      
    1290. 

  1290.      <p class="- topic/p ">通常，恒等矩阵 (<codeph class="+ topic/ph pr-d/codeph ">new Matrix()</codeph>) 就足够了。但是，您可以使用其他矩阵（例如按比例缩小的矩阵）将其他位图上载到 GPU。例如，以下示例应用了对 x 轴和 y 轴按 0.5 缩放的 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> 矩阵。GPU 使用的位图对象较小，但是，GPU 将调整其大小，以便与显示对象的 transform.matrix 属性相匹配：</p>
    1291. 

  1291.      
    1292. 

  1292.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">matrix:Matrix = new Matrix(); // creates an identity matrix 
    1293. 

  1293.      matrix.scale(0.5, 0.5); // scales the matrix 
    1294. 

  1294.      mySprite.cacheAsBitmapMatrix = matrix; 
    1295. 

  1295.      mySprite.cacheAsBitmap = true;</codeblock>
    1296. 

  1296.      
    1297. 

  1297.      <p class="- topic/p ">通常，您应该选择使用将显示对象的大小转换为在应用程序显示大小的矩阵。例如，如果您的应用程序将 Sprite 的位图版本显示为原来的一半，则应该使用缩小一半的矩阵。如果您的应用程序显示的 Sprite 大于其当前尺寸，则应该使用放大该系数的矩阵。</p>
    1298. 

  1298.      
    1299. 

  1299.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b><codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> 属性适用于 2D 变形。如果需要在 3D 中应用变形，您可能需要通过设置对象的 3D 属性，并且处理它的 <codeph class="+ topic/ph pr-d/codeph ">transform.matrix3D</codeph> 属性来应用变形。如果使用 GPU 模式打包应用程序，则允许 GPU 对对象应用 3D 变形。3D 对象将忽略 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph>。</p>
    1300. 

  1300.      
    1301. 

  1301.      </apiDesc><example conref="examples\DisplayObject.cacheAsBitmapMatrix.as" class="- topic/example "> 以下示例使用 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> 属性对影片剪辑 <codeph class="+ topic/ph pr-d/codeph ">my_shape</codeph> 的位图版本进行转换。
    1302. 

  1302. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1303. 

  1303. import flash.geom.Matrix;
    1304. 

  1304. import flash.display.*;
    1305. 

  1305. import flash.utils.Timer;
    1306. 

  1306. 

  1307. var my_shape:MovieClip = new MovieClip();
    1308. 

  1308. my_shape.graphics.beginFill(0xCCFF00);
    1309. 

  1309. my_shape.graphics.drawRect(200, 0, 100, 100);
    1310. 

  1310. addChild(my_shape);
    1311. 

  1311. 

  1312. var my_timer:Timer = new Timer(250);
    1313. 

  1313. my_timer.start();
    1314. 

  1314. my_timer.addEventListener(TimerEvent.TIMER, timerHandler);
    1315. 

  1315. 

  1316. // make sure this Display Object remains cached for all 2D transforms
    1317. 

  1317. my_shape.cacheAsBitmap = true;
    1318. 

  1318. my_shape.cacheAsBitmapMatrix = new Matrix();
    1319. 

  1319. 

  1320. // rotation variables
    1321. 

  1321. const initAngle:Number = 0;
    1322. 

  1322. const pi:Number = 3.142;
    1323. 

  1323. const incrAngle:Number = pi/10;
    1324. 

  1324. 

  1325. // scaling variables
    1326. 

  1326. const initScale:Number = 0.25;
    1327. 

  1327. const incrScale: Number = 1.1;
    1328. 

  1328. var initHeight : Number = my_shape.height;
    1329. 

  1329. var initWidth : Number = my_shape.width;
    1330. 

  1330. 

  1331. // translation variables
    1332. 

  1332. var incrX : Number = root.width / 20;
    1333. 

  1333. var incrY : Number = root.height / 10;
    1334. 

  1334. 

  1335. // do some initial transforms
    1336. 

  1336. var tempMat : Matrix = my_shape.transform.matrix;
    1337. 

  1337. tempMat.rotate(initAngle);
    1338. 

  1338. tempMat.scale(initScale, initScale);
    1339. 

  1339. 

  1340. my_shape.transform.matrix = tempMat;
    1341. 

  1341. 

  1342. function timerHandler(evt:TimerEvent):void {
    1343. 

  1343. 

  1344.     tempMat = my_shape.transform.matrix;
    1345. 

  1345.     
    1346. 

  1346.     tempMat.rotate(incrAngle);
    1347. 

  1347.     tempMat.translate(incrX, incrY);
    1348. 

  1348.     tempMat.scale(incrScale, incrScale);
    1349. 

  1349.     
    1350. 

  1350.     my_shape.transform.matrix = tempMat;
    1351. 

  1351.     
    1352. 

  1352.     // ensure we are still in a reasonable state or reset 
    1353. 

  1353.     if(my_shape.height > stage.stageHeight/2)
    1354. 

  1354.     {
    1355. 

  1355.         my_shape.height = initHeight;
    1356. 

  1356.     }
    1357. 

  1357.     
    1358. 

  1358.     if(my_shape.width > stage.stageWidth/2)
    1359. 

  1359.     {
    1360. 

  1360.         my_shape.width = initWidth;
    1361. 

  1361.     }
    1362. 

  1362.                               
    1363. 

  1363.     if(my_shape.x > stage.stageWidth)
    1364. 

  1364.     {
    1365. 

  1365.         my_shape.x = 0;
    1366. 

  1366.     }
    1367. 

  1367.     else if (my_shape.x &lt; 0)
    1368. 

  1368.     {
    1369. 

  1369.         my_shape.x = stage.stageWidth;
    1370. 

  1370.     }
    1371. 

  1371. 

  1372.     
    1373. 

  1373.     if(my_shape.y > stage.stageHeight)
    1374. 

  1374.     {
    1375. 

  1375.         my_shape.y = 0;
    1376. 

  1376.     }
    1377. 

  1377.     else if (my_shape.y &lt; 0)
    1378. 

  1378.     {
    1379. 

  1379.         my_shape.y = stage.stageHeight;
    1380. 

  1380.     }
    1381. 

  1381.     
    1382. 

  1382. }
    1383. 

  1383. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/cacheAsBitmap" class="- topic/link "><linktext class="- topic/linktext ">cacheAsBitmap</linktext></link><link href="flash.geom.xml#Matrix3D" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.Matrix3D</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:cacheAsBitmap:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">cacheAsBitmap</apiName><shortdesc class="- topic/shortdesc ">
    1384. 

  1384.      如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">是否将此 DisplayObject 缓存为位图。
    1385. 

  1385.      
    1386. 

  1386.      </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1387. 

  1387.      如果设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，则 Flash 运行时将缓存显示对象的内部位图表示形式。此缓存可以提高包含复杂矢量内容的显示对象的性能。
    1388. 

  1388.      
    1389. 

  1389.      <p class="- topic/p ">具有已缓存位图的显示对象的所有矢量数据都将被绘制到位图而不是主显示。如果 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> 为空或不受支持，位图将作为与最近的像素边界对齐的未拉伸且未旋转的像素复制到主显示。像素按一对一与父对象进行映射。如果位图的边界发生更改，则将重新创建位图而不会拉伸它。</p>
    1390. 

  1390. 	 
    1391. 

  1391. 	 <p class="- topic/p ">如果支持 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph>，并且它为非空，则对象将使用该矩阵绘制到屏幕范围外的位图，并且使用该呈现的拉伸和/或旋转结果将对象绘制到主显示。</p>
    1392. 

  1392.      
    1393. 

  1393.      <p class="- topic/p ">除非将 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，否则不会创建内部位图。</p>
    1394. 

  1394.      
    1395. 

  1395.      <p class="- topic/p ">将 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 后，呈现并不更改，但是，显示对象将自动执行像素贴紧。动画速度可能会大大加快，具体取决于矢量内容的复杂性。
    1396. 

  1396.      </p>
    1397. 

  1397.      
    1398. 

  1398.      <p class="- topic/p ">只要对显示对象（当其 <codeph class="+ topic/ph pr-d/codeph ">filter</codeph> 数组不为空时）应用滤镜，<codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性就自动设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，而且如果对显示对象应用了滤镜，即使将该属性设置为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>，也会将该显示对象的 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 报告为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。如果清除显示对象的所有滤镜，则 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 设置将更改为它上次的设置。</p>
    1399. 

  1399.      
    1400. 

  1400.      <p class="- topic/p ">在下面的情况下，即使将 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，显示对象也不使用位图，而是从矢量数据呈现：</p>
    1401. 

  1401.      
    1402. 

  1402.      <ul class="- topic/ul "><li class="- topic/li ">位图过大。在 AIR 1.5 和 Flash Player 10 中，位图图像的最大宽度或高度为 8,191 像素，并且像素总数不能超过 16,777,215 像素。（因此，如果位图图像的宽度为 8,191 像素，则其高度只能为 2,048 像素。）在 Flash Player 9 及早期版本中，高度最大为 2880 像素，宽度最大为 2,880 像素。</li><li class="- topic/li ">位图无法分配（内存不足错误）。 </li></ul>
    1403. 

  1403.      
    1404. 

  1404.      <p class="- topic/p ">最好将 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性与主要具有静态内容且不频繁缩放和旋转的影片剪辑一起使用。对于这样的影片剪辑，在转换影片剪辑时（更改其 <i class="+ topic/ph hi-d/i ">x</i> 和 <i class="+ topic/ph hi-d/i ">y</i> 位置时），<codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 可以提高性能。</p>
    1405. 

  1405.      
    1406. 

  1406.      </apiDesc><example conref="examples\DisplayObject.cacheAsBitmap.1.as" class="- topic/example "> 下例将投影应用于 Shape 实例。然后，它将跟踪 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性的值，该值在应用滤镜时设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>：
    1407. 

  1407. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1408. 

  1408. import flash.display.Sprite;
    1409. 

  1409. import flash.filters.DropShadowFilter
    1410. 

  1410. 

  1411. var circle:Sprite = new Sprite();
    1412. 

  1412. circle.graphics.beginFill(0xAA0022);
    1413. 

  1413. circle.graphics.drawCircle(40, 40, 40);
    1414. 

  1414. 

  1415. addChild(circle);
    1416. 

  1416. 

  1417. trace(circle.cacheAsBitmap); // false
    1418. 

  1418. 

  1419. var filter:DropShadowFilter = new DropShadowFilter();
    1420. 

  1420. circle.filters = [filter];
    1421. 

  1421. 

  1422. trace(circle.cacheAsBitmap); // true
    1423. 

  1423. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/cacheAsBitmapMatrix" class="- topic/link "><linktext class="- topic/linktext ">cacheAsBitmapMatrix</linktext></link><link href="flash.display.xml#DisplayObject/opaqueBackground" class="- topic/link "><linktext class="- topic/linktext ">opaqueBackground</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:filters:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">filters</apiName><shortdesc class="- topic/shortdesc ">
    1424. 

  1424.      包含当前与显示对象关联的每个滤镜对象的索引数组。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Array</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 包括 ShaderFilter，并且着色器输出类型与此操作不兼容时（着色器必须指定 <codeph class="+ topic/ph pr-d/codeph ">pixel4</codeph> 输出）。
    1425. 

  1425.      
    1426. 

  1426.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 包括 ShaderFilter，并且着色器未指定任何图像输入或第一个输入不是 <codeph class="+ topic/ph pr-d/codeph ">image4</codeph> 输入时。
    1427. 

  1427.      
    1428. 

  1428.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 包括 ShaderFilter，并且着色器指定了未提供的图像输入时。
    1429. 

  1429.      
    1430. 

  1430.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 包括 ShaderFilter，使用了 ByteArray 或 Vector.&lt;Number> 实例作为着色器输入，没有为 ShaderInput 对象指定 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 属性，或者指定的值与输入数据中的数据量不匹配。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph ">ShaderInput.input</codeph> 属性。
    1431. 

  1431.      
    1432. 

  1432.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1433. 

  1433.      包含当前与显示对象关联的每个滤镜对象的索引数组。flash.filters 包中的多个类定义了可使用的特定滤镜。
    1434. 

  1434.      
    1435. 

  1435.      <p class="- topic/p ">在设计时或在运行时，可通过使用 ActionScript 代码在 Flash Professional 中应用筛选器。要通过使用 ActionScript 应用滤镜，您必须制作整个 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组的临时副本，修改临时数组，然后将临时数组的值分配回 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组。无法直接将新滤镜对象添加到 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组。</p>
    1436. 

  1436.      
    1437. 

  1437.      <p class="- topic/p ">要通过使用 ActionScript 添加滤镜，请执行以下步骤（假定目标显示对象名为 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph>）：</p>
    1438. 

  1438.      
    1439. 

  1439.      <ol class="- topic/ol "><li class="- topic/li ">使用所选滤镜类的构造函数方法创建一个新的滤镜对象。</li><li class="- topic/li ">将 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject.filters</codeph> 数组的值分配给临时数组，例如一个名为 <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph> 的数组。</li><li class="- topic/li ">将新的滤镜对象添加到临时数组 <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph>。</li><li class="- topic/li ">将临时数组的值分配给 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject.filters</codeph> 数组。</li></ol>
    1440. 

  1440.      
    1441. 

  1441.      <p class="- topic/p ">如果 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组未定义，则无需使用临时数组。相反，您可以直接赋值包含一个或多个已创建的滤镜对象的一个数组文本值。“示例”部分的第一个示例通过使用处理已定义和未定义的 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组的代码来添加投影滤镜。</p>
    1442. 

  1442.      
    1443. 

  1443.      <p class="- topic/p ">要修改现有的滤镜对象，必须使用修改 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组的副本的技术：</p>
    1444. 

  1444.      
    1445. 

  1445.      <ol class="- topic/ol "><li class="- topic/li ">将 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组的值分配给临时数组，例如一个名为 <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph> 的数组。</li><li class="- topic/li ">使用临时数组 <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph> 修改属性。例如，如果要设置数组中第一个滤镜的品质属性，可以使用以下代码：<codeph class="+ topic/ph pr-d/codeph ">myFilters[0].quality = 1;</codeph></li><li class="- topic/li ">将临时数组的值分配给 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组。</li></ol>
    1446. 

  1446.      
    1447. 

  1447.      <p class="- topic/p ">在加载时，如果显示对象具有关联的滤镜，则将它标记为像透明位图那样缓存自身。从此时起，只要显示对象具有有效的滤镜列表，播放器就会将显示对象缓存为位图。此源位图用作滤镜效果的源图像。每个显示对象通常有两个位图：一个包含原始未过滤的源显示对象，另一个是过滤后的最终图像。呈现时使用最终图像。只要显示对象不发生更改，最终图像就不需要更新。</p>
    1448. 

  1448.      
    1449. 

  1449.      <p class="- topic/p ">flash.filters 包含有滤镜类。例如，要创建 DropShadow 滤镜，请输入：</p>
    1450. 

  1450.      
    1451. 

  1451.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1452. 

  1452.      import flash.filters.DropShadowFilter
    1453. 

  1453.      var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
    1454. 

  1454.      </codeblock>
    1455. 

  1455.      
    1456. 

  1456.      <p class="- topic/p ">您可以使用 <codeph class="+ topic/ph pr-d/codeph ">is</codeph> 运算符确定分配给 <codeph class="+ topic/ph pr-d/codeph ">filter</codeph> 数组中每个索引位置的滤镜的类型。例如，以下代码显示如何确定是 DropShadowFilter 的 <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> 数组中第一个滤镜的位置：
    1457. 

  1457.      </p>
    1458. 

  1458.      
    1459. 

  1459.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1460. 

  1460.      import flash.text.TextField;
    1461. 

  1461.      import flash.filters.~~;
    1462. 

  1462.      var tf:TextField = new TextField();
    1463. 

  1463.      var filter1:DropShadowFilter = new DropShadowFilter();
    1464. 

  1464.      var filter2:GradientGlowFilter = new GradientGlowFilter();
    1465. 

  1465.      tf.filters = [filter1, filter2];
    1466. 

  1466.      
    1467. 

  1467.      tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
    1468. 

  1468.      addChild(tf)
    1469. 

  1469.      
    1470. 

  1470.      function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
    1471. 

  1471.          for (var i:uint = 0; i &lt; displayObject.filters.length; i++) {
    1472. 

  1472.              if (displayObject.filters[i] is filterClass) {
    1473. 

  1473.                  return i;
    1474. 

  1474.              }
    1475. 

  1475.          }
    1476. 

  1476.          return -1;
    1477. 

  1477.      }
    1478. 

  1478.      </codeblock>
    1479. 

  1479.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>由于无法直接将新滤镜对象添加到 <codeph class="+ topic/ph pr-d/codeph ">DisplayObject.filters</codeph> 数组，因此以下代码对名为 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph> 的目标显示对象不起作用：</p>
    1480. 

  1480.      
    1481. 

  1481.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1482. 

  1482.      myDisplayObject.filters.push(myDropShadow);
    1483. 

  1483.      </codeblock>
    1484. 

  1484.      
    1485. 

  1485.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="../../flash/filters/package-detail.html" class="- topic/link "><linktext class="- topic/linktext ">flash.filters package</linktext></link><link href="flash.display.xml#ShaderInput/input" class="- topic/link "><linktext class="- topic/linktext ">flash.display.ShaderInput.input</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:height:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">height</apiName><shortdesc class="- topic/shortdesc ">
    1486. 

  1486.      表示显示对象的高度，以像素为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1487. 

  1487.      表示显示对象的高度，以像素为单位。高度是根据显示对象内容的范围来计算的。如果您设置了 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 属性，则 <codeph class="+ topic/ph pr-d/codeph ">scaleY</codeph> 属性会相应调整，如以下代码所示：
    1488. 

  1488.      
    1489. 

  1489.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1490. 

  1490.     var rect:Shape = new Shape();
    1491. 

  1491.     rect.graphics.beginFill(0xFF0000);
    1492. 

  1492.     rect.graphics.drawRect(0, 0, 100, 100);
    1493. 

  1493.     trace(rect.scaleY) // 1;
    1494. 

  1494.     rect.height = 200;
    1495. 

  1495.     trace(rect.scaleY) // 2;</codeblock>
    1496. 

  1496.     
    1497. 

  1497.     <p class="- topic/p ">除 TextField 和 Video 对象以外，没有内容的显示对象（如一个空的 Sprite）的高度为 0，即使您尝试将 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 设置为其他值，也是这样。</p>
    1498. 

  1498.      
    1499. 

  1499.      </apiDesc><example conref="examples\DisplayObject.height.1.as" class="- topic/example "> 以下代码创建两个 TextField 对象并调整每个对象的 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 属性（基于每个对象的 <codeph class="+ topic/ph pr-d/codeph ">textHeight</codeph> 属性）；此外，它还通过设置其 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性来定位第二个文本字段：
    1500. 

  1500. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1501. 

  1501. import flash.text.TextField;
    1502. 

  1502. 

  1503. var tf1:TextField = new TextField();
    1504. 

  1504. tf1.text = "Text Field 1";
    1505. 

  1505. tf1.border = true;
    1506. 

  1506. tf1.wordWrap = true;
    1507. 

  1507. tf1.width = 40;
    1508. 

  1508. tf1.height = tf1.textHeight + 5;
    1509. 

  1509. addChild(tf1);
    1510. 

  1510. 

  1511. var tf2:TextField = new TextField();
    1512. 

  1512. tf2.text = "Text Field 2";
    1513. 

  1513. tf2.border = true;
    1514. 

  1514. tf2.wordWrap = true;
    1515. 

  1515. tf2.width = 40;
    1516. 

  1516. tf2.height = tf2.textHeight + 5;
    1517. 

  1517. tf2.y = tf1.y + tf1.height + 5;
    1518. 

  1518. addChild(tf2);
    1519. 

  1519. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:loaderInfo:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">loaderInfo</apiName><shortdesc class="- topic/shortdesc ">
    1520. 

  1520.      返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:LoaderInfo</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1521. 

  1521.      返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。<codeph class="+ topic/ph pr-d/codeph ">loaderInfo</codeph> 属性仅为 SWF 文件的根显示对象或已加载的位图（而不是使用 ActionScript 绘制的位图）定义。要查找与包含名为 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph> 的显示对象的 SWF 文件相关的 <codeph class="+ topic/ph pr-d/codeph ">loaderInfo</codeph> 对象，请使用 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject.root.loaderInfo</codeph>。
    1522. 

  1522.      
    1523. 

  1523.      <p class="- topic/p ">大的 SWF 文件可以通过调用 <codeph class="+ topic/ph pr-d/codeph ">this.root.loaderInfo.addEventListener(Event.COMPLETE, func)</codeph> 来监控其下载。</p>
    1524. 

  1524.      
    1525. 

  1525.      </apiDesc><example conref="examples\DisplayObject.loaderInfo.1.as" class="- topic/example "> 以下代码假定 <codeph class="+ topic/ph pr-d/codeph ">this</codeph> 引用显示对象。代码会输出该显示对象的根 SWF 文件的 URL：
    1526. 

  1526. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1527. 

  1527.  trace (this.loaderInfo.url);
    1528. 

  1528.  
    1529. 

  1529. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#LoaderInfo" class="- topic/link "><linktext class="- topic/linktext ">LoaderInfo 类</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:mask:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">mask</apiName><shortdesc class="- topic/shortdesc ">
    1530. 

  1530.      调用显示对象被指定的 mask 对象遮罩。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:DisplayObject</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">为显示对象设置蒙版。
    1531. 

  1531.      
    1532. 

  1532.      </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1533. 

  1533.      调用显示对象被指定的 <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 对象遮罩。要确保当舞台缩放时蒙版仍然有效，<codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 显示对象必须处于显示列表的活动部分。但不绘制 <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 对象本身。将 <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph> 可删除蒙版。
    1534. 

  1534.      
    1535. 

  1535.      <p class="- topic/p ">要能够缩放遮罩对象，它必须在显示列表中。要能够拖动蒙版 Sprite 对象（通过调用其 <codeph class="+ topic/ph pr-d/codeph ">startDrag()</codeph> 方法），它必须在显示列表中。要为基于 sprite 正在调度的 <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> 事件调用 <codeph class="+ topic/ph pr-d/codeph ">startDrag()</codeph> 方法，请将 sprite 的 <codeph class="+ topic/ph pr-d/codeph ">buttonMode</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。</p>
    1536. 

  1536.      
    1537. 

  1537.      <p class="- topic/p ">通过将 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，将 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> 属性设置为 Matrix 对象来缓存显示对象时，遮罩对象和被遮罩的显示对象必须是同一缓存位图的一部分。因此，如果缓存显示对象，则遮罩必须是显示对象的子级。如果缓存显示列表上的显示对象的祖代，则遮罩必须是该祖代的子级或其后代之一。如果缓存遮罩对象的多个祖先，则遮罩必须是显示列表中离遮罩对象最近的缓存容器的后代。</p>
    1538. 

  1538.      
    1539. 

  1539.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>单个 <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 对象不能用于遮罩多个执行调用的显示对象。在将 <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 分配给第二个显示对象时，会撤消其作为第一个对象的遮罩，该对象的 <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> 属性将变为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。</p>  
    1540. 

  1540.      
    1541. 

  1541.      </apiDesc><example conref="examples\DisplayObject.mask.1.as" class="- topic/example "> 以下代码创建 TextField 对象以及被设置为 TextField 对象的遮罩的 Sprite 对象。当用户单击文本字段时，<codeph class="+ topic/ph pr-d/codeph ">drag()</codeph> 事件侦听器函数会调用遮罩 Sprite 对象的 <codeph class="+ topic/ph pr-d/codeph ">startDrag()</codeph> 方法：
    1542. 

  1542. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1543. 

  1543. import flash.text.TextField;
    1544. 

  1544. import flash.display.Sprite;
    1545. 

  1545. import flash.events.MouseEvent;
    1546. 

  1546. 

  1547. var tf:TextField = new TextField();
    1548. 

  1548. tf.text = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " 
    1549. 

  1549.             + "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
    1550. 

  1550. tf.selectable = false;
    1551. 

  1551. tf.wordWrap = true;
    1552. 

  1552. tf.width = 150;
    1553. 

  1553. addChild(tf);
    1554. 

  1554. 

  1555. var square:Sprite = new Sprite();
    1556. 

  1556. square.graphics.beginFill(0xFF0000);
    1557. 

  1557. square.graphics.drawRect(0, 0, 40, 40);
    1558. 

  1558. addChild(square);
    1559. 

  1559. 

  1560. tf.mask = square;
    1561. 

  1561. 

  1562. tf.addEventListener(MouseEvent.MOUSE_DOWN, drag);
    1563. 

  1563. tf.addEventListener(MouseEvent.MOUSE_UP, noDrag);
    1564. 

  1564. 

  1565. function drag(event:MouseEvent):void {
    1566. 

  1566.     square.startDrag();
    1567. 

  1567. }
    1568. 

  1568. function noDrag(event:MouseEvent):void {
    1569. 

  1569.     square.stopDrag();
    1570. 

  1570. }
    1571. 

  1571. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:mouseX:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">mouseX</apiName><shortdesc class="- topic/shortdesc ">
    1572. 

  1572.      表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1573. 

  1573.      表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。
    1574. 

  1574.      
    1575. 

  1575.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意</b>：对于已旋转的 DisplayObject，返回的 x 坐标将反映未旋转的对象。</p>
    1576. 

  1576.      
    1577. 

  1577.      </apiDesc><example conref="examples\DisplayObject.mouseX.1.as" class="- topic/example "> 以下代码创建一个 Sprite 对象，并在用户单击该对象时跟踪 <codeph class="+ topic/ph pr-d/codeph ">mouseX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">mouseY</codeph> 的位置：
    1578. 

  1578. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1579. 

  1579. import flash.display.Sprite;
    1580. 

  1580. import flash.events.MouseEvent;
    1581. 

  1581. 

  1582. var square:Sprite = new Sprite();
    1583. 

  1583. square.graphics.beginFill(0xFF0000);
    1584. 

  1584. square.graphics.drawRect(0, 0, 200, 200);
    1585. 

  1585. addChild(square);
    1586. 

  1586. 

  1587. square.addEventListener(MouseEvent.CLICK, traceCoordinates);
    1588. 

  1588. 

  1589. function traceCoordinates(event:MouseEvent):void {
    1590. 

  1590.     trace(square.mouseX, square.mouseY);
    1591. 

  1591. }
    1592. 

  1592. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:mouseY:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">mouseY</apiName><shortdesc class="- topic/shortdesc ">
    1593. 

  1593.      表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1594. 

  1594.      表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。
    1595. 

  1595.      
    1596. 

  1596.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意</b>：对于已旋转的 DisplayObject，返回的 y 坐标将反映未旋转的对象。</p>
    1597. 

  1597.      
    1598. 

  1598.      </apiDesc><example conref="examples\DisplayObject.mouseX.1.as" class="- topic/example "> 以下代码创建一个 Sprite 对象，并在用户单击该对象时跟踪 <codeph class="+ topic/ph pr-d/codeph ">mouseX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">mouseY</codeph> 的位置：
    1599. 

  1599. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1600. 

  1600. import flash.display.Sprite;
    1601. 

  1601. import flash.events.MouseEvent;
    1602. 

  1602. 

  1603. var square:Sprite = new Sprite();
    1604. 

  1604. square.graphics.beginFill(0xFF0000);
    1605. 

  1605. square.graphics.drawRect(0, 0, 200, 200);
    1606. 

  1606. addChild(square);
    1607. 

  1607. 

  1608. square.addEventListener(MouseEvent.CLICK, traceCoordinates);
    1609. 

  1609. 

  1610. function traceCoordinates(event:MouseEvent):void {
    1611. 

  1611.     trace(square.mouseX, square.mouseY);
    1612. 

  1612. }
    1613. 

  1613. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:name:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">name</apiName><shortdesc class="- topic/shortdesc ">
    1614. 

  1614.      表示 DisplayObject 的实例名称。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果尝试在 Flash 创作工具中对放置在时间轴上的对象设置此属性。
    1615. 

  1615.      
    1616. 

  1616.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IllegalOperationError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IllegalOperationError</apiOperationClassifier></apiException><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">此 DisplayObject 的名称。
    1617. 

  1617.      
    1618. 

  1618.      </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1619. 

  1619.      表示 DisplayObject 的实例名称。通过调用父显示对象容器的 <codeph class="+ topic/ph pr-d/codeph ">getChildByName()</codeph> 方法，可以在父显示对象容器的子列表中标识该对象。
    1620. 

  1620.      
    1621. 

  1621.      </apiDesc><example conref="examples\DisplayObject.name.1.as" class="- topic/example "> 以下代码创建两个 Sprite 对象，并跟踪相关的 <codeph class="+ topic/ph pr-d/codeph ">name</codeph> 属性（当用户单击其中一个对象时）：
    1622. 

  1622. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1623. 

  1623. import flash.display.Sprite;
    1624. 

  1624. import flash.events.MouseEvent;
    1625. 

  1625. 

  1626. var circle1:Sprite = new Sprite();
    1627. 

  1627. circle1.graphics.beginFill(0xFF0000);
    1628. 

  1628. circle1.graphics.drawCircle(40, 40, 40);
    1629. 

  1629. circle1.name = "circle1";
    1630. 

  1630. addChild(circle1);
    1631. 

  1631. circle1.addEventListener(MouseEvent.CLICK, traceName);
    1632. 

  1632. 

  1633. var circle2:Sprite = new Sprite();
    1634. 

  1634. circle2.graphics.beginFill(0x0000FF);
    1635. 

  1635. circle2.graphics.drawCircle(140, 40, 40);
    1636. 

  1636. circle2.name = "circle2";
    1637. 

  1637. addChild(circle2);
    1638. 

  1638. circle2.addEventListener(MouseEvent.CLICK, traceName);
    1639. 

  1639. 

  1640. function traceName(event:MouseEvent):void {
    1641. 

  1641.     trace(event.target.name);
    1642. 

  1642. }
    1643. 

  1643. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:opaqueBackground:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">opaqueBackground</apiName><shortdesc class="- topic/shortdesc ">
    1644. 

  1644.      指定显示对象是否由于具有某种背景颜色而不透明。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Object</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1645. 

  1645.      指定显示对象是否由于具有某种背景颜色而不透明。透明的位图包含 Alpha 通道数据，并以透明的方式进行绘制。不透明位图没有 Alpha 通道（呈现速度比透明位图快）。如果位图是不透明的，则您可以指定要使用的其自己的背景颜色。
    1646. 

  1646.      
    1647. 

  1647.      <p class="- topic/p ">如果设置为某个数值，则表面是不透明的，并且带有该数值指定的 RGB 背景颜色。如果设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>（默认值），则显示对象将有透明背景。</p>
    1648. 

  1648.      
    1649. 

  1649.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">opaqueBackground</codeph> 属性主要与 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性一起使用，以优化呈现。对于 <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> 属性设置为 true 的显示对象，设置 <codeph class="+ topic/ph pr-d/codeph ">opaqueBackground</codeph> 可以提高呈现性能。</p>
    1650. 

  1650.      
    1651. 

  1651.      <p class="- topic/p ">如果在 <codeph class="+ topic/ph pr-d/codeph ">shapeFlag</codeph> 参数设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 时调用 <codeph class="+ topic/ph pr-d/codeph ">hitTestPoint()</codeph> 方法，则不透明的背景区域<i class="+ topic/ph hi-d/i ">不</i> 匹配。</p>
    1652. 

  1652.      
    1653. 

  1653.      <p class="- topic/p ">不透明背景区域不响应鼠标事件。</p>
    1654. 

  1654.      
    1655. 

  1655.      </apiDesc><example conref="examples\DisplayObject.opaqueBackground.1.as" class="- topic/example "> 以下代码创建一个具有蓝色圆形的 Shape 对象，并将其 <codeph class="+ topic/ph pr-d/codeph ">opaqueBackground</codeph> 属性设置为红色 (0xFF0000)：
    1656. 

  1656. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1657. 

  1657. import flash.display.Shape;
    1658. 

  1658. 

  1659. var circle:Shape = new Shape();
    1660. 

  1660. circle.graphics.beginFill(0x0000FF);
    1661. 

  1661. circle.graphics.drawCircle(40, 40, 40);
    1662. 

  1662. circle.opaqueBackground = 0xFF0000;
    1663. 

  1663. addChild(circle);
    1664. 

  1664. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/cacheAsBitmap" class="- topic/link "><linktext class="- topic/linktext ">cacheAsBitmap</linktext></link><link href="flash.display.xml#DisplayObject/hitTestPoint()" class="- topic/link "><linktext class="- topic/linktext ">hitTestPoint()</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:parent:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">parent</apiName><shortdesc class="- topic/shortdesc ">
    1665. 

  1665.      表示包含此显示对象的 DisplayObjectContainer 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:DisplayObjectContainer</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">父显示对象属于您无权访问的安全沙箱。通过让父影片调用 <codeph class="+ topic/ph pr-d/codeph ">Security.allowDomain()</codeph> 方法，可以避免发生这种情况。
    1666. 

  1666.      
    1667. 

  1667.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">SecurityError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">SecurityError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1668. 

  1668.      表示包含此显示对象的 DisplayObjectContainer 对象。使用 <codeph class="+ topic/ph pr-d/codeph ">parent</codeph> 属性可以指定高于显示列表层次结构中当前显示对象的显示对象的相对路径。
    1669. 

  1669.      
    1670. 

  1670.      <p class="- topic/p ">可以使用 <codeph class="+ topic/ph pr-d/codeph ">parent</codeph> 在显示列表中上移多个级别，如下所示：</p>
    1671. 

  1671.      
    1672. 

  1672.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1673. 

  1673.      this.parent.parent.alpha = 20;
    1674. 

  1674.      </codeblock>
    1675. 

  1675.      
    1676. 

  1676.      </apiDesc><example conref="examples\DisplayObject.parent.1.as" class="- topic/example "> 以下代码创建三个 Sprite 对象，并显示 <codeph class="+ topic/ph pr-d/codeph ">parent</codeph> 属性如何反映显示列表层次结构：
    1677. 

  1677. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1678. 

  1678. 

  1679. import flash.display.Sprite;
    1680. 

  1680. 

  1681. var sprite1:Sprite = new Sprite();
    1682. 

  1682. sprite1.name = "sprite1";
    1683. 

  1683. var sprite2:Sprite = new Sprite();
    1684. 

  1684. sprite2.name = "sprite2";
    1685. 

  1685. var sprite3:Sprite = new Sprite();
    1686. 

  1686. sprite3.name = "sprite3";
    1687. 

  1687. 

  1688. sprite1.addChild(sprite2);
    1689. 

  1689. sprite2.addChild(sprite3);
    1690. 

  1690. 

  1691. trace(sprite2.parent.name); // sprite1
    1692. 

  1692. trace(sprite3.parent.name); // sprite2
    1693. 

  1693. trace(sprite3.parent.parent.name); // sprite1
    1694. 

  1694. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:root:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">root</apiName><shortdesc class="- topic/shortdesc ">
    1695. 

  1695.      对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:DisplayObject</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">返回此对象的根显示对象。
    1696. 

  1696.      
    1697. 

  1697.      </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1698. 

  1698.      对于加载的 SWF 文件中的显示对象，<codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。对于代表已加载图像文件的位图对象，<codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性就是位图对象本身。对于第一个加载的 SWF 文件的主类的实例，<codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性就是显示对象本身。Stage 对象的 <codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性是 Stage 对象本身。对于任何未添加到显示列表的显示对象，<codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，除非它已添加到符合以下条件的显示对象容器：不在显示列表中，但属于已加载 SWF 文件中顶级显示对象的子级。
    1699. 

  1699.      
    1700. 

  1700.      <p class="- topic/p ">例如，如果您通过调用 <codeph class="+ topic/ph pr-d/codeph ">Sprite()</codeph> 构造函数方法创建新的 Sprite 对象，则其 <codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性将为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，除非您将其添加到显示列表中（或添加到不在显示列表中但属于 SWF 文件中顶级显示对象的子级的显示对象容器中）。</p>
    1701. 

  1701.      
    1702. 

  1702.      <p class="- topic/p ">对于加载的 SWF 文件，即使用于加载文件的 Loader 对象未在显示列表中，SWF 文件中的顶级显示对象也会为其本身设置 <codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性。在 Loader 对象添加为对其设置 <codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性的显示对象的子级前，它不会设置自己的 <codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性。</p>
    1703. 

  1703.      
    1704. 

  1704.      </apiDesc><example conref="examples\DisplayObject.root.1.as" class="- topic/example "> 以下代码显示 Stage 对象、未加载的（添加到显示列表前后）显示对象（Loader 对象）和已加载对象（已加载 Bitmap 对象）的 <codeph class="+ topic/ph pr-d/codeph ">root</codeph> 属性之间的差异：
    1705. 

  1705. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1706. 

  1706. import flash.display.Loader;
    1707. 

  1707. import flash.net.URLRequest;
    1708. 

  1708. import flash.events.Event;
    1709. 

  1709. 

  1710. trace(stage.root); // [object Stage]
    1711. 

  1711. 

  1712. var ldr:Loader = new Loader();
    1713. 

  1713. trace (ldr.root); // null
    1714. 

  1714. 

  1715. addChild(ldr); 
    1716. 

  1716. trace (ldr.root); // [object ...]
    1717. 

  1717. 

  1718. var urlReq:URLRequest = new URLRequest("example.jpg");
    1719. 

  1719. ldr.load(urlReq);
    1720. 

  1720. 

  1721. ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, loaded);
    1722. 

  1722. 

  1723. function loaded(event:Event):void {
    1724. 

  1724.     trace(ldr.content.root); // [object Bitmap]
    1725. 

  1725. }
    1726. 

  1726. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:rotationX:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rotationX</apiName><shortdesc class="- topic/shortdesc ">
    1727. 

  1727.      表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1728. 

  1728.      表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。
    1729. 

  1729.      
    1730. 

  1730.      </apiDesc><example conref="examples\RotationExample1.as" class="- topic/example "> 在本示例中，两个椭圆使用其 <codeph class="+ topic/ph pr-d/codeph ">rotationX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">rotationY</codeph> 属性进行旋转。第一个椭圆的注册点设置为椭圆的中心点。它围绕自身进行旋转。第二个椭圆围绕一个外部点进行旋转。 
    1731. 

  1731. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1732. 

  1732. package {
    1733. 

  1733.     import flash.display.MovieClip;
    1734. 

  1734.     import flash.display.Shape;
    1735. 

  1735.     import flash.geom.*;
    1736. 

  1736.     import flash.display.Graphics;
    1737. 

  1737.     import flash.events.TimerEvent;
    1738. 

  1738.     import flash.utils.Timer;
    1739. 

  1739. 

  1740.     public class RotationExample1 extends MovieClip {
    1741. 

  1741.         private var ellipse:Shape = new Shape();
    1742. 

  1742.         private var speed:int = 10;
    1743. 

  1743.         private var ellipse1:Shape;
    1744. 

  1744.         private var ellipse2:Shape;
    1745. 

  1745.         
    1746. 

  1746.         public function RotationExample1():void {
    1747. 

  1747. 

  1748.             ellipse1 = drawEllipse(-50, -40, (this.stage.stageWidth / 2), 
    1749. 

  1749.                                     (this.stage.stageHeight / 2));
    1750. 

  1750.             
    1751. 

  1751.             ellipse2 = drawEllipse(30, 40, (this.stage.stageWidth / 2), 
    1752. 

  1752.                                           (this.stage.stageHeight / 2));
    1753. 

  1753. 

  1754.             this.addChild(ellipse1);
    1755. 

  1755.             this.addChild(ellipse2);
    1756. 

  1756. 

  1757.             var t:Timer = new Timer(50);
    1758. 

  1758.             t.addEventListener(TimerEvent.TIMER, timerHandler);
    1759. 

  1759.             t.start();
    1760. 

  1760.         }
    1761. 

  1761. 

  1762.         private function drawEllipse(x1, y1, x2, y2):Shape {
    1763. 

  1763.         
    1764. 

  1764.             var e:Shape = new Shape();
    1765. 

  1765.             e.graphics.beginFill(0xFF0000);
    1766. 

  1766.             e.graphics.lineStyle(2);
    1767. 

  1767.             e.graphics.drawEllipse(x1, y1, 100, 80);
    1768. 

  1768.             e.graphics.endFill();
    1769. 

  1769. 

  1770.             e.x  = x2;  
    1771. 

  1771.             e.y  = y2;
    1772. 

  1772.             e.z = 1;
    1773. 

  1773.             return e;
    1774. 

  1774.         }
    1775. 

  1775. 

  1776.         private function timerHandler(event:TimerEvent):void {
    1777. 

  1777.             ellipse1.rotationY += speed;    
    1778. 

  1778.             ellipse1.rotationX -= speed;
    1779. 

  1779. 

  1780.             ellipse2.rotationY += speed;    
    1781. 

  1781.             ellipse2.rotationX -= speed;
    1782. 

  1782.         }
    1783. 

  1783.     }
    1784. 

  1784. }
    1785. 

  1785. </codeblock></example><example conref="examples\Slider_rotationX.as" class="- topic/example "> 以下示例显示如何通过设置 Sprite 对象的 rotationX 属性使用 Flash Professional、ActionScript 3.0 和 Flash Player 10 使对象绕其 x 轴进行 3D 旋转。<xref href="http://actionscriptexamples.com/2009/02/26/rotating-a-sprite-object-around-its-x-axis-in-flash-using-actionscript-30-and-flash-player-10/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref> 提供的示例。 
    1786. 

  1786. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1787. 

  1787. //Requires:
    1788. 

  1788. //  - Slider control UI component in Flash library.
    1789. 

  1789. //  - Publish for Flash Player 10.
    1790. 

  1790. //
    1791. 

  1791.  
    1792. 

  1792. [SWF(width="400", height="300")]
    1793. 

  1793.  
    1794. 

  1794. import fl.controls.Slider;
    1795. 

  1795. import fl.controls.SliderDirection;
    1796. 

  1796. import fl.events.SliderEvent;
    1797. 

  1797.  
    1798. 

  1798. var slider:Slider = new Slider();
    1799. 

  1799. slider.direction = SliderDirection.HORIZONTAL;
    1800. 

  1800. slider.minimum = 0;
    1801. 

  1801. slider.maximum = 360;
    1802. 

  1802. slider.value = 45;
    1803. 

  1803. slider.tickInterval = 45;
    1804. 

  1804. slider.snapInterval = 1;
    1805. 

  1805. slider.liveDragging = true;
    1806. 

  1806. slider.addEventListener(SliderEvent.CHANGE, slider_change);
    1807. 

  1807. slider.move(10, 10);
    1808. 

  1808. addChild(slider);
    1809. 

  1809.  
    1810. 

  1810. var spr:Sprite = new Sprite();
    1811. 

  1811. spr.graphics.lineStyle(2, 0xFF0000);
    1812. 

  1812. spr.graphics.drawRect(0, 0, 100, 80);
    1813. 

  1813. spr.x = Math.round((stage.stageWidth - spr.width)/2);
    1814. 

  1814. spr.y = Math.round((stage.stageHeight - spr.height)/2);
    1815. 

  1815. spr.rotationX = 45;
    1816. 

  1816. addChild(spr);
    1817. 

  1817.  
    1818. 

  1818. function slider_change(evt:SliderEvent):void {
    1819. 

  1819.     spr.rotationX = evt.value;
    1820. 

  1820. }
    1821. 

  1821. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:rotationY:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rotationY</apiName><shortdesc class="- topic/shortdesc ">
    1822. 

  1822.      表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1823. 

  1823.      表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。
    1824. 

  1824.      
    1825. 

  1825.      
    1826. 

  1826.      </apiDesc><example conref="examples\RotationExample1.as" class="- topic/example "> 在本示例中，两个椭圆使用其 <codeph class="+ topic/ph pr-d/codeph ">rotationX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">rotationY</codeph> 属性进行旋转。第一个椭圆的注册点设置为椭圆的中心点。它围绕自身进行旋转。第二个椭圆围绕一个外部点进行旋转。 
    1827. 

  1827. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1828. 

  1828. package {
    1829. 

  1829.     import flash.display.MovieClip;
    1830. 

  1830.     import flash.display.Shape;
    1831. 

  1831.     import flash.geom.*;
    1832. 

  1832.     import flash.display.Graphics;
    1833. 

  1833.     import flash.events.TimerEvent;
    1834. 

  1834.     import flash.utils.Timer;
    1835. 

  1835. 

  1836.     public class RotationExample1 extends MovieClip {
    1837. 

  1837.         private var ellipse:Shape = new Shape();
    1838. 

  1838.         private var speed:int = 10;
    1839. 

  1839.         private var ellipse1:Shape;
    1840. 

  1840.         private var ellipse2:Shape;
    1841. 

  1841.         
    1842. 

  1842.         public function RotationExample1():void {
    1843. 

  1843. 

  1844.             ellipse1 = drawEllipse(-50, -40, (this.stage.stageWidth / 2), 
    1845. 

  1845.                                     (this.stage.stageHeight / 2));
    1846. 

  1846.             
    1847. 

  1847.             ellipse2 = drawEllipse(30, 40, (this.stage.stageWidth / 2), 
    1848. 

  1848.                                           (this.stage.stageHeight / 2));
    1849. 

  1849. 

  1850.             this.addChild(ellipse1);
    1851. 

  1851.             this.addChild(ellipse2);
    1852. 

  1852. 

  1853.             var t:Timer = new Timer(50);
    1854. 

  1854.             t.addEventListener(TimerEvent.TIMER, timerHandler);
    1855. 

  1855.             t.start();
    1856. 

  1856.         }
    1857. 

  1857. 

  1858.         private function drawEllipse(x1, y1, x2, y2):Shape {
    1859. 

  1859.         
    1860. 

  1860.             var e:Shape = new Shape();
    1861. 

  1861.             e.graphics.beginFill(0xFF0000);
    1862. 

  1862.             e.graphics.lineStyle(2);
    1863. 

  1863.             e.graphics.drawEllipse(x1, y1, 100, 80);
    1864. 

  1864.             e.graphics.endFill();
    1865. 

  1865. 

  1866.             e.x  = x2;  
    1867. 

  1867.             e.y  = y2;
    1868. 

  1868.             e.z = 1;
    1869. 

  1869.             return e;
    1870. 

  1870.         }
    1871. 

  1871. 

  1872.         private function timerHandler(event:TimerEvent):void {
    1873. 

  1873.             ellipse1.rotationY += speed;    
    1874. 

  1874.             ellipse1.rotationX -= speed;
    1875. 

  1875. 

  1876.             ellipse2.rotationY += speed;    
    1877. 

  1877.             ellipse2.rotationX -= speed;
    1878. 

  1878.         }
    1879. 

  1879.     }
    1880. 

  1880. }
    1881. 

  1881. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:rotationZ:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rotationZ</apiName><shortdesc class="- topic/shortdesc ">
    1882. 

  1882.      表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1883. 

  1883.      表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。
    1884. 

  1884.      
    1885. 

  1885.      
    1886. 

  1886.      </apiDesc></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:rotation:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rotation</apiName><shortdesc class="- topic/shortdesc ">
    1887. 

  1887.      表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1888. 

  1888.      表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或减去 360 获得该范围内的值。例如，<codeph class="+ topic/ph pr-d/codeph ">my_video.rotation = 450</codeph>语句与 <codeph class="+ topic/ph pr-d/codeph "> my_video.rotation = 90</codeph> 是相同的。
    1889. 

  1889.      
    1890. 

  1890.      </apiDesc><example conref="examples\DisplayObject.rotation.1.as" class="- topic/example "> 以下代码可创建一个 Sprite 对象并在用户单击该对象时旋转它：
    1891. 

  1891. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1892. 

  1892. 

  1893. import flash.display.Sprite;
    1894. 

  1894. import flash.events.MouseEvent;
    1895. 

  1895. 

  1896. var square:Sprite = new Sprite();
    1897. 

  1897. square.graphics.beginFill(0xFFCC00);
    1898. 

  1898. square.graphics.drawRect(-50, -50, 100, 100);
    1899. 

  1899. square.x = 150;
    1900. 

  1900. square.y = 150;
    1901. 

  1901. addChild(square);
    1902. 

  1902. 

  1903. square.addEventListener(MouseEvent.CLICK, rotate);
    1904. 

  1904. 

  1905. function rotate(event:MouseEvent):void {
    1906. 

  1906.         square.rotation += 15;
    1907. 

  1907. }
    1908. 

  1908. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:scale9Grid:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">scale9Grid</apiName><shortdesc class="- topic/shortdesc ">
    1909. 

  1909.      当前有效的缩放网格。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following creates a movie clip that contains a 20-pixel line (which forms a border)
    1910. 

  1910.      and a gradient fill. The movie clip scales based on the mouse position, and because of the
    1911. 

  1911.      <code>scale9Grid</code> set for the movie clip, the thickness of the 20-pixel line does not
    1912. 

  1912.      vary when the clip scales (although the gradient in the movie clip <em>does</em> scale):
    1913. 

  1913.      
    1914. 

  1914.      <listing version="2.0">
    1915. 

  1915.      import flash.geom.Rectangle;
    1916. 

  1916.      import flash.geom.Matrix;
    1917. 

  1917.      
    1918. 

  1918.      this.createEmptyMovieClip("my_mc", this.getNextHighestDepth());
    1919. 

  1919.      
    1920. 

  1920.      var grid:Rectangle = new Rectangle(20, 20, 260, 260);
    1921. 

  1921.      my_mc.scale9Grid = grid ;
    1922. 

  1922.      
    1923. 

  1923.      my_mc._x = 50;
    1924. 

  1924.      my_mc._y = 50;
    1925. 

  1925.      
    1926. 

  1926.      function onMouseMove()
    1927. 

  1927.      {
    1928. 

  1928.       my_mc._width  = _xmouse;
    1929. 

  1929.       my_mc._height = _ymouse;
    1930. 

  1930.      }
    1931. 

  1931.      
    1932. 

  1932.      my_mc.lineStyle(20, 0xff3333, 100);
    1933. 

  1933.      var gradient_matrix:Matrix = new Matrix();
    1934. 

  1934.      gradient_matrix.createGradientBox(15, 15, Math.PI, 10, 10);
    1935. 

  1935.      my_mc.beginGradientFill("radial", [0xffff00, 0x0000ff],
    1936. 

  1936.               [100, 100], [0, 0xFF], gradient_matrix,
    1937. 

  1937.               "reflect", "RGB", 0.9);
    1938. 

  1938.      my_mc.moveTo(0, 0);
    1939. 

  1939.      my_mc.lineTo(0, 300);
    1940. 

  1940.      my_mc.lineTo(300, 300);
    1941. 

  1941.      my_mc.lineTo(300, 0);
    1942. 

  1942.      my_mc.lineTo(0, 0);
    1943. 

  1943.      my_mc.endFill();
    1944. 

  1944.      </listing>
    1945. 

  1945.      
    1946. 

  1946.      </maelexample></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Rectangle</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果向方法传递的参数无效。
    1947. 

  1947.      
    1948. 

  1948.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1949. 

  1949.      当前有效的缩放网格。如果设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，则在应用任何缩放转换时，将正常缩放整个显示对象。
    1950. 

  1950.      
    1951. 

  1951.      <p class="- topic/p ">当定义 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 属性时，该显示对象被分割到以 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 矩形为基础的具有九个区域的网格中，该矩形定义网格的中心区域。网格的其他八个区域如下所示： </p>
    1952. 

  1952.      
    1953. 

  1953.      <ul class="- topic/ul "><li class="- topic/li ">矩形外的左上角</li><li class="- topic/li ">矩形上方的区域 </li><li class="- topic/li ">矩形外的右上角</li><li class="- topic/li ">矩形左侧的区域</li><li class="- topic/li ">矩形右侧的区域</li><li class="- topic/li ">矩形外的左下角</li><li class="- topic/li ">矩形下方的区域</li><li class="- topic/li ">矩形外的右下角</li></ul>
    1954. 

  1954.      
    1955. 

  1955.      <p class="- topic/p ">可以认为中心区域（由矩形定义）之外的八个区域类似于在缩放时已应用特殊规则的图片帧。</p>
    1956. 

  1956.      
    1957. 

  1957.      <p class="- topic/p ">在设置 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 属性并缩放显示对象后，会正常缩放所有文本和渐变；但是，对于其他类型的对象，将应用以下规则：</p>
    1958. 

  1958.      
    1959. 

  1959.      <ul class="- topic/ul "><li class="- topic/li ">正常缩放中心区域中的内容。 </li><li class="- topic/li ">不缩放转角中的内容。 </li><li class="- topic/li ">仅水平缩放顶部和底部区域中的内容。仅垂直缩放左侧和右侧区域中的内容。</li><li class="- topic/li ">拉伸所有填充（包括位图、视频和渐变）以适应其形状。</li></ul>
    1960. 

  1960.      
    1961. 

  1961.      <p class="- topic/p ">如果旋转显示对象，则所有后续缩放都是正常的（并会忽略 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 属性）。</p>
    1962. 

  1962.      
    1963. 

  1963.      <p class="- topic/p ">例如，请考虑以下显示对象和作为该显示对象的 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 属性应用的矩形：</p>
    1964. 

  1964.      
    1965. 

  1965.      <adobetable class="+ topic/table adobe-d/adobetable "><tgroup cols="2" class="- topic/tgroup "><tbody class="- topic/tbody "><row class="- topic/row "><entry align="center" class="- topic/entry "><adobeimage alt="显示对象图像" href="../../images/scale9Grid-a.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/>
    1966. 

  1966.      <p class="- topic/p ">显示对象。</p></entry><entry align="center" class="- topic/entry "><adobeimage alt="显示对象缩放 9 区域" href="../../images/scale9Grid-b.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/>
    1967. 

  1967.       <p class="- topic/p ">红色矩形显示 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph>。</p></entry></row></tbody></tgroup></adobetable>
    1968. 

  1968.      
    1969. 

  1969.      <p class="- topic/p ">缩放或拉伸显示对象时，矩形内的对象正常缩放，但是矩形外的对象则按照 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 规则进行缩放：</p>
    1970. 

  1970.      
    1971. 

  1971.      <adobetable class="+ topic/table adobe-d/adobetable "><tgroup cols="2" class="- topic/tgroup "><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">缩放到 75%：</entry><entry class="- topic/entry "><adobeimage alt="缩放到 75% 的显示对象" href="../../images/scale9Grid-c.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row><row class="- topic/row "><entry class="- topic/entry ">缩放到 50%：</entry><entry class="- topic/entry "><adobeimage alt="缩放到 50% 的显示对象" href="../../images/scale9Grid-d.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row><row class="- topic/row "><entry class="- topic/entry ">缩放到 25%：</entry><entry class="- topic/entry "><adobeimage alt="缩放到 25% 的显示对象" href="../../images/scale9Grid-e.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row><row class="- topic/row "><entry class="- topic/entry ">水平拉伸 150%： </entry><entry class="- topic/entry "><adobeimage alt="拉伸 150% 的显示" href="../../images/scale9Grid-f.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row></tbody></tgroup></adobetable>
    1972. 

  1972.      
    1973. 

  1973.      <p class="- topic/p ">设置 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 的常见用法是设置用作组件的显示对象，当缩放该组件时，其中的边缘区域保持相同的宽度。</p>
    1974. 

  1974.      
    1975. 

  1975.      </apiDesc><example conref="examples\DisplayObject.scale9Grid.1.as" class="- topic/example "> 以下代码创建一个 Shape 对象，并用该对象的 <codeph class="+ topic/ph pr-d/codeph ">graphics</codeph> 属性绘制一个矩形。该矩形将一个 20 像素宽的线条作为边框，并且用渐变填充。该 timer 事件调用 <codeph class="+ topic/ph pr-d/codeph ">scale()</codeph> 函数，该函数通过调整 <codeph class="+ topic/ph pr-d/codeph ">scaleX</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">scaleY</codeph> 属性来缩放 Shape 对象。应用于 Shape 对象的 <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> 会阻止缩放矩形的边框线，而只缩放渐变填充：
    1976. 

  1976. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1977. 

  1977. 

  1978. import flash.display.Shape;
    1979. 

  1979. import flash.display.GradientType;
    1980. 

  1980. import flash.display.SpreadMethod;
    1981. 

  1981. import flash.display.InterpolationMethod;
    1982. 

  1982. import flash.geom.Matrix;
    1983. 

  1983. import flash.geom.Rectangle;
    1984. 

  1984. import flash.utils.Timer;
    1985. 

  1985. import flash.events.TimerEvent;
    1986. 

  1986. 

  1987. var square:Shape = new Shape();
    1988. 

  1988. square.graphics.lineStyle(20, 0xFFCC00);
    1989. 

  1989. var gradientMatrix:Matrix = new Matrix();
    1990. 

  1990. gradientMatrix.createGradientBox(15, 15, Math.PI, 10, 10);
    1991. 

  1991. square.graphics.beginGradientFill(GradientType.RADIAL, 
    1992. 

  1992.             [0xffff00, 0x0000ff], 
    1993. 

  1993.             [100, 100], 
    1994. 

  1994.             [0, 0xFF], 
    1995. 

  1995.             gradientMatrix, 
    1996. 

  1996.             SpreadMethod.REFLECT, 
    1997. 

  1997.             InterpolationMethod.RGB, 
    1998. 

  1998.             0.9);
    1999. 

  1999. square.graphics.drawRect(0, 0, 100, 100);
    2000. 

  2000. 

  2001. var grid:Rectangle = new Rectangle(20, 20, 60, 60);
    2002. 

  2002. square.scale9Grid = grid ;
    2003. 

  2003. 

  2004. addChild(square);
    2005. 

  2005. 

  2006. var tim:Timer = new Timer(100);
    2007. 

  2007. tim.start();
    2008. 

  2008. tim.addEventListener(TimerEvent.TIMER, scale);
    2009. 

  2009. 

  2010. var scaleFactor:Number = 1.01;
    2011. 

  2011. 

  2012. function scale(event:TimerEvent):void {
    2013. 

  2013.     square.scaleX *= scaleFactor;
    2014. 

  2014.     square.scaleY *= scaleFactor;
    2015. 

  2015.     
    2016. 

  2016.     if (square.scaleX > 2.0) {
    2017. 

  2017.         scaleFactor = 0.99;
    2018. 

  2018.     }
    2019. 

  2019.     if (square.scaleX &lt; 1.0) {
    2020. 

  2020.         scaleFactor = 1.01;
    2021. 

  2021.     }
    2022. 

  2022. }
    2023. 

  2023. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.geom.xml#Rectangle" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.Rectangle</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:scaleX:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">scaleX</apiName><shortdesc class="- topic/shortdesc ">
    2024. 

  2024.      表示从注册点开始应用的对象的水平缩放比例（百分比）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2025. 

  2025.      表示从注册点开始应用的对象的水平缩放比例（百分比）。默认注册点为 (0,0)。1.0 等于 100% 缩放。
    2026. 

  2026.      
    2027. 

  2027.      <p class="- topic/p ">缩放本地坐标系统将更改 <codeph class="+ topic/ph pr-d/codeph ">x</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性值，这些属性值是以整像素定义的。 </p>
    2028. 

  2028.      
    2029. 

  2029.      </apiDesc><example conref="examples\DisplayObject.scaleX.1.as" class="- topic/example "> 以下代码创建一个 Sprite 对象，并用该对象的 <codeph class="+ topic/ph pr-d/codeph ">graphics</codeph> 属性绘制一个矩形。当用户单击该 Sprite 对象时，它将按 10% 的比例进行缩放：
    2030. 

  2030. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2031. 

  2031. 

  2032. import flash.display.Sprite;
    2033. 

  2033. import flash.events.MouseEvent;
    2034. 

  2034. 

  2035. var square:Sprite = new Sprite();
    2036. 

  2036. square.graphics.beginFill(0xFFCC00);
    2037. 

  2037. square.graphics.drawRect(0, 0, 100, 100);
    2038. 

  2038. addChild(square);
    2039. 

  2039. 

  2040. square.addEventListener(MouseEvent.CLICK, scale);
    2041. 

  2041. 

  2042. function scale(event:MouseEvent):void {
    2043. 

  2043.     square.scaleX *= 1.10;
    2044. 

  2044.     square.scaleY *= 1.10;
    2045. 

  2045. }
    2046. 

  2046. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:scaleY:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">scaleY</apiName><shortdesc class="- topic/shortdesc ">
    2047. 

  2047.      表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2048. 

  2048.      表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。默认注册点为 (0,0)。1.0 是 100% 缩放。
    2049. 

  2049.      
    2050. 

  2050.      <p class="- topic/p ">缩放本地坐标系统将更改 <codeph class="+ topic/ph pr-d/codeph ">x</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性值，这些属性值是以整像素定义的。 </p>
    2051. 

  2051.      
    2052. 

  2052.      </apiDesc><example conref="examples\DisplayObject.scaleX.1.as" class="- topic/example "> 以下代码创建一个 Sprite 对象，并用该对象的 <codeph class="+ topic/ph pr-d/codeph ">graphics</codeph> 属性绘制一个矩形。当用户单击该 Sprite 对象时，它将按 10% 的比例进行缩放：
    2053. 

  2053. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2054. 

  2054. 

  2055. import flash.display.Sprite;
    2056. 

  2056. import flash.events.MouseEvent;
    2057. 

  2057. 

  2058. var square:Sprite = new Sprite();
    2059. 

  2059. square.graphics.beginFill(0xFFCC00);
    2060. 

  2060. square.graphics.drawRect(0, 0, 100, 100);
    2061. 

  2061. addChild(square);
    2062. 

  2062. 

  2063. square.addEventListener(MouseEvent.CLICK, scale);
    2064. 

  2064. 

  2065. function scale(event:MouseEvent):void {
    2066. 

  2066.     square.scaleX *= 1.10;
    2067. 

  2067.     square.scaleY *= 1.10;
    2068. 

  2068. }
    2069. 

  2069. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:scaleZ:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">scaleZ</apiName><shortdesc class="- topic/shortdesc ">
    2070. 

  2070.      表示从对象的注册点开始应用的对象的深度缩放比例（百分比）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2071. 

  2071.      表示从对象的注册点开始应用的对象的深度缩放比例（百分比）。默认注册点为 (0,0)。1.0 是 100% 缩放。
    2072. 

  2072.      
    2073. 

  2073.      <p class="- topic/p ">缩放本地坐标系统将更改 <codeph class="+ topic/ph pr-d/codeph ">x</codeph>、<codeph class="+ topic/ph pr-d/codeph ">y</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">z</codeph> 属性值，这些属性值是以整像素定义的。 </p>
    2074. 

  2074.      
    2075. 

  2075.      
    2076. 

  2076.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#DisplayObject/z" class="- topic/link "><linktext class="- topic/linktext ">z</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:scrollRect:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">scrollRect</apiName><shortdesc class="- topic/shortdesc ">
    2077. 

  2077.      显示对象的滚动矩形范围。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Rectangle</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2078. 

  2078.      显示对象的滚动矩形范围。显示对象被裁切为矩形定义的大小，当您更改 <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> 对象的 <codeph class="+ topic/ph pr-d/codeph ">x</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性时，它会在矩形内滚动。
    2079. 

  2079.      
    2080. 

  2080.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> Rectangle 对象的属性使用显示对象的坐标空间，并缩放到像整个显示对象一样。滚动显示对象上已裁切窗口的转角范围是显示对象的原点 (0,0) 和矩形的宽度和高度定义的点。它们不按原点居中，而是使用原点定义区域的左上角。滚动的显示对象始终以整像素为增量进行滚动。 </p>
    2081. 

  2081.      
    2082. 

  2082.      <p class="- topic/p ">您可以通过设置 <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> Rectangle 对象的 <codeph class="+ topic/ph pr-d/codeph ">x</codeph> 属性来左右滚动对象， 还可以通过设置 <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> 对象的 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性来上下滚动对象。如果显示对象旋转了 90 度，并且您左右滚动它，则实际上显示对象会上下滚动。</p>
    2083. 

  2083.      
    2084. 

  2084.      </apiDesc><example conref="examples\DisplayObject.scrollRect.1.as" class="- topic/example "> 下例显示 <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> 属性如何为显示对象 <codeph class="+ topic/ph pr-d/codeph ">circle</codeph> 定义滚动区域。单击 <codeph class="+ topic/ph pr-d/codeph ">circle</codeph> 对象时，<codeph class="+ topic/ph pr-d/codeph ">clicked()</codeph> 事件处理函数方法会调整 <codeph class="+ topic/ph pr-d/codeph ">circle</codeph> 对象 <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> 属性的 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性，从而使对象向下滚动：
    2085. 

  2085. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2086. 

  2086. 

  2087. import flash.display.Sprite;
    2088. 

  2088. import flash.geom.Rectangle;
    2089. 

  2089. import flash.events.MouseEvent;
    2090. 

  2090. 

  2091. var circle:Sprite = new Sprite();
    2092. 

  2092. circle.graphics.beginFill(0xFFCC00);
    2093. 

  2093. circle.graphics.drawCircle(200, 200, 200);
    2094. 

  2094. circle.scrollRect = new Rectangle(0, 0, 200, 200);
    2095. 

  2095. addChild(circle);
    2096. 

  2096. 

  2097. circle.addEventListener(MouseEvent.CLICK, clicked);
    2098. 

  2098. 

  2099. function clicked(event:MouseEvent):void {
    2100. 

  2100.     var rect:Rectangle = event.target.scrollRect;
    2101. 

  2101.     rect.y -= 5;
    2102. 

  2102.     event.target.scrollRect = rect;
    2103. 

  2103. }
    2104. 

  2104. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.geom.xml#Rectangle" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.Rectangle</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:stage:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">stage</apiName><shortdesc class="- topic/shortdesc ">
    2105. 

  2105.      显示对象的舞台。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:Stage</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2106. 

  2106.      显示对象的舞台。Flash 运行时应用程序仅包含一个 Stage 对象。例如，您可以创建多个显示对象并加载到显示列表中，每个显示对象的 <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> 属性是指相同的 Stage 对象（即使显示对象属于已加载的 SWF 文件）。
    2107. 

  2107.      
    2108. 

  2108.      <p class="- topic/p ">如果显示对象未添加到显示列表，则其 <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> 属性会设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。</p>
    2109. 

  2109.      
    2110. 

  2110.      </apiDesc><example conref="examples\DisplayObject.stage.1.as" class="- topic/example "> 以下代码创建两个 TextField 对象并使用 Stage 对象的 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 属性来定位文本字段：
    2111. 

  2111. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2112. 

  2112. 

  2113. import flash.text.TextField;
    2114. 

  2114. 

  2115. var tf1:TextField = new TextField();
    2116. 

  2116. tf1.text = "Text Field 1";
    2117. 

  2117. tf1.border = true;
    2118. 

  2118. tf1.x = 10;
    2119. 

  2119. addChild(tf1);
    2120. 

  2120. tf1.width = tf1.stage.stageWidth / 2 - 10;
    2121. 

  2121. 

  2122. var tf2:TextField = new TextField();
    2123. 

  2123. tf2.text = "Text Field 2";
    2124. 

  2124. tf2.border = true;
    2125. 

  2125. tf2.x = tf1.x + tf1.width + 5;
    2126. 

  2126. addChild(tf2);
    2127. 

  2127. tf2.width = tf2.stage.stageWidth / 2 - 10;
    2128. 

  2128. 

  2129. trace(stage.stageWidth);
    2130. 

  2130. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:transform:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">transform</apiName><shortdesc class="- topic/shortdesc ">
    2131. 

  2131.     一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Transform</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2132. 

  2132.     一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。在 Transform 类的条目中对特定属性 matrix、colorTransform 和三个只读属性（<codeph class="+ topic/ph pr-d/codeph ">concatenatedMatrix</codeph>、<codeph class="+ topic/ph pr-d/codeph ">concatenatedColorTransform</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">pixelBounds</codeph>）进行了说明。
    2133. 

  2133.     
    2134. 

  2134.     <p class="- topic/p ">transform 对象的每个属性本身都是一个对象。此概念很重要，因为设置 matrix 或 colorTransform 对象的新值的唯一方法是，创建新对象并将该对象复制到 transform.matrix 或 transform.colorTransform 属性。</p>
    2135. 

  2135.     
    2136. 

  2136.     <p class="- topic/p ">例如，要增加显示对象矩阵的 <codeph class="+ topic/ph pr-d/codeph ">tx</codeph> 值，您必须制作整个矩阵对象的副本，然后将新对象复制到 transform 对象的 matrix 属性中：</p>
    2137. 

  2137.     
    2138. 

  2138.     <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph ">
    2139. 

  2139.     var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    2140. 

  2140.     myMatrix.tx += 10; 
    2141. 

  2141.     myDisplayObject.transform.matrix = myMatrix;  
    2142. 

  2142.     </codeph></pre>
    2143. 

  2143.     
    2144. 

  2144.     <p class="- topic/p ">不能直接设置 <codeph class="+ topic/ph pr-d/codeph ">tx</codeph> 属性。下面的代码对 <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph> 不起作用： </p>
    2145. 

  2145.     
    2146. 

  2146.     <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph ">
    2147. 

  2147.     myDisplayObject.transform.matrix.tx += 10;
    2148. 

  2148.     </codeph></pre>
    2149. 

  2149.     
    2150. 

  2150.     <p class="- topic/p ">您也可以复制整个 transform 对象并为其赋予另一个显示对象的 transform 属性。例如，下面的代码将整个 transform 对象从 <codeph class="+ topic/ph pr-d/codeph ">myOldDisplayObj</codeph> 复制到 <codeph class="+ topic/ph pr-d/codeph ">myNewDisplayObj</codeph>：</p>
    2151. 

  2151.     <codeph class="+ topic/ph pr-d/codeph ">myNewDisplayObj.transform = myOldDisplayObj.transform;</codeph>
    2152. 

  2152.     <p class="- topic/p ">现在，新显示对象 <codeph class="+ topic/ph pr-d/codeph ">myNewDisplayObj</codeph> 与旧显示对象 <codeph class="+ topic/ph pr-d/codeph ">myOldDisplayObj</codeph> 具有相同的矩阵、颜色转换和像素范围值。</p>
    2153. 

  2153.     
    2154. 

  2154.     <p class="- topic/p ">请注意，用于电视的 AIR 设备使用硬件加速器（如果可用）进行颜色转换。</p>
    2155. 

  2155.     
    2156. 

  2156.     </apiDesc><example conref="examples\DisplayObject.transform.1.as" class="- topic/example "> 以下代码设置一个 <codeph class="+ topic/ph pr-d/codeph ">square</codeph> Sprite 对象。当用户单击 Sprite 时，<codeph class="+ topic/ph pr-d/codeph ">transformer()</codeph> 方法会调整 Sprite <codeph class="+ topic/ph pr-d/codeph ">transform</codeph> 属性的 <codeph class="+ topic/ph pr-d/codeph ">colorTransform</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> 属性：
    2157. 

  2157. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2158. 

  2158. 

  2159. import flash.display.Sprite;
    2160. 

  2160. import flash.geom.ColorTransform;
    2161. 

  2161. import flash.geom.Matrix;
    2162. 

  2162. import flash.geom.Transform;
    2163. 

  2163. import flash.events.MouseEvent;
    2164. 

  2164. 

  2165. var square:Sprite = new Sprite();
    2166. 

  2166. square.graphics.lineStyle(20, 0xFF2200);
    2167. 

  2167. square.graphics.beginFill(0x0000DD);
    2168. 

  2168. square.graphics.drawRect(0, 0, 100, 100);
    2169. 

  2169. addChild(square);
    2170. 

  2170. 

  2171. var resultColorTransform:ColorTransform = new ColorTransform();
    2172. 

  2172. resultColorTransform.alphaMultiplier = 0.5;
    2173. 

  2173. resultColorTransform.redOffset = 155;
    2174. 

  2174. resultColorTransform.greenMultiplier = 0.5;
    2175. 

  2175. 

  2176. var skewMatrix:Matrix = new Matrix(1, 1, 0, 1);
    2177. 

  2177. 

  2178. square.addEventListener(MouseEvent.CLICK, transformer);
    2179. 

  2179. 

  2180. function transformer(event:MouseEvent):void {
    2181. 

  2181.     var transformation:Transform = square.transform;
    2182. 

  2182.     var tempMatrix:Matrix = square.transform.matrix;
    2183. 

  2183.     tempMatrix.concat(skewMatrix);
    2184. 

  2184.     square.transform.colorTransform = resultColorTransform;
    2185. 

  2185.     
    2186. 

  2186.     square.transform.matrix = tempMatrix;
    2187. 

  2187. }
    2188. 

  2188. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.geom.xml#Transform" class="- topic/link "><linktext class="- topic/linktext ">Transform 类</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:visible:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">visible</apiName><shortdesc class="- topic/shortdesc ">
    2189. 

  2189.      显示对象是否可见。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2190. 

  2190.      显示对象是否可见。不可见的显示对象已被禁用。例如，如果 InteractiveObject 实例的 <codeph class="+ topic/ph pr-d/codeph ">visible=false</codeph>，则无法单击该对象。
    2191. 

  2191.      
    2192. 

  2192.      </apiDesc><example conref="examples\DisplayObject.visible.1.as" class="- topic/example "> 以下代码使用 Timer 对象调用定期更改显示对象的 <codeph class="+ topic/ph pr-d/codeph ">visible</codeph> 属性的函数，从而会产生闪烁的效果：
    2193. 

  2193. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2194. 

  2194. 

  2195. import flash.text.TextField;
    2196. 

  2196. import flash.utils.Timer;
    2197. 

  2197. import flash.events.TimerEvent;
    2198. 

  2198. 

  2199. var tf:TextField = new TextField();
    2200. 

  2200. tf.text = "Hello.";
    2201. 

  2201. addChild(tf);
    2202. 

  2202. 

  2203. var tim:Timer = new Timer(250);
    2204. 

  2204. tim.start();
    2205. 

  2205. tim.addEventListener(TimerEvent.TIMER, blinker);
    2206. 

  2206. 

  2207. function blinker(event:TimerEvent):void {
    2208. 

  2208.     tf.visible = !tf.visible;
    2209. 

  2209. }
    2210. 

  2210. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:width:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">width</apiName><shortdesc class="- topic/shortdesc ">
    2211. 

  2211.      表示显示对象的宽度，以像素为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2212. 

  2212.      表示显示对象的宽度，以像素为单位。宽度是根据显示对象内容的范围来计算的。如果您设置了 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 属性，则 <codeph class="+ topic/ph pr-d/codeph ">scaleX</codeph> 属性会相应调整，如以下代码所示：
    2213. 

  2213.      
    2214. 

  2214.      <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2215. 

  2215.     var rect:Shape = new Shape();
    2216. 

  2216.     rect.graphics.beginFill(0xFF0000);
    2217. 

  2217.     rect.graphics.drawRect(0, 0, 100, 100);
    2218. 

  2218.     trace(rect.scaleX) // 1;
    2219. 

  2219.     rect.width = 200;
    2220. 

  2220.     trace(rect.scaleX) // 2;</codeblock>
    2221. 

  2221.     
    2222. 

  2222.     <p class="- topic/p ">除 TextField 和 Video 对象以外，没有内容的显示对象（如一个空的 Sprite）的宽度为 0，即使您尝试将 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 设置为其他值，也是这样。</p>
    2223. 

  2223.      
    2224. 

  2224.      </apiDesc><example conref="examples\DisplayObject.width.1.as" class="- topic/example "> 以下代码设置一个 <codeph class="+ topic/ph pr-d/codeph ">square</codeph> Sprite 对象。当用户单击 Sprite 时，<codeph class="+ topic/ph pr-d/codeph ">widen()</codeph> 方法会增加 Sprite 的 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 属性：
    2225. 

  2225. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2226. 

  2226. 

  2227. import flash.display.Sprite;
    2228. 

  2228. import flash.events.MouseEvent;
    2229. 

  2229. 

  2230. var square:Sprite = new Sprite();
    2231. 

  2231. square.graphics.beginFill(0xFF0000);
    2232. 

  2232. square.graphics.drawRect(0, 0, 100, 100);
    2233. 

  2233. addChild(square);
    2234. 

  2234. 

  2235. square.addEventListener(MouseEvent.CLICK, widen);
    2236. 

  2236. 

  2237. function widen(event:MouseEvent):void {
    2238. 

  2238.     square.width += 10;
    2239. 

  2239. }
    2240. 

  2240. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:x:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">x</apiName><shortdesc class="- topic/shortdesc ">
    2241. 

  2241.      表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2242. 

  2242.      表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 <i class="+ topic/ph hi-d/i ">x</i> 坐标。如果该对象位于具有变形的 DisplayObjectContainer 内，则它也位于包含 DisplayObjectContainer 的本地坐标系中。因此，对于逆时针旋转 90 度的 DisplayObjectContainer，该 DisplayObjectContainer 的子级将继承逆时针旋转 90 度的坐标系。对象的坐标指的是注册点的位置。
    2243. 

  2243.      
    2244. 

  2244.      </apiDesc><example conref="examples\DisplayObject.x.1.as" class="- topic/example "> 以下代码设置一个 <codeph class="+ topic/ph pr-d/codeph ">circle</codeph> Sprite 对象。Timer 对象用于每 50 毫秒更改一次 Sprite 的 <codeph class="+ topic/ph pr-d/codeph ">x</codeph> 属性：
    2245. 

  2245. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2246. 

  2246. 

  2247. import flash.display.Sprite;
    2248. 

  2248. import flash.utils.Timer;
    2249. 

  2249. import flash.events.TimerEvent;
    2250. 

  2250. 

  2251. var circle:Sprite = new Sprite();
    2252. 

  2252. circle.graphics.beginFill(0xFF0000);
    2253. 

  2253. circle.graphics.drawCircle(100, 100, 100);
    2254. 

  2254. addChild(circle);
    2255. 

  2255. 

  2256. var tim:Timer = new Timer(50);
    2257. 

  2257. tim.start();
    2258. 

  2258. tim.addEventListener(TimerEvent.TIMER, bounce);
    2259. 

  2259. 

  2260. var xInc:Number = 2;
    2261. 

  2261. 

  2262. function bounce(event:TimerEvent):void {
    2263. 

  2263.     circle.x += xInc;
    2264. 

  2264.     if (circle.x > circle.width) {
    2265. 

  2265.         xInc = -2;
    2266. 

  2266.     }
    2267. 

  2267.     if (circle.x &lt; 0) {
    2268. 

  2268.         xInc = 2;
    2269. 

  2269.     }
    2270. 

  2270. }
    2271. 

  2271. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:y:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">y</apiName><shortdesc class="- topic/shortdesc ">
    2272. 

  2272.      表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2273. 

  2273.      表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 <i class="+ topic/ph hi-d/i ">y</i> 坐标。如果该对象位于具有变形的 DisplayObjectContainer 内，则它也位于包含 DisplayObjectContainer 的本地坐标系中。因此，对于逆时针旋转 90 度的 DisplayObjectContainer，该 DisplayObjectContainer 的子级将继承逆时针旋转 90 度的坐标系。对象的坐标指的是注册点的位置。
    2274. 

  2274.      
    2275. 

  2275.      </apiDesc><example conref="examples\DisplayObject.height.1.as" class="- topic/example "> 以下代码创建两个 TextField 对象并调整每个对象的 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 属性（基于每个对象的 <codeph class="+ topic/ph pr-d/codeph ">textHeight</codeph> 属性）；此外，它还通过设置其 <codeph class="+ topic/ph pr-d/codeph ">y</codeph> 属性来定位第二个文本字段：
    2276. 

  2276. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2277. 

  2277. import flash.text.TextField;
    2278. 

  2278. 

  2279. var tf1:TextField = new TextField();
    2280. 

  2280. tf1.text = "Text Field 1";
    2281. 

  2281. tf1.border = true;
    2282. 

  2282. tf1.wordWrap = true;
    2283. 

  2283. tf1.width = 40;
    2284. 

  2284. tf1.height = tf1.textHeight + 5;
    2285. 

  2285. addChild(tf1);
    2286. 

  2286. 

  2287. var tf2:TextField = new TextField();
    2288. 

  2288. tf2.text = "Text Field 2";
    2289. 

  2289. tf2.border = true;
    2290. 

  2290. tf2.wordWrap = true;
    2291. 

  2291. tf2.width = 40;
    2292. 

  2292. tf2.height = tf2.textHeight + 5;
    2293. 

  2293. tf2.y = tf1.y + tf1.height + 5;
    2294. 

  2294. addChild(tf2);
    2295. 

  2295. </codeblock></example></apiValueDetail></apiValue><apiValue id="flash.display:DisplayObject:z:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">z</apiName><shortdesc class="- topic/shortdesc ">
    2296. 

  2296.      表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2297. 

  2297.      表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。z 属性用于 3D 坐标，而不是屏幕坐标或像素坐标。 
    2298. 

  2298.      <p class="- topic/p ">当您将显示对象的 <codeph class="+ topic/ph pr-d/codeph ">z</codeph> 属性设置为默认值 <codeph class="+ topic/ph pr-d/codeph ">0</codeph> 之外的其他值时，将自动创建一个相对应的 Matrix3D 对象，以便调整显示对象在三维中的位置和方向。在使用 z 轴时，x 和 y 属性的现有行为将从屏幕坐标或像素坐标更改为相对于 3D 父容器的位置。</p>
    2299. 

  2299.      <p class="- topic/p ">例如，位于 x = 100、y = 100、z = 200 位置的 <codeph class="+ topic/ph pr-d/codeph ">_root</codeph> 的子级不在像素位置 (100,100) 处进行绘制。将在 3D 投影计算将其所置之处绘制该子级。计算方法为：</p>
    2300. 

  2300.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph "> (x*cameraFocalLength/cameraRelativeZPosition, y*cameraFocalLength/cameraRelativeZPosition)</codeph></p>
    2301. 

  2301.      
    2302. 

  2302.      
    2303. 

  2303.      </apiDesc><example conref="examples\ZAxisExample1.as" class="- topic/example "> 本示例绘制了两个椭圆并使其朝着消失点前后移动（沿 <codeph class="+ topic/ph pr-d/codeph ">z</codeph> 轴上下移动）。一个椭圆设置的移动速度要快于另一个。 
    2304. 

  2304. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2305. 

  2305. package {
    2306. 

  2306.     import flash.display.MovieClip;
    2307. 

  2307.     import flash.display.Shape;
    2308. 

  2308.     import flash.display.Graphics;
    2309. 

  2309.     import flash.events.Event;
    2310. 

  2310.     import flash.geom.*;
    2311. 

  2311. 

  2312.     public class ZAxisExample1 extends MovieClip {
    2313. 

  2313.         private var ellipse1Back:int = 1;
    2314. 

  2314.         private var ellipse2Back:int = 1;
    2315. 

  2315.         private var depth:int = 1000;
    2316. 

  2316.         
    2317. 

  2317.         public function ZAxisExample1():void {
    2318. 

  2318.             
    2319. 

  2319.             var ellipse1 = drawEllipse((this.stage.stageWidth / 2) - 100, 
    2320. 

  2320.                                       (this.stage.stageHeight / 2), 100, 80, 10);
    2321. 

  2321.             var ellipse2 = drawEllipse((this.stage.stageWidth / 2) + 100, 
    2322. 

  2322.                                       (this.stage.stageHeight / 2), 100, 80, 300);
    2323. 

  2323. 

  2324.             this.addChild(ellipse1);
    2325. 

  2325.             this.addChild(ellipse2);
    2326. 

  2326.             
    2327. 

  2327.             ellipse1.addEventListener(Event.ENTER_FRAME, ellipse1FrameHandler);
    2328. 

  2328.             ellipse2.addEventListener(Event.ENTER_FRAME, ellipse2FrameHandler);
    2329. 

  2329.         }
    2330. 

  2330. 

  2331.         private function drawEllipse(x:Number, y:Number, w:Number, h:Number, z:Number):Shape {
    2332. 

  2332.             var s:Shape = new Shape();                            
    2333. 

  2333.             s.z = z;
    2334. 

  2334.             s.graphics.beginFill(0xFF0000);
    2335. 

  2335.             s.graphics.lineStyle(2);
    2336. 

  2336.             s.graphics.drawEllipse(x, y, w, h);
    2337. 

  2337.             s.graphics.endFill();
    2338. 

  2338.             return s;
    2339. 

  2339.         }
    2340. 

  2340. 

  2341.         private function ellipse1FrameHandler(e:Event):void {
    2342. 

  2342.             ellipse1Back = setDepth(e, ellipse1Back);
    2343. 

  2343.             e.currentTarget.z += ellipse1Back * 10;
    2344. 

  2344.         }
    2345. 

  2345. 

  2346.         private function ellipse2FrameHandler(e:Event):void {
    2347. 

  2347.             ellipse2Back = setDepth(e, ellipse2Back);
    2348. 

  2348.             e.currentTarget.z += ellipse2Back * 20;
    2349. 

  2349.         }
    2350. 

  2350. 

  2351.         private function setDepth(e:Event, d:int):int {
    2352. 

  2352.             if(e.currentTarget.z > depth) {
    2353. 

  2353.                 e.currentTarget.z = depth; 
    2354. 

  2354.                 d = -1;
    2355. 

  2355.             }else if (e.currentTarget.z &lt;  0) {
    2356. 

  2356.                 e.currentTarget.z = 0;
    2357. 

  2357.                 d = 1;
    2358. 

  2358.             }
    2359. 

  2359.             return d;
    2360. 

  2360.         }
    2361. 

  2361.     }
    2362. 

  2362. }
    2363. 

  2363. </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.geom.xml#PerspectiveProjection" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.PerspectiveProjection</linktext></link><link href="flash.geom.xml#Matrix3D" class="- topic/link "><linktext class="- topic/linktext ">flash.geom.Matrix3D</linktext></link><link href="flash.display.xml#DisplayObject/transform" class="- topic/link "><linktext class="- topic/linktext ">transform</linktext></link></related-links></apiValue><apiValue id="flash.display:DisplayObject:blendShader:set" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">blendShader</apiName><shortdesc class="- topic/shortdesc ">
    2364. 

  2364.      设置用于混合前景和背景的着色器。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="write" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:Shader</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当着色器输出类型与此操作不兼容时（着色器必须指定 <codeph class="+ topic/ph pr-d/codeph ">pixel4</codeph> 输出）。
    2365. 

  2365.      
    2366. 

  2366.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当着色器指定的图像输入少于两个，或者前两个输入不是 <codeph class="+ topic/ph pr-d/codeph ">image4</codeph> 输入时。
    2367. 

  2367.      
    2368. 

  2368.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当着色器指定了未提供的图像输入时。
    2369. 

  2369.      
    2370. 

  2370.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当使用 ByteArray 或 Vector.&lt;Number> 实例作为输入，并且没有为 ShaderInput 指定 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 属性或指定的值与输入对象中的数据量不匹配时。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph ">ShaderInput.input</codeph> 属性。
    2371. 

  2371.      
    2372. 

  2372.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2373. 

  2373.      设置用于混合前景和背景的着色器。当 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph> 时，将使用指定的着色器为显示对象创建混合模式输出。
    2374. 

  2374.      
    2375. 

  2375.      <p class="- topic/p ">如果将显示对象的 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性设置为 Shader 实例，则会将显示对象的 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性自动设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>。如果设置了 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性（这会将 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>），则 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性的值会发生变化，只需将 <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph> 即可将混合模式重置为使用混合着色器。除非要更改用于混合模式的着色器，否则无需再次设置 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性。</p>
    2376. 

  2376.      
    2377. 

  2377.      <p class="- topic/p ">赋予 <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> 属性的 Shader 至少必须指定两个 <codeph class="+ topic/ph pr-d/codeph ">image4</codeph> 输入。<b class="+ topic/ph hi-d/b ">无需</b>使用关联 ShaderInput 对象的 <codeph class="+ topic/ph pr-d/codeph ">input</codeph> 属性在代码中指定输入。会自动使用背景显示对象作为第一个输入（<codeph class="+ topic/ph pr-d/codeph ">index</codeph> 为 0 的输入）。使用前景显示对象作为第二个输入（<codeph class="+ topic/ph pr-d/codeph ">index</codeph> 为 1 的输入）。用作混合着色器的着色器可以指定超过两个输入。在这种情况下，必须通过设置其 ShaderInput 实例的 <codeph class="+ topic/ph pr-d/codeph ">input</codeph> 属性来指定任何附加输入。</p>
    2378. 

  2378.      
    2379. 

  2379.      <p class="- topic/p ">将 Shader 实例赋予此属性时，会在内部复制着色器。混合操作将使用该内部副本，而不是对原始着色器的引用。对着色器进行的任何更改（比如更改参数值、输入或字节代码）不会应用于所复制的用于混合模式的着色器。</p>
    2380. 

  2380.      
    2381. 

  2381.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#BlendMode" class="- topic/link "><linktext class="- topic/linktext ">flash.display.BlendMode</linktext></link><link href="flash.display.xml#Shader" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Shader</linktext></link><link href="flash.display.xml#ShaderInput" class="- topic/link "><linktext class="- topic/linktext ">flash.display.ShaderInput</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.display:Loader" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Loader</apiName><shortdesc class="- topic/shortdesc ">
    2382. 

  2382.  Loader 类可用于加载 SWF 文件或图像（JPG、PNG 或 GIF）文件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.display:DisplayObjectContainer</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2383. 

  2383.  Loader 类可用于加载 SWF 文件或图像（JPG、PNG 或 GIF）文件。使用 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法来启动加载。被加载的显示对象将作为 Loader 对象的子级添加。
    2384. 

  2384.  
    2385. 

  2385.  <p class="- topic/p ">使用 URLLoader 类加载文本或二进制数据。</p>
    2386. 

  2386.  
    2387. 

  2387.  <p class="- topic/p ">Loader 类会覆盖其继承的以下方法，因为 Loader 对象只能有一个子显示对象 -- 其加载的显示对象。调用以下方法将引发异常：<codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">addChildAt()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">removeChild()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">removeChildAt()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">setChildIndex()</codeph>。要删除被加载的显示对象，必须从其父 DisplayObjectContainer 子级数组中删除 <i class="+ topic/ph hi-d/i ">Loader</i> 对象。 </p>
    2388. 

  2388.  
    2389. 

  2389.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>在 ActionScript 3.0 中使用的不是 ActionScript 2.0 MovieClipLoader 和 LoadVars 类，而是 Loader 和 URLLoader 类。</p>
    2390. 

  2390.  
    2391. 

  2391.  <p class="- topic/p ">在使用 Loader 类时，请考虑 Flash Player 和 Adobe AIR 的安全模型： </p>
    2392. 

  2392.  
    2393. 

  2393.  <ul class="- topic/ul "><li class="- topic/li ">您可以加载来自任何可访问源的内容。 </li><li class="- topic/li ">如果执行调用的 SWF 文件位于网络沙箱中并且要加载的文件是本地的，则不允许加载。 </li><li class="- topic/li ">如果加载的内容为用 ActionScript 3.0 编写的 SWF 文件，那么除非可以通过调用加载的内容文件中的 <codeph class="+ topic/ph pr-d/codeph ">System.allowDomain()</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">System.allowInsecureDomain()</codeph> 方法来允许跨脚本排列，否则另一个安全沙箱中的 SWF 文件不能对它执行跨脚本操作。</li><li class="- topic/li ">如果被加载的内容为 AVM1 SWF 文件（用 ActionScript 1.0 或 2.0 编写），则 AVM2 SWF 文件（用 ActionScript 3.0 编写）不能对它执行跨脚本操作。但是，可以通过使用 LocalConnection 类在两个 SWF 文件之间实现通信。</li><li class="- topic/li ">如果加载的内容为图像，则安全沙箱之外的 SWF 文件将无法访问其数据，除非该 SWF 文件的域包含在该图像的原始域上的 URL 策略文件中。</li><li class="- topic/li ">在只能与本地文件系统的内容交互的沙箱中的影片剪辑不能对只能与远程内容交互的沙箱中的影片剪辑使用脚本，反之亦然。 </li><li class="- topic/li ">无法连接到常用的保留端口。有关已阻止的端口的完整列表，请参阅《ActionScript 3.0 开发人员指南》<i class="+ topic/ph hi-d/i "/>中的“限制网络 API”。 </li></ul>
    2394. 

  2394.  
    2395. 

  2395.  <p class="- topic/p ">但在 AIR 中，<codeph class="+ topic/ph pr-d/codeph ">application</codeph> 安全沙箱中的内容（使用 AIR 应用程序安装的内容）不受这些安全限制的约束。</p>
    2396. 

  2396.  
    2397. 

  2397.  <p class="- topic/p ">有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：<xref href="http://www.adobe.com/go/devnet_security_cn" scope="external" class="- topic/xref ">安全性</xref>。</p>
    2398. 

  2398.  
    2399. 

  2399.  <p class="- topic/p ">当从不受信任的源（如除 Loader 对象的根 SWF 文件以外的域）加载 SWF 文件时，您可能需要为 Loader 对象定义蒙版，以防止将加载的内容（Loader 对象的子级）绘画到该蒙版之外的舞台部分中，如以下代码所示：</p>
    2400. 

  2400.  
    2401. 

  2401.  <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">import flash.display.~~;
    2402. 

  2402.  import flash.net.URLRequest;
    2403. 

  2403.  var rect:Shape = new Shape();
    2404. 

  2404.  rect.graphics.beginFill(0xFFFFFF);
    2405. 

  2405.  rect.graphics.drawRect(0, 0, 100, 100);
    2406. 

  2406.  rect.graphics.endFill();
    2407. 

  2407.  addChild(rect);
    2408. 

  2408.  var ldr:Loader = new Loader();
    2409. 

  2409.  ldr.mask = rect;
    2410. 

  2410.  var url:String = "http://www.unknown.example.com/content.swf";
    2411. 

  2411.  var urlReq:URLRequest = new URLRequest(url);
    2412. 

  2412.  ldr.load(urlReq);
    2413. 

  2413.  addChild(ldr);
    2414. 

  2414.  </codeblock>
    2415. 

  2415.  
    2416. 

  2416.  </apiDesc><example conref="examples\LoaderExample.as" class="- topic/example "> 下例用 LoaderExample 类来说明如何使用各种事件侦听器。执行下列步骤可完成该任务：
    2417. 

  2417.  <ol class="- topic/ol "><li class="- topic/li ">创建 <codeph class="+ topic/ph pr-d/codeph ">url</codeph> 属性，它是图像文件的位置和名称</li><li class="- topic/li ">在 <codeph class="+ topic/ph pr-d/codeph ">LoaderExample</codeph> 构造函数中，创建一个新的 Loader 对象，名为 <codeph class="+ topic/ph pr-d/codeph ">loader</codeph>，该对象随后被传递给 <codeph class="+ topic/ph pr-d/codeph ">configureListeners()</codeph> 方法，如步骤 3 所述。</li><li class="- topic/li ">构造函数创建一个 URLRequest 对象的新实例 <codeph class="+ topic/ph pr-d/codeph ">request</codeph>，该实例带有传递的 <codeph class="+ topic/ph pr-d/codeph ">url</codeph>，这样，就可以知道文件的名称和位置。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">request</codeph> 对象传递给 <codeph class="+ topic/ph pr-d/codeph ">loader</codeph> 对象的 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法，该方法会将图像加载到显示列表上。</li><li class="- topic/li ">为加载器上的 <codeph class="+ topic/ph pr-d/codeph ">click</codeph> 事件注册 <codeph class="+ topic/ph pr-d/codeph ">clickHandler</codeph> 事件侦听器。在单击鼠标后，便可卸载加载的图像。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">configureListeners()</codeph> 方法通过以下方法添加 7 个事件侦听器：
    2418. 

  2418.   <ul class="- topic/ul "><li class="- topic/li ">图像加载完成时，执行 <codeph class="+ topic/ph pr-d/codeph ">completeHandler()</codeph> 方法。</li><li class="- topic/li ">图像不是在本地加载，并且只有在网络请求可用并可被 Flash Player 检测到的情况下，才会执行 <codeph class="+ topic/ph pr-d/codeph ">httpStatusHandler()</codeph> 方法。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">initHandler()</codeph> 方法在 <codeph class="+ topic/ph pr-d/codeph ">completeHandler()</codeph> 方法之前、<codeph class="+ topic/ph pr-d/codeph ">progressHandler()</codeph> 方法之后执行。通常，<codeph class="+ topic/ph pr-d/codeph ">init</codeph> 事件在加载 SWF 文件时更有用。</li><li class="- topic/li ">图像文件不可用或不可访问，则执行 <codeph class="+ topic/ph pr-d/codeph ">ioErrorHandler()</codeph> 方法。</li><li class="- topic/li ">首次打开图像文件时，执行 <codeph class="+ topic/ph pr-d/codeph ">openHandler()</codeph> 方法。</li><li class="- topic/li ">图像文件开始下载和下载完成时，执行 <codeph class="+ topic/ph pr-d/codeph ">progressHandler()</codeph> 方法。</li><li class="- topic/li ">通过使用用户单击图像时使用的 <codeph class="+ topic/ph pr-d/codeph ">unload()</codeph> 方法卸载图像时，执行 <codeph class="+ topic/ph pr-d/codeph ">unLoadHandler()</codeph> 方法。</li></ul>
    2419. 

  2419.   </li></ol>
    2420. 

  2420.  <p class="- topic/p "> 请牢记以下要求：</p>
    2421. 

  2421.  
    2422. 

  2422.  <ul class="- topic/ul "><li class="- topic/li ">该示例要求您将名为 Image.gif 的文件放置在与经过编译的 SWF 文件相同的目录中。使用具有一个适合主 SWF 文件尺寸的区域的图像。</li><li class="- topic/li ">虽然该示例使用可用于 LoaderInfo 对象的所有事件，但是在大部分情况下，只需要一个子集。特别是在只加载图像文件时，<codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件（还可能是 <codeph class="+ topic/ph pr-d/codeph ">ioError</codeph> 事件）足够用于加载本地图像。</li></ul>
    2423. 

  2423.  
    2424. 

  2424. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2425. 

  2425. package {
    2426. 

  2426.     import flash.display.Loader;
    2427. 

  2427.     import flash.display.Sprite;
    2428. 

  2428.     import flash.events.*;
    2429. 

  2429.     import flash.net.URLRequest;
    2430. 

  2430. 

  2431.     public class LoaderExample extends Sprite {
    2432. 

  2432.         private var url:String = "Image.gif";
    2433. 

  2433. 

  2434.         public function LoaderExample() {
    2435. 

  2435.             var loader:Loader = new Loader();
    2436. 

  2436.             configureListeners(loader.contentLoaderInfo);
    2437. 

  2437.             loader.addEventListener(MouseEvent.CLICK, clickHandler);
    2438. 

  2438. 

  2439.             var request:URLRequest = new URLRequest(url);
    2440. 

  2440.             loader.load(request);
    2441. 

  2441. 

  2442.             addChild(loader);
    2443. 

  2443.         }
    2444. 

  2444. 

  2445.         private function configureListeners(dispatcher:IEventDispatcher):void {
    2446. 

  2446.             dispatcher.addEventListener(Event.COMPLETE, completeHandler);
    2447. 

  2447.             dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
    2448. 

  2448.             dispatcher.addEventListener(Event.INIT, initHandler);
    2449. 

  2449.             dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    2450. 

  2450.             dispatcher.addEventListener(Event.OPEN, openHandler);
    2451. 

  2451.             dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
    2452. 

  2452.             dispatcher.addEventListener(Event.UNLOAD, unLoadHandler);
    2453. 

  2453.         }
    2454. 

  2454. 

  2455.         private function completeHandler(event:Event):void {
    2456. 

  2456.             trace("completeHandler: " + event);
    2457. 

  2457.         }
    2458. 

  2458. 

  2459.         private function httpStatusHandler(event:HTTPStatusEvent):void {
    2460. 

  2460.             trace("httpStatusHandler: " + event);
    2461. 

  2461.         }
    2462. 

  2462. 

  2463.         private function initHandler(event:Event):void {
    2464. 

  2464.             trace("initHandler: " + event);
    2465. 

  2465.         }
    2466. 

  2466. 

  2467.         private function ioErrorHandler(event:IOErrorEvent):void {
    2468. 

  2468.             trace("ioErrorHandler: " + event);
    2469. 

  2469.         }
    2470. 

  2470. 

  2471.         private function openHandler(event:Event):void {
    2472. 

  2472.             trace("openHandler: " + event);
    2473. 

  2473.         }
    2474. 

  2474. 

  2475.         private function progressHandler(event:ProgressEvent):void {
    2476. 

  2476.             trace("progressHandler: bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
    2477. 

  2477.         }
    2478. 

  2478. 

  2479.         private function unLoadHandler(event:Event):void {
    2480. 

  2480.             trace("unLoadHandler: " + event);
    2481. 

  2481.         }
    2482. 

  2482. 

  2483.         private function clickHandler(event:MouseEvent):void {
    2484. 

  2484.             trace("clickHandler: " + event);
    2485. 

  2485.             var loader:Loader = Loader(event.target);
    2486. 

  2486.             loader.unload();
    2487. 

  2487.         }
    2488. 

  2488.     }
    2489. 

  2489. }
    2490. 

  2490. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#LoaderInfo" class="- topic/link "><linktext class="- topic/linktext ">flash.display.LoaderInfo</linktext></link><link href="flash.net.xml#URLLoader" class="- topic/link "><linktext class="- topic/linktext ">flash.net.URLLoader</linktext></link><link href="flash.display.xml#DisplayObject" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObject</linktext></link></related-links><apiConstructor id="flash.display:Loader:Loader" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Loader</apiName><shortdesc class="- topic/shortdesc ">
    2491. 

  2491.      创建一个可用于加载文件（如 SWF、JPEG、GIF 或 PNG 文件）的 Loader 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>Need wording on parent/child relationships, root DisplayObjects, and so on.
    2492. 

  2492.       
    2493. 

  2493.       </internal></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2494. 

  2494.      创建一个可用于加载文件（如 SWF、JPEG、GIF 或 PNG 文件）的 Loader 对象。调用 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法可将资源加载为 Loader 实例的子级。然后，可以将 Loader 对象添加到显示列表（例如，通过使用 DisplayObjectContainer 实例的 <codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph> 方法）。这样，资源在加载时会出现在舞台上。
    2495. 

  2495.      
    2496. 

  2496.      <p class="- topic/p ">您也可以在“offlist”模式下使用 Loader 实例，这样就不会将 Loader 实例添加到显示列表的显示对象容器中。在该模式下，Loader 实例可以用于加载包含应用程序的其它模块的 SWF 文件。 </p>
    2497. 

  2497.      
    2498. 

  2498.      <p class="- topic/p ">要检测何时可以完成 SWF 文件的加载，您可以使用与 Loader 对象的 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 属性相关联的 LoaderInfo 对象的事件。此时，便可执行模块 SWF 文件中的代码以初始化和启动模块。在 offlist 模式下，还可以使用 Loader 实例来加载包含组件或媒体资源的 SWF 文件。同时，您可以使用 LoaderInfo 对象事件通知来检测组件的加载何时完成。此时，应用程序可以通过实例化代表这些组件和资源的 ActionScript 3.0 类来开始使用 SWF 文件库中的组件和媒体资源。</p>
    2499. 

  2499.      
    2500. 

  2500.      <p class="- topic/p ">要确定 Loader 对象的状态，请监视与 Loader 对象的 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 属性相关联的 LoaderInfo 对象的以下事件：</p>
    2501. 

  2501.      
    2502. 

  2502.      <ul class="- topic/ul "><li class="- topic/li ">在加载开始时调度 <codeph class="+ topic/ph pr-d/codeph ">open</codeph> 事件。</li><li class="- topic/li ">在无法加载文件或在加载过程中出现错误时，调度 <codeph class="+ topic/ph pr-d/codeph ">ioError</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">securityError</codeph> 事件。 </li><li class="- topic/li ">在文件加载过程中会不断引发 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 事件。</li><li class="- topic/li ">在文件完成下载但加载的影片剪辑的方法和属性尚不可用时调度 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件。 </li><li class="- topic/li ">在可以访问加载的 SWF 文件的属性和方法，即可以开始操作加载的 SWF 文件时调度 <codeph class="+ topic/ph pr-d/codeph ">init</codeph> 事件。在 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 处理函数之前调度该事件。在流式 SWF 文件中，<codeph class="+ topic/ph pr-d/codeph ">init</codeph> 事件可以在明显早于 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件的时间发生。在大多数情况下，请使用 <codeph class="+ topic/ph pr-d/codeph ">init</codeph> 处理函数。</li></ul>
    2503. 

  2503.      
    2504. 

  2504.      </apiDesc></apiConstructorDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Loader/load()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Loader.load()</linktext></link><link href="flash.display.xml#LoaderInfo" class="- topic/link "><linktext class="- topic/linktext ">flash.display.LoaderInfo</linktext></link></related-links></apiConstructor><apiOperation id="flash.display:Loader:close" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">close</apiName><shortdesc class="- topic/shortdesc ">
    2505. 

  2505.      取消当前正在对 Loader 实例执行的 load() 方法操作。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2506. 

  2506.      取消当前正在对 Loader 实例执行的 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法操作。
    2507. 

  2507.      
    2508. 

  2508.      </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Loader/load()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Loader.load()</linktext></link></related-links></apiOperation><apiOperation id="flash.display:Loader:loadBytes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">loadBytes</apiName><shortdesc class="- topic/shortdesc ">
    2509. 

  2509.      从 ByteArray 对象中所存储的二进制数据中加载。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 ByteArray 对象的 <codeph class="+ topic/ph pr-d/codeph ">length</codeph> 属性不大于 0。
    2510. 

  2510.      
    2511. 

  2511.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 参数的 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">securityDomain</codeph> 属性为非空。
    2512. 

  2512.      
    2513. 

  2513.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IllegalOperationError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IllegalOperationError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 参数的 <codeph class="+ topic/ph pr-d/codeph ">requestedContentParent</codeph> 属性为 <codeph class="+ topic/ph pr-d/codeph ">Loader</codeph>。
    2514. 

  2514.      
    2515. 

  2515.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IllegalOperationError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IllegalOperationError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">LoaderContext.parameters</codeph> 参数设置为非 null，并且具有不是字符串的某些值。
    2516. 

  2516.      
    2517. 

  2517.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IllegalOperationError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IllegalOperationError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果提供的 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 属性的 <codeph class="+ topic/ph pr-d/codeph ">applicationDomain</codeph> 属性来自不允许的域。
    2518. 

  2518.      
    2519. 

  2519.       </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">SecurityError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">SecurityError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">无法连接到常用的保留端口。有关已阻止的端口的完整列表，请参阅《ActionScript 3.0 开发人员指南》<i class="+ topic/ph hi-d/i "/>中的“限制网络 API”。
    2520. 

  2520.      
    2521. 

  2521.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">SecurityError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">SecurityError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bytes</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.utils:ByteArray</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个 ByteArray 对象。ByteArray 的内容可以采用受 Loader 类支持的任何文件格式：SWF、GIF、JPEG 或 PNG。
    2522. 

  2522.      
    2523. 

  2523.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">context</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.system:LoaderContext</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个 LoaderContext 对象。只应用 LoaderContext 对象的 <codeph class="+ topic/ph pr-d/codeph ">applicationDomain</codeph> 属性；不应用 LoaderContext 对象的 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">securityDomain</codeph> 属性。 
    2524. 

  2524.      
    2525. 

  2525.      <p class="- topic/p ">如果未指定 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 参数或者该参数引用了 null 对象，则内容将加载到当前的安全域（在 Flash Player 安全文档中称为“导入加载”的进程）中。具体来说，如果执行加载的 SWF 文件通过将远程 SWF 并入到其代码中来信任远程 SWF，则执行加载的 SWF 可直接将其导入到自己的安全域中。</p>
    2526. 

  2526.      
    2527. 

  2527.      <p class="- topic/p ">有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：<xref href="http://www.adobe.com/go/devnet_security_cn" scope="external" class="- topic/xref ">安全性</xref>。</p>
    2528. 

  2528.      
    2529. 

  2529.      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2530. 

  2530.      从 ByteArray 对象中所存储的二进制数据中加载。
    2531. 

  2531.      
    2532. 

  2532.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">loadBytes()</codeph> 方法是异步的。必须等待“init”事件出现才能访问已加载对象的属性。</p>
    2533. 

  2533.      
    2534. 

  2534.      <p class="- topic/p ">使用此方法时，请考虑 Loader 类说明中描述的 Flash Player 安全模型。 </p>
    2535. 

  2535.      
    2536. 

  2536.      </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.utils.xml#ByteArray" class="- topic/link "><linktext class="- topic/linktext ">flash.utils.ByteArray</linktext></link><link href="flash.system.xml#LoaderContext/applicationDomain" class="- topic/link "><linktext class="- topic/linktext ">flash.system.LoaderContext.applicationDomain</linktext></link></related-links><adobeApiEvent id="flash.display:Loader:loadBytes_asyncError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">asyncError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:AsyncErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">LoaderContext.requestedContentParent</codeph> 属性已指定并且不可能将加载的内容作为子级添加到指定的 DisplayObjectContainer，则由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。如果加载的内容为 <codeph class="+ topic/ph pr-d/codeph ">flash.display.AVM1Movie</codeph>，或者 <codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph> 调用 requestedContentParent 时引发了错误，则可能发生这种情况。
    2537. 

  2537.      
    2538. 

  2538.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">如果 LoaderContext.requestedContentParent 属性已指定并且不可能将加载的内容作为子级添加到指定的 DisplayObjectContainer，则由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_complete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">complete</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当操作完成时由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。<codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件始终在 <codeph class="+ topic/ph pr-d/codeph ">init</codeph> 事件之后调度。
    2539. 

  2539.      
    2540. 

  2540.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当操作完成时由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_init" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">init</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当已加载数据的属性和方法可以访问时由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。<codeph class="+ topic/ph pr-d/codeph ">init</codeph> 事件始终在 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件之前。
    2541. 

  2541.      
    2542. 

  2542.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当已加载数据的属性和方法可以访问时由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_ioError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">ioError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当运行时无法分析字节数组中的数据时由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。 
    2543. 

  2543.      
    2544. 

  2544.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当运行时无法分析字节数组中的数据时由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_open" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">open</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当操作开始时由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。
    2545. 

  2545.      
    2546. 

  2546.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当操作开始时由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_progress" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">progress</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ProgressEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当数据传输至内存时由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。 
    2547. 

  2547.      
    2548. 

  2548.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当数据传输至内存时由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_securityError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">securityError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:SecurityErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">LoaderContext.requestedContentParent</codeph> 属性已指定并且 <codeph class="+ topic/ph pr-d/codeph ">LoaderContext.requestedContentParent</codeph> 的安全沙箱不能访问加载的 SWF，则由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。
    2549. 

  2549.      
    2550. 

  2550.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">如果 LoaderContext.requestedContentParent 属性已指定并且 LoaderContext.requestedContentParent 的安全沙箱不能访问加载的 SWF，则由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.display:Loader:loadBytes_unload" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">unload</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">在删除所加载的对象时，由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。
    2551. 

  2551.      
    2552. 

  2552.      </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">在删除所加载的对象时，由 contentLoaderInfo 对象调度。</shortdesc></adobeApiEvent></apiOperation><apiOperation id="flash.display:Loader:loadFilePromise" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">loadFilePromise</apiName><shortdesc class="- topic/shortdesc ">
    2553. 

  2553. 	 加载 IFilePromise 实例。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 参数的 <codeph class="+ topic/ph pr-d/codeph ">requestedContentParent</codeph> 属性为 <codeph class="+ topic/ph pr-d/codeph ">Loader</codeph>。
    2554. 

  2554.      
    2555. 

  2555.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IllegalOperationError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IllegalOperationError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">LoaderContext.parameters</codeph> 参数设置为非 null，并且具有不是字符串的某些值。
    2556. 

  2556.      
    2557. 

  2557.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IllegalOperationError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IllegalOperationError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果作为参数传递的 <codeph class="+ topic/ph pr-d/codeph ">IFilePromise</codeph> 对象为 null。
    2558. 

  2558.      
    2559. 

  2559.      </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">promise</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.desktop:IFilePromise</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">IFilePromise 对象。对象的数据源可以采用 Loader 类支持的任何文件格式：SWF、GIF、JPEG 或 PNG。
    2560. 

  2560. 	 
    2561. 

  2561. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">context</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.system:LoaderContext</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个 LoaderContext 对象。只应用 LoaderContext 对象的 <codeph class="+ topic/ph pr-d/codeph ">applicationDomain</codeph> 属性；不应用 LoaderContext 对象的 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">securityDomain</codeph> 属性。 
    2562. 

  2562. 	 
    2563. 

  2563. 	 <p class="- topic/p ">如果未指定 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 参数或者该参数引用了 null 对象，则内容将加载到当前的安全域（在 Flash Player 安全文档中称为“导入加载”的进程）中。具体来说，如果执行加载的 SWF 文件通过将远程 SWF 并入到其代码中来信任远程 SWF，则执行加载的 SWF 可直接将其导入到自己的安全域中。</p>
    2564. 

  2564. 	 
    2565. 

  2565. 	 <p class="- topic/p ">有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：<xref href="http://www.adobe.com/go/devnet_security_cn" scope="external" class="- topic/xref ">安全性</xref>。</p>
    2566. 

  2566. 	 
    2567. 

  2567. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2568. 

  2568. 	 加载 IFilePromise 实例。
    2569. 

  2569. 	 
    2570. 

  2570.  	 <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">loadFilePromise</codeph> 方法使用 <codeph class="+ topic/ph pr-d/codeph ">IFilePromise</codeph> 对象并加载二进制数据。如果数据是渐进流，例如视频，则在访问加载的对象的属性之前等待“init”或 progress 事件。否则，等待 complete 事件以确保完全加载了数据。</p>
    2571. 

  2571. 	 
    2572. 

  2572. 	 <p class="- topic/p ">使用此方法时，请考虑 Loader 类说明中描述的 Flash Player 安全模型。 </p>
    2573. 

  2573. 	 
    2574. 

  2574. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#MediaPromise" class="- topic/link "><linktext class="- topic/linktext ">MediaPromise</linktext></link><link href="flash.media.xml#CameraRoll/browseForImage()" class="- topic/link "><linktext class="- topic/linktext ">CameraRoll.browseForImage()</linktext></link><link href="flash.media.xml#CameraUI" class="- topic/link "><linktext class="- topic/linktext ">CameraUI</linktext></link></related-links><adobeApiEvent id="flash.display:Loader:loadFilePromise_asyncError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">asyncError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:AsyncErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果 <codeph class="+ topic/ph pr-d/codeph ">LoaderContext.requestedContentParent</codeph> 属性已指定并且不可能将加载的内容作为子级添加到指定的 DisplayObjectContainer，则由 <codeph class="+ topic/ph pr-d/codeph ">contentLoaderInfo</codeph> 对象调度。如果加载的内容为 <codeph class="+ topic/ph pr-d/codeph ">flash.display.AVM1Movie</
    2575.