/frameworks/projects/playerglobal/bundles/fr_FR/docs/flash.display.xml
XML | 2385 lines | 1837 code | 530 blank | 18 comment | 0 complexity | 71c198cbd5d3d92f66c3894446127364 MD5 | raw file
Possible License(s): Apache-2.0
- <?xml version="1.0" encoding="UTF-8"?>
- <!--
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
- <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 ">
-
- L’objet FrameLabel contient des propriétés qui spécifient un numéro d’image et le nom d’étiquette correspondant.</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 ">
-
- L’objet FrameLabel contient des propriétés qui spécifient un numéro d’image et le nom d’étiquette correspondant. La classe Scene inclut la propriété <codeph class="+ topic/ph pr-d/codeph ">labels</codeph>, qui correspond à un tableau d’objets FrameLabel pour la séquence.
-
- </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 ">
- Numéro de l’image qui contient l’étiquette.</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 ">
- Numéro de l’image qui contient l’étiquette.
- </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 ">
- Nom de l’étiquette.</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 ">
- Nom de l’étiquette.
- </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 ">
- La classe InteractiveObject correspond à la classe de base abstraite de l’ensemble des objets d’affichage avec lesquels l’utilisateur peut interagir à l’aide de la souris, du clavier ou d’autres périphériques de saisie utilisateur.</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 ">
- La classe InteractiveObject correspond à la classe de base abstraite de l’ensemble des objets d’affichage avec lesquels l’utilisateur peut interagir à l’aide de la souris, du clavier ou d’autres périphériques de saisie utilisateur.
-
- <p class="- topic/p ">Il est impossible d’instancier directement la classe InteractiveObject. Tout appel au constructeur <codeph class="+ topic/ph pr-d/codeph ">new InteractiveObject()</codeph> renvoie une exception <codeph class="+ topic/ph pr-d/codeph ">ArgumentError</codeph>.</p>
-
- <p class="- topic/p ">La classe InteractiveObject n’inclut pas d’API pour le rendu de contenu à l’écran. Pour créer une sous-classe personnalisée de la classe InteractiveObject, étendez l’une des sous-classes disposant d’API pour le rendu du contenu à l’écran, telles que Sprite, SimpleButton, TextField ou MovieClip.</p>
-
- </apiDesc><example conref="examples\InteractiveObjectExample.as" class="- topic/example "> L’exemple suivant utilise la classe <codeph class="+ topic/ph pr-d/codeph ">InteractiveObjectExample</codeph>, qui en retour utilise la classe <codeph class="+ topic/ph pr-d/codeph ">ChildSprite</codeph> pour dessiner un rectangle et le manipule en fonction des différents événements de la souris. Pour ce faire, procédez comme suit :
- <ol class="- topic/ol "><li class="- topic/li ">Dans le constructeur <codeph class="+ topic/ph pr-d/codeph ">InteractiveObjectExample</codeph>, un nouvel objet ChildSprite de type Sprite appelé <codeph class="+ topic/ph pr-d/codeph ">child</codeph> est créé, qui en retour appelle la méthode de constructeur ChildSprite pour dessiner la forme et ajoute des événements de souris à la forme (comme expliqué au cours des étapes suivantes). L’objet <codeph class="+ topic/ph pr-d/codeph ">child</codeph> est ajouté dans la partie supérieure de la liste d’affichage aux coordonnées <i class="+ topic/ph hi-d/i ">x = 0, y = 0</i>. </li><li class="- topic/li ">Dans la classe <codeph class="+ topic/ph pr-d/codeph ">ChildSprite</codeph>, déclarez les propriétés <codeph class="+ topic/ph pr-d/codeph ">size</codeph> et <codeph class="+ topic/ph pr-d/codeph ">overSize</codeph> qui sont utilisées par la suite par les méthodes <codeph class="+ topic/ph pr-d/codeph ">draw()</codeph> et MouseEvent.</li><li class="- topic/li ">Déclare des propriétés qui définissent la couleur de fond sur orange, la couleur de survol de la souris sur jaune et la couleur clic sur bleu clair.</li><li class="- topic/li ">Dans le constructeur <codeph class="+ topic/ph pr-d/codeph ">ChildSprite</codeph>, un carré orange est dessiné à l’aide des méthodes de la classe Graphics et de la méthode <codeph class="+ topic/ph pr-d/codeph ">draw()</codeph>.</li><li class="- topic/li ">Le constructeur ajoute quatre méthodes d’écouteur d’événements MouseEvent :
-
- <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseOverHandler</codeph> : dessine de nouveau un carré plus grand, de 60x60 pixels, en jaune plus sombre et aux coordonnées d’origine.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseOutHandler</codeph> : rétablit la couleur et la taille d’origine du carré.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseDownHandler</codeph> : dessine de nouveau un carré plus grand, de 60x60 pixels, en bleu clair et aux coordonnées d’origine.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">mouseUpHandler</codeph> : identique à <codeph class="+ topic/ph pr-d/codeph ">mouseOverHandler</codeph>.</li></ul>
- </li></ol>
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- package {
- import flash.display.Sprite;
- public class InteractiveObjectExample extends Sprite {
- public function InteractiveObjectExample() {
- var child:Sprite = new ChildSprite();
- addChild(child);
- }
- }
- }
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- class ChildSprite extends Sprite {
- private var size:uint = 50;
- private var overSize:uint = 60;
- private var backgroundColor:uint = 0xFFCC00;
- private var overColor:uint = 0xCCFF00;
- private var downColor:uint = 0x00CCFF;
- public function ChildSprite() {
- buttonMode = true;
- draw(size, size, backgroundColor);
- addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
- addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
- addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
- addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
- }
- private function draw(w:uint, h:uint, bgColor:uint):void {
- graphics.clear();
- graphics.beginFill(bgColor);
- graphics.drawRect(0, 0, w, h);
- graphics.endFill();
- }
- public function mouseOverHandler(event:MouseEvent):void {
- trace("mouseOverHandler");
- draw(overSize, overSize, overColor);
- }
- public function mouseOutHandler(event:MouseEvent):void {
- trace("mouseOutHandler");
- draw(size, size, backgroundColor);
- }
- public function mouseDownHandler(event:MouseEvent):void {
- trace("mouseDownHandler");
- draw(overSize, overSize, downColor);
- }
- public function mouseUpHandler(event:MouseEvent):void {
- trace("mouseUpHandler");
- draw(overSize, overSize, overColor);
- }
- }
- </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 ">
- Distribué immédiatement après la disparition du clavier logiciel.</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 ">Distribué immédiatement après la disparition du clavier logiciel.
- </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Distribué immédiatement après la disparition du clavier logiciel.
- </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 ">
- Distribué immédiatement après l’affichage du clavier logiciel.</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 ">Distribué immédiatement après l’affichage du clavier logiciel.
- </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Distribué immédiatement après l’affichage du clavier logiciel.
- </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 ">
- Distribué immédiatement avant l’affichage du clavier logiciel.</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 ">Distribué immédiatement avant l’affichage du clavier logiciel.
- </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Distribué immédiatement avant l’affichage du clavier logiciel.
- </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 ">
- Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte.</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 ">
- Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte. Différentes méthodes de saisie de texte peuvent générer cet événement, ce qui inclut les claviers standard, les éditeurs de méthode d’entrée (IME), les systèmes de reconnaissance vocale, voire même la copie de texte simple sans formatage ni ajout de style.
- </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 ">
- Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.
-
- </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 ">
- Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.
-
- </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 ">
- Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application 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 ">
- Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.
-
- </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 ">
- Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.</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 ">
- Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.
-
- <p class="- topic/p ">La propriété dropAction de l’événement indique l’action définie par l’objet cible drag ; une valeur "none" (<codeph class="+ topic/ph pr-d/codeph ">DragActions.NONE</codeph>) indique que l’opération déposer a été annulée ou refusée.</p>
-
- <p class="- topic/p ">Le gestionnaire d’événement <codeph class="+ topic/ph pr-d/codeph ">nativeDragComplete</codeph> est un espace pratique permettant de mettre à jour l’état de l’objet d’affichage déclencheur, notamment en supprimant un élément d’une liste (sur un mouvement de glissement) ou en changeant les propriétés visuelles.</p>
-
- </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 ">
- Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().</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 ">
- Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().
-
- <p class="- topic/p ">Les événements <codeph class="+ topic/ph pr-d/codeph ">nativeDragUpdate</codeph> ne sont pas distribués sous Linux.</p>
-
- </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 ">
- Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().</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 ">
- Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().
-
- </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 ">
- Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites.</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 ">
- Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites.
-
- </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 ">
- Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().</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 ">
- Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().
-
- <p class="- topic/p ">Accédez aux données déposées à l’aide de la propriété <codeph class="+ topic/ph pr-d/codeph ">clipboard</codeph> de l’objet d’événement.</p>
-
- <p class="- topic/p ">Le gestionnaire de cet événement doit régler la propriété <codeph class="+ topic/ph pr-d/codeph ">DragManager.dropAction</codeph> pour fournir des informations à l’objet déclencheur sur l’action glisser effectuée. Si aucune valeur n’est réglée, le DragManager sélectionne une valeur par défaut dans la liste des actions autorisées.</p>
-
- </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 ">
- Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites.</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 ">
- Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites.
-
- <p class="- topic/p ">Les événements <codeph class="+ topic/ph pr-d/codeph ">nativeDragOver</codeph> sont distribués dès que la souris est déplacée. Sous Windows et Mac, ils sont également distribués après quelques secondes, même lorsque la souris n’a pas été déplacée.</p>
-
- <p class="- topic/p ">Gérez les événements <codeph class="+ topic/ph pr-d/codeph ">nativeDragOver</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">nativeDragEnter</codeph> pour permettre à l’objet d’affichage de devenir la cible déposer.</p>
-
- <p class="- topic/p ">Pour déterminer si l’objet d’affichage de distribution peut accepter l’opération déposer, vérifiez si les données dans la propriété <codeph class="+ topic/ph pr-d/codeph ">clipboard</codeph> de l’objet d’événement sont adaptées, et les actions glisser dans la propriété<codeph class="+ topic/ph pr-d/codeph ">allowedActions</codeph>.</p>
-
- </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 ">
- Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites.</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 ">
- Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites.
-
- <p class="- topic/p ">Gérez les événements <codeph class="+ topic/ph pr-d/codeph ">nativeDragEnter</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">nativeDragOver</codeph> pour permettre à l’objet d’affichage de devenir la cible déposer.</p>
-
- <p class="- topic/p ">Pour déterminer si l’objet d’affichage de distribution peut accepter l’opération déposer, vérifiez si les données dans la propriété <codeph class="+ topic/ph pr-d/codeph ">clipboard</codeph> de l’objet d’événement sont adaptées, et les actions glisser dans la propriété<codeph class="+ topic/ph pr-d/codeph ">allowedActions</codeph>.</p>
-
- </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 ">
- Distribué lorsque la valeur de la propriété tabIndex de l’objet change.</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 ">
- Distribué lorsque la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> de l’objet change.
- </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 ">
- Distribué lorsque l’indicateur tabEnabled de l’objet change.</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 ">
- Distribué lorsque l’indicateur <codeph class="+ topic/ph pr-d/codeph ">tabEnabled</codeph> de l’objet change.
- </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 ">
- Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change.</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 ">
- Distribué lorsque la valeur de l’indicateur <codeph class="+ topic/ph pr-d/codeph ">tabChildren</codeph> de l’objet change.
- </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 ">
- Distribué lorsque l’utilisateur relâche une touche.</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 ">
- Distribué lorsque l’utilisateur relâche une touche. La concordance entre les touches et des caractères spécifiques dépend du périphérique et du système d’exploitation. Ce type d’événement est généré lors du mappage, mais avant le traitement d’un éditeur de méthode d’entrée (IME). Les IME permettent d’entrer des caractères, tels que les idéogrammes chinois, que le clavier AZERTY standard ne permet pas de produire. Cet événement se produit après un événement <codeph class="+ topic/ph pr-d/codeph ">keyDown</codeph> et présente les caractéristiques suivantes :
- </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 ">
- Distribué lorsque l’utilisateur appuie sur une touche.</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 ">
- Distribué lorsque l’utilisateur appuie sur une touche. La concordance entre les touches et des caractères spécifiques dépend du périphérique et du système d’exploitation. Ce type d’événement est généré lors du mappage, mais avant le traitement d’un éditeur de méthode d’entrée (IME). Les IME permettent d’entrer des caractères, tels que les idéogrammes chinois, que le clavier AZERTY standard ne permet pas de produire. Cet événement se produit avant l’événement <codeph class="+ topic/ph pr-d/codeph ">keyUp</codeph>.
-
- <p class="- topic/p ">Dans AIR, l’annulation de cet événement empêche le caractère d’être inséré dans un champ de texte. </p>
-
- </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 ">
- Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence 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 ">
- Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.
- </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 ">
- Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence 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 ">
- Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.
- </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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de 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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement <codeph class="+ topic/ph pr-d/codeph ">rightClick</codeph> se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement <codeph class="+ topic/ph pr-d/codeph ">rightMouseDown</codeph>, puis <codeph class="+ topic/ph pr-d/codeph ">rightMouseUp</codeph>. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement <codeph class="+ topic/ph pr-d/codeph ">rightClick</codeph> ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements <codeph class="+ topic/ph pr-d/codeph ">rightmouseDown</codeph> et <codeph class="+ topic/ph pr-d/codeph ">rightmouseUp</codeph>, l’événement <codeph class="+ topic/ph pr-d/codeph ">rightclick</codeph> se produit.
- </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 ">
- Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence 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 ">
- Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.
- </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 ">
- Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence 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 ">
- Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.
- </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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de 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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement <codeph class="+ topic/ph pr-d/codeph ">middleClick</codeph> se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement <codeph class="+ topic/ph pr-d/codeph ">middleMouseDown</codeph>, puis <codeph class="+ topic/ph pr-d/codeph ">middleMouseUp</codeph>. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement <codeph class="+ topic/ph pr-d/codeph ">middleClick</codeph> ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements <codeph class="+ topic/ph pr-d/codeph ">middleMouseDown</codeph> et <codeph class="+ topic/ph pr-d/codeph ">middleMouseUp</codeph>, l’événement <codeph class="+ topic/ph pr-d/codeph ">middleClick</codeph> se produit.
- </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 ">
- Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Bien que le déplacement parallèle de plusieurs doigts soit un mouvement de glissement commun, chaque périphérique ou système d’exploitation peut avoir sa propre méthode de glissement. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les déplace simultanément, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> et un événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> (entre autres) en plus de l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureSwipe</codeph>, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureSwipe</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p ">Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> sont définies sur le point de contact principal. Les propriétés <codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> représentent la distance jusqu’au point de contact où se termine le mouvement de glissement.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> bien que certains périphériques qui utilisent le système d’exploitation Mac OS soient capables d’interpréter un glissement à quatre doigts, cette API prend en charge un glissement à trois doigts uniquement.</p>
- </apiDesc><example conref="..\events\examples\TransformGesture_swipe.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">GESTURE_SWIPE</codeph>. Lorsque l’utilisateur effectue un mouvement de glissement sur le périphérique tactile, myTextField se remplit avec la phase <codeph class="+ topic/ph pr-d/codeph ">all</codeph> (unique phase pour les événements de glissement).
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.GESTURE;
- var mySprite = new Sprite();
- mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
- mySprite.graphics.beginFill(0x336699);
- mySprite.graphics.drawRect(0, 0, 100, 80);
- var myTextField = new TextField();
- myTextField.y = 200;
- addChild(mySprite);
- addChild(myTextField);
- function onSwipe(evt:TransformGestureEvent):void {
- if (evt.offsetX == 1 ) {
- myTextField.text = "right";
- }
- if (evt.offsetY == -1) {
- myTextField.text = "up";
- }
- myTextField.text = evt.phase;
- }
- </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:rollOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement rollOver</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Bien que cette manière d’effectuer un zoom soit commune, chaque périphérique et système d’exploitation peut avoir sa propre méthode de zoom. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur pose ses doigts sur un objet InteractiveObject, puis les écarte, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> et un événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph> (entre autres) en plus de l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureZoom</codeph>, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureZoom</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p ">Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> sont définies sur le point de contact principal. Les propriétés <codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> représentent la distance jusqu’au point de contact où le mouvement de zoom se termine.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\events\examples\TransformGesture_zoom.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">GESTURE_ZOOM</codeph>. Lorsque l’utilisateur effectue un mouvement de zoom sur le périphérique tactile, myTextField se remplit avec la phase actuelle.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.GESTURE;
- var mySprite = new Sprite();
- mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
- mySprite.graphics.beginFill(0x336699);
- mySprite.graphics.drawRect(0, 0, 100, 80);
- var myTextField = new TextField();
- myTextField.y = 200;
- addChild(mySprite);
- addChild(myTextField);
- function onZoom(evt:TransformGestureEvent):void {
- evt.target.scaleX++;
- if (evt.phase==GesturePhase.BEGIN) {
- myTextField.text = "Begin";
- }
- if (evt.phase==GesturePhase.UPDATE) {
- myTextField.text = "Update";
- }
- if (evt.phase==GesturePhase.END) {
- myTextField.text = "End";
- }
- }
- </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement mouseOver</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter).</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 ">
- Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). Bien que cette manière d’effectuer une rotation soit commune, chaque périphérique et système d’exploitation peut avoir sa propre méthode de rotation. Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> et un événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph> (entre autres) en plus de l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureRotate</codeph>, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureRotate</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p ">Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> sont définies sur le point de contact principal. Les propriétés <codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> représentent la distance jusqu’au point de contact où le mouvement de rotation se termine.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\events\examples\TransformGestureEventExample.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">GESTURE_ROTATE</codeph>. Lorsque l’utilisateur effectue un mouvement de rotation sur le périphérique tactile, mySprite pivote et myTextField se remplit avec la phase actuelle.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.GESTURE;
- var mySprite = new Sprite();
- mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
- mySprite.graphics.beginFill(0x336699);
- mySprite.graphics.drawRect(0, 0, 100, 80);
- var myTextField = new TextField();
- myTextField.y = 200;
- addChild(mySprite);
- addChild(myTextField);
- function onRotate(evt:TransformGestureEvent):void {
- evt.target.rotation -= 45;
- if (evt.phase==GesturePhase.BEGIN) {
- myTextField.text = "Begin";
- }
- if (evt.phase==GesturePhase.UPDATE) {
- myTextField.text = "Update";
- }
- if (evt.phase==GesturePhase.END) {
- myTextField.text = "End";
- }
- }
- </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement mouseOver</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu).</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 ">
- Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements de souris.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, puis appuie brièvement dessus avec un doigt, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> et un événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph> (entre autres) en plus de l’événement <codeph class="+ topic/ph pr-d/codeph ">gesturePressAndTap</codeph>, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">gesturePressAndTap</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p ">Lors de la gestion des propriétés de l’objet d’événement, notez que les propriétés <codeph class="+ topic/ph pr-d/codeph ">localX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">localY</codeph> sont définies sur le point de contact principal (l’« appui »). Les propriétés <codeph class="+ topic/ph pr-d/codeph ">offsetX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">offsetY</codeph> représentent la distance au point de contact secondaire (l’« appui bref »).</p>
- </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement mouseOver</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> et comme un événement <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace ses doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, un événement <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">gesturePan</codeph>, ou tous ces événements si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">gesturePan</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\events\examples\TransformGesture_pan.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">GESTURE_PAN</codeph>. Lorsque l’utilisateur effectue un mouvement de panoramique sur le périphérique tactile, myTextField se remplit avec la phase actuelle.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.GESTURE;
- var mySprite = new Sprite();
- mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
- mySprite.graphics.beginFill(0x336699);
- mySprite.graphics.drawRect(0, 0, 100, 80);
- var myTextField = new TextField();
- myTextField.y = 200;
- addChild(mySprite);
- addChild(myTextField);
- function onPan(evt:TransformGestureEvent):void {
- evt.target.localX++;
- if (evt.phase==GesturePhase.BEGIN) {
- myTextField.text = "Begin";
- }
- if (evt.phase==GesturePhase.UPDATE) {
- myTextField.text = "Update";
- }
- if (evt.phase==GesturePhase.END) {
- myTextField.text = "End";
- }
- }
- </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement mouseOver</linktext></link><link href="flash.display.xml#InteractiveObject/event:touchOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire).</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 ">
- Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur appuie brièvement avec deux doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">gestureTwoFingerTap</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">gestureTwoFingerTap</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:doubleClick" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire).</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 ">
- Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur appuie brièvement avec deux doigts sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchTap</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchTap</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\ui\examples\Multitouch_inputMode.as" class="- topic/example "> L’exemple suivant affiche un message lorsque l’utilisateur appuie sur le carré dessiné sur mySprite sur un écran tactile :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
- var mySprite:Sprite = new Sprite();
- var myTextField:TextField = new TextField();
- mySprite.graphics.beginFill(0x336699);
- mySprite.graphics.drawRect(0,0,40,40);
- addChild(mySprite);
- mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
- function taphandler(e:TouchEvent): void {
- myTextField.text = "I've been tapped";
- myTextField.y = 50;
- addChild(myTextField);
- }
- </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:click" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace un doigt sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchRollOver</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchRollOver</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:rollOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet).</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 ">
- Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace un doigt sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchRollOut</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchRollOut</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:rollOut" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace un doigt sur un objet InteractiveObject, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchOver</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOver" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace un doigt sur un écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchOut</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchOut</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseOut" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur déplace le point de contact avec un périphérique tactile (notamment lorsqu’il fait glisser un doigt sur un téléphone portable ou une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur déplace le point de contact avec un périphérique tactile (notamment lorsqu’il fait glisser un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">mouseMove</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur déplace un doigt sur un écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseMove</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchMove</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseMove</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchMove</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\events\examples\TouchEventExample.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">TOUCH_BEGIN</codeph>, <codeph class="+ topic/ph pr-d/codeph ">TOUCH_MOVE</codeph> et <codeph class="+ topic/ph pr-d/codeph ">TOUCH_END</codeph>. Lorsque le point de contact se déplace sur l’écran (<codeph class="+ topic/ph pr-d/codeph ">onTouchMove</codeph>), la coordonnée x par rapport à la scène est tracée à la sortie. Pour les paramètres <codeph class="+ topic/ph pr-d/codeph ">sprite.startTouchDrag</codeph> de la fonction <codeph class="+ topic/ph pr-d/codeph ">onTouchBegin</codeph>, la valeur de touchPointID correspond à la valeur affectée à l’objet d’événement. Le paramètre bounds correspond au rectangle qui définit les limites de l’objet d’affichage parent (bg est un objet d’affichage contenant MySprite).
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
- MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
- MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
- MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
- function onTouchBegin(eBegin:TouchEvent) {
- eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
- trace("touch begin");
-
- }
- function onTouchMove(eMove:TouchEvent) {
- trace(eMove.stageX);
- }
-
- function onTouchEnd(eEnd:TouchEvent) {
- eEnd.target.stopTouchDrag(eEnd.touchPointID);
- trace("touch end");
- }
- </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, événement</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 ">
- Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur retire le doigt d’un écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseEnd</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchEnd</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchEnd</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\events\examples\TouchEventExample.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">TOUCH_BEGIN</codeph>, <codeph class="+ topic/ph pr-d/codeph ">TOUCH_MOVE</codeph> et <codeph class="+ topic/ph pr-d/codeph ">TOUCH_END</codeph>. Lorsque le point de contact se déplace sur l’écran (<codeph class="+ topic/ph pr-d/codeph ">onTouchMove</codeph>), la coordonnée x par rapport à la scène est tracée à la sortie. Pour les paramètres <codeph class="+ topic/ph pr-d/codeph ">sprite.startTouchDrag</codeph> de la fonction <codeph class="+ topic/ph pr-d/codeph ">onTouchBegin</codeph>, la valeur de touchPointID correspond à la valeur affectée à l’objet d’événement. Le paramètre bounds correspond au rectangle qui définit les limites de l’objet d’affichage parent (bg est un objet d’affichage contenant MySprite).
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
- MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
- MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
- MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
- function onTouchBegin(eBegin:TouchEvent) {
- eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
- trace("touch begin");
-
- }
- function onTouchMove(eMove:TouchEvent) {
- trace(eMove.stageX);
- }
-
- function onTouchEnd(eEnd:TouchEvent) {
- eEnd.target.stopTouchDrag(eEnd.touchPointID);
- trace("touch end");
- }
- </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.display.xml#InteractiveObject/event:mouseUp" class="- topic/link "><linktext class="- topic/linktext ">Evénement 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 ">
- Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile).</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 ">
- Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). Certains périphériques peuvent également interpréter ce contact comme un événement <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph>.
- <p class="- topic/p ">De façon plus spécifique, si un utilisateur pose le doigt sur écran tactile, l’occurrence d’InteractiveObject peut distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> ou un événement <codeph class="+ topic/ph pr-d/codeph ">touchBegin</codeph>, ou les deux si l’environnement actuel le permet. Choisissez la manière dont vous souhaitez gérer l’interaction de l’utilisateur. Utilisez la classe flash.ui.Multitouch pour gérer les événements tactiles (activez la gestion des événements de mouvements tactiles ou la gestion des événements de points tactiles simples, ou désactivez les événements tactiles afin de ne distribuer que les événements de souris). Si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph>, le gestionnaire d’événement sera exécuté sur un périphérique tactile et sur un périphérique de type souris. Toutefois, si vous choisissez de gérer l’événement <codeph class="+ topic/ph pr-d/codeph ">touchBegin</codeph>, vous pouvez concevoir votre gestionnaire d’événement de façon à répondre aux besoins spécifiques d’un environnement tactile et à fournir aux utilisateurs des fonctionnalités tactiles avancées. Vous pouvez également gérer ces deux événements de façon indépendante pour fournir une réponse différente selon qu’il s’agit d’un événement tactile ou d’un événement de souris.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> voir la classe Multitouch pour plus d’informations sur la compatibilité de l’environnement.</p>
- </apiDesc><example conref="..\events\examples\TouchEventExample.as" class="- topic/example "> L’exemple suivant illustre la gestion d’événements pour les événements <codeph class="+ topic/ph pr-d/codeph ">TOUCH_BEGIN</codeph>, <codeph class="+ topic/ph pr-d/codeph ">TOUCH_MOVE</codeph> et <codeph class="+ topic/ph pr-d/codeph ">TOUCH_END</codeph>. Lorsque le point de contact se déplace sur l’écran (<codeph class="+ topic/ph pr-d/codeph ">onTouchMove</codeph>), la coordonnée x par rapport à la scène est tracée à la sortie. Pour les paramètres <codeph class="+ topic/ph pr-d/codeph ">sprite.startTouchDrag</codeph> de la fonction <codeph class="+ topic/ph pr-d/codeph ">onTouchBegin</codeph>, la valeur de touchPointID correspond à la valeur affectée à l’objet d’événement. Le paramètre bounds correspond au rectangle qui définit les limites de l’objet d’affichage parent (bg est un objet d’affichage contenant MySprite).
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
- MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
- MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
- MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
- function onTouchBegin(eBegin:TouchEvent) {
- eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
- trace("touch begin");
-
- }
- function onTouchMove(eMove:TouchEvent) {
- trace(eMove.stageX);
- }
-
- function onTouchEnd(eEnd:TouchEvent) {
- eEnd.target.stopTouchDrag(eEnd.touchPointID);
- trace("touch end");
- }
- </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, événement</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 ">
- Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de 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 ">
- Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence d’InteractiveObject. L’événement a pour cible l’objet placé sous le périphérique de pointage ou un parent de cet objet. <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> correspond à l’objet précédemment placé sous le périphérique de pointage. Les événements <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> sont envoyés de façon consécutive vers le bas de la chaîne parent de l’objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l’ancêtre de <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> et se termine par l’objet.
- <p class="- topic/p ">L’événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d’objet d’affichage avec enfants. Lorsque la souris pénètre dans la zone d’un objet d’affichage ou de l’un de ses enfants à partir d’un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph>. Ce comportement diffère de celui de l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph>, qui est envoyé lorsque la souris entre dans la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage. </p>
- </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 ">
- Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de 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 ">
- Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence d’InteractiveObject. L’événement a pour cible l’objet placé précédemment sous le périphérique de pointage ou un parent de cet objet. L’objet <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> correspond à l’objet sur lequel s’est placé le périphérique de pointage. Les événements <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> sont envoyés de façon consécutive vers le haut de la chaîne parent de l’objet, en commençant par l’objet et en se terminant par le parent de plus haut niveau qui n’est ni la racine, ni l’ancêtre de <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph>.
- <p class="- topic/p ">L’événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> a pour objet de simplifier le codage des comportements de survol des conteneurs d’objet d’affichage avec enfants. Lorsque la souris quitte la zone d’un objet d’affichage ou de l’un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph>. Ce comportement diffère de celui de l’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph>, qui est envoyé lorsque la souris quitte la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage.</p>
- </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 ">
- Distribué lorsque la molette d’une souris est actionnée sur une occurrence de 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 ">
- Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. Si la cible est un champ de texte, le comportement par défaut consiste à faire défiler le texte. Disponible uniquement sur les systèmes d’exploitation Microsoft Windows.
- </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 ">
- Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence 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 ">
- Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. Si la cible est une occurrence de SimpleButton, l’objet présente l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">upState</codeph>. Si la cible est un champ de texte sélectionnable, le champ de texte termine la sélection, ce qui est son comportement par défaut.
- </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 ">
- Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de 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 ">
- Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence d’InteractiveObject. <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> correspond à l’objet précédemment placé sous le périphérique de pointage. Si la cible est une occurrence de SimpleButton, l’objet présente l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">overState</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">upState</codeph>, selon que le bouton de la souris est enfoncé ou non, comme comportement par défaut.
- <p class="- topic/p ">L’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOver</codeph> est envoyé chaque fois que la souris pénètre dans la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris survolait déjà un autre objet enfant du conteneur d’objet d’affichage. Ce comportement est différent de celui de l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> qui a pour objet de simplifier le codage des comportements de fin de sélection des conteneurs d’objet d’affichage avec enfants. Lorsque la souris pénètre dans la zone d’un objet d’affichage ou de l’un de ses enfants à partir d’un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph>. Les événements <codeph class="+ topic/ph pr-d/codeph ">rollOver</codeph> sont envoyés de façon consécutive vers le bas de la chaîne parent de l’objet, en commençant par le parent de plus haut niveau qui ne constitue ni la racine, ni l’ancêtre de <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> et se termine par l’objet.</p>
- </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 ">
- Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de 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 ">
- Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence d’InteractiveObject. L’événement a pour cible l’objet précédemment placé sous le périphérique de pointage. L’objet <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> correspond à l’objet sur lequel s’est placé le périphérique de pointage. Lorsque la cible est une occurrence de SimpleButton, le bouton présente l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">upState</codeph> comme comportement par défaut.
- <p class="- topic/p ">L’événement <codeph class="+ topic/ph pr-d/codeph ">mouseOut</codeph> est envoyé chaque fois que la souris quitte la zone d’un objet enfant du conteneur d’objet d’affichage, même si la souris reste au-dessus d’un autre objet enfant du conteneur d’objet d’affichage. Ce comportement est différent de celui de l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> qui a pour objet de simplifier le codage des comportements de survol des conteneurs d’objet d’affichage avec enfants. Lorsque la souris quitte la zone d’un objet d’affichage ou de l’un de ses enfants pour atteindre un objet qui ne fait pas partie de ses enfants, l’objet d’affichage distribue l’événement <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph>. Les événements <codeph class="+ topic/ph pr-d/codeph ">rollOut</codeph> sont distribués de façon consécutive vers le haut de la chaîne parent de l’objet, en commençant par l’objet et en se terminant par le parent de plus haut niveau qui n’est ni la racine, ni l’ancêtre de <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph>.</p>
- </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 ">
- Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de 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 ">
- Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence d’InteractiveObject. Si la cible est un champ de texte sélectionné par l’utilisateur, le comportement par défaut consiste à mettre à jour la sélection.
- </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 ">
- Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence 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 ">
- Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. Lorsque la cible est une occurrence de SimpleButton, celle-ci affiche l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">downState</codeph> en tant que comportement par défaut. Si la cible est un champ de texte sélectionnable, le champ de texte commence la sélection, ce qui est son comportement par défaut.
- </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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur 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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> de cet objet est défini sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. Pour qu’un événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> se produise, il doit suivre immédiatement la série d’événements ci-après : <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>. Tous ces événements doivent partager la même cible en tant qu’événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>. Le second clic, représenté par les seconds événements <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph>, doit se produire dans un délai spécifique après l’événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph>. La longueur autorisée de ce délai varie selon le système d’exploitation et peut souvent être configurée par l’utilisateur. Si la cible est un champ de texte sélectionnable, le comportement par défaut consiste à sélectionner le mot qui se trouve sous le pointeur. Si l’indicateur <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> de l’objet InteractiveObject cible n’est pas réglé sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, celui-ci reçoit deux événements <codeph class="+ topic/ph pr-d/codeph ">click</codeph>.
-
- <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> prend par défaut la valeur <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. </p>
-
- <p class="- topic/p ">Le comportement de sélection de texte par le biais d’un double clic d’un objet TextField n’est pas lié à l’événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>. Utilisez <codeph class="+ topic/ph pr-d/codeph ">TextField.doubleClickEnabled</codeph> pour contrôler les sélections TextField.</p>
- </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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de 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 ">
- Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. Pour qu’un événement clic se produise, il doit toujours suivre cette série d’événements dans l’ordre suivant : événement mouseDown, puis mouseUp. L’objet cible doit être identique pour ces deux événements, sans quoi l’événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph> ne se produit pas. Quel que soit le nombre d’autres événements de souris effectués entre les événements <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mouseUp</codeph>, l’événement <codeph class="+ topic/ph pr-d/codeph ">click</codeph> se produit.
- </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 ">
- Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage.</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 ">
- Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. Le comportement par défaut de cet événement consiste à déplacer le focus et à distribuer les événements <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> et <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> correspondants.
-
- <p class="- topic/p ">Cet événement est distribué à l’objet qui possède actuellement le focus. L’objet apparenté de cet événement correspond à l’occurrence d’InteractiveObject qui reçoit le focus si vous ne bloquez pas le comportement par défaut. Pour éviter le déplacement du focus, appelez <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> dans un écouteur d’événement correctement enregistré auprès de l’objet cible. La propriété <codeph class="+ topic/ph pr-d/codeph ">shiftKey</codeph> n’est pas utilisée. Le focus change et les événements <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> et <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> sont distribués par défaut.</p>
- </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 ">
- Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.</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 ">
- Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. Le comportement par défaut de cet événement consiste à déplacer le focus et à distribuer les événements <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> et <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> correspondants.
-
- <p class="- topic/p ">Cet événement est distribué à l’objet qui possède actuellement le focus. L’objet apparenté de cet événement correspond à l’occurrence d’InteractiveObject qui reçoit le focus si vous ne bloquez pas le comportement par défaut. Pour éviter le déplacement du focus, appelez <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> dans un écouteur d’événement correctement enregistré auprès de l’objet cible. Le focus change et les événements <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> et <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> sont distribués par défaut.</p>
- </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 ">
- Distribué après la perte de focus par un objet d’affichage.</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 ">
- Distribué <i class="+ topic/ph hi-d/i ">après</i> la perte de focus d’un objet d’affichage. Ce cas de figure se produit lorsqu’un utilisateur affiche en surbrillance un autre objet à l’aide d’un périphérique de pointage ou du clavier. L’objet qui perd le focus s’appelle l’objet cible de cet événement, tandis que l’occurrence d’InteractiveObject correspondante qui reçoit le focus porte le nom d’objet apparenté. Une référence à l’objet apparenté est enregistrée dans la propriété <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> de l’objet cible. La propriété <codeph class="+ topic/ph pr-d/codeph ">shiftKey</codeph> n’est pas utilisée. Cet événement précède la distribution de l’événement <codeph class="+ topic/ph pr-d/codeph ">focusIn</codeph> par l’objet apparenté.
- </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 ">
- Distribué après la prise de focus par un objet d’affichage.</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 ">
- Distribué <i class="+ topic/ph hi-d/i ">après</i> la prise de focus d’un objet d’affichage. Ce cas de figure se produit lorsqu’un utilisateur affiche l’objet en surbrillance à l’aide d’un périphérique de pointage ou du clavier. L’objet qui reçoit le focus s’appelle l’objet cible de cet événement, tandis que l’occurrence d’InteractiveObject correspondante qui perd le focus en raison de ce changement porte le nom d’objet apparenté. Une référence à l’objet apparenté est enregistrée dans la propriété <codeph class="+ topic/ph pr-d/codeph ">relatedObject</codeph> de l’objet cible. La propriété <codeph class="+ topic/ph pr-d/codeph ">shiftKey</codeph> n’est pas utilisée. Cet événement suit la distribution de l’événement <codeph class="+ topic/ph pr-d/codeph ">focusOut</codeph> de l’objet précédent.
- </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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel.</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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a actuellement le focus est un TextField, le comportement par défaut de cet événement est de sélectionner l’ensemble du contenu du champ de texte.
- </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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel.</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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de coller le contenu du presse-papiers dans le champ de texte, au niveau du point d’insertion actuel, en remplaçant éventuellement le texte actuellement sélectionné dans le champ de texte.
- </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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel.</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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de couper le texte actuellement sélectionné dans le champ de texte pour l’envoyer dans le presse-papiers.
- </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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel.</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 ">
- Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de copier le texte actuellement sélectionné dans le champ de texte pour l’envoyer dans le presse-papiers.
- </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 ">
- Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel.</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 ">
- Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. Cet événement est distribué à l’objet qui possède actuellement le focus. Si l’objet qui a le focus est un TextField, le comportement par défaut de cet événement est de supprimer le texte actuellement sélectionné dans le champ de texte.
- </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 ">
- L’appel du constructeur InteractiveObject() renvoie une exception 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 ">
- L’appel du constructeur <codeph class="+ topic/ph pr-d/codeph ">new InteractiveObject()</codeph> renvoie une exception <codeph class="+ topic/ph pr-d/codeph ">ArgumentError</codeph>. Vous pouvez cependant appeler des constructeurs pour les sous-classes suivantes de InteractiveObject :
-
- <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>
-
-
- </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 ">
- Affiche un clavier virtuel.</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 ">La valeur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> signifie que la demande de clavier logiciel a été accordée, la valeur <codeph class="+ topic/ph pr-d/codeph ">false</codeph> que le clavier logiciel n’a pas été activé.
- </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 ">Si le contexte actuel le permet, affiche le clavier.
- </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Affiche un clavier virtuel.
-
- <p class="- topic/p ">L’appel de cette méthode place le focus sur l’occurrence d’InteractiveObject et affiche le clavier logiciel, si nécessaire. La propriété <codeph class="+ topic/ph pr-d/codeph ">needsSoftKeyboard</codeph> doit également être définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. Aucun clavier n’apparaît si un clavier matériel est disponible ou si le système client ne prend pas en charge les claviers virtuels.</p>
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> cette méthode n’est pas prise en charge dans les applications AIR sous iOS.</p>
-
- </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 ">
- Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’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 "/></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 ">
- Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject.
- </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 ">
- Spécifie le menu contextuel associé à l’objet.</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 ">Menu contextuel associé à l’objet.
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Spécifie le menu contextuel associé à l’objet.
-
- <p class="- topic/p ">Pour le contenu s’exécutant dans Flash Player, cette propriété est un objet ContextMenu. Dans le moteur d’exécution AIR, la classe ContextMenu étend la classe NativeMenu, mais Flash Player prend en charge la classe ContextMenu uniquement, pas la classe NativeMenu.
- </p>
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> les objets TextField incluent toujours un menu du Presse-papiers dans le menu contextuel. Le menu du Presse-papiers comporte les commandes Couper, Copier, Coller, Effacer et Sélectionner tout. Vous ne pouvez pas supprimer ces commandes du menu contextuel pour les objets TextField. Pour les objets TextField, la sélection de ces commandes (ou leurs équivalents clavier) ne génère pas d’événement <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> ou <codeph class="+ topic/ph pr-d/codeph ">selectAll</codeph>.</p>
-
- </apiDesc><example conref="examples\ContextMenu_custom.as" class="- topic/example "> L’exemple suivant explique comment ajouter une option de menu contextuel personnalisée à un objet Sprite en définissant la propriété contextMenu du sprite sur un objet ContextMenu. Exemple fourni par <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>.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- var red_cmi:ContextMenuItem = new ContextMenuItem("red");
- red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
-
- var cm:ContextMenu = new ContextMenu();
- cm.customItems.push(red_cmi);
- cm.hideBuiltInItems();
-
- var spr:Sprite = new Sprite();
- spr.contextMenu = cm;
- spr.graphics.beginFill(0x000000);
- spr.graphics.drawRect(0, 0, 120, 90);
- spr.graphics.endFill();
- spr.x = 10;
- spr.y = 10;
- addChild(spr);
-
- function cmi_menuItemSelect(evt:ContextMenuEvent):void {
- spr.graphics.clear();
- spr.graphics.beginFill(0xFF0000);
- spr.graphics.drawRect(0, 0, 120, 90);
- spr.graphics.endFill();
- }
- </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 ">
- Spécifie si l’objet reçoit les événements 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 ">Spécifie si cet objet reçoit les messages double clic.
-
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Spécifie si l’objet reçoit les événements <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>. La valeur par défaut est <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, ce qui signifie que, par défaut, une occurrence d’InteractiveObject ne reçoit pas les événements <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">doubleClickEnabled</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, l’occurrence reçoit les événements <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph> qui la concernent. La propriété <codeph class="+ topic/ph pr-d/codeph ">mouseEnabled</codeph> de l’occurrence d’InteractiveObject doit également être réglée sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> pour que l’objet reçoive les événements <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>.
-
- <p class="- topic/p ">Définir cette propriété ne distribue aucun événement. Vous devez utiliser la méthode <codeph class="+ topic/ph pr-d/codeph ">addEventListener()</codeph> pour ajouter un écouteur d’événement à l’événement <codeph class="+ topic/ph pr-d/codeph ">doubleClick</codeph>.</p>
-
- </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 ">
- Spécifie si l’objet affiche un rectangle de focus.</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
- _focusRect (global property) topics for information to migrate to the ASDoc description of this
- AS3 property.
-
-
- </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 ">
- Spécifie si l’objet affiche un rectangle de focus. Trois valeurs sont possibles : <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, <codeph class="+ topic/ph pr-d/codeph ">false</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">null</codeph>. Les valeurs <codeph class="+ topic/ph pr-d/codeph ">true</codeph> et <codeph class="+ topic/ph pr-d/codeph ">false</codeph> fonctionnent comme prévu, c’est-à-dire indiquent si le rectangle du focus s’affiche. La valeur <codeph class="+ topic/ph pr-d/codeph ">null</codeph> indique que cet objet dépend de la propriété <codeph class="+ topic/ph pr-d/codeph ">stageFocusRect</codeph> de la scène.
-
- </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 ">
- Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur.</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 ">
- Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. La valeur par défaut est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, ce qui signifie que, par défaut, toute occurrence d’InteractiveObject figurant dans la liste d’affichage reçoit des événements de souris ou d’autres événements de saisie utilisateur. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">mouseEnabled</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, l’occurrence ne reçoit aucun événement de souris (ni aucun autre événement de saisie utilisateur, tel qu’un événement de clavier). Aucun enfant de cette occurrence figurant dans la liste d’affichage n’est affecté. Pour modifier le comportement <codeph class="+ topic/ph pr-d/codeph ">mouseEnabled</codeph> de tous les enfants d’un objet figurant dans la liste d’affichage, utilisez <codeph class="+ topic/ph pr-d/codeph ">flash.display.DisplayObjectContainer.mouseChildren</codeph>.
- <p class="- topic/p "> Définir cette propriété ne distribue aucun événement. La méthode <codeph class="+ topic/ph pr-d/codeph ">addEventListener()</codeph> vous permet de créer une fonctionnalité interactive.</p>
-
- </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 ">
- Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus.</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 ">
- Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus.
-
- <p class="- topic/p ">Par défaut, cette valeur est définie sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph> ; placer le focus sur une occurrence d’InteractiveObject n’affiche pas de clavier logiciel. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">needsSoftKeyboard</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, le moteur d’exécution affiche un clavier logiciel lorsque l’occurrence d’InteractiveObject est prête à prendre en charge la saisie utilisateur. Une occurrence d’InteractiveObject est prête à prendre en charge la saisie utilisateur après un appel par programmation visant à définir la propriété <codeph class="+ topic/ph pr-d/codeph ">focus</codeph> de la scène ou une interaction utilisateur, telle qu’un appui bref. Si le système client dispose d’un clavier matériel ou ne prend pas en charge les claviers virtuels, le clavier logiciel n’apparaît pas.</p>
-
- <p class="- topic/p ">L’occurrence d’InteractiveObject distribue les événements <codeph class="+ topic/ph pr-d/codeph ">softKeyboardActivating</codeph>, <codeph class="+ topic/ph pr-d/codeph ">softKeyboardActivate</codeph> et <codeph class="+ topic/ph pr-d/codeph ">softKeyboardDeactivate</codeph> lorsque le clavier logiciel apparaît ou disparaît.</p>
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> cette propriété n’est pas prise en charge dans les applications AIR sous iOS.</p>
-
- </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 ">
- Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche.</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 ">Définit la zone qui doit s’afficher lorsque le clavier logiciel s’ouvre.
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche.
-
- <p class="- topic/p ">Si la propriété <codeph class="+ topic/ph pr-d/codeph ">needsSoftKeyboard</codeph> de cet objet InteractiveObject est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, le moteur d’exécution ajuste l’affichage en conséquence pour conserver l’objet en vue lorsque l’utilisateur effectue une saisie. En règle générale, le moteur d’exécution utilise les limites de l’objet obtenues à partir de la méthode <codeph class="+ topic/ph pr-d/codeph ">DisplayObject.getBounds()</codeph>. Vous pouvez spécifier une autre zone à l’aide de cette propriété <codeph class="+ topic/ph pr-d/codeph ">softKeyboardInputAreaOfInterest</codeph>.</p>
-
- <p class="- topic/p ">Spécifiez la propriété <codeph class="+ topic/ph pr-d/codeph ">softKeyboardInputAreaOfInterest</codeph> dans les coordonnées de la scène.</p>
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> sous Android, la propriété <codeph class="+ topic/ph pr-d/codeph ">softKeyboardInputAreaOfInterest</codeph> n’est pas respectée en mode paysage.</p>
-
- </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 ">
- Indique si cet objet est spécifié dans l’ordre de tabulation.</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
- TextField.tabEnabled topics for information to migrate to the ASDoc description of this
- AS3 property.
-
-
- </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 ">Indique si cet objet est spécifié dans l’ordre de tabulation.
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Indique si cet objet est spécifié dans l’ordre de tabulation. Lorsque cet objet figure dans l’ordre de tabulation, la valeur est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. Sinon, elle est <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. La valeur par défaut est <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, sauf pour les éléments suivants :
- <ul class="- topic/ul "><li class="- topic/li ">Pour un objet SimpleButton, la valeur est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</li><li class="- topic/li ">Pour un objet TextField avec <codeph class="+ topic/ph pr-d/codeph ">type = "input"</codeph>, la valeur est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</li><li class="- topic/li ">Pour un objet Sprite ou MovieClip avec <codeph class="+ topic/ph pr-d/codeph ">buttonMode = true</codeph>, la valeur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</li></ul>
-
- </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 ">
- Spécifie l’ordre de tabulation des objets dans un fichier 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 "/></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 ">Index de tabulation de l’objet.
-
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Spécifie l’ordre de tabulation des objets dans un fichier SWF. La propriété <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> est réglée sur -1 par défaut, ce qui signifie qu’aucun index de tabulation n’est associé à l’objet.
-
- <p class="- topic/p ">Si un objet actuellement affiché dans le fichier SWF contient une propriété <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph>, l’ordre de tabulation automatique est désactivé : l’ordre de tabulation est alors calculé à partir des propriétés <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> des objets contenus dans le fichier SWF. L’ordre de tabulation personnalisé inclut uniquement les objets dotés de propriétés <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph>.</p>
-
- <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> peut être un entier non négatif. Les objets sont triés selon leurs propriétés <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph>, par ordre croissant. Un objet dont la valeur de <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> est définie sur 1 précède celui dont la valeur de <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> est 2. N’appliquez pas la même valeur <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> à plusieurs objets.</p>
-
- <p class="- topic/p ">L’ordre de tabulation personnalisé défini par la propriété <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> est <i class="+ topic/ph hi-d/i ">flat</i>. Cela signifie que les relations hiérarchiques des objets contenus dans le fichier SWF ne sont pas prises en compte. Tous les objets du fichier SWF dotés de propriétés <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph> sont placés dans l’ordre de tabulation, qui est déterminé par l’ordre des valeurs <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph>. </p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> pour définir l’ordre de tabulation des occurrences de TLFTextField, distribuez l’objet d’affichage enfant de TLFTextField en tant qu’objet InteractiveObject, puis définissez la propriété <codeph class="+ topic/ph pr-d/codeph ">tabIndex</codeph>. Par exemple :
- <pre xml:space="preserve" class="- topic/pre ">
- InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
- </pre>
- Pour inverser l’ordre de tabulation par défaut pour trois occurrences d’un objet TLFTextField (<codeph class="+ topic/ph pr-d/codeph ">tlfInstance1</codeph>, <codeph class="+ topic/ph pr-d/codeph ">tlfInstance2</codeph> et <codeph class="+ topic/ph pr-d/codeph ">tlfInstance3</codeph>), utilisez :
- <pre xml:space="preserve" class="- topic/pre ">
- InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
- InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
- InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
- </pre>
- </p>
-
- </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 ">
- Définit un ensemble ordonné de triangles pouvant être restitués à l’aide de coordonnées de remplissage (u,v) ou d’un remplissage normal.</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 ">
- Définit un ensemble ordonné de triangles pouvant être restitués à l’aide de coordonnées de remplissage (u,v) ou d’un remplissage normal. Chaque triangle du tracé est représenté par trois jeux de coordonnées (x, y), correspondant chacun à un point du triangle.
-
- <p class="- topic/p ">
- Les sommets du triangle ne contiennent pas de coordonnées z et ne représentent pas nécessairement des faces 3D. Toutefois, un tracé de triangle peut être utilisé pour assurer le rendu d’une géométrie 3D dans un espace 2D.
- </p>
-
- </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 ">
- Crée un nouvel objet 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 ">Vecteur de Nombres où chaque paire de nombres est traitée comme un point (paire x, y). Obligatoire.
-
- </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 ">Vecteur d’entiers ou d’index, où chaque groupe de trois index définit un triangle.
-
- </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 ">Vecteur de coordonnées normalisées utilisées pour appliquer un mappage de texture.
-
- </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 ">Spécifie si les triangles tournés vers une direction donnée doivent être restitués. Utilisé pour éviter de restituer les triangles que la vue en cours ne permet pas de voir. Peut être défini sur toute valeur définie par la classe TriangleCulling.
-
- </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Crée un nouvel objet GraphicsTrianglePath.
-
- </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 ">
- Vecteur d’entiers ou d’index, où chaque groupe de trois index définit un triangle.</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 ">
- Vecteur d’entiers ou d’index, où chaque groupe de trois index définit un triangle. Si le paramètre indexes est défini sur null, chaque groupe de trois sommets (six paires de x,y dans le vecteur vertices) définit un triangle. Sinon, chaque index fait référence à un sommet, c’est-à-dire à une paire de nombres dans le vecteur vertices. Par exemple <codeph class="+ topic/ph pr-d/codeph ">indexes[1]</codeph> fait référence à (<codeph class="+ topic/ph pr-d/codeph ">vertices[2]</codeph>, <codeph class="+ topic/ph pr-d/codeph ">vertices[3]</codeph>).
- </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 ">
- Vecteur de coordonnées normalisées utilisées pour appliquer un mappage de texture.</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 ">
- Vecteur de coordonnées normalisées utilisées pour appliquer un mappage de texture. Chaque coordonnée fait référence à un point sur l’image bitmap utilisée pour le remplissage. Il doit y avoir une coordonnée UV ou UVT par sommet.
-
- <p class="- topic/p ">
- Dans coordonnées UV, (0,0) est le coin supérieur gauche de l’image bitmap et (1,1) le coin inférieur droit.
- </p>
-
- <p class="- topic/p ">
- Si la longueur de ce vecteur est le double de celle du vecteur <codeph class="+ topic/ph pr-d/codeph ">vertices</codeph>, les coordonnées normalisées sont utilisées sans correction de perspective.
- </p>
-
- <p class="- topic/p ">
- Si la longueur de ce vecteur est le triple de la longueur du vecteur <codeph class="+ topic/ph pr-d/codeph ">vertices</codeph>, la troisième coordonnée est interprétée comme ’t’, distance séparant l’oeil de la texture dans l’espace visuel. Cela permet au moteur de rendu d’appliquer correctement la perspective lors du mappage des textures en 3D.
- </p>
- </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 ">
- Vecteur de Nombres, où chaque paire de nombres est traitée comme un point (paire 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 ">
- Vecteur de Nombres, où chaque paire de nombres est traitée comme un point (paire x, y).
- </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 ">
- Spécifie si les triangles tournés vers une direction donnée doivent être restitués. </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 ">
- Spécifie si les triangles tournés vers une direction donnée doivent être restitués. Utilisé pour éviter de restituer les triangles que la vue en cours ne permet pas de voir.
- <p class="- topic/p ">
- Peut être défini sur toute valeur définie par la classe TriangleCulling.
- </p>
-
- </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 ">
- La classe DisplayObject constitue la classe de base de tous les objets susceptibles d’être insérés dans la liste d’affichage.</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 ">
- La classe DisplayObject constitue la classe de base de tous les objets susceptibles d’être insérés dans la liste d’affichage. La liste d’affichage gère tous les objets affichés dans les moteurs d’exécution de Flash. La classe DisplayObjectContainer permet d’organiser les objets d’affichage dans la liste d’affichage. Les objets DisplayObjectContainer peuvent posséder des objets enfant, tandis que d’autres objets d’affichage, tels que Shape et TextField, sont des nœuds terminaux qui possèdent uniquement des parents et des frères, mais pas d’enfant.
-
- <p class="- topic/p ">La classe DisplayObject prend en charge des fonctionnalités enfant, telles que la position <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> d’un objet, ainsi que les propriétés les plus avancées de l’objet, telles que sa matrice de transformation.
- </p>
-
- <p class="- topic/p ">DisplayObject est une classe de base abstraite. De ce fait, il est impossible de l’appeler directement. Appeler <codeph class="+ topic/ph pr-d/codeph ">new DisplayObject()</codeph> renvoie une exception <codeph class="+ topic/ph pr-d/codeph ">ArgumentError</codeph>. </p>
-
- <p class="- topic/p ">Tous les objets d’affichage héritent de la classe DisplayObject.</p>
-
- <p class="- topic/p ">La classe DisplayObject n’inclut pas d’API pour le rendu de contenu à l’écran. Par conséquent, si vous devez créer une sous-classe personnalisée de la classe DisplayObject, vous devez étendre l’une de ses sous-classes qui dispose d’API de rendu de contenu à l’écran, telles que les classes Shape, Sprite, Bitmap, SimpleButton, TextField ou MovieClip.</p>
-
- <p class="- topic/p ">La classe DisplayObject contient plusieurs événements de diffusion. En règle générale, la cible d’un événement spécifique correspond à une occurrence de DisplayObject. Par exemple, la cible d’un événement <codeph class="+ topic/ph pr-d/codeph ">added</codeph> correspond à l’occurrence de DisplayObject spécifique ajoutée à la liste d’affichage. Ne posséder qu’une seule cible réduit le placement des écouteurs d’événement à cette cible, et dans certains cas aux ancêtres de la cible sur la liste d’affichage. Néanmoins, s’il s’agit d’événements de diffusion, la cible ne correspond pas à une occurrence de DisplayObject spécifique, mais plutôt à toutes les occurrences de DisplayObject, y compris à celles qui ne figurent pas dans la liste d’affichage. Cela signifie que vous pouvez ajouter un écouteur à n’importe quelle occurrence de DisplayObject afin d’écouter les événements de diffusion. Outre les événements de diffusion répertoriés dans le tableau des événements de la classe DisplayObject, la classe DisplayObject hérite de la classe EventDispatcher les deux événements de diffusion suivants : <codeph class="+ topic/ph pr-d/codeph ">activate</codeph> et <codeph class="+ topic/ph pr-d/codeph ">deactivate</codeph>.</p>
-
- <p class="- topic/p ">Certaines propriétés utilisées précédemment dans les classes MovieClip, TextField et Button d’ActionScript 1.0 et 2.0 (telles que <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> et autres) disposent d’équivalents dans la classe DisplayObject d’ActionScript 3.0 qui sont renommés de façon à commencer par le caractère souligné (_).</p>
-
- <p class="- topic/p ">Pour plus d’informations, voir le chapitre « Programmation de l’affichage » du <i class="+ topic/ph hi-d/i ">Guide du développeur d’ActionScript 3.0</i>.</p>
-
- </apiDesc><example conref="examples\DisplayObjectExample.as" class="- topic/example "> L’exemple suivant, utilise la classe <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectExample</codeph> pour dessiner un carré orange dans le coin de la scène, puis répondre aux événements en affichant des informations sur le texte de chaque événement. Pour ce faire, procédez comme suit :
- <ol class="- topic/ol "><li class="- topic/li ">Les propriétés de classe sont déclarées pour la couleur et la taille du carré.</li><li class="- topic/li ">Le constructeur appelle la méthode <codeph class="+ topic/ph pr-d/codeph ">draw()</codeph> qui dessine un carré orange sur la scène aux coordonnées par défaut <i class="+ topic/ph hi-d/i ">x = 0, y = 0</i>.</li><li class="- topic/li ">Les méthodes d’écouteur d’événements suivantes sont associées au carré :
- <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addedHandler()</codeph> écoute les événements <codeph class="+ topic/ph pr-d/codeph ">added</codeph>, appelés lorsque le carré est ajouté à la liste d’affichage.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">enterFrameHandler()</codeph> écoute les événements <codeph class="+ topic/ph pr-d/codeph ">enterFrame</codeph>, qui n’ont aucune signification réelle dans cet exemple.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">removedHandler()</codeph> écoute les événements <codeph class="+ topic/ph pr-d/codeph ">removed</codeph>, distribués lorsque le carré est supprimé de la liste d’affichage, ce qui se produit lorsque l’utilisateur clique sur le carré.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> écoute les événements <codeph class="+ topic/ph pr-d/codeph ">click</codeph>, qui sont distribués lorsque l’utilisateur clique sur le carré orange.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">renderHandler()</codeph> écoute les événements <codeph class="+ topic/ph pr-d/codeph ">render</codeph> une fois la liste d’affichage mise à jour.</li></ul></li></ol>
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- package {
- import flash.display.Sprite;
- public class DisplayObjectExample extends Sprite {
- public function DisplayObjectExample() {
- var child:CustomDisplayObject = new CustomDisplayObject();
- addChild(child);
- }
- }
- }
- import flash.display.DisplayObject;
- import flash.display.Sprite;
- import flash.display.Stage;
- import flash.display.StageAlign;
- import flash.display.StageScaleMode;
- import flash.events.*;
- class CustomDisplayObject extends Sprite {
- private var bgColor:uint = 0xFFCC00;
- private var size:uint = 80;
- public function CustomDisplayObject() {
- draw();
- addEventListener(Event.ADDED, addedHandler);
- addEventListener(Event.ENTER_FRAME, enterFrameHandler);
- addEventListener(Event.REMOVED, removedHandler);
- addEventListener(MouseEvent.CLICK, clickHandler);
- addEventListener(Event.RENDER, renderHandler);
- }
- private function draw():void {
- graphics.beginFill(bgColor);
- graphics.drawRect(0, 0, size, size);
- graphics.endFill();
- }
- private function clickHandler(event:MouseEvent):void {
- trace("clickHandler: " + event);
- parent.removeChild(this);
- }
- private function addedHandler(event:Event):void {
- trace("addedHandler: " + event);
- stage.scaleMode = StageScaleMode.NO_SCALE;
- stage.align = StageAlign.TOP_LEFT;
- stage.addEventListener("resize", resizeHandler);
- }
- private function enterFrameHandler(event:Event):void {
- trace("enterFrameHandler: " + event);
- removeEventListener("enterFrame", enterFrameHandler);
- }
- private function removedHandler(event:Event):void {
- trace("removedHandler: " + event);
- stage.removeEventListener("resize", resizeHandler);
- }
- private function renderHandler(event:Event):void {
- trace("renderHandler: " + event);
- }
- private function resizeHandler(event:Event):void {
- trace("resizeHandler: " + event);
- }
- }
- </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 ">
- [événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée.</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 ">
- [événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée. Cet événement offre une dernière possibilité de modification des objets qui écoutent cet événement avant le rendu de la liste d’affichage. Vous devez appeler la méthode <codeph class="+ topic/ph pr-d/codeph ">invalidate()</codeph> de l’objet Stage chaque fois que vous souhaitez distribuer un événement <codeph class="+ topic/ph pr-d/codeph ">render</codeph>. Les événements <codeph class="+ topic/ph pr-d/codeph ">Render</codeph> ne sont distribués à un objet que s’il existe un lien d’approbation entre ce dernier et l’objet qui a appelé <codeph class="+ topic/ph pr-d/codeph ">Stage.invalidate()</codeph>. Cet événement est un événement de diffusion, ce qui signifie qu’il est distribué par tous les objets d’affichage avec un écouteur enregistré pour cet événement.
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque : </b>cet événement n’est pas distribué si l’affichage n’effectue pas de rendu. Tel est le cas lorsque le contenu est réduit en icône ou masqué. </p>
- </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 ">
- Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage.</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 ">
- Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage. Les deux méthodes de la classe DisplayObjectContainer génèrent cet événement : <codeph class="+ topic/ph pr-d/codeph ">removeChild()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">removeChildAt()</codeph>.
-
- <p class="- topic/p ">Les méthodes suivantes d’un objet DisplayObjectContainer génèrent également cet événement lorsqu’un objet doit être supprimé pour céder la place au nouvel objet : <codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">addChildAt()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">setChildIndex()</codeph>. </p>
- </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 ">
- Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.</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 ">
- Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage. Les deux méthodes de la classe DisplayObjectContainer génèrent cet événement : <codeph class="+ topic/ph pr-d/codeph ">removeChild()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">removeChildAt()</codeph>.
-
- <p class="- topic/p ">Les méthodes suivantes d’un objet DisplayObjectContainer génèrent également cet événement lorsqu’un objet doit être supprimé pour céder la place au nouvel objet : <codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">addChildAt()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">setChildIndex()</codeph>. </p>
- </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 ">
- [événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours.</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 ">
- [événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. Tous les scripts d’image ont été exécutés. Lorsque la tête de lecture ne bouge pas ou lorsqu’il n’existe qu’une seule image, cet événement est distribué de façon continue, en fonction de la cadence. Cet événement est un événement de diffusion, ce qui signifie qu’il est distribué par tous les objets d’affichage avec un écouteur enregistré pour cet événement.
- </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 ">
- [événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image.</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 ">
- [événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image. Lorsque la tête de lecture ne bouge pas ou lorsqu’il n’existe qu’une seule image, cet événement est distribué de façon continue, en fonction de la cadence. Cet événement est un événement de diffusion, ce qui signifie qu’il est distribué par tous les objets d’affichage avec un écouteur enregistré pour cet événement.
- </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 ">
- [événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.</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 ">
- [événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. Lorsque la tête de lecture ne bouge pas ou lorsqu’il n’existe qu’une seule image, cet événement est distribué de façon continue, en fonction de la cadence. Cet événement est un événement de diffusion, ce qui signifie qu’il est distribué par tous les objets d’affichage avec un écouteur enregistré pour cet événement.
- </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 ">
- Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage.</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 ">
- Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. Les méthodes suivantes déclenchent cet événement : <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChild()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChildAt()</codeph>.
- </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 ">
- Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.</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 ">
- Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. Les méthodes suivantes déclenchent cet événement : <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChild()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChildAt()</codeph>.
- </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 ">
- Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet 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 ">Le rectangle qui définit la zone de l’objet d’affichage par rapport au système de coordonnées de l’objet <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph>.
-
- </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 ">Objet d’affichage qui définit le système de coordonnées à utiliser.
-
- </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph>. Consultez le code suivant, qui indique comment le rectangle renvoyé peut varier en fonction du paramètre <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph> que vous transmettez à la méthode :
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- var container:Sprite = new Sprite();
- container.x = 100;
- container.y = 100;
- this.addChild(container);
- var contents:Shape = new Shape();
- contents.graphics.drawCircle(0,0,100);
- container.addChild(contents);
- trace(contents.getBounds(container));
- // (x=-100, y=-100, w=200, h=200)
- trace(contents.getBounds(this));
- // (x=0, y=0, w=200, h=200)
- </codeblock>
-
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> utilisez les méthodes <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> pour convertir les coordonnées locales de l’objet d’affichage en coordonnées d’affichage, ou pour convertir les coordonnées d’affichage en coordonnées locales.</p>
-
- <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> est semblable à la méthode <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph>. Cependant, le rectangle renvoyé par la méthode <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> inclut les traits appliqués aux formes, contrairement au rectangle renvoyé par la méthode <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph>. Pour consulter un exemple d’utilisation de la méthode <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph>, reportez-vous à la description correspondante.</p>
-
- </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 ">
- Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.</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 ">Le rectangle qui définit la zone de l’objet d’affichage par rapport au système de coordonnées de l’objet <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph>.
-
- </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 ">Objet d’affichage qui définit le système de coordonnées à utiliser.
-
- </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre <codeph class="+ topic/ph pr-d/codeph ">targetCoordinateSpace</codeph>, moins tout trait appliqué aux formes. Les valeurs renvoyées par la méthode <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> sont inférieures ou égales à celles qui sont renvoyées par la méthode <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph>.
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> utilisez les méthodes <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> pour convertir les coordonnées locales de l’objet d’affichage en coordonnées de scène, ou pour convertir les coordonnées de scène en coordonnées locales.</p>
-
- </apiDesc><example conref="examples\DisplayObject.getRect.1.as" class="- topic/example "> L’exemple suivant indique comment la méthode <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> peut renvoyer un rectangle dont les dimensions sont supérieures à celles de la méthode <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph>, du fait de la zone supplémentaire qui est occupée par les traits. Dans ce cas, le sprite <codeph class="+ topic/ph pr-d/codeph ">triangle</codeph> inclut des traits supplémentaires en raison des paramètres <codeph class="+ topic/ph pr-d/codeph ">width</codeph> et <codeph class="+ topic/ph pr-d/codeph ">jointStyle</codeph> de la méthode <codeph class="+ topic/ph pr-d/codeph ">lineStyle()</codeph>. La sortie <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph> (dans les deux dernières lignes) indique la différence entre les rectangles <codeph class="+ topic/ph pr-d/codeph ">getRect()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">getBounds()</codeph> :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.CapsStyle;
- import flash.display.JointStyle;
- import flash.display.LineScaleMode;
- import flash.display.Sprite;
- import flash.geom.Rectangle;
- var triangle:Sprite = new Sprite();
- var color:uint = 0xFF0044;
- var width:Number = 20;
- var alpha:Number = 1.0;
- var pixelHinting:Boolean = true;
- var scaleMode:String = LineScaleMode.NORMAL;
- var caps:String = CapsStyle.SQUARE;
- var joints:String = JointStyle.MITER;
- triangle.graphics.lineStyle(width, color, alpha, pixelHinting, scaleMode, caps, joints);
- var triangleSide:Number = 100;
- triangle.graphics.moveTo(0, 0);
- triangle.graphics.lineTo(0, triangleSide);
- triangle.graphics.lineTo(triangleSide, triangleSide);
- triangle.graphics.lineTo(0, 0);
- addChild(triangle);
- trace(triangle.getBounds(this)); // (x=-10, y=-24.1, w=134.10000000000002, h=134.1)
- trace(triangle.getRect(this)); // (x=0, y=0, w=100, h=100)
- </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 ">
- Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales).</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 ">Objet Vector3D dont les coordonnées sont relatives à l’objet d’affichage tridimensionnel.
-
- </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 ">Objet Point bidimensionnel représentant les coordonnés globales x et y.
-
- </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales).
-
- <p class="- topic/p ">Pour utiliser cette méthode, commencez par créer une occurrence de la classe Point. Les valeurs x et y que vous affectez à l’objet Point représentent des coordonnées globales dans la mesure où elles se rapportent à l’origine (0,0) de la zone d’affichage principale. Transmettez ensuite l’objet Point à la méthode <codeph class="+ topic/ph pr-d/codeph ">globalToLocal3D()</codeph> en tant que paramètre <codeph class="+ topic/ph pr-d/codeph ">point</codeph>. La méthode renvoie les coordonnées tridimensionnelles en tant qu’objet Vector3D contenant les valeurs <codeph class="+ topic/ph pr-d/codeph ">x</codeph>, <codeph class="+ topic/ph pr-d/codeph ">y</codeph> et <codeph class="+ topic/ph pr-d/codeph ">z</codeph> relatives à l’origine de l’objet d’affichage tridimensionnel.</p>
-
- </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 ">
- Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).</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 ">Objet Point dont les coordonnées sont relatives à l’objet d’affichage.
-
- </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 ">Objet créé avec la classe Point. L’objet Point spécifie les coordonnées <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> en tant que propriétés.
-
- </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Convertit l’objet <codeph class="+ topic/ph pr-d/codeph ">point</codeph> des coordonnées de l’objet Stage (globales) vers les coordonnées de l’objet d’affichage (locales).
-
- </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Convertit l’objet <codeph class="+ topic/ph pr-d/codeph ">point</codeph> des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).
-
- <p class="- topic/p ">Pour utiliser cette méthode, commencez par créer une occurrence de la classe Point. Les valeurs <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> que vous affectez représentent des coordonnées globales dans la mesure où elles se référent à l’origine (0,0) de la zone d’affichage principal. Passez ensuite l’occurrence Point en tant que paramètre à la méthode <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph>. La méthode renvoie un nouvel objet Point avec des valeurs <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> qui se rapportent à l’origine de l’objet d’affichage et non pas à l’origine de la scène.</p>
-
- </apiDesc><example conref="examples\DisplayObject.hitTestPoint.1.as" class="- topic/example "> Le code suivant crée un objet Shape et affiche le résultat de l’appel de la méthode <codeph class="+ topic/ph pr-d/codeph ">hitTestPoint()</codeph>, qui utilise différents points en tant que paramètres. La méthode <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> convertit le point provenant des coordonnées de l’objet Stage en espace de coordonnées de la forme :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Shape;
- import flash.geom.Point;
- var circle:Shape = new Shape();
- circle.graphics.beginFill(0x0000FF);
- circle.graphics.drawCircle(40, 40, 40);
- circle.x = 10;
- addChild(circle);
- var point1:Point = new Point(0, 0);
- trace(circle.hitTestPoint(point1.x, point1.y, true)); // false
- trace(circle.hitTestPoint(point1.x, point1.y, false)); // false
- trace(circle.globalToLocal(point1)); // [x=-10, y=0]
- var point2:Point = new Point(10, 1);
- trace(circle.hitTestPoint(point2.x, point2.y, true)); // false
- trace(circle.hitTestPoint(point2.x, point2.y, false)); // true
- trace(circle.globalToLocal(point2)); // [x=0, y=1]
- var point3:Point = new Point(30, 20);
- trace(circle.hitTestPoint(point3.x, point3.y, true)); // true
- trace(circle.hitTestPoint(point3.x, point3.y, false)); // true
- trace(circle.globalToLocal(point3)); // [x=20, y=20]
- </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 ">Classe 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 ">
- Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage 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 ">Définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> si les cadres de sélection des objets d’affichage se recoupent, sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph> dans le cas contraire.
-
-
- </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 ">Objet d’affichage à utiliser pour le test.
-
- </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage transmis en tant que paramètre.
-
- </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">obj</codeph>.
-
- </apiDesc><example conref="examples\DisplayObject.hitTestObject.1.as" class="- topic/example "> Le code suivant crée trois objets Shape et affiche le résultat de l’appel de la méthode <codeph class="+ topic/ph pr-d/codeph ">hitTestObject()</codeph>. Notez que même si les objets circle2 et circle3 ne se recoupent pas, leurs cadres de sélection, eux, se recoupent. Par conséquent, le test de recherche des objets circle2 et circle3 renvoie <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Shape;
- var circle1:Shape = new Shape();
- circle1.graphics.beginFill(0x0000FF);
- circle1.graphics.drawCircle(40, 40, 40);
- addChild(circle1);
- var circle2:Shape = new Shape();
- circle2.graphics.beginFill(0x00FF00);
- circle2.graphics.drawCircle(40, 40, 40);
- circle2.x = 50;
- addChild(circle2);
- var circle3:Shape = new Shape();
- circle3.graphics.beginFill(0xFF0000);
- circle3.graphics.drawCircle(40, 40, 40);
- circle3.x = 100;
- circle3.y = 67;
- addChild(circle3);
- trace(circle1.hitTestObject(circle2)); // true
- trace(circle1.hitTestObject(circle3)); // false
- trace(circle2.hitTestObject(circle3)); // true
- </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 ">
- Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et 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> si l’objet d’affichage recouvre ou recoupe le point spécifié, <codeph class="+ topic/ph pr-d/codeph ">false</codeph> dans tous les autres cas.
-
- </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 ">Coordonnée <i class="+ topic/ph hi-d/i ">x</i> à tester par rapport à l’objet.
-
- </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 ">Coordonnée <i class="+ topic/ph hi-d/i ">y</i> à tester par rapport à l’objet.
-
- </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 ">Indique si la vérification doit porter sur les pixels réels de l’objet (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) ou du cadre de sélection (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>).
-
- </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par x et y.
-
- </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres <codeph class="+ topic/ph pr-d/codeph ">x</codeph> et <codeph class="+ topic/ph pr-d/codeph ">y</codeph>. Les paramètres <codeph class="+ topic/ph pr-d/codeph ">x</codeph> et <codeph class="+ topic/ph pr-d/codeph ">y</codeph> spécifient un point dans l’espace de coordonnées de la scène et non pas le conteneur d’objet d’affichage qui contient l’objet d’affichage (sauf si ce conteneur correspond à la scène).
-
- </apiDesc><example conref="examples\DisplayObject.hitTestPoint.1.as" class="- topic/example "> Le code suivant crée un objet Shape et affiche le résultat de l’appel de la méthode <codeph class="+ topic/ph pr-d/codeph ">hitTestPoint()</codeph>, qui utilise différents points en tant que paramètres. La méthode <codeph class="+ topic/ph pr-d/codeph ">globalToLocal()</codeph> convertit le point provenant des coordonnées de l’objet Stage en espace de coordonnées de la forme :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Shape;
- import flash.geom.Point;
- var circle:Shape = new Shape();
- circle.graphics.beginFill(0x0000FF);
- circle.graphics.drawCircle(40, 40, 40);
- circle.x = 10;
- addChild(circle);
- var point1:Point = new Point(0, 0);
- trace(circle.hitTestPoint(point1.x, point1.y, true)); // false
- trace(circle.hitTestPoint(point1.x, point1.y, false)); // false
- trace(circle.globalToLocal(point1)); // [x=-10, y=0]
- var point2:Point = new Point(10, 1);
- trace(circle.hitTestPoint(point2.x, point2.y, true)); // false
- trace(circle.hitTestPoint(point2.x, point2.y, false)); // true
- trace(circle.globalToLocal(point2)); // [x=0, y=1]
- var point3:Point = new Point(30, 20);
- trace(circle.hitTestPoint(point3.x, point3.y, true)); // true
- trace(circle.hitTestPoint(point3.x, point3.y, false)); // true
- trace(circle.globalToLocal(point3)); // [x=20, y=20]
- </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 ">
- Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).</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 ">Point bidimensionnel représentant un point tridimensionnel dans un espace bidimensionnel.
-
- </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 ">Objet Vector3D contenant soit un point tridimensionnel soit les coordonnées de l’objet d’affichage tridimensionnel.
-
- </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).
-
- <p class="- topic/p ">Par exemple, vous pouvez utiliser uniquement des coordonnées bidimensionnelles (x,y) pour dessiner à l’aide des méthodes <codeph class="+ topic/ph pr-d/codeph ">display.Graphics</codeph>. Pour dessiner un objet tridimensionnel, vous devez mapper les coordonnées tridimensionnelles d’un objet d’affichage sur les coordonnées bidimensionnelles. Commencez par créer une occurrence de la classe Vector3D contenant les coordonnées x, y, et z de l’objet d’affichage tridimensionnel. Transmettez ensuite l’objet Vector3D à la méthode <codeph class="+ topic/ph pr-d/codeph ">local3DToGlobal()</codeph> en tant que paramètre <codeph class="+ topic/ph pr-d/codeph ">point3d</codeph>. La méthode renvoie un objet Point bidimensionnel pouvant être utilisé avec l’API graphique pour dessiner l’objet tridimensionnel.</p>
-
-
- </apiDesc><example conref="examples\Local3DToGlobalExample.as" class="- topic/example "> Cet exemple dessine un cube tridimensionnel simple dans un espace bidimensionnel à l’aide des méthodes <codeph class="+ topic/ph pr-d/codeph ">display.Graphics</codeph>. L’emplacement de l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">this</codeph> est décalé afin que le point d’alignement du cube soit en son centre. Un vecteur des objets Vector3D contient les coordonnées tridimensionnelles du cube. La partie supérieure du cube est dessinée en premier. Vient ensuite la partie inférieure. Enfin, les quatre coins supérieurs et inférieurs sont connectés. Pour utiliser la méthode <codeph class="+ topic/ph pr-d/codeph ">local3DToGlobal()</codeph>, vous devez ajouter le cube au conteneur d’objet d’affichage avant de dessiner le cube.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- package {
- import flash.display.MovieClip;
- import flash.display.Sprite;
- import flash.display.Graphics;
- import flash.geom.*;
- public class Local3DToGlobalExample extends MovieClip {
- private var myCube:Sprite = new Sprite();
- private var v8:Vector.<Vector3D> = new Vector.<Vector3D>(8);
- public function Local3DToGlobalExample():void {
- this.x = -(this.stage.stageWidth / 2);
- this.y = -(this.stage.stageWidth / 2);
- v8[0] = new Vector3D(-40,-40,-40);
- v8[1] = new Vector3D(40,-40,-40);
- v8[2] = new Vector3D(40,-40,40);
- v8[3] = new Vector3D(-40,-40,40);
- v8[4] = new Vector3D(-40,100,-40);
- v8[5] = new Vector3D(40,100,-40);
- v8[6] = new Vector3D(40,100,40);
- v8[7] = new Vector3D(-40,100,40);
- myCube.x = (this.stage.stageWidth / 2);
- myCube.y = (this.stage.stageWidth / 2);
- myCube.z = 1;
- addChild(myCube);
- Cube();
- }
- private function Cube():void {
- var ps:Point = new Point(0,0);
- myCube.graphics.lineStyle(2,0xFF0000);
- ps = myCube.local3DToGlobal(v8[0]);
- myCube.graphics.moveTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[1]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[2]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[3]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[0]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[4]);
- myCube.graphics.moveTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[5]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[6]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[7]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[4]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[0]);
- myCube.graphics.moveTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[4]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[1]);
- myCube.graphics.moveTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[5]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[2]);
- myCube.graphics.moveTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[6]);
- myCube.graphics.lineTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[3]);
- myCube.graphics.moveTo(ps.x, ps.y);
- ps = myCube.local3DToGlobal(v8[7]);
- myCube.graphics.lineTo(ps.x, ps.y);
- }
- }
- }
- </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 ">
- Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).</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 ">Objet Point dont les coordonnées sont relatives à la scène.
-
- </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 ">Le nom ou l’identificateur d’un point créé avec la classe Point, qui spécifie les coordonnées <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> en tant que propriétés.
-
- </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Convertit l’objet <codeph class="+ topic/ph pr-d/codeph ">point</codeph> des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).
-
- <p class="- topic/p ">Cette méthode permet de convertir les coordonnées <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> des valeurs qui se rapportent à l’origine (0,0) d’un objet d’affichage spécifique (coordonnées locales) en valeurs qui se rapportent à l’origine de la scène (coordonnées globales).</p>
-
- <p class="- topic/p ">Pour utiliser cette méthode, commencez par créer une occurrence de la classe Point. Les valeurs <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> que vous affectez représentent des coordonnées locales dans la mesure où elles se référent à l’origine de l’objet d’affichage principal.</p>
-
- <p class="- topic/p ">Vous transmettez ensuite l’occurrence de Point que vous avez créée en tant que paramètre à la méthode <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph>. La méthode renvoie un nouvel objet Point avec des valeurs <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> qui se rapportent à l’origine de la scène et non pas à l’origine de l’objet d’affichage.</p>
-
- </apiDesc><example conref="examples\DisplayObject.localToGlobal.1.as" class="- topic/example "> Le code suivant crée un objet Sprite. Les propriétés <codeph class="+ topic/ph pr-d/codeph ">mouseX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mouseY</codeph> du sprite figurent dans l’espace de coordonnées de l’objet d’affichage. Ce code utilise la méthode <codeph class="+ topic/ph pr-d/codeph ">localToGlobal()</codeph> pour convertir ces propriétés en coordonnées globales (scène) :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- import flash.geom.Point;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFFCC00);
- square.graphics.drawRect(0, 0, 100, 100);
- square.x = 100;
- square.y = 200;
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, traceCoordinates)
- function traceCoordinates(event:MouseEvent):void {
- var clickPoint:Point = new Point(square.mouseX, square.mouseY);
- trace("display object coordinates:", clickPoint);
- trace("stage coordinates:", square.localToGlobal(clickPoint));
- }
- </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 ">Classe 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 ">
- Options d’accessibilité actuelles de l’objet d’affichage.</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 ">
- Options d’accessibilité actuelles de l’objet d’affichage. Si vous modifiez la propriété <codeph class="+ topic/ph pr-d/codeph ">accessibilityProperties</codeph> ou l’un de ses champs dans <codeph class="+ topic/ph pr-d/codeph ">accessibilityProperties</codeph>, vous devez appeler la méthode <codeph class="+ topic/ph pr-d/codeph ">Accessibility.updateProperties()</codeph> pour appliquer vos modifications.
-
- <p class="flashonly"><b class="+ topic/ph hi-d/b ">Remarque </b>: pour tout objet créé dans l’environnement de création de Flash, la valeur de <codeph class="+ topic/ph pr-d/codeph ">accessibilityProperties</codeph> est préremplie avec les informations que vous avez entrées dans le panneau Accessibilité pour cet objet.</p>
-
- </apiDesc><example conref="examples\DisplayObject.accessibilityProperties.1.as" class="- topic/example "> L’exemple suivant indique comment joindre un objet AccessibilityProperties simple à une occurrence TextField :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- import flash.accessibility.AccessibilityProperties;
- import flash.accessibility.Accessibility;
- import flash.system.Capabilities;
- var tf:TextField = new TextField();
- tf.text = "hello";
- var accessProps:AccessibilityProperties = new AccessibilityProperties();
- accessProps.name = "Greeting";
- tf.accessibilityProperties = accessProps;
- if (Capabilities.hasAccessibility) {
- Accessibility.updateProperties();
- }
- trace(tf.accessibilityProperties.name); // Greeting
- </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 ">
- Indique la valeur de transparence alpha de l’objet spécifié.</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 ">
- Indique la valeur de transparence alpha de l’objet spécifié. Les valeurs gérées sont comprises entre 0 (entièrement transparent) et 1 (entièrement opaque). La valeur par défaut est 1. Les objets d’affichage où <codeph class="+ topic/ph pr-d/codeph ">alpha</codeph> est défini sur 0 <i class="+ topic/ph hi-d/i ">sont</i> actifs, même s’ils sont invisibles.
-
- </apiDesc><example conref="examples\DisplayObject.alpha.1.as" class="- topic/example "> Le code suivant définit la propriété <codeph class="+ topic/ph pr-d/codeph ">alpha</codeph> d’un sprite sur 50 % lorsque la souris survole le sprite :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var circle:Sprite = new Sprite();
- circle.graphics.beginFill(0xFF0000);
- circle.graphics.drawCircle(40, 40, 40);
- addChild(circle);
- circle.addEventListener(MouseEvent.MOUSE_OVER, dimObject);
- circle.addEventListener(MouseEvent.MOUSE_OUT, restoreObject);
- function dimObject(event:MouseEvent):void {
- event.target.alpha = 0.5;
- }
- function restoreObject(event:MouseEvent):void {
- event.target.alpha = 1.0;
- }
- </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 ">
- Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser.</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 ">
- Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser. Une image bitmap peut être dessinée en interne de deux manières. Si un mode de fondu ou un masque de découpage externe est activé, l’image bitmap est dessinée en ajoutant une forme carrée remplie avec l’image bitmap au rendu vectoriel. Si vous tentez de définir cette propriété sur une valeur non valide, les moteurs d’exécution de Flash la remplacent par <codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph>.
-
- <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> affecte chaque pixel de l’objet d’affichage. Chaque pixel est composé de trois couleurs élémentaires (rouge, vert et bleu), chacune de ces couleurs ayant une valeur située entre 0x00 et 0xFF. Flash Player ou Adobe AIR compare chaque couleur constituante d’un pixel dans le clip à la couleur correspondante du pixel d’arrière-plan. Par exemple si <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> est défini sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.LIGHTEN</codeph>, Flash Player ou Adobe AIR compare la valeur rouge de l’objet d’affichage avec la valeur rouge de l’arrière-plan, et utilise la plus claire des deux comme valeur pour le composant rouge de la couleur affichée.</p>
-
- <p class="- topic/p ">Le tableau suivant répertorie les réglages <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph>. La classe BlendMode définit les valeurs de chaîne que vous pouvez utiliser. Les illustrations du tableau ci-dessous présentent les valeurs <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> appliquées à un objet d’affichage (2) circulaire superposé sur un autre objet d’affichage (1).</p>
-
-
- <p class="- topic/p ">
- <adobeimage alt="Carré numéro 1" href="../../images/blendMode-0a.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/> <adobeimage alt="Cercle numéro 2" href="../../images/blendMode-0b.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/>
-
- </p>
-
-
- <adobetable class="innertable"><tgroup cols="3" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Constante BlendMode</entry><entry class="- topic/entry ">Illustration</entry><entry class="- topic/entry ">Description</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="mode de fondu NORMAL" href="../../images/blendMode-1.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">L’objet d’affichage apparaît devant l’arrière-plan. Les valeurs de pixels de l’objet d’affichage écrasent celles de l’arrière-plan. Lorsque l’objet d’affichage est transparent, l’arrière-plan est visible.</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="mode de fondu LAYER" href="../../images/blendMode-2.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Impose la création d’un groupe de transparences pour l’objet d’affichage. Cela signifie que l’objet d’affichage est précomposé dans un tampon temporaire avant que son traitement ne se poursuive. Cette opération s’exécute automatiquement si l’objet d’affichage est préalablement placé en mémoire cache par le biais d’une mise en cache des bitmaps ou s’il correspond à un conteneur d’objet d’affichage qui possède au moins un objet enfant associé à un réglage <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> autre que <codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph>. Pas de prise en charge sous le rendu sur GPU.
- </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="mode de fondu MULTIPLY" href="../../images/blendMode-3.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Multiplie les valeurs des couleurs élémentaires de l’objet d’affichage par celles de la couleur d’arrière-plan, puis les normalise en les divisant par 0xFF, ce qui donne des couleurs plus sombres. Ce réglage est souvent utilisé pour les effets d’ombre et de profondeur.
-
- <p class="- topic/p ">Par exemple, si une couleur élémentaire (comme le rouge) d’un pixel de l’objet d’affichage et la couleur correspondante du pixel de l’arrière-plan ont toutes les deux une valeur de 0x88, le résultat de la multiplication est 0x4840. La division par 0xFF donne une valeur de 0x48 pour cette couleur élémentaire, qui est plus sombre que celle de l’objet d’affichage ou de l’arrière-plan.</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="mode de fondu SCREEN" href="../../images/blendMode-4.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Multiplie le complément (l’inverse) de la couleur de l’objet d’affichage par le complément de la couleur d’arrière-plan, ce qui donne un effet de blanchissement. Ce réglage est couramment utilisé pour la mise en valeur ou pour supprimer les parties noires de l’objet d’affichage.</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="mode de fondu LIGHTEN" href="../../images/blendMode-5.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Sélectionne les plus claires des couleurs élémentaires de l’objet d’affichage et la couleur d’arrière-plan (celles qui ont les valeurs les plus élevées). Ce réglage est généralement utilisé pour les superpositions.
-
- <p class="- topic/p ">Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xFFCC33, et que le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDDF800, la valeur RVB obtenue pour le pixel affiché est 0xFFF833 (car 0xFF > 0xDD, 0xCC < 0xF8 et 0x33 > 0x00 = 33). Pas de prise en charge sous le rendu sur 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="mode de fondu DARKEN" href="../../images/blendMode-6.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Sélectionne les plus sombres des couleurs élémentaires de l’objet d’affichage et de l’arrière-plan (celles qui ont les valeurs les plus faibles). Ce réglage est généralement utilisé pour les superpositions.
-
- <p class="- topic/p ">Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xFFCC33, et que le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDDF800, la valeur RVB obtenue pour le pixel affiché est 0xDDCC00 (car 0xFF > 0xDD, 0xCC < 0xF8 et 0x33 > 0x00 = 33). Pas de prise en charge sous le rendu sur 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="mode de fondu DIFFERENCE" href="../../images/blendMode-7.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Compare les couleurs élémentaires de l’objet d’affichage à celles de son arrière-plan et soustrait la valeur la plus sombre des deux couleurs élémentaires de la plus claire. Ce réglage est habituellement utilisé pour obtenir des couleurs plus vibrantes.
-
- <p class="- topic/p ">Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xFFCC33, et le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDDF800, la valeur RVB résultante du pixel affiché est 0x222C33 (parce que 0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C et 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="mode de fondu ADD" href="../../images/blendMode-8.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Ajoute les valeurs des couleurs élémentaires de l’objet d’affichage à celles de son arrière-plan, en appliquant un plafond de 0xFF. Ce réglage est habituellement utilisé pour animer un fondu d’éclaircissement entre deux objets.
-
- <p class="- topic/p ">Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xAAA633, et que le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDD2200, la valeur RVB résultante du pixel affiché est 0xFFC833 (parce que 0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8 et 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="mode de fondu SUBTRACT" href="../../images/blendMode-9.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Soustrait les valeurs des couleurs élémentaires de l’objet d’affichage de celles de la couleur d’arrière-plan, en appliquant un plancher de 0. Ce réglage est habituellement utilisé pour animer un fondu de plus en plus sombre entre deux objets.
-
- <p class="- topic/p ">Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xAA2233, et que le pixel d’arrière-plan a une valeur RVB réglée sur 0xDDA600, alors la valeur RVB obtenue pour le pixel affiché est 0x338400 (car 0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84 et 0x00 - 0x33 < 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="mode de fondu INVERT" href="../../images/blendMode-10.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Inverse l’arrière-plan.</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="mode de fondu ALPHA" href="../../images/blendMode-11.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Applique la valeur alpha de chaque pixel de l’objet d’affichage à l’arrière-plan. Pour ce faire, le réglage <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> de l’objet d’affichage parent doit être réglé sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.LAYER</codeph>. Par exemple, dans l’illustration, l’objet d’affichage parent, qui est un arrière-plan blanc, a un paramètre <codeph class="+ topic/ph pr-d/codeph ">blendMode = BlendMode.LAYER</codeph>. Pas de prise en charge sous le rendu sur 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="mode de fondu ERASE" href="../../images/blendMode-12.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Efface l’arrière-plan sur la base de la valeur alpha de l’objet d’affichage. Pour ce faire, le réglage <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> de l’objet d’affichage parent doit être défini sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.LAYER</codeph>. Par exemple, dans l’illustration, l’objet d’affichage parent, qui est un arrière-plan blanc, a un paramètre <codeph class="+ topic/ph pr-d/codeph ">blendMode = BlendMode.LAYER</codeph>. Pas de prise en charge sous le rendu sur 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="mode de fondu OVERLAY" href="../../images/blendMode-13.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Ajuste la couleur de chaque pixel sur la base de l’obscurité de l’arrière-plan. Si l’arrière-plan est plus clair qu’un gris à 50 %, les couleurs de l’objet d’affichage et de l’arrière-plan sont masquées, ce qui donne une couleur plus claire. Si l’arrière-plan est plus foncé qu’un gris à 50 %, les couleurs sont multipliées, ce qui donne une couleur plus sombre. Ce réglage est habituellement utilisé pour les effets d’ombrage. Pas de prise en charge sous le rendu sur 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="mode de fondu HARDLIGHT" href="../../images/blendMode-14.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry><entry class="- topic/entry ">Ajuste la couleur de chaque pixel sur la base de l’obscurité de l’objet d’affichage. Si l’objet d’affichage est plus clair qu’un gris à 50 %, les couleurs de l’objet d’affichage et de l’arrière-plan sont masquées, ce qui permet d’obtenir une couleur plus claire. Si l’objet d’affichage est plus foncé qu’un gris à 50 %, les couleurs sont multipliées, ce qui donne une couleur plus sombre. Ce réglage est habituellement utilisé pour les effets d’ombrage. Pas de prise en charge sous le rendu sur 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 ">S/O</entry><entry class="- topic/entry ">Ajuste la couleur à l’aide d’une routine de shader personnalisée. Le shader utilisé est spécifié en tant qu’occurrence Shader affectée à la propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph>. La définition de la propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> d’un objet d’affichage sur une occurrence Shader définit automatiquement la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> de l’objet d’affichage sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph> sans que la propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> n’ait été définie auparavant, la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.NORMAL</codeph>. Pas de prise en charge sous le rendu sur GPU.</entry></row></tbody></tgroup></adobetable>
-
- </apiDesc><example conref="examples\DisplayObject.blendMode.1.as" class="- topic/example "> Le code suivant crée deux objets sprite, un carré et un cercle, puis définit le mode de fondu du cercle (au premier plan) sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SUBTRACT</codeph> lorsque le pointeur survole le cercle :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.display.BlendMode;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFF88CC);
- square.graphics.drawRect(0, 0, 80, 80);
- addChild(square);
- var circle:Sprite = new Sprite();
- circle.graphics.beginFill(0xAA0022);
- circle.graphics.drawCircle(40, 40, 40);
- addChild(circle);
- circle.addEventListener(MouseEvent.MOUSE_OVER, dimObject);
- circle.addEventListener(MouseEvent.MOUSE_OUT, restoreObject);
- function dimObject(event:MouseEvent):void {
- event.target.blendMode = BlendMode.SUBTRACT;
- }
- function restoreObject(event:MouseEvent):void {
- event.target.blendMode = BlendMode.NORMAL;
- }
- </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 ">
- S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur 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 ">Matrice de transformation utilisée lors du rendu d’une version mise en cache de l’image bitmap de cet objet d’affichage.
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. L’application utilise cette matrice comme matrice de transformation appliquée lors du rendu de la version bitmap de l’objet d’affichage.
-
- <p class="- topic/p "><i class="+ topic/ph hi-d/i ">Prise en charge du profil AIR :</i> cette fonctionnalité est prise en charge sur les périphériques mobiles, mais ne l’est pas sur les systèmes d’exploitation de bureau. Il possède également une prise en charge limitée sur les périphériques AIR pour TV. Plus précisément, sur les périphériques AIR pour TV, la prise en charge des transformations inclut la mise à l’échelle et la translation, mais pas la rotation ni l’inclinaison. Voir <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">Prise en charge du profil AIR</xref> pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.</p>
-
- <p class="- topic/p ">Si la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> est définie, l’application conserve une image bitmap mise en cache lors de diverses transformations 2D, notamment la translation, la rotation et la mise à l’échelle. Si l’application utilise l’accélération matérielle, l’objet est stocké dans la mémoire vidéo comme texture. Ceci permet au GPU d’appliquer à l’objet les transformations prises en charge. Le processeur graphique peut effectuer ces transformations plus rapidement que l’unité centrale.</p>
-
-
- <p class="- topic/p ">Pour utiliser l’accélération matérielle, définissez le rendu sur GPU dans l’onglet Général de la boîte de dialogue Paramètres iPhone de Flash Professional CS5. Vous pouvez également définir la propriété <codeph class="+ topic/ph pr-d/codeph ">renderMode</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">gpu</codeph> dans le fichier descripteur de l’application. Notez que les périphériques AIR pour TV font automatiquement appel à l’accélération matérielle, si elle est disponible.</p>
-
- <p class="- topic/p ">Par exemple, le code suivant envoie une représentation bitmap non transformée de l’objet d’affichage au GPU :</p>
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">matrix:Matrix = new Matrix(); // creates an identity matrix
- mySprite.cacheAsBitmapMatrix = matrix;
- mySprite.cacheAsBitmap = true;</codeblock>
-
- <p class="- topic/p ">Généralement, la matrice d’identité (<codeph class="+ topic/ph pr-d/codeph ">new Matrix()</codeph>) suffit. Cependant, vous pouvez utiliser une autre matrice, notamment une matrice réduite, pour charger une autre image bitmap dans le GPU. Par exemple, l’exemple suivant applique une matrice <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> mise à l’échelle 0,5 sur les axes x et y. L’objet bitmap qu’utilise le processeur graphique est plus petit ; néanmoins, ce dernier ajuste la taille de l’objet en fonction de la propriété transform.matrix de l’objet d’affichage :</p>
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">matrix:Matrix = new Matrix(); // creates an identity matrix
- matrix.scale(0.5, 0.5); // scales the matrix
- mySprite.cacheAsBitmapMatrix = matrix;
- mySprite.cacheAsBitmap = true;</codeblock>
-
- <p class="- topic/p ">En règle générale, vous devez sélectionner une matrice permettant de dimensionner l’objet d’affichage à la taille à laquelle il apparaîtra dans l’application. Par exemple, si votre application affiche la version bitmap du sprite réduit de moitié, utilisez une matrice qui réduit de moitié. Si votre application affiche le sprite plus grand que ses dimensions actuelles, utilisez une matrice qui effectue une augmentation à l’aide de ce facteur.</p>
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> convient aux transformations 2D. Si vous devez appliquer des transformations en 3D, définissez une propriété 3D de l’objet et manipulez sa propriété <codeph class="+ topic/ph pr-d/codeph ">transform.matrix3D</codeph>. Si l’application est mise en package à l’aide du mode GPU, les transformations 3D sont appliquées à l’objet via le GPU. La propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> est ignorée pour les objets 3D.</p>
-
- </apiDesc><example conref="examples\DisplayObject.cacheAsBitmapMatrix.as" class="- topic/example "> L’exemple suivant utilise la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> pour appliquer des transformations à une version bitmap du clip <codeph class="+ topic/ph pr-d/codeph ">my_shape</codeph>.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.geom.Matrix;
- import flash.display.*;
- import flash.utils.Timer;
- var my_shape:MovieClip = new MovieClip();
- my_shape.graphics.beginFill(0xCCFF00);
- my_shape.graphics.drawRect(200, 0, 100, 100);
- addChild(my_shape);
- var my_timer:Timer = new Timer(250);
- my_timer.start();
- my_timer.addEventListener(TimerEvent.TIMER, timerHandler);
- // make sure this Display Object remains cached for all 2D transforms
- my_shape.cacheAsBitmap = true;
- my_shape.cacheAsBitmapMatrix = new Matrix();
- // rotation variables
- const initAngle:Number = 0;
- const pi:Number = 3.142;
- const incrAngle:Number = pi/10;
- // scaling variables
- const initScale:Number = 0.25;
- const incrScale: Number = 1.1;
- var initHeight : Number = my_shape.height;
- var initWidth : Number = my_shape.width;
- // translation variables
- var incrX : Number = root.width / 20;
- var incrY : Number = root.height / 10;
- // do some initial transforms
- var tempMat : Matrix = my_shape.transform.matrix;
- tempMat.rotate(initAngle);
- tempMat.scale(initScale, initScale);
- my_shape.transform.matrix = tempMat;
- function timerHandler(evt:TimerEvent):void {
- tempMat = my_shape.transform.matrix;
-
- tempMat.rotate(incrAngle);
- tempMat.translate(incrX, incrY);
- tempMat.scale(incrScale, incrScale);
-
- my_shape.transform.matrix = tempMat;
-
- // ensure we are still in a reasonable state or reset
- if(my_shape.height > stage.stageHeight/2)
- {
- my_shape.height = initHeight;
- }
-
- if(my_shape.width > stage.stageWidth/2)
- {
- my_shape.width = initWidth;
- }
-
- if(my_shape.x > stage.stageWidth)
- {
- my_shape.x = 0;
- }
- else if (my_shape.x < 0)
- {
- my_shape.x = stage.stageWidth;
- }
-
- if(my_shape.y > stage.stageHeight)
- {
- my_shape.y = 0;
- }
- else if (my_shape.y < 0)
- {
- my_shape.y = stage.stageHeight;
- }
-
- }
- </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 ">
- Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage.</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 ">Indique si la mise en cache de cet objet DisplayObject sous forme de bitmap est activée ou non.
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Si la valeur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. Cette mise en cache permet d’améliorer les performances des objets d’affichage qui intègrent du contenu vectoriel complexe.
-
- <p class="- topic/p ">Toutes les données vectorielles d’un objet d’affichage contenant une image bitmap en mémoire cache sont tracées sur l’image bitmap et non pas sur l’affichage principal. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> est définie sur null ou n’est pas prise en charge, l’image bitmap est alors copiée sur l’affichage principal sous forme de pixels non étirés et non pivotés accrochés aux limites de pixels les plus proches. Les correspondances des pixels avec l’objet parent se font selon un rapport de 1 à 1. Si les limites de l’image bitmap changent, elle est recréée au lieu d’être étirée.</p>
-
- <p class="- topic/p ">Si la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> n’est pas nulle et est prise en charge, l’objet est dessiné sur l’image bitmap hors écran à l’aide de cette matrice, et les résultats d’étirement et/ou de rotation de ce rendu sont utilisés pour dessiner l’objet sur l’affichage principal.</p>
-
- <p class="- topic/p ">Aucune bitmap interne n’est créée sauf si la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</p>
-
- <p class="- topic/p ">Après avoir défini la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> du bouton sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, le rendu ne change pas, bien que l’objet d’affichage procède automatiquement à l’accrochage aux pixels. La vitesse d’animation peut être beaucoup plus importante selon la complexité du contenu vectoriel.
- </p>
-
- <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> est définie automatiquement sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> lorsque vous appliquez un filtre à l’objet d’affichage (lorsque son tableau <codeph class="+ topic/ph pr-d/codeph ">filter</codeph> n’est pas vide). Lorsqu’un objet d’affichage est filtré, <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> renvoie la valeur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> pour cet objet d’affichage, même si vous l’aviez définie sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. Si vous supprimez tous les filtres d’un objet d’affichage, le réglage <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> à sa position précédente.</p>
-
- <p class="- topic/p ">Un objet d’affichage n’utilise pas d’image bitmap, même si la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> et procède au rendu à partir de données vectorielles dans les cas suivants :</p>
-
- <ul class="- topic/ul "><li class="- topic/li ">L’image bitmap est trop grande : dans AIR 1.5 et Flash Player 10, la taille maximale d’une image bitmap est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image bitmap est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Dans Flash Player 9 et versions antérieures, la limite est de 2 880 pixels de haut sur 2 880 pixels de large.</li><li class="- topic/li ">L’image bitmap ne peut être allouée en mémoire (erreur liée à une saturation de la mémoire). </li></ul>
-
- <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> est utilisée de préférence avec les clips dont le contenu est principalement statique et qui n’est ni redimensionné, ni pivoté de façon fréquente. Avec ce type de clip, <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> permet d’améliorer les performances lors de la conversion (lorsque les positions <i class="+ topic/ph hi-d/i ">x</i> et <i class="+ topic/ph hi-d/i ">y</i> sont changées).</p>
-
- </apiDesc><example conref="examples\DisplayObject.cacheAsBitmap.1.as" class="- topic/example "> L’exemple suivant applique un filtre d’ombre portée à une occurrence de l’objet Shape. Il présente ensuite la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> lorsqu’un filtre est appliqué :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.filters.DropShadowFilter
- var circle:Sprite = new Sprite();
- circle.graphics.beginFill(0xAA0022);
- circle.graphics.drawCircle(40, 40, 40);
- addChild(circle);
- trace(circle.cacheAsBitmap); // false
- var filter:DropShadowFilter = new DropShadowFilter();
- circle.filters = [filter];
- trace(circle.cacheAsBitmap); // true
- </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 ">
- Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.</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 ">Lorsque <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> comprend un ShaderFilter et que le type de sortie du shader n’est pas compatible avec cette opération (le shader doit spécifier une sortie <codeph class="+ topic/ph pr-d/codeph ">pixel4</codeph>).
-
- </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 ">Lorsque <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> comprend un ShaderFilter et que le shader ne spécifie aucune entrée d’image ou que la première entrée n’est pas une entrée <codeph class="+ topic/ph pr-d/codeph ">image4</codeph>.
-
- </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 ">Lorsque <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> comprend un ShaderFilter et que le shader spécifie une entrée d’image n’ont fournie.
-
- </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 ">Lorsque <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> comprend une occurrence de ShaderFilter, ByteArray ou Vector.<Number> en tant qu’entrée de shader, et les propriétés <codeph class="+ topic/ph pr-d/codeph ">width</codeph> et <codeph class="+ topic/ph pr-d/codeph ">height</codeph> ne sont pas spécifiées pour l’objet ShaderInput, ou les valeurs spécifiées ne correspondent pas à la quantité de données dans les données d’entrée. Voir la propriété <codeph class="+ topic/ph pr-d/codeph ">ShaderInput.input</codeph> pour plus d’informations.
-
- </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 ">
- Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. Le package flash.filters contient plusieurs classes qui définissent des filtres spécifiques.
-
- <p class="- topic/p ">Ces filtres peuvent s’appliquer dans Flash Professional pendant la phase de conception ou d’exécution à l’aide du code ActionScript. Pour appliquer un filtre avec ActionScript, vous devez créer une copie temporaire de l’intégralité du tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph>, modifier le tableau temporaire, puis reporter les valeurs de ce tableau temporaire dans le tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph>. Vous ne pouvez pas ajouter directement un nouvel objet filtre au tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph>.</p>
-
- <p class="- topic/p ">Pour ajouter un filtre à l’aide du code ActionScript, exécutez les opérations suivantes (supposons que l’objet d’affichage cible est appelé <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph>) :</p>
-
- <ol class="- topic/ol "><li class="- topic/li ">Créez un objet filtre avec la méthode constructeur de la classe de filtre choisie.</li><li class="- topic/li ">Assignez la valeur du tableau <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject.filters</codeph> à un tableau temporaire, tel que celui qui est nommé <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph>.</li><li class="- topic/li ">Ajoutez le nouvel objet filtre au tableau temporaire, <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph>.</li><li class="- topic/li ">Affectez la valeur du tableau temporaire au tableau <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject.filters</codeph>.</li></ol>
-
- <p class="- topic/p ">Si le tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> n’est pas défini, il n’est pas nécessaire d’utiliser un tableau temporaire. Par contre, vous pouvez affecter directement un littéral de tableau contenant un ou plusieurs des objets filtre que vous avez créés. Le premier exemple de la section Exemples ajoute un filtre d’ombre portée à l’aide du code qui traite à la fois les tableaux de <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> définis et non définis.</p>
-
- <p class="- topic/p ">Pour modifier un objet filtre, vous devez utiliser la technique de modification d’une copie du tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> :</p>
-
- <ol class="- topic/ol "><li class="- topic/li ">Assignez la valeur du tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> à un tableau temporaire, tel que celui qui est nommé <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph>.</li><li class="- topic/li ">Modifiez la propriété avec le tableau temporaire, <codeph class="+ topic/ph pr-d/codeph ">myFilters</codeph>. Par exemple, pour définir la propriété quality du premier filtre du tableau, utilisez le code suivant : <codeph class="+ topic/ph pr-d/codeph ">myFilters[0].quality = 1;</codeph></li><li class="- topic/li ">Affectez la valeur du tableau temporaire au tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph>.</li></ol>
-
- <p class="- topic/p ">Lors du chargement, si un objet d’affichage est associé à un filtre, ce bouton se place en mémoire cache en tant qu’image bitmap transparente. A partir de ce stade, tant que le clip possède une liste de filtres valide, le lecteur place le clip en mémoire cache au format bitmap. Cette image bitmap source est ensuite reprise en tant qu’image source pour les effets de filtrage. Tout objet d’affichage comporte généralement deux bitmaps : le premier avec l’objet d’affichage source non filtré d’origine et un autre pour l’image finale après filtrage. L’image finale est utilisée pour le rendu. Tant que l’objet d’affichage ne change pas, l’image source ne nécessite aucune mise à jour.</p>
-
- <p class="- topic/p ">Le package flash.filters contient des classes de filtres. Par exemple, pour créer un filtre DropShadow, vous devez écrire le code suivant :</p>
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.filters.DropShadowFilter
- var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
- </codeblock>
-
- <p class="- topic/p ">Vous pouvez utiliser l’opérateur <codeph class="+ topic/ph pr-d/codeph ">is</codeph> pour déterminer le type de filtre affecté à chaque position d’index dans le tableau <codeph class="+ topic/ph pr-d/codeph ">filter</codeph>. Par exemple, le code suivant indique comment déterminer la position du premier filtre dans le tableau <codeph class="+ topic/ph pr-d/codeph ">filters</codeph> qui est DropShadowFilter :
- </p>
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- import flash.filters.~~;
- var tf:TextField = new TextField();
- var filter1:DropShadowFilter = new DropShadowFilter();
- var filter2:GradientGlowFilter = new GradientGlowFilter();
- tf.filters = [filter1, filter2];
-
- tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
- addChild(tf)
-
- function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
- for (var i:uint = 0; i < displayObject.filters.length; i++) {
- if (displayObject.filters[i] is filterClass) {
- return i;
- }
- }
- return -1;
- }
- </codeblock>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> comme vous ne pouvez pas appliquer directement un nouvel objet filtre au tableau <codeph class="+ topic/ph pr-d/codeph ">DisplayObject.filters</codeph>, le code suivant n’a pas d’effet sur l’objet d’affichage cible, appelé <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph> :</p>
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- myDisplayObject.filters.push(myDropShadow);
- </codeblock>
-
- </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="../../flash/filters/package-detail.html" class="- topic/link "><linktext class="- topic/linktext ">Package flash.filters</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 ">
- Indique la hauteur de l’objet d’affichage, en pixels.</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 ">
- Indique la hauteur de l’objet d’affichage, en pixels. La hauteur est calculée en fonction des limites du contenu de l’objet d’affichage. Lorsque vous définissez la propriété <codeph class="+ topic/ph pr-d/codeph ">height</codeph>, la propriété <codeph class="+ topic/ph pr-d/codeph ">scaleY</codeph> est ajustée en conséquence, comme illustré dans le code suivant :
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- var rect:Shape = new Shape();
- rect.graphics.beginFill(0xFF0000);
- rect.graphics.drawRect(0, 0, 100, 100);
- trace(rect.scaleY) // 1;
- rect.height = 200;
- trace(rect.scaleY) // 2;</codeblock>
-
- <p class="- topic/p ">A l’exception des objets TextField et Video, un objet d’affichage sans contenu (comme un sprite vide) a une hauteur de 0, même si vous essayez de définir <codeph class="+ topic/ph pr-d/codeph ">height</codeph> sur une valeur différente.</p>
-
- </apiDesc><example conref="examples\DisplayObject.height.1.as" class="- topic/example "> Le code suivant crée deux objets TextField et règle la propriété <codeph class="+ topic/ph pr-d/codeph ">height</codeph> de chacun en fonction de leur propriété <codeph class="+ topic/ph pr-d/codeph ">textHeight</codeph> ; il place également le deuxième champ de texte en définissant sa propriété <codeph class="+ topic/ph pr-d/codeph ">y</codeph> :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- var tf1:TextField = new TextField();
- tf1.text = "Text Field 1";
- tf1.border = true;
- tf1.wordWrap = true;
- tf1.width = 40;
- tf1.height = tf1.textHeight + 5;
- addChild(tf1);
- var tf2:TextField = new TextField();
- tf2.text = "Text Field 2";
- tf2.border = true;
- tf2.wordWrap = true;
- tf2.width = 40;
- tf2.height = tf2.textHeight + 5;
- tf2.y = tf1.y + tf1.height + 5;
- addChild(tf2);
- </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 ">
- Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage.</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 ">
- Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. La propriété <codeph class="+ topic/ph pr-d/codeph ">loaderInfo</codeph> est définie uniquement pour l’objet d’affichage racine d’un fichier SWF ou d’une image bitmap chargée (et non pas d’une image bitmap dessinée avec le code ActionScript). Pour trouver l’objet <codeph class="+ topic/ph pr-d/codeph ">loaderInfo</codeph> associé avec le fichier SWF qui contient un objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph>, utilisez <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject.root.loaderInfo</codeph>.
-
- <p class="- topic/p ">Un grand fichier SWF peut superviser son téléchargement en appelant <codeph class="+ topic/ph pr-d/codeph ">this.root.loaderInfo.addEventListener(Event.COMPLETE, func)</codeph>.</p>
-
- </apiDesc><example conref="examples\DisplayObject.loaderInfo.1.as" class="- topic/example "> Le code suivant suppose que <codeph class="+ topic/ph pr-d/codeph ">this</codeph> se rapporte à un objet d’affichage. Le code renvoie l’URL du fichier SWF racine pour l’objet d’affichage :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- trace (this.loaderInfo.url);
-
- </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#LoaderInfo" class="- topic/link "><linktext class="- topic/linktext ">Classe 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 ">
- L’objet d’affichage appelant est masqué par l’objet mask spécifié.</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 ">Définit un masque pour l’objet d’affichage.
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- L’objet d’affichage appelant est masqué par l’objet <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> spécifié. Afin de vous assurer que le masquage fonctionne lorsque la scène est redimensionnée, l’objet d’affichage <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> doit figurer dans la section active de la liste d’affichage. L’objet <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> en tant que tel n’est pas dessiné. Réglez <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph> pour supprimer le masque.
-
- <p class="- topic/p ">Pour pouvoir redimensionner un objet masque, il doit figurer dans la liste d’affichage. Pour faire glisser un objet Sprite de masque (à l’aide de sa méthode <codeph class="+ topic/ph pr-d/codeph ">startDrag()</codeph>), vous devez placer ce dernier dans la liste d’affichage. Pour appeler la méthode <codeph class="+ topic/ph pr-d/codeph ">startDrag()</codeph> d’un sprite de masque en fonction d’un événement <codeph class="+ topic/ph pr-d/codeph ">mouseDown</codeph> en cours de distribution par le sprite, définissez la propriété <codeph class="+ topic/ph pr-d/codeph ">buttonMode</codeph> du sprite sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</p>
-
- <p class="- topic/p ">Lorsque les objets d’affichage sont mis en cache en définissant la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> et la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmapMatrix</codeph> sur un objet Matrix, le masque et l’objet d’affichage en cours de masquage doivent appartenir à la même image bitmap en mémoire cache. Par conséquent, si l’objet d’affichage est mis en cache, le masque doit être un enfant de l’objet d’affichage. Si un ancêtre de l’objet d’affichage sur la liste d’affichage est mis en cache, le masque doit être un enfant de cet ancêtre ou de l’un de ses descendants. Si plusieurs ancêtres de l’objet masqué sont mis en cache, le masque doit être un descendant du conteneur mis en cache le plus proche de l’objet masqué dans la liste d’affichage.</p>
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> un seul objet <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> ne peut être utilisé pour masquer plusieurs objets d’affichage appelants. Lorsque <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> est affecté à un deuxième objet d’affichage, il est supprimé du masque du premier objet et la propriété <codeph class="+ topic/ph pr-d/codeph ">mask</codeph> de cet objet devient <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.</p>
-
- </apiDesc><example conref="examples\DisplayObject.mask.1.as" class="- topic/example "> Le code suivant crée un objet TextField, ainsi qu’un objet Sprite qui est défini en tant que masque pour l’objet TextField. Lorsque l’utilisateur clique sur le champ de texte, la fonction écouteur d’événement <codeph class="+ topic/ph pr-d/codeph ">drag()</codeph> appelle la méthode <codeph class="+ topic/ph pr-d/codeph ">startDrag()</codeph> de l’objet Sprite de masque :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var tf:TextField = new TextField();
- tf.text = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, "
- + "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
- tf.selectable = false;
- tf.wordWrap = true;
- tf.width = 150;
- addChild(tf);
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFF0000);
- square.graphics.drawRect(0, 0, 40, 40);
- addChild(square);
- tf.mask = square;
- tf.addEventListener(MouseEvent.MOUSE_DOWN, drag);
- tf.addEventListener(MouseEvent.MOUSE_UP, noDrag);
- function drag(event:MouseEvent):void {
- square.startDrag();
- }
- function noDrag(event:MouseEvent):void {
- square.stopDrag();
- }
- </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 ">
- Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels.</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 ">
- Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels.
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque</b> : si vous avez fait pivoter un objet DisplayObject, la coordonnée x renvoyée reflète l’objet non pivoté.</p>
-
- </apiDesc><example conref="examples\DisplayObject.mouseX.1.as" class="- topic/example "> Le code suivant crée un objet Sprite et suit les positions <codeph class="+ topic/ph pr-d/codeph ">mouseX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mouseY</codeph> lorsque l’utilisateur clique sur le sprite :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFF0000);
- square.graphics.drawRect(0, 0, 200, 200);
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, traceCoordinates);
- function traceCoordinates(event:MouseEvent):void {
- trace(square.mouseX, square.mouseY);
- }
- </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 ">
- Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels.</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 ">
- Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels.
-
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque</b> : si vous avez fait pivoter un objet DisplayObject, la coordonnée y renvoyée reflète l’objet non pivoté.</p>
-
- </apiDesc><example conref="examples\DisplayObject.mouseX.1.as" class="- topic/example "> Le code suivant crée un objet Sprite et suit les positions <codeph class="+ topic/ph pr-d/codeph ">mouseX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mouseY</codeph> lorsque l’utilisateur clique sur le sprite :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFF0000);
- square.graphics.drawRect(0, 0, 200, 200);
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, traceCoordinates);
- function traceCoordinates(event:MouseEvent):void {
- trace(square.mouseX, square.mouseY);
- }
- </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 ">
- Indique le nom d’occurrence de 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 ">Si vous tentez de définir cette propriété sur un objet qui a été placé dans le scénario de l’outil de création de Flash.
-
- </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 ">Nom de cette occurrence de DisplayObject.
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Indique le nom d’occurrence de DisplayObject. L’objet peut être identifié dans la liste d’enfants de son conteneur d’objet d’affichage parent en appelant la méthode <codeph class="+ topic/ph pr-d/codeph ">getChildByName()</codeph> du conteneur de l’objet d’affichage.
-
- </apiDesc><example conref="examples\DisplayObject.name.1.as" class="- topic/example "> Le code suivant crée deux objets Sprite et suit la propriété <codeph class="+ topic/ph pr-d/codeph ">name</codeph> associée lorsque l’utilisateur clique sur l’un des objets :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var circle1:Sprite = new Sprite();
- circle1.graphics.beginFill(0xFF0000);
- circle1.graphics.drawCircle(40, 40, 40);
- circle1.name = "circle1";
- addChild(circle1);
- circle1.addEventListener(MouseEvent.CLICK, traceName);
- var circle2:Sprite = new Sprite();
- circle2.graphics.beginFill(0x0000FF);
- circle2.graphics.drawCircle(140, 40, 40);
- circle2.name = "circle2";
- addChild(circle2);
- circle2.addEventListener(MouseEvent.CLICK, traceName);
- function traceName(event:MouseEvent):void {
- trace(event.target.name);
- }
- </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 ">
- Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique.</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 ">
- Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. Une image bitmap transparente contient des données de canal alpha et est dessinée de façon transparente. Une image bitmap opaque ne comporte pas de canal alpha (et procède au rendu plus rapidement qu’avec une image bitmap transparente). Si l’image bitmap est opaque, vous spécifiez la couleur d’arrière-plan à utiliser.
-
- <p class="- topic/p ">Si elle est réglée sur une valeur numérique, la surface est opaque (et non transparente) et la couleur d’arrière-plan RVB correspond au nombre spécifié. Si défini sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph> (la valeur par défaut), l’objet d’affichage a un arrière-plan transparent.</p>
-
- <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">opaqueBackground</codeph> est conçue principalement pour l’utilisation avec la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph>, pour l’optimisation du rendu. Pour les objets d’affichage dont la propriété <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> est définie sur true, le paramètre <codeph class="+ topic/ph pr-d/codeph ">opaqueBackground</codeph> peut améliorer les performances de rendu.</p>
-
- <p class="- topic/p ">La zone opaque d’arrière-plan n’est <i class="+ topic/ph hi-d/i ">pas</i> prise comme référence lors de l’appel de la méthode <codeph class="+ topic/ph pr-d/codeph ">hitTestPoint()</codeph> avec le paramètre <codeph class="+ topic/ph pr-d/codeph ">shapeFlag</codeph> défini sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</p>
-
- <p class="- topic/p ">La zone d’arrière-plan opaque ne réagit pas aux événements de souris.</p>
-
- </apiDesc><example conref="examples\DisplayObject.opaqueBackground.1.as" class="- topic/example "> Le code suivant crée un objet Shape avec un cercle bleu et définit sa propriété <codeph class="+ topic/ph pr-d/codeph ">opaqueBackground</codeph> sur rouge (0xFF0000) :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Shape;
- var circle:Shape = new Shape();
- circle.graphics.beginFill(0x0000FF);
- circle.graphics.drawCircle(40, 40, 40);
- circle.opaqueBackground = 0xFF0000;
- addChild(circle);
- </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 ">
- Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage.</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 ">L’objet d’affichage parent appartient à un sandbox de sécurité auquel vous n’avez pas accès. Pour éviter ce cas de figure, faites en sorte que l’animation parent appelle la méthode <codeph class="+ topic/ph pr-d/codeph ">Security.allowDomain()</codeph>.
-
- </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 ">
- Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. Appliquez la propriété <codeph class="+ topic/ph pr-d/codeph ">parent</codeph> pour spécifier un chemin relatif vers les objets d’affichage qui figurent au-dessus de l’objet d’affichage actuel dans la hiérarchie de liste d’affichage.
-
- <p class="- topic/p ">Vous pouvez utiliser <codeph class="+ topic/ph pr-d/codeph ">parent</codeph> pour remonter de plusieurs niveaux dans l’arborescence de la liste d’affichage, comme dans l’exemple suivant :</p>
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- this.parent.parent.alpha = 20;
- </codeblock>
-
- </apiDesc><example conref="examples\DisplayObject.parent.1.as" class="- topic/example "> Le code suivant crée trois objets Sprite et indique comment la propriété <codeph class="+ topic/ph pr-d/codeph ">parent</codeph> doit refléter la hiérarchie de la liste d’affichage :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- var sprite1:Sprite = new Sprite();
- sprite1.name = "sprite1";
- var sprite2:Sprite = new Sprite();
- sprite2.name = "sprite2";
- var sprite3:Sprite = new Sprite();
- sprite3.name = "sprite3";
- sprite1.addChild(sprite2);
- sprite2.addChild(sprite3);
- trace(sprite2.parent.name); // sprite1
- trace(sprite3.parent.name); // sprite2
- trace(sprite3.parent.parent.name); // sprite1
- </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 ">
- Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier.</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 ">Renvoie l’objet d’affichage racine associé à l’objet.
-
- </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
- Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. Pour un objet Bitmap représentant un fichier d’image chargé, la propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> correspond à l’objet Bitmap lui-même. Pour l’occurrence de la classe principale du premier fichier SWF chargé, la propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> correspond à l’objet d’affichage lui-même. La propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> de l’objet Stage correspond à l’objet Stage en tant que tel. La propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph> pour tout objet d’affichage qui n’a pas été ajouté à la liste d’affichage, sauf s’il a été ajouté à un conteneur d’objet d’affichage qui ne rentre pas dans le cadre de la liste d’affichage, mais qui est un enfant de l’objet d’affichage de plus haut niveau dans un fichier SWF chargé.
-
- <p class="- topic/p ">Par exemple, si vous créez un nouvel objet Sprite en appelant la méthode de constructeur <codeph class="+ topic/ph pr-d/codeph ">Sprite()</codeph>, sa propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> reste <codeph class="+ topic/ph pr-d/codeph ">null</codeph> jusqu’à ce qu’elle soit ajoutée à la liste d’affichage (ou pour un conteneur d’objet d’affichage qui ne rentre pas dans le cadre de la liste d’affichage, mais qui est un enfant de l’objet d’affichage de plus haut niveau dans un fichier SWF chargé).</p>
-
- <p class="- topic/p ">Pour un fichier SWF chargé, même si l’objet Loader utilisé pour charger le fichier ne figure pas dans la liste d’affichage, l’objet d’affichage de plus haut niveau du fichier SWF voit sa propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> définie sur lui-même. La propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> de l’objet Loader n’est pas définie tant qu’elle n’est pas ajoutée en tant qu’enfant de l’objet d’affichage pour lequel la propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> est définie.</p>
-
- </apiDesc><example conref="examples\DisplayObject.root.1.as" class="- topic/example "> Le code suivant indique la différence entre la propriété <codeph class="+ topic/ph pr-d/codeph ">root</codeph> de l’objet Stage, pour un objet d’affichage (un objet Loader) qui n’est pas chargé (avant et après avoir été ajouté à la liste d’affichage) et pour un objet chargé (un objet Bitmap chargé) :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Loader;
- import flash.net.URLRequest;
- import flash.events.Event;
- trace(stage.root); // [object Stage]
- var ldr:Loader = new Loader();
- trace (ldr.root); // null
- addChild(ldr);
- trace (ldr.root); // [object ...]
- var urlReq:URLRequest = new URLRequest("example.jpg");
- ldr.load(urlReq);
- ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, loaded);
- function loaded(event:Event):void {
- trace(ldr.content.root); // [object Bitmap]
- }
- </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 ">
- Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.</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 ">
- Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. Les valeurs comprises entre 0 et 180 représentent la rotation en sens horaire ; les valeurs comprises entre 0 et -180 représentent la rotation en sens anti-horaire. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage.
-
- </apiDesc><example conref="examples\RotationExample1.as" class="- topic/example "> Dans cet exemple, deux ellipses pivotent grâce à leurs propriétés <codeph class="+ topic/ph pr-d/codeph ">rotationX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">rotationY</codeph>. Le point d’alignement de la première ellipse est défini en son centre. Elle pivote sur elle-même. La deuxième ellipse pivote autour d’un point externe.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- package {
- import flash.display.MovieClip;
- import flash.display.Shape;
- import flash.geom.*;
- import flash.display.Graphics;
- import flash.events.TimerEvent;
- import flash.utils.Timer;
- public class RotationExample1 extends MovieClip {
- private var ellipse:Shape = new Shape();
- private var speed:int = 10;
- private var ellipse1:Shape;
- private var ellipse2:Shape;
-
- public function RotationExample1():void {
- ellipse1 = drawEllipse(-50, -40, (this.stage.stageWidth / 2),
- (this.stage.stageHeight / 2));
-
- ellipse2 = drawEllipse(30, 40, (this.stage.stageWidth / 2),
- (this.stage.stageHeight / 2));
- this.addChild(ellipse1);
- this.addChild(ellipse2);
- var t:Timer = new Timer(50);
- t.addEventListener(TimerEvent.TIMER, timerHandler);
- t.start();
- }
- private function drawEllipse(x1, y1, x2, y2):Shape {
-
- var e:Shape = new Shape();
- e.graphics.beginFill(0xFF0000);
- e.graphics.lineStyle(2);
- e.graphics.drawEllipse(x1, y1, 100, 80);
- e.graphics.endFill();
- e.x = x2;
- e.y = y2;
- e.z = 1;
- return e;
- }
- private function timerHandler(event:TimerEvent):void {
- ellipse1.rotationY += speed;
- ellipse1.rotationX -= speed;
- ellipse2.rotationY += speed;
- ellipse2.rotationX -= speed;
- }
- }
- }
- </codeblock></example><example conref="examples\Slider_rotationX.as" class="- topic/example "> L’exemple suivant explique comment faire pivoter en 3D un objet Sprite autour de son axe x avec Flash Professional, ActionScript 3.0 et Flash Player 10 en définissant la propriété rotationX de l’objet. Exemple fourni par <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>.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- //Requires:
- // - Slider control UI component in Flash library.
- // - Publish for Flash Player 10.
- //
-
- [SWF(width="400", height="300")]
-
- import fl.controls.Slider;
- import fl.controls.SliderDirection;
- import fl.events.SliderEvent;
-
- var slider:Slider = new Slider();
- slider.direction = SliderDirection.HORIZONTAL;
- slider.minimum = 0;
- slider.maximum = 360;
- slider.value = 45;
- slider.tickInterval = 45;
- slider.snapInterval = 1;
- slider.liveDragging = true;
- slider.addEventListener(SliderEvent.CHANGE, slider_change);
- slider.move(10, 10);
- addChild(slider);
-
- var spr:Sprite = new Sprite();
- spr.graphics.lineStyle(2, 0xFF0000);
- spr.graphics.drawRect(0, 0, 100, 80);
- spr.x = Math.round((stage.stageWidth - spr.width)/2);
- spr.y = Math.round((stage.stageHeight - spr.height)/2);
- spr.rotationX = 45;
- addChild(spr);
-
- function slider_change(evt:SliderEvent):void {
- spr.rotationX = evt.value;
- }
- </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 ">
- Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.</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 ">
- Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. Les valeurs comprises entre 0 et 180 représentent la rotation dans le sens des aiguilles d’une montre ; les valeurs comprises entre 0 et -180 représentent la rotation dans le sens inverse des aiguilles d’une montre. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage.
-
-
- </apiDesc><example conref="examples\RotationExample1.as" class="- topic/example "> Dans cet exemple, deux ellipses pivotent grâce à leurs propriétés <codeph class="+ topic/ph pr-d/codeph ">rotationX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">rotationY</codeph>. Le point d’alignement de la première ellipse est défini en son centre. Elle pivote sur elle-même. La deuxième ellipse pivote autour d’un point externe.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- package {
- import flash.display.MovieClip;
- import flash.display.Shape;
- import flash.geom.*;
- import flash.display.Graphics;
- import flash.events.TimerEvent;
- import flash.utils.Timer;
- public class RotationExample1 extends MovieClip {
- private var ellipse:Shape = new Shape();
- private var speed:int = 10;
- private var ellipse1:Shape;
- private var ellipse2:Shape;
-
- public function RotationExample1():void {
- ellipse1 = drawEllipse(-50, -40, (this.stage.stageWidth / 2),
- (this.stage.stageHeight / 2));
-
- ellipse2 = drawEllipse(30, 40, (this.stage.stageWidth / 2),
- (this.stage.stageHeight / 2));
- this.addChild(ellipse1);
- this.addChild(ellipse2);
- var t:Timer = new Timer(50);
- t.addEventListener(TimerEvent.TIMER, timerHandler);
- t.start();
- }
- private function drawEllipse(x1, y1, x2, y2):Shape {
-
- var e:Shape = new Shape();
- e.graphics.beginFill(0xFF0000);
- e.graphics.lineStyle(2);
- e.graphics.drawEllipse(x1, y1, 100, 80);
- e.graphics.endFill();
- e.x = x2;
- e.y = y2;
- e.z = 1;
- return e;
- }
- private function timerHandler(event:TimerEvent):void {
- ellipse1.rotationY += speed;
- ellipse1.rotationX -= speed;
- ellipse2.rotationY += speed;
- ellipse2.rotationX -= speed;
- }
- }
- }
- </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 ">
- Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.</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 ">
- Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. Les valeurs comprises entre 0 et 180 représentent la rotation en sens horaire ; les valeurs comprises entre 0 et -180 représentent la rotation en sens anti-horaire. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage.
-
-
- </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 ">
- Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine.</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 ">
- Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. Les valeurs comprises entre 0 et 180 représentent la rotation en sens horaire ; les valeurs comprises entre 0 et -180 représentent la rotation en sens anti-horaire. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Par exemple, l’instruction <codeph class="+ topic/ph pr-d/codeph ">my_video.rotation = 450</codeph> correspond à <codeph class="+ topic/ph pr-d/codeph "> my_video.rotation = 90</codeph>.
-
- </apiDesc><example conref="examples\DisplayObject.rotation.1.as" class="- topic/example "> Le code suivant crée un objet Sprite et le fait pivoter lorsque l’utilisateur clique dessus :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFFCC00);
- square.graphics.drawRect(-50, -50, 100, 100);
- square.x = 150;
- square.y = 150;
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, rotate);
- function rotate(event:MouseEvent):void {
- square.rotation += 15;
- }
- </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 ">
- Grille de mise à l’échelle en vigueur.</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)
- and a gradient fill. The movie clip scales based on the mouse position, and because of the
- <code>scale9Grid</code> set for the movie clip, the thickness of the 20-pixel line does not
- vary when the clip scales (although the gradient in the movie clip <em>does</em> scale):
-
- <listing version="2.0">
- import flash.geom.Rectangle;
- import flash.geom.Matrix;
-
- this.createEmptyMovieClip("my_mc", this.getNextHighestDepth());
-
- var grid:Rectangle = new Rectangle(20, 20, 260, 260);
- my_mc.scale9Grid = grid ;
-
- my_mc._x = 50;
- my_mc._y = 50;
-
- function onMouseMove()
- {
- my_mc._width = _xmouse;
- my_mc._height = _ymouse;
- }
-
- my_mc.lineStyle(20, 0xff3333, 100);
- var gradient_matrix:Matrix = new Matrix();
- gradient_matrix.createGradientBox(15, 15, Math.PI, 10, 10);
- my_mc.beginGradientFill("radial", [0xffff00, 0x0000ff],
- [100, 100], [0, 0xFF], gradient_matrix,
- "reflect", "RGB", 0.9);
- my_mc.moveTo(0, 0);
- my_mc.lineTo(0, 300);
- my_mc.lineTo(300, 300);
- my_mc.lineTo(300, 0);
- my_mc.lineTo(0, 0);
- my_mc.endFill();
- </listing>
-
- </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 ">Si vous transmettez un argument non valide à la méthode.
-
- </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 ">
- Grille de mise à l’échelle en vigueur. Si la valeur est définie sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, tout l’objet d’affichage est alors dimensionné normalement lorsqu’une transformation par redimensionnement est appliquée.
-
- <p class="- topic/p ">Lorsque vous définissez une propriété <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph>, l’objet d’affichage est divisé dans une grille comportant neuf zones, en fonction du rectangle <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph>, qui définit le centre de la grille. La grille est constituée des huit autres zones suivantes : </p>
-
- <ul class="- topic/ul "><li class="- topic/li ">le coin supérieur gauche, en dehors du rectangle,</li><li class="- topic/li ">la zone située au-dessus du rectangle, </li><li class="- topic/li ">le coin supérieur droit, en dehors du rectangle,</li><li class="- topic/li ">la zone située à gauche du rectangle,</li><li class="- topic/li ">la zone située à droite du rectangle,</li><li class="- topic/li ">le coin inférieur gauche, en dehors du rectangle,</li><li class="- topic/li ">la zone située au-dessous du rectangle,</li><li class="- topic/li ">le coin inférieur droit, en dehors du rectangle.</li></ul>
-
- <p class="- topic/p ">Les huit zones entourant la partie centrale (définie par le rectangle) peuvent être conçues comme un cadre qui bénéficie de règles spécifiques de redimensionnement.</p>
-
- <p class="- topic/p ">Lorsque la propriété <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> est définie et qu’un objet d’affichage est redimensionné, la totalité du texte et les dégradés sont dimensionnés normalement ; toutefois, les règles suivantes s’appliquent pour les autres types d’objets :</p>
-
- <ul class="- topic/ul "><li class="- topic/li ">Le contenu de la zone centrale est redimensionné normalement. </li><li class="- topic/li ">Le contenu apparaissant dans les coins n’est pas redimensionné. </li><li class="- topic/li ">Le contenu des zones supérieures et inférieures est redimensionné horizontalement uniquement. Le contenu apparaissant dans les zones de gauche et de droite est redimensionné verticalement uniquement.</li><li class="- topic/li ">Tous les remplissages (ce qui inclut les bitmaps, les vidéos et les dégradés) sont étirés pour remplir leur forme.</li></ul>
-
- <p class="- topic/p ">Si vous faites pivoter un objet d’affichage, tout redimensionnement effectué ultérieurement est normal et la propriété <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> est ignorée.</p>
-
- <p class="- topic/p ">Par exemple, considérez l’objet d’affichage suivant et un rectangle qui lui est appliqué en tant que propriété <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> :</p>
-
- <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="image d’objet d’affichage" href="../../images/scale9Grid-a.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/>
- <p class="- topic/p ">Objet d’affichage.</p></entry><entry align="center" class="- topic/entry "><adobeimage alt="zone échelle-9 d’objet d’affichage" href="../../images/scale9Grid-b.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/>
- <p class="- topic/p ">Le rectangle rouge représente la zone couverte par <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph>.</p></entry></row></tbody></tgroup></adobetable>
-
- <p class="- topic/p ">Lorsque l’objet d’affichage est redimensionné ou étiré, les objets placés dans le rectangle se redimensionnent normalement. Par contre, les objets situés en dehors du rectangle sont redimensionnés selon les règles de <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> :</p>
-
- <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 ">Redimensionné à 75 % :</entry><entry class="- topic/entry "><adobeimage alt="objet d’affichage à 75 %" href="../../images/scale9Grid-c.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row><row class="- topic/row "><entry class="- topic/entry ">Redimensionné à 50 % :</entry><entry class="- topic/entry "><adobeimage alt="objet d’affichage à 50 %" href="../../images/scale9Grid-d.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row><row class="- topic/row "><entry class="- topic/entry ">Redimensionné à 25 % :</entry><entry class="- topic/entry "><adobeimage alt="objet d’affichage à 25 %" href="../../images/scale9Grid-e.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row><row class="- topic/row "><entry class="- topic/entry ">Etiré à l’horizontal à 150 % : </entry><entry class="- topic/entry "><adobeimage alt="affichage étiré à 150 %" href="../../images/scale9Grid-f.jpg" placement="inline" class="+ topic/image adobe-d/adobeimage "/></entry></row></tbody></tgroup></adobetable>
-
- <p class="- topic/p ">L’une des principales utilisations de <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> consiste à définir un objet d’affichage en tant que composant où les zones de bordure conservent la même largeur lorsque le composant est redimensionné.</p>
-
- </apiDesc><example conref="examples\DisplayObject.scale9Grid.1.as" class="- topic/example "> Le code suivant crée un objet Shape avec un rectangle dessiné dans sa propriété <codeph class="+ topic/ph pr-d/codeph ">graphics</codeph>. La ligne de bordure du rectangle fait 20 pixels de large et est remplie par un dégradé. Cet événement d’horloge appelle la fonction <codeph class="+ topic/ph pr-d/codeph ">scale()</codeph>, qui redimensionne l’objet Shape en réglant les propriétés <codeph class="+ topic/ph pr-d/codeph ">scaleX</codeph> et <codeph class="+ topic/ph pr-d/codeph ">scaleY</codeph>. La propriété <codeph class="+ topic/ph pr-d/codeph ">scale9Grid</codeph> appliquée à l’objet Shape empêche le redimensionnement de la ligne de bordure de l’écran, seul le remplissage en dégradé est redimensionné :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Shape;
- import flash.display.GradientType;
- import flash.display.SpreadMethod;
- import flash.display.InterpolationMethod;
- import flash.geom.Matrix;
- import flash.geom.Rectangle;
- import flash.utils.Timer;
- import flash.events.TimerEvent;
- var square:Shape = new Shape();
- square.graphics.lineStyle(20, 0xFFCC00);
- var gradientMatrix:Matrix = new Matrix();
- gradientMatrix.createGradientBox(15, 15, Math.PI, 10, 10);
- square.graphics.beginGradientFill(GradientType.RADIAL,
- [0xffff00, 0x0000ff],
- [100, 100],
- [0, 0xFF],
- gradientMatrix,
- SpreadMethod.REFLECT,
- InterpolationMethod.RGB,
- 0.9);
- square.graphics.drawRect(0, 0, 100, 100);
- var grid:Rectangle = new Rectangle(20, 20, 60, 60);
- square.scale9Grid = grid ;
- addChild(square);
- var tim:Timer = new Timer(100);
- tim.start();
- tim.addEventListener(TimerEvent.TIMER, scale);
- var scaleFactor:Number = 1.01;
- function scale(event:TimerEvent):void {
- square.scaleX *= scaleFactor;
- square.scaleY *= scaleFactor;
-
- if (square.scaleX > 2.0) {
- scaleFactor = 0.99;
- }
- if (square.scaleX < 1.0) {
- scaleFactor = 1.01;
- }
- }
- </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 ">
- Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.</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 ">
- Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. Le point d’alignement par défaut est (0,0). 1.0 correspond à une échelle 100 %.
-
- <p class="- topic/p ">La mise à l’échelle du système de coordonnées local modifie les valeurs des propriétés <codeph class="+ topic/ph pr-d/codeph ">x</codeph> et <codeph class="+ topic/ph pr-d/codeph ">y</codeph> définies en pixels. </p>
-
- </apiDesc><example conref="examples\DisplayObject.scaleX.1.as" class="- topic/example "> Le code suivant crée un objet Sprite avec un rectangle dessiné dans sa propriété <codeph class="+ topic/ph pr-d/codeph ">graphics</codeph>. Le fait de cliquer sur le sprite, entraîne son redimensionnement par un facteur de 10 % :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFFCC00);
- square.graphics.drawRect(0, 0, 100, 100);
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, scale);
- function scale(event:MouseEvent):void {
- square.scaleX *= 1.10;
- square.scaleY *= 1.10;
- }
- </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 ">
- Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.</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 ">
- Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. Le point d’alignement par défaut est (0,0). 1.0 correspond à une échelle 100 %.
-
- <p class="- topic/p ">La mise à l’échelle du système de coordonnées local modifie les valeurs des propriétés <codeph class="+ topic/ph pr-d/codeph ">x</codeph> et <codeph class="+ topic/ph pr-d/codeph ">y</codeph> définies en pixels. </p>
-
- </apiDesc><example conref="examples\DisplayObject.scaleX.1.as" class="- topic/example "> Le code suivant crée un objet Sprite avec un rectangle dessiné dans sa propriété <codeph class="+ topic/ph pr-d/codeph ">graphics</codeph>. Le fait de cliquer sur le sprite, entraîne son redimensionnement par un facteur de 10 % :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFFCC00);
- square.graphics.drawRect(0, 0, 100, 100);
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, scale);
- function scale(event:MouseEvent):void {
- square.scaleX *= 1.10;
- square.scaleY *= 1.10;
- }
- </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 ">
- Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement.</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 ">
- Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. Le point d’alignement par défaut est (0,0). 1.0 correspond à une échelle 100 %.
-
- <p class="- topic/p ">La mise à l’échelle du système de coordonnées local modifie les valeurs des propriétés <codeph class="+ topic/ph pr-d/codeph ">x</codeph>, <codeph class="+ topic/ph pr-d/codeph ">y</codeph> et <codeph class="+ topic/ph pr-d/codeph ">z</codeph> définies en pixels. </p>
-
-
- </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 ">
- Cadre de sélection du défilement de l’objet d’affichage.</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 ">
- Cadre de sélection du défilement de l’objet d’affichage. L’objet d’affichage est recadré en fonction de la taille définie par le rectangle et il défile au sein de ce dernier lorsque vous modifiez les propriétés <codeph class="+ topic/ph pr-d/codeph ">x</codeph> et <codeph class="+ topic/ph pr-d/codeph ">y</codeph> de l’objet <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph>.
-
- <p class="- topic/p ">Les propriétés de l’objet rectangle <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> reprennent l’espace de coordonnées de l’objet d’affichage et sont redimensionnées tout comme l’objet d’affichage global. Les angles de la fenêtre recadrée de l’objet d’affichage avec défilement correspondent à l’origine de l’objet d’affichage (0,0) et le point défini par la largeur et la hauteur du rectangle. Ils ne sont pas centrés autour de l’origine, mais utilisent cette dernière pour définir le coin supérieur gauche de la zone. L’objet d’affichage avec défilement se fait toujours par pixels entiers. </p>
-
- <p class="- topic/p ">Vous pouvez faire défiler un objet vers la gauche ou la droite en définissant la propriété <codeph class="+ topic/ph pr-d/codeph ">x</codeph> de l’objet rectangle <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph>. Vous pouvez faire défiler un objet vers le haut ou le bas en définissant la propriété <codeph class="+ topic/ph pr-d/codeph ">y</codeph> de l’objet rectangle <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph>. Si l’objet d’affichage subit une rotation de 90° et que vous le faites défiler vers la gauche ou vers la droite, il défile en fait vers le haut ou vers le bas.</p>
-
- </apiDesc><example conref="examples\DisplayObject.scrollRect.1.as" class="- topic/example "> L’exemple suivant indique comment la propriété <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> définit la zone de défilement d’un objet d’affichage, <codeph class="+ topic/ph pr-d/codeph ">circle</codeph> . Lorsque vous cliquez sur l’objet <codeph class="+ topic/ph pr-d/codeph ">circle</codeph>, la méthode de gestionnaire d’événements <codeph class="+ topic/ph pr-d/codeph ">clicked()</codeph> ajuste la coordonnée <codeph class="+ topic/ph pr-d/codeph ">y</codeph> de la propriété <codeph class="+ topic/ph pr-d/codeph ">scrollRect</codeph> de l’objet <codeph class="+ topic/ph pr-d/codeph ">circle</codeph>, ce qui entraîne le défilement de l’objet vers le bas :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.geom.Rectangle;
- import flash.events.MouseEvent;
- var circle:Sprite = new Sprite();
- circle.graphics.beginFill(0xFFCC00);
- circle.graphics.drawCircle(200, 200, 200);
- circle.scrollRect = new Rectangle(0, 0, 200, 200);
- addChild(circle);
- circle.addEventListener(MouseEvent.CLICK, clicked);
- function clicked(event:MouseEvent):void {
- var rect:Rectangle = event.target.scrollRect;
- rect.y -= 5;
- event.target.scrollRect = rect;
- }
- </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 ">
- Scène de l’objet d’affichage.</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 ">
- Scène de l’objet d’affichage. L’application d’un moteur d’exécution de Flash ne possède qu’un seul objet Stage. Par exemple, vous pouvez créer et charger plusieurs objets d’affichage dans la liste d’affichage. La propriété <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> de chaque objet d’affichage se rapporte au même objet Stage (même si l’objet d’affichage appartient à un fichier SWF chargé).
-
- <p class="- topic/p ">Si un objet d’affichage n’est pas ajouté à la liste d’affichage, sa propriété <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.</p>
-
- </apiDesc><example conref="examples\DisplayObject.stage.1.as" class="- topic/example "> Le code suivant crée deux objets TextField et exploite la propriété <codeph class="+ topic/ph pr-d/codeph ">width</codeph> de l’objet Stage pour placer les champs de texte :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- var tf1:TextField = new TextField();
- tf1.text = "Text Field 1";
- tf1.border = true;
- tf1.x = 10;
- addChild(tf1);
- tf1.width = tf1.stage.stageWidth / 2 - 10;
- var tf2:TextField = new TextField();
- tf2.text = "Text Field 2";
- tf2.border = true;
- tf2.x = tf1.x + tf1.width + 5;
- addChild(tf2);
- tf2.width = tf2.stage.stageWidth / 2 - 10;
- trace(stage.stageWidth);
- </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 ">
- Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage.</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 ">
- Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. Les propriétés spécifiques, telles que matrix, colorTransform et trois propriétés en lecture seule (<codeph class="+ topic/ph pr-d/codeph ">concatenatedMatrix</codeph>, <codeph class="+ topic/ph pr-d/codeph ">concatenatedColorTransform</codeph> et <codeph class="+ topic/ph pr-d/codeph ">pixelBounds</codeph>) sont décrites dans la section relative à la classe Transform.
-
- <p class="- topic/p ">Chacune des propriétés de l’objet transform constitue un objet. Ce concept est important dans la mesure où la seule façon de définir de nouvelles valeurs pour les objets matrix ou colorTransform consiste à créer un objet et à le copier dans la propriété transform.matrix ou transform.colorTransform.</p>
-
- <p class="- topic/p ">Par exemple, pour augmenter la valeur <codeph class="+ topic/ph pr-d/codeph ">tx</codeph> d’une matrice d’objet d’affichage, vous devez copier l’ensemble de l’objet de la matrice, puis copier le nouvel objet dans la propriété matrix de l’objet transform :</p>
-
- <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph ">
- var myMatrix:Matrix = myDisplayObject.transform.matrix;
- myMatrix.tx += 10;
- myDisplayObject.transform.matrix = myMatrix;
- </codeph></pre>
-
- <p class="- topic/p ">Vous ne pouvez pas définir directement la propriété <codeph class="+ topic/ph pr-d/codeph ">tx</codeph>. Le code suivant n’a pas d’effet sur <codeph class="+ topic/ph pr-d/codeph ">myDisplayObject</codeph> : </p>
-
- <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph ">
- myDisplayObject.transform.matrix.tx += 10;
- </codeph></pre>
-
- <p class="- topic/p ">Vous pouvez copier un objet transform et l’associer à la propriété transform d’un autre objet d’affichage. Par exemple, le code suivant copie l’objet transform dans son intégralité, de <codeph class="+ topic/ph pr-d/codeph ">myOldDisplayObj</codeph> à <codeph class="+ topic/ph pr-d/codeph ">myNewDisplayObj</codeph> :</p>
- <codeph class="+ topic/ph pr-d/codeph ">myNewDisplayObj.transform = myOldDisplayObj.transform;</codeph>
- <p class="- topic/p ">Le nouvel objet d’affichage qui en résulte, <codeph class="+ topic/ph pr-d/codeph ">myNewDisplayObj</codeph>, dispose désormais des mêmes valeurs pour ses paramètres de matrice, transformation de couleurs et limites de pixels que l’ancien objet d’affichage, <codeph class="+ topic/ph pr-d/codeph ">myOldDisplayObj</codeph>.</p>
-
- <p class="- topic/p ">Notez que les périphériques AIR pour TV font appel à l’accélération matérielle, si elle est disponible, pour les transformations de couleur.</p>
-
- </apiDesc><example conref="examples\DisplayObject.transform.1.as" class="- topic/example "> Le code suivant définit un objet Sprite <codeph class="+ topic/ph pr-d/codeph ">square</codeph>. Lorsque l’utilisateur clique sur le sprite, la méthode <codeph class="+ topic/ph pr-d/codeph ">transformer()</codeph> ajuste les propriétés <codeph class="+ topic/ph pr-d/codeph ">colorTransform</codeph> et <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> de la propriété <codeph class="+ topic/ph pr-d/codeph ">transform</codeph> du sprite :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.geom.ColorTransform;
- import flash.geom.Matrix;
- import flash.geom.Transform;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.lineStyle(20, 0xFF2200);
- square.graphics.beginFill(0x0000DD);
- square.graphics.drawRect(0, 0, 100, 100);
- addChild(square);
- var resultColorTransform:ColorTransform = new ColorTransform();
- resultColorTransform.alphaMultiplier = 0.5;
- resultColorTransform.redOffset = 155;
- resultColorTransform.greenMultiplier = 0.5;
- var skewMatrix:Matrix = new Matrix(1, 1, 0, 1);
- square.addEventListener(MouseEvent.CLICK, transformer);
- function transformer(event:MouseEvent):void {
- var transformation:Transform = square.transform;
- var tempMatrix:Matrix = square.transform.matrix;
- tempMatrix.concat(skewMatrix);
- square.transform.colorTransform = resultColorTransform;
-
- square.transform.matrix = tempMatrix;
- }
- </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.geom.xml#Transform" class="- topic/link "><linktext class="- topic/linktext ">Transform, classe</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 ">
- Indique si l’objet d’affichage est visible ou non.</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 ">
- Indique si l’objet d’affichage est visible ou non. Les objets d’affichage qui ne sont pas visibles sont désactivés. Par exemple, si <codeph class="+ topic/ph pr-d/codeph ">visible=false</codeph> pour une occurrence InteractiveObject, il est impossible de cliquer sur cette dernière.
-
- </apiDesc><example conref="examples\DisplayObject.visible.1.as" class="- topic/example "> Le code suivant utilise un objet Timer pour appeler une fonction qui modifie de façon périodique la propriété <codeph class="+ topic/ph pr-d/codeph ">visible</codeph> d’un objet d’affichage, ce qui produit un effet de clignotement :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- import flash.utils.Timer;
- import flash.events.TimerEvent;
- var tf:TextField = new TextField();
- tf.text = "Hello.";
- addChild(tf);
- var tim:Timer = new Timer(250);
- tim.start();
- tim.addEventListener(TimerEvent.TIMER, blinker);
- function blinker(event:TimerEvent):void {
- tf.visible = !tf.visible;
- }
- </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 ">
- Indique la largeur de l’objet d’affichage, en pixels.</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 ">
- Indique la largeur de l’objet d’affichage, en pixels. La largeur est calculée en fonction des limites du contenu de l’objet d’affichage. Lorsque vous définissez la propriété <codeph class="+ topic/ph pr-d/codeph ">width</codeph>, la propriété <codeph class="+ topic/ph pr-d/codeph ">scaleX</codeph> est ajustée en conséquence, comme illustré dans le code suivant :
-
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- var rect:Shape = new Shape();
- rect.graphics.beginFill(0xFF0000);
- rect.graphics.drawRect(0, 0, 100, 100);
- trace(rect.scaleX) // 1;
- rect.width = 200;
- trace(rect.scaleX) // 2;</codeblock>
-
- <p class="- topic/p ">A l’exception des objets TextField et Video, un objet d’affichage sans contenu (comme un sprite vide) a une largeur de 0, même si vous essayez de définir <codeph class="+ topic/ph pr-d/codeph ">width</codeph> sur une valeur différente.</p>
-
- </apiDesc><example conref="examples\DisplayObject.width.1.as" class="- topic/example "> Le code suivant définit un objet Sprite <codeph class="+ topic/ph pr-d/codeph ">square</codeph>. Lorsque l’utilisateur clique sur le sprite, la méthode <codeph class="+ topic/ph pr-d/codeph ">widen()</codeph> augmente la propriété <codeph class="+ topic/ph pr-d/codeph ">width</codeph> du sprite :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.events.MouseEvent;
- var square:Sprite = new Sprite();
- square.graphics.beginFill(0xFF0000);
- square.graphics.drawRect(0, 0, 100, 100);
- addChild(square);
- square.addEventListener(MouseEvent.CLICK, widen);
- function widen(event:MouseEvent):void {
- square.width += 10;
- }
- </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 ">
- Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.</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 ">
- Indique la coordonnée <i class="+ topic/ph hi-d/i ">x</i> de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. Si l’objet figure dans un objet DisplayObjectContainer qui dispose de transformations, ce dernier figure dans le système de coordonnées locales de l’objet DisplayObjectContainer qui l’englobe. Ainsi, dans le cas d’un objet DisplayObjectContainer qui a subi une rotation de 90 ° dans le sens inverse des aiguilles d’une montre, les enfants de DisplayObjectContainer héritent d’un système de coordonnées ayant effectué une rotation à 90 ° dans le sens inverse des aiguilles d’une montre. Les coordonnées de l’objet renvoient à la position du point d’alignement.
-
- </apiDesc><example conref="examples\DisplayObject.x.1.as" class="- topic/example "> Le code suivant définit un objet Sprite <codeph class="+ topic/ph pr-d/codeph ">circle</codeph>. Un objet Timer permet de modifier la propriété <codeph class="+ topic/ph pr-d/codeph ">x</codeph> du sprite toutes les 50 millisecondes :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.display.Sprite;
- import flash.utils.Timer;
- import flash.events.TimerEvent;
- var circle:Sprite = new Sprite();
- circle.graphics.beginFill(0xFF0000);
- circle.graphics.drawCircle(100, 100, 100);
- addChild(circle);
- var tim:Timer = new Timer(50);
- tim.start();
- tim.addEventListener(TimerEvent.TIMER, bounce);
- var xInc:Number = 2;
- function bounce(event:TimerEvent):void {
- circle.x += xInc;
- if (circle.x > circle.width) {
- xInc = -2;
- }
- if (circle.x < 0) {
- xInc = 2;
- }
- }
- </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 ">
- Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.</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 ">
- Indique la coordonnée <i class="+ topic/ph hi-d/i ">y</i> de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. Si l’objet figure dans un objet DisplayObjectContainer qui dispose de transformations, ce dernier figure dans le système de coordonnées locales de l’objet DisplayObjectContainer qui l’englobe. Ainsi, dans le cas d’un objet DisplayObjectContainer qui a subi une rotation de 90 ° dans le sens inverse des aiguilles d’une montre, les enfants de DisplayObjectContainer héritent d’un système de coordonnées ayant effectué une rotation à 90 ° dans le sens inverse des aiguilles d’une montre. Les coordonnées de l’objet renvoient à la position du point d’alignement.
-
- </apiDesc><example conref="examples\DisplayObject.height.1.as" class="- topic/example "> Le code suivant crée deux objets TextField et règle la propriété <codeph class="+ topic/ph pr-d/codeph ">height</codeph> de chacun en fonction de leur propriété <codeph class="+ topic/ph pr-d/codeph ">textHeight</codeph> ; il place également le deuxième champ de texte en définissant sa propriété <codeph class="+ topic/ph pr-d/codeph ">y</codeph> :
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- import flash.text.TextField;
- var tf1:TextField = new TextField();
- tf1.text = "Text Field 1";
- tf1.border = true;
- tf1.wordWrap = true;
- tf1.width = 40;
- tf1.height = tf1.textHeight + 5;
- addChild(tf1);
- var tf2:TextField = new TextField();
- tf2.text = "Text Field 2";
- tf2.border = true;
- tf2.wordWrap = true;
- tf2.width = 40;
- tf2.height = tf2.textHeight + 5;
- tf2.y = tf1.y + tf1.height + 5;
- addChild(tf2);
- </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 ">
- Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent.</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 ">
- Indique la position de coordonnée z le long de l’axe z de l’occurrence de DisplayObject par rapport au conteneur 3D parent. La propriété z est utilisée avec des coordonnées 3D et non avec des coordonnées d’écran ou de pixel.
- <p class="- topic/p ">Lorsque vous réglez la propriété <codeph class="+ topic/ph pr-d/codeph ">z</codeph> d’un objet d’affichage sur une valeur autre que la valeur par défaut, à savoir <codeph class="+ topic/ph pr-d/codeph ">0</codeph>, l’objet Matrix3D correspondant est automatiquement créé pour régler la position et l’orientation 3D d’un objet d’affichage. Lorsque l’on utilise l’axe des z, le comportement existant des propriétés x et y passe des coordonnées d’écran ou pixel aux positions par rapport au conteneur 3D parent.</p>
- <p class="- topic/p ">Par exemple, un enfant de <codeph class="+ topic/ph pr-d/codeph ">_root</codeph> dont la position est x = 100, y = 100, z = 200 n’est pas dessiné à l’emplacement du pixel (100,100). L’enfant est dessiné à l’endroit où les calculs de projection 3D le placent. Ce calcul est :</p>
- <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph "> (x~~cameraFocalLength/cameraRelativeZPosition, y~~cameraFocalLength/cameraRelativeZPosition)</codeph></p>
-
-
- </apiDesc><example conref="examples\ZAxisExample1.as" class="- topic/example "> Cet exemple dessine deux ellipses et les fait se déplacer vers l’avant et vers l’arrière (de bas en haut sur l’axe <codeph class="+ topic/ph pr-d/codeph ">z</codeph>) du point de fuite. L’une des ellipses est définie de sorte à se déplacer plus vite que l’autre.
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
- package {
- import flash.display.MovieClip;
- import flash.display.Shape;
- import flash.display.Graphics;
- import flash.events.Event;
- import flash.geom.*;
- public class ZAxisExample1 extends MovieClip {
- private var ellipse1Back:int = 1;
- private var ellipse2Back:int = 1;
- private var depth:int = 1000;
-
- public function ZAxisExample1():void {
-
- var ellipse1 = drawEllipse((this.stage.stageWidth / 2) - 100,
- (this.stage.stageHeight / 2), 100, 80, 10);
- var ellipse2 = drawEllipse((this.stage.stageWidth / 2) + 100,
- (this.stage.stageHeight / 2), 100, 80, 300);
- this.addChild(ellipse1);
- this.addChild(ellipse2);
-
- ellipse1.addEventListener(Event.ENTER_FRAME, ellipse1FrameHandler);
- ellipse2.addEventListener(Event.ENTER_FRAME, ellipse2FrameHandler);
- }
- private function drawEllipse(x:Number, y:Number, w:Number, h:Number, z:Number):Shape {
- var s:Shape = new Shape();
- s.z = z;
- s.graphics.beginFill(0xFF0000);
- s.graphics.lineStyle(2);
- s.graphics.drawEllipse(x, y, w, h);
- s.graphics.endFill();
- return s;
- }
- private function ellipse1FrameHandler(e:Event):void {
- ellipse1Back = setDepth(e, ellipse1Back);
- e.currentTarget.z += ellipse1Back * 10;
- }
- private function ellipse2FrameHandler(e:Event):void {
- ellipse2Back = setDepth(e, ellipse2Back);
- e.currentTarget.z += ellipse2Back * 20;
- }
- private function setDepth(e:Event, d:int):int {
- if(e.currentTarget.z > depth) {
- e.currentTarget.z = depth;
- d = -1;
- }else if (e.currentTarget.z < 0) {
- e.currentTarget.z = 0;
- d = 1;
- }
- return d;
- }
- }
- }
- </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 ">transformation</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 ">
- Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan.</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 ">Lorsque le type de sortie du shader n’est pas compatible avec cette opération (le shader doit spécifier une sortie <codeph class="+ topic/ph pr-d/codeph ">pixel4</codeph>).
-
- </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 ">Lorsque le shader spécifie moins de deux entrées d’image ou que les deux premières entrées ne sont pas des entrées <codeph class="+ topic/ph pr-d/codeph ">image4</codeph>.
-
- </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 ">Lorsque le shader spécifie une entrée d’image non fournie.
-
- </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 ">Lorsqu’une occurrence de ByteArray ou de Vector.<Number> est utilisée comme entrée et les propriétés <codeph class="+ topic/ph pr-d/codeph ">width</codeph> et <codeph class="+ topic/ph pr-d/codeph ">height</codeph> ne sont pas spécifiées pour le ShaderInput, ou les valeurs spécifiées ne correspondent pas à la quantité de données dans l’objet d’entrée. Voir la propriété <codeph class="+ topic/ph pr-d/codeph ">ShaderInput.input</codeph> pour plus d’informations.
-
- </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 ">
- Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. Lorsque la propriété<codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>, le Shader spécifié est utilisé pour créer la sortie du mode fondu pour l’objet d’affichage.
-
- <p class="- topic/p ">La définition de la propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> d’un objet d’affichage sur une occurrence Shader définit automatiquement la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> de l’objet d’affichage sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> est définie (ce qui définit la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>) et que la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> est modifiée, le mode de fondu peut être réinitialisé pour utiliser le shader de fondu en définissant simplement la propriété <codeph class="+ topic/ph pr-d/codeph ">blendMode</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">BlendMode.SHADER</codeph>. La propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> n’a plus besoin d’être définie, sauf pour modifier le shader utilisé pour définir le mode de fondu.</p>
-
- <p class="- topic/p ">Le Shader affecté à la propriété <codeph class="+ topic/ph pr-d/codeph ">blendShader</codeph> doit spécifier au moins deux entrées <codeph class="+ topic/ph pr-d/codeph ">image4</codeph>. Il n’est <b class="+ topic/ph hi-d/b ">pas</b> nécessaire de spécifier les entrées en code à l’aide des propriétés <codeph class="+ topic/ph pr-d/codeph ">input</codeph> des objets ShaderInput. L’objet d’affichage de l’arrière-plan est automatiquement utilisé comme première entrée (l’entrée présentant un <codeph class="+ topic/ph pr-d/codeph ">index</codeph> 0). L’objet d’affichage de premier-plan est automatiquement utilisé comme seconde entrée (l’entrée présentant un <codeph class="+ topic/ph pr-d/codeph ">index</codeph> 1). Un shader utilisé comme shader de fondu peut spécifier plus de deux entrées. Dans ce cas, toute entrée supplémentaire doit être spécifiée par la définition de la propriété <codeph class="+ topic/ph pr-d/codeph ">input</codeph> de son occurrence de ShaderInput.</p>
-
- <p class="- topic/p ">Lorsque vous affectez une occurrence Shader à cette propriété, le shader est copié en interne. L’opération de fondu utilise cette copie interne et non une référence au shader d’origine. Toute modification apportée au shader, par exemple la modification de la valeur d’un paramètre, l’entrée ou le pseudo-code binaire, n’est pas appliquée au shader copié qui est utilisé pour le mode de fondu.</p>
-
- </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 ">
- La classe Loader permet de charger des fichiers SWF ou des fichiers d’image (JPG, PNG ou 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 ">
- La classe Loader permet de charger des fichiers SWF ou des fichiers d’image (JPG, PNG ou GIF). Utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> pour lancer le chargement. L’objet d’affichage chargé est intégré en tant qu’enfant à l’objet Loader.
-
- <p class="- t