Extension

dADOBE FLASH CS4 PROFESSIONAL

 2008 Adobe Systems Incorporated. Tous droits rservs.

Copyright

Extension de Flash pour Windows et Mac OS Si ce guide accompagne un logiciel qui inclut un contrat de licence utilisateur final, ce guide et le logiciel qu'il dcrit sont fournis sous licence et peuvent uniquement tre utiliss ou copis dans le respect des conditions de cette licence. Sauf indication expresse dans le contrat de licence, aucune partie de ce guide ne peut tre reproduite, stocke dans un systme d'extraction ni transmise de quelque manire que soit, lectronique, mcanique, par enregistrement ou autre, sans l'accord crit pralable d'Adobe Systems Incorporated. Veuillez noter que le contenu de ce manuel est protg par des droits dauteur, mme sil nest pas distribu avec un logiciel comprenant un contrat de licence utilisateur final. Le contenu de ce guide est fourni titre d'information uniquement ; il peut faire l'objet de modifications sans pravis et ne saurait tre considr comme un engagement quelconque de la part d'Adobe Systems Incorporated. Adobe Systems Incorporated dcline toute responsabilit quant aux erreurs ou imprcisions susceptibles d'apparatre dans les informations que prsente ce guide. Il est important de se rappeler que certaines illustrations ou images que vous souhaitez inclure dans votre projet peuvent tre protges par les lois de copyright. L'inclusion sans autorisation de tels lments dans vos propres travaux peut porter atteinte aux droits du dtenteur de ce copyright. Veillez obtenir toutes les autorisations ncessaires auprs de ce dernier. Toutes les rfrences aux noms de socits dans les exemples de modles sont fournies titre d'illustration uniquement et ne visent aucune entreprise existante. Adobe, the Adobe logo, ActionScript, Dreamweaver, Fireworks, Flash, Flash Lite, and Version Cue are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Windows and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and other countries. Macintosh and Mac OS are trademarks of Apple Inc., registered in the United States and other countries. All other trademarks are the property of their respective owners. This product includes software developed by the Apache Software Foundation (http://www.apache.org/). MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (http://www.mp3licensing.com). Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com). Video compression and decompression is powered by On2 TrueMotion video technology. 1992-2005 On2 Technologies, Inc. All Rights Reserved. http://www.on2.com. This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/). This product contains either BSAFE and/or TIPEM software by RSA Security, Inc.

Sorenson Spark video compression and decompression technology licensed from Sorenson Media, Inc. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA Notice to U.S. government end users. The software and documentation are Commercial Items, as that term is defined at 48 C.F.R. 2.101, consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R. 12.212 or 48 C.F.R. 227.7202, as applicable. Consistent with 48 C.F.R. 12.212 or 48 C.F.R. 227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250 ,and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

iii

Sommaire
Chapitre 1 : Prsentation Utilisation de l'API JavaScript Nouveauts de l'API JavaScript Objets de l'API JavaScript Exemples dimplmentation .......................................................................................... 1 ......................................................................................... 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

.............................................................................................. 8

Chapitre 2 : Fonctions et mthodes de haut niveau activate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 alert() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 configureTool() confirm() deactivate() keyDown() keyUp()

mouseDoubleClick() mouseDown() mouseMove() mouseUp() prompt() setCursor()

notifySettingsChanged()

Chapitre 3 : Objet actionsPanel actionsPanel.getClassForObject() actionsPanel.getScriptAssistMode() actionsPanel.getSelectedText() actionsPanel.getText() actionsPanel.hasSelection()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

actionsPanel.replaceSelectedText() actionsPanel.setScriptAssistMode() actionsPanel.setSelection() actionsPanel.setText()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Chapitre 4 : Objet BitmapInstance bitmapInstance.getBits() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 bitmapInstance.hPixels bitmapInstance.setBits() bitmapInstance.vPixels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Chapitre 5 : Objet BitmapItem bitmapItem.allowSmoothing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 bitmapItem.compressionType bitmapItem.exportToFile() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

bitmapItem.fileLastModifiedDate

EXTENSION DE FLASH CS4 PROFESSIONAL iv

Sommaire

bitmapItem.originalCompressionType bitmapItem.quality bitmapItem.sourceFileExists bitmapItem.sourceFilePath bitmapItem.useDeblocking

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

bitmapItem.sourceFileIsCurrent

bitmapItem.useImportedJPEGQuality

Chapitre 6 : Objet CompiledClipInstance compiledClipInstance.accName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 compiledClipInstance.actionScript compiledClipInstance.description compiledClipInstance.forceSimple compiledClipInstance.shortcut compiledClipInstance.silent compiledClipInstance.tabIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Chapitre 7 : Objet compilerErrors compilerErrors.clear() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 compilerErrors.save() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Chapitre 8 : Objet ComponentInstance componentInstance.parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Chapitre 9 : Objet componentsPanel componentsPanel.addItemToDocument() componentsPanel.reload()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Chapitre 10 : Objet Contour contour.fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 contour.getHalfEdge() contour.interior contour.orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Chapitre 11 : Objet Document document.accName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 document.addDataToDocument() document.addDataToSelection() document.addFilter() document.addItem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

document.addNewLine() document.addNewOval()

document.addNewPrimitiveOval() document.addNewPublishProfile() document.addNewRectangle() document.addNewScene() document.addNewText()

document.addNewPrimitiveRectangle()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

EXTENSION DE FLASH CS4 PROFESSIONAL v

Sommaire

document.align()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

document.allowScreens() document.arrange() document.as3Dialect document.as3AutoDeclare document.as3ExportFrame document.as3StrictMode document.asVersion document.autoLabel document.breakApart() document.canRevert()

document.as3WarningsMode

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

document.backgroundColor document.canEditSymbol() document.canSaveAVersion() document.canTestMovie() document.canTestScene() document.clipCopy() document.clipCut() document.clipPaste() document.close()

document.changeFilterOrder()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

document.convertLinesToFills() document.convertToSymbol() document.crop() document.currentPublishProfile document.currentTimeline document.deleteEnvelope() document.deleteScene() document.description document.disableFilter() document.distribute() document.docClass

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

document.deletePublishProfile() document.deleteSelection() document.disableAllFilters()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

document.disableOtherFilters() document.distributeToLayers() document.documentHasData() document.duplicateScene() document.duplicateSelection() document.editScene() document.enableFilter() document.enableAllFilters() document.enterEditMode()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

document.duplicatePublishProfile()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

EXTENSION DE FLASH CS4 PROFESSIONAL vi

Sommaire

document.exitEditMode() document.exportPNG()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

document.exportPublishProfile() document.exportSWF() document.forceSimple document.frameRate

document.exportPublishProfileString() document.externalLibraryPath

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

document.getAlignToDocument() document.getBlendMode() document.getCustomFill() document.getCustomStroke() document.getElementProperty() document.getElementTextAttr() document.getFilters() document.getMetadata()

document.getDataFromDocument()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

document.getMobileSettings() document.getPlayerVersion() document.getSelectionRect() document.getTextString() document.getTimeline() document.group() document.height document.id

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

document.getTransformationPoint()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

document.importFile()

document.importPublishProfile() document.importSWF() document.intersect() document.library document.libraryPath document.livePreview document.match() document.mouseClick() document.mouseDblClk()

document.importPublishProfileString()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

document.moveSelectedBezierPointsBy() document.moveSelectionBy() document.name document.path document.optimizeCurves() document.pathURI document.publish() document.punch()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

document.publishProfiles

EXTENSION DE FLASH CS4 PROFESSIONAL vii

Sommaire

document.removeAllFilters()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

document.removeDataFromDocument() document.removeDataFromSelection() document.removeFilter() document.renameScene() document.reorderScene() document.resetOvalObject() document.renamePublishProfile()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

document.resetRectangleObject() document.resetTransformation() document.revert() document.revertToLastVersion() document.rotate3DSelection() document.rotateSelection() document.save() document.saveAndCompact() document.saveAVersion() document.scaleSelection() document.screenOutline document.selectAll() document.selection document.selectNone()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

document.setAlignToDocument() document.setBlendMode() document.setCustomFill() document.setCustomStroke() document.setElementTextAttr() document.setFillColor() document.setFilters() document.setFilterProperty() document.setInstanceAlpha() document.setInstanceTint() document.setMetadata()

document.setElementProperty()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

document.setInstanceBrightness()

document.setMobileSettings() document.setPlayerVersion()

document.setOvalObjectProperty()

document.setRectangleObjectProperty() document.setSelectionBounds() document.setSelectionRect() document.setStageViewAngle() document.setStroke() document.setStrokeColor() document.setStrokeSize()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

document.setStageVanishingPoint()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

EXTENSION DE FLASH CS4 PROFESSIONAL viii

Sommaire

document.setStrokeStyle() document.setTextSelection() document.setTextString() document.silent

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

document.setTextRectangle()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

document.setTransformationPoint() document.skewSelection() document.sourcePath document.space()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

document.smoothSelection()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

document.straightenSelection() document.swapElement() document.swapStrokeAndFill() document.testMovie() document.testScene() document.timelines document.traceBitmap()

document.synchronizeWithHeadVersion()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

document.translate3DCenter() document.transformSelection() document.unGroup() document.union()

document.translate3DSelection()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

document.unlockAllElements() document.viewMatrix document.width document.xmlPanel() document.zoomFactor

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Chapitre 12 : Objet drawingLayer drawingLayer.beginDraw() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 drawingLayer.beginFrame() drawingLayer.cubicCurveTo() drawingLayer.curveTo() drawingLayer.drawPath() drawingLayer.endDraw() drawingLayer.endFrame() drawingLayer.lineTo() drawingLayer.moveTo() drawingLayer.newPath() drawingLayer.setColor() drawingLayer.setFill() drawingLayer.setStroke() Chapitre 13 : Objet Edge edge.cubicSegmentIndex edge.getControl() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

EXTENSION DE FLASH CS4 PROFESSIONAL ix

Sommaire

edge.getHalfEdge() edge.id edge.isLine

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

edge.setControl() edge.splitEdge() edge.stroke

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Chapitre 14 : Objet Element element.depth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 element.elementType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 element.getPersistentData() element.hasPersistentData() element.height element.layer element.left element.locked element.matrix element.name element.rotation element.scaleX element.scaleY element.selected

element.getTransformationPoint()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

element.removePersistentData()

element.setPersistentData() element.skewX element.skewY element.top

element.setTransformationPoint()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

element.transformX element.transformY element.width element.x element.y

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Chapitre 15 : Objet Fill fill.bitmapIsClipped . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 fill.bitmapPath fill.color fill.colorArray fill.focalPoint fill.linearRGB fill.matrix fill.overflow fill.posArray fill.style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

EXTENSION DE FLASH CS4 PROFESSIONAL x

Sommaire

Chapitre 16 : Objet Filter filter.angle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 filter.blurX filter.blurY filter.color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

filter.brightness filter.contrast filter.distance filter.enabled filter.hideObject filter.hue filter.inner filter.name filter.quality

filter.highlightColor

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

filter.knockout

filter.saturation filter.strength filter.type

filter.shadowColor

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Chapitre 17 : Objet flash (fl) fl.actionsPanel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 fl.addEventListener() fl.as3PackagePaths fl.browseForFileURL() fl.clipCopyString() fl.closeAll() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

fl.browseForFolderURL()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

fl.closeAllPlayerDocuments() fl.closeDocument() fl.compilerErrors fl.configDirectory fl.configURI fl.componentsPanel

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

fl.contactSensitiveSelection fl.createDocument() fl.createNewDocList

fl.createNewDocListType fl.createNewTemplateList fl.documents fl.drawingLayer fl.fileExists() fl.downloadLatestVersion() fl.externalLibraryPath fl.findDocumentDOM() fl.findDocumentIndex()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

EXTENSION DE FLASH CS4 PROFESSIONAL xi

Sommaire

fl.findObjectInDocByName() fl.findObjectInDocByType() fl.flexSDKPath fl.getAppMemoryInfo() fl.getDocumentDOM() fl.isFontInstalled() fl.libraryPath fl.Math fl.mapPlayerURL() fl.mruRecentFileList fl.objectDrawingMode fl.openDocument() fl.openScript() fl.outputPanel fl.packagePaths fl.presetPanel fl.quit() fl.reloadEffects() fl.reloadTools()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

fl.mruRecentFileListType

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

fl.removeEventListener() fl.resetAS3PackagePaths() fl.resetPackagePaths() fl.revertDocument() fl.runScript() fl.saveAll()

fl.revertDocumentToLastVersion()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

fl.saveAVersionOfDocument() fl.saveDocument() fl.saveDocumentAs() fl.scriptURI fl.selectTool() fl.selectElement()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

fl.setActiveWindow() fl.showIdleMessage() fl.sourcePath fl.swfPanels fl.tools fl.trace() fl.version fl.xmlui

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

fl.synchronizeDocumentWithHeadVersion()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Chapitre 18 : Objet FLfile FLfile.copy() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 FLfile.createFolder() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

EXTENSION DE FLASH CS4 PROFESSIONAL xii

Sommaire

FLfile.exists()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

FLfile.getAttributes() FLfile.getCreationDate()

FLfile.getCreationDateObj() FLfile.getModificationDate() FLfile.getSize() FLfile.listFolder() FLfile.read() FLfile.remove()

FLfile.getModificationDateObj()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

FLfile.platformPathToURI()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

FLfile.setAttributes() FLfile.write()

FLfile.uriToPlatformPath()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Chapitre 19 : Objet folderItem Chapitre 20 : Objet fontItem fontItem.bitmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 fontItem.bold fontItem.font fontItem.italic fontItem.size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 fontItem.embedVariantGlyphs fontItem.isDefineFont4Symbol

Chapitre 21 : Objet Frame frame.actionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 frame.duration frame.elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

frame.getCustomEase() frame.hasCustomEase frame.labelType

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

frame.motionTweenOrientToPath frame.motionTweenRotate frame.motionTweenScale frame.motionTweenSnap frame.motionTweenSync frame.name frame.setCustomEase() frame.shapeTweenBlend frame.soundEffect frame.soundLoop frame.soundName frame.soundLibraryItem frame.soundLoopMode frame.motionTweenRotateTimes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

EXTENSION DE FLASH CS4 PROFESSIONAL xiii

Sommaire

frame.soundSync frame.startFrame frame.tweenEasing frame.tweenType

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

frame.useSingleEaseCurve

Chapitre 22 : Objet halfEdge halfEdge.getEdge() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 halfEdge.getNext() halfEdge.getPrev() halfEdge.getVertex() halfEdge.id halfEdge.index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 halfEdge.getOppositeHalfEdge()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Chapitre 23 : Objet Instance instance.instanceType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 instance.libraryItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Chapitre 24 : Objet Item item.addData() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 item.getData() item.hasData() item.itemType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

item.linkageBaseClass item.linkageClassName item.linkageExportForAS item.linkageExportForRS item.linkageIdentifier item.linkageURL item.name item.removeData()

item.linkageExportInFirstFrame item.linkageImportForRS

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

Chapitre 25 : Objet Layer layer.color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 layer.frameCount layer.frames layer.height layer.locked layer.name layer.outline layer.visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

layer.layerType

layer.parentLayer

EXTENSION DE FLASH CS4 PROFESSIONAL xiv

Sommaire

Chapitre 26 : Objet library library.addItemToDocument() library.addNewItem() library.deleteItem() library.editItem() library.duplicateItem() library.expandFolder() library.findItemIndex() library.getItemProperty() library.getItemType() library.getSelectedItems() library.itemExists() library.items

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

library.importEmbeddedSWF()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

library.moveToFolder() library.newFolder() library.renameItem() library.selectAll() library.selectItem() library.selectNone() library.updateItem()

library.setItemProperty()

Chapitre 27 : Objet Math Math.concatMatrix() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Math.invertMatrix() Math.pointDistance() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Chapitre 28 : Objet Matrix matrix.a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 matrix.b matrix.c matrix.d matrix.tx matrix.ty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Chapitre 29 : Objet outputPanel outputPanel.clear() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 outputPanel.save() outputPanel.trace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Chapitre 30 : Objet Oval OvalObject.closePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 OvalObject.endAngle OvalObject.innerRadius OvalObject.startAngle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

EXTENSION DE FLASH CS4 PROFESSIONAL xv

Sommaire

Chapitre 31 : Objet Parameter parameter.category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 parameter.insertItem() parameter.listIndex parameter.name parameter.value parameter.verbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

parameter.removeItem() parameter.valueType

Chapitre 32 : Objet Path path.addCubicCurve() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 path.addCurve() path.addPoint() path.clear() path.close() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

path.makeShape() path.newContour() path.nPts

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

Chapitre 33 : Objet presetItem presetItem.isDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 presetItem.isFolder presetItem.level presetItem.name presetItem.open presetItem.path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Chapitre 34 : Objet presetPanel presetPanel.addNewItem() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 presetPanel.applyPreset() presetPanel.deleteFolder() presetPanel.deleteItem() presetPanel.expandFolder() presetPanel.exportItem() presetPanel.findItemIndex() presetPanel.importItem() presetPanel.items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

presetPanel.getSelectedItems()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

presetPanel.moveToFolder() presetPanel.newFolder() presetPanel.renameItem() presetPanel.selectItem()

Chapitre 35 : Objet Rectangle RectangleObject.bottomLeftRadius RectangleObject.bottomRightRadius RectangleObject.lockFlag

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

EXTENSION DE FLASH CS4 PROFESSIONAL xvi

Sommaire

RectangleObject.topLeftRadius RectangleObject.topRightRadius

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

Chapitre 36 : Objet Screen screen.accName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 screen.childScreens screen.description screen.forceSimple screen.hidden screen.name screen.instanceName screen.nextScreen screen.parameters screen.parentScreen screen.prevScreen screen.silent screen.tabIndex screen.timeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

Chapitre 37 : Objet ScreenOutline screenOutline.copyScreenFromFile() screenOutline.currentScreen screenOutline.deleteScreen()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

screenOutline.duplicateScreen()

screenOutline.getSelectedScreens() screenOutline.insertNestedScreen() screenOutline.insertScreen() screenOutline.moveScreen() screenOutline.renameScreen() screenOutline.rootScreen screenOutline.screens

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

screenOutline.setCurrentScreen() screenOutline.setScreenProperty() screenOutline.setSelectedScreens()

Chapitre 38 : Objet Shape shape.beginEdit() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 shape.contours shape.edges shape.endEdit() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 shape.deleteEdge()

shape.getCubicSegmentPoints() shape.isDrawingObject shape.isGroup shape.isOvalObject shape.members

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

shape.isRectangleObject

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

EXTENSION DE FLASH CS4 PROFESSIONAL xvii

Sommaire

shape.numCubicSegments shape.vertices

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

Chapitre 39 : Objet SoundItem soundItem.bitRate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 soundItem.bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 soundItem.compressionType soundItem.exportToFile()

soundItem.convertStereoToMono soundItem.fileLastModifiedDate soundItem.quality

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

soundItem.originalCompressionType soundItem.sampleRate

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

soundItem.sourceFileExists soundItem.sourceFilePath

soundItem.sourceFileIsCurrent

soundItem.useImportedMP3Quality

Chapitre 40 : Objet Stroke stroke.breakAtCorners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 stroke.capType stroke.color stroke.curve stroke.dash1 stroke.dash2 stroke.density stroke.dotSize stroke.dotSpace stroke.jiggle stroke.length stroke.pattern stroke.rotate stroke.shapeFill stroke.space stroke.style stroke.scaleType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

stroke.hatchThickness stroke.joinType stroke.miterLimit

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

stroke.strokeHinting stroke.thickness stroke.variation stroke.waveHeight stroke.waveLength

EXTENSION DE FLASH CS4 PROFESSIONAL xviii

Sommaire

Chapitre 41 : Objet swfPanel swfPanel.call() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 swfPanel.name swfPanel.path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

Chapitre 42 : Objet SymbolInstance symbolInstance.accName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 symbolInstance.actionScript symbolInstance.blendMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

symbolInstance.buttonTracking symbolInstance.cacheAsBitmap symbolInstance.colorAlphaPercent symbolInstance.colorBlueAmount symbolInstance.colorBluePercent

symbolInstance.colorAlphaAmount

symbolInstance.colorGreenAmount symbolInstance.colorGreenPercent symbolInstance.colorMode symbolInstance.colorRedAmount symbolInstance.colorRedPercent symbolInstance.description symbolInstance.filters symbolInstance.firstFrame symbolInstance.forceSimple symbolInstance.loop symbolInstance.silent symbolInstance.shortcut

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

symbolInstance.symbolType symbolInstance.tabIndex

Chapitre 43 : Objet SymbolItem symbolItem.convertToCompiledClip() symbolItem.exportSWC() symbolItem.exportSWF() symbolItem.scalingGrid

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

symbolItem.scalingGridRect symbolItem.sourceFilePath symbolItem.symbolType symbolItem.timeline

symbolItem.sourceAutoUpdate symbolItem.sourceLibraryName

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

Chapitre 44 : Objet Text text.accName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 text.antiAliasSharpness text.antiAliasThickness text.autoExpand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

EXTENSION DE FLASH CS4 PROFESSIONAL xix

Sommaire

text.border

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

text.description text.embedRanges

text.embeddedCharacters text.embedVariantGlyphs text.fontRenderingMode text.getTextAttr() text.getTextString() text.length text.lineType text.orientation text.scrollable text.selectable

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

text.maxCharacters text.renderAsHTML

text.selectionEnd text.selectionStart text.setTextAttr() text.setTextString() text.shortcut text.silent text.tabIndex text.textRuns text.textType

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

text.useDeviceFonts text.variableName

Chapitre 45 : Objet TextAttrs textAttrs.aliasText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 textAttrs.alignment textAttrs.autoKern textAttrs.bold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

textAttrs.characterPosition textAttrs.characterSpacing textAttrs.face textAttrs.indent textAttrs.italic textAttrs.fillColor

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

textAttrs.leftMargin textAttrs.letterSpacing textAttrs.lineSpacing textAttrs.rightMargin textAttrs.rotation textAttrs.size textAttrs.target textAttrs.url

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

EXTENSION DE FLASH CS4 PROFESSIONAL xx

Sommaire

Chapitre 46 : Objet TextRun textRun.textAttrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 textRun.characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

Chapitre 47 : Objet Timeline timeline.addMotionGuide() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 timeline.addNewLayer() timeline.clearFrames() timeline.clearKeyframes() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480

timeline.convertToBlankKeyframes() timeline.convertToKeyframes() timeline.copyFrames() timeline.copyMotion()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

timeline.copyMotionAsAS3() timeline.createMotionTween() timeline.currentFrame timeline.currentLayer timeline.cutFrames() timeline.deleteLayer() timeline.expandFolder() timeline.findLayerIndex() timeline.frameCount

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

timeline.getFrameProperty() timeline.getGuidelines() timeline.getLayerProperty() timeline.getSelectedFrames() timeline.getSelectedLayers() timeline.insertBlankKeyframe() timeline.insertFrames() timeline.insertKeyframe() timeline.layerCount timeline.layers timeline.name

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499

timeline.pasteFrames() timeline.pasteMotion() timeline.removeFrames() timeline.reorderLayer() timeline.reverseFrames() timeline.selectAllFrames()

timeline.setFrameProperty() timeline.setGuidelines() timeline.setLayerProperty() timeline.setSelectedFrames() timeline.setSelectedLayers() timeline.showLayerMasking()

EXTENSION DE FLASH CS4 PROFESSIONAL xxi

Sommaire

Chapitre 48 : Objet ToolObj toolObj.depth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 toolObj.enablePIControl() toolObj.iconID toolObj.position toolObj.setIcon() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

toolObj.setMenuString() toolObj.setOptionsFile() toolObj.setPI() toolObj.setToolName() toolObj.setToolTip() toolObj.showPIControl()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508

toolObj.showTransformHandles()

Chapitre 49 : Objet Tools tools.activeTool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512 tools.altIsDown tools.ctlIsDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 tools.constrainPoint() tools.getKeyDown() tools.mouseIsDown tools.penDownLoc tools.penLoc tools.setCursor() tools.shiftIsDown tools.snapPoint() tools.toolObjs

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516

Chapitre 50 : Objet Vertex vertex.getHalfEdge() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 vertex.setLocation() vertex.x vertex.y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521

Chapitre 51 : Objet VideoItem videoItem.exportToFLV() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 videoItem.fileLastModifiedDate videoItem.sourceFileExists videoItem.sourceFilePath videoItem.videoType videoItem.sourceFileIsCurrent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525

Chapitre 52 : Objet XMLUI xmlui.accept() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 xmlui.cancel() xmlui.get() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

xmlui.getControlItemElement() xmlui.getEnabled()

EXTENSION DE FLASH CS4 PROFESSIONAL xxii

Sommaire

xmlui.getVisible() xmlui.set()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

xmlui.setControlItemElement() xmlui.setControlItemElements() xmlui.setEnabled() xmlui.setVisible()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

Chapitre 53 : Extensibilit de niveau C A propos de l'extensibilit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 Intgration de fonctions en C Types de donnes API de niveau C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

Chapitre 1 : Prsentation
En tant qu'utilisateur de l'application Adobe Flash CS4 Professional, vous connaissez peut-tre le code AdobeActionScript qui permet de crer des scripts s'excutant dans Adobe Flash Player au moment de son excution. L'interface de programmation d'applications JavaScript (ou API JavaScript) de Flash dcrite dans ce document est un outil de programmation complmentaire qui permet de crer des scripts exploitables dans l'environnement de programmation. Ce document dcrit les objets, mthodes et proprits disponibles dans l'API JavaScript. Il suppose la matrise des commandes de lenvironnement de programmation. Pour toute question au sujet du rle d'une commande spcifique, consultez d'autres documents dans l'aide de Flash, comme Utilisation de Flash. Ce document suppose galement que vous connaissez la syntaxe JavaScript ou ActionScript et les concepts de base de la programmation (fonctions, paramtres et types de donnes).

Utilisation de l'API JavaScript

L'API Flash JavaScript permet dcrire des scripts destins effectuer plusieurs actions dans lenvironnement de dveloppement Flash (pendant que l'utilisateur excute le programme Flash). Cette fonctionnalit est diffrente du langage ActionScript qui permet dcrire des scripts destins effectuer des actions dans l'environnement Flash Player (pendant la lecture dun fichier SWF). Elle diffre galement des commandes JavaScript utilisables dans les pages qui s'affichent dans un navigateur Web. Grce l'utilisation de l'API JavaScript, vous crivez des scripts d'application Flash qui permettent de simplifier le processus de programmation. Par exemple, vous pouvez crire des scripts pour automatiser des tches rptitives ou ajouter des outils personnaliss au panneau Outils. LAPI JavaScript de Flash a t conue sur le mme modle que les API JavaScript d'Adobe Dreamweaver et d'Adobe Fireworks (elles-mmes bases sur lAPI JavaScript de Netscape). LAPI JavaScript de Flash repose sur un modle d'objet document (DOM, Document Object Model) qui permet daccder aux documents Flash laide dobjets crs en JavaScript. Elle comporte tous les lments de lAPI JavaScript de Netscape, ainsi que le DOM de Flash. Les objets qui sont ajouts, ainsi que leurs mthodes et proprits, sont dcrits dans le prsent document. Vous pouvez utiliser tous les lments du langage JavaScript natif dans un script Flash, mais seuls les lments dont lutilisation est logique dans le contexte dun document Flash prendront effet. L'API JavaScript contient galement un certain nombre de mthodes qui permettent dimplmenter des extensions par une combinaison de code JavaScript et C personnalis. Pour plus d'informations, consultez la section Extensibilit de niveau C la page 534. Linterprteur JavaScript de Flash est la version 1.5 du moteur SpiderMonkey de Mozilla, disponible sur le Web ladresse suivante www.mozilla.org/js/spidermonkey/. SpiderMonkey, lune des deux implmentations de rfrence du langage JavaScript dvelopp par Mozilla.org, est intgr au navigateur Mozilla. SpiderMonkey implmente le langage JavaScript de base tel quil est dfini par la spcification ECMAScript (ECMA262) dition 3 et est conforme tous les niveaux celle-ci. Seuls les objets hte propres au navigateur (qui ne figurent pas dans la spcification ECMA-262) ne sont pas pris en charge. De mme, de nombreux guides de rfrence JavaScript tablissent une distinction entre le langage JavaScript de base et le langage JavaScript ct client (associ au navigateur). Seul le langage JavaScript de base s'applique l'interprteur Flash JavaScript.

EXTENSION DE FLASH CS4 PROFESSIONAL 2

Prsentation

Cration de fichiers JSFL

Pour crer et modifier des fichiers JavaScript Flash, ou fichiers JSFL, utilisez Adobe Flash CS4 Professional ou un diteur de texte de votre choix. Si vous utilisez Flash, ces fichiers auront par dfaut lextension .jsfl. Pour rdiger un script, slectionnez Fichier > Nouveau > Fichier Flash JavaScript. Il est galement possible de crer un fichier JSFL en slectionnant des commandes dans le panneau Historique. Puis, cliquez sur le bouton Enregistrer du panneau Historique ou choisissez Enregistrer comme commande dans le menu. Le fichier de commandes est alors enregistr dans le dossier Commands avec lextension JSFL (voir Enregistrement des fichiers JSFL la page 2). Vous pouvez ensuite louvrir et le modifier comme tout autre fichier script. Le panneau Historique fournit lui aussi d'autres options utiles. Vous pouvez copier les commandes slectionnes dans le presse-papiers et visualiser les commandes JavaScript qui sont gnres pendant votre travail dans Flash. Pour copier des commandes dans le presse-papiers partir du panneau Historique : 1 Slectionnez une ou plusieurs commandes dans le panneau Historique.
2 Effectuez l'une des oprations suivantes :

Cliquez sur le bouton Copier. Dans le menu du panneau, slectionnez Copier ces tapes.
Pour visualiser les commandes JavaScript dans le panneau Historique : Dans le menu du panneau, choisissez Affichage > JavaScript dans le panneau.

Enregistrement des fichiers JSFL

Vous pouvez rendre les scripts JSFL disponibles dans l'environnement de programmation Flash en les stockant dans un ou plusieurs sous-dossiers du dossier Configuration. Par dfaut, le dossier Configuration se trouve l'emplacement suivant :

Windows Vista :
lecteur d'amorage\Utilisateurs\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\

Windows XP :
lecteur d'amorage\Documents and Settings\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\

Mac OS X :
DD Macintosh/Users/nom d'utilisateur/Library/Application Support/Adobe/Flash CS4/langue/Configuration/ Pour dterminer l'emplacement du dossier Configuration, utilisez fl.configDirectory ou fl.configURI, comme dans l'exemple suivant :
// store directory to a variable var configDir = fl.configDirectory; // display directory in the Output panel fl.trace(fl.configDirectory);

EXTENSION DE FLASH CS4 PROFESSIONAL 3

Prsentation

Dans le dossier Configuration, les dossiers suivants peuvent contenir des scripts auxquels vous pouvez accder dans l'environnement de programmation : Behaviors (pour prendre en charge l'interface utilisateur des comportements), Commands (pour les scripts qui figurent dans le menu Commandes), JavaScript (pour les scripts utiliss par l'Assistant de script), Tools (pour les outils extensibles du panneau Outils) et WindowSWF (pour les panneaux qui s'affichent dans le menu Fentres). Ce document aborde les scripts utiliss pour les commandes et les outils. Si vous modifiez un script dans le dossier Commands, il est immdiatement disponible dans Flash. Si vous modifiez un script pour un outil extensible, fermez et redmarrez Flash, ou utilisez la commande fl.reloadTools(). Toutefois, si vous avez utilis un script pour ajouter un outil extensible au panneau Outils puis que vous modifiez ce script, supprimez l'outil du panneau Outils puis ajoutez-le de nouveau, ou fermez Flash et redmarrez-le, pour que l'outil modifi soit disponible. Pour tre accessibles partir de lenvironnement de programmation, les fichiers de commandes et d'outils peuvent tre stocks en deux endroits diffrents.

Pour les scripts qui prennent la forme d'lments du menu Commandes, enregistrez les fichiers JSFL dans le dossier
Commands qui se trouve l'emplacement suivant :
Systme d'exploitation Windows Vista Emplacement lecteur d'amorage\Users\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\Commands lecteur d'amorage\Documents and Settings\utilisateur\Local Settings\Application Data\Adobe\ FlashCS4\langue\Configuration\Commands Disque dur Macintosh/Utilisateurs/utilisateur/Library/Application Support/Adobe/FlashCS4/langue/Configuration/Commands

Windows XP

Mac OS X

Pour les scripts qui prennent la forme d'outils extensibles dans le panneau Outils, enregistrez les fichiers JSFL dans
le dossier Tools qui se trouve l'emplacement suivant :
Systme d'exploitation Windows Vista Emplacement lecteur d'amorage\Users\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\Tools lecteur d'amorage\Documents and Settings\utilisateur\Local Settings\Application Data\Adobe\FlashCS4\langue\Configuration\Tools Disque dur Macintosh/Utilisateurs/utilisateur/Library/Application Support/Adobe/FlashCS4/langue/Configuration/Tools

Windows XP

Mac OS X

Si d'autres fichiers doivent accompagner un fichier JSFL, par exemple des fichiers XML, enregistrez-les dans le mme rpertoire que ce fichier JSFL.

Excution des scripts

Il existe plusieurs manires d'excuter des scripts. Les plus courantes sont dveloppes dans la section ci-dessous. Pour excuter un script affich ou en cours de modification : Cliquez du bouton droit (touche Commande sous Macintosh) et choisissez Excuter le script.

Cliquez sur l'icne Excuter le script de la barre d'outils de la fentre du script.

Cette option vous permet d'excuter un script avant de l'avoir enregistr. Elle vous permet galement d'excuter un script mme si aucun fichier FLA n'est ouvert.

EXTENSION DE FLASH CS4 PROFESSIONAL 4

Prsentation

Pour excuter un script stock dans le dossier Commands, effectuez l'une des actions suivantes : Dans l'environnement de programmation, choisissez Commandes > Nom du script.

Utilisez un raccourci clavier que vous aurez attribu au script. Pour attribuer un raccourci clavier, utilisez Edition >
Raccourcis clavier, puis choisissez Commandes du menu dessin dans la liste droulante Commandes. Dveloppez le noeud Commandes de l'arborescence afin d'afficher la liste des scripts disponibles. Pour excuter un script de commandes qui ne rside pas dans le dossier Commands, effectuez l'une des actions suivantes : Dans l'environnement de programmation, choisissez Commandes > Excuter une commande, puis slectionnez le script excuter.

Depuis un script, utilisez la commande fl.runScript(). Dans le systme de fichiers, double-cliquez sur le fichier de script.
Pour ajouter dans le panneau Outils un lment implment dans un fichier JSFL : 1 Copiez le fichier JSFL de cet outil (ainsi que les ventuels autres fichiers associs) dans le dossier Tools (voir Enregistrement des fichiers JSFL la page 2).
2 Choisissez Edition > Personnaliser le panneau Outils (Windows) ou Flash > Personnaliser le panneau Outils

(Macintosh).
3 Ajoutez le nouvel outil la liste des outils disponibles. 4 Cliquez sur OK.

Vous pouvez ajouter des commandes individuelles de l'API JavaScript dans un fichier ActionScript laide de la fonction MMExecute() dcrite dans le Guide de rfrence du langage ActionScript 3.0. Toutefois, la fonction MMExecute() nest excute que dans le contexte dun lment dinterface utilisateur personnalis, par exemple comme composant de l'inspecteur Proprits, ou dans un panneau SWF au sein de lenvironnement de programmation. Mme si elles sont appeles par ActionScript, les commandes API JavaScript sont inoprantes dans Flash Player ou hors de l'environnement de programmation. Pour lancer une commande partir d'un script ActionScript : Employez la syntaxe suivante (vous pouvez concatner plusieurs commandes en une seule chane) :
MMExecute(Javascript command string);

Vous pouvez galement excuter un script partir de la ligne de commande. Pour excuter un script partir de la ligne de commande de Windows : Utilisez la syntaxe suivante (en ajoutant les informations requises concernant le chemin d'accs) :
"flash.exe" myTestFile.jsfl

Pour excuter un script partir de l'application Terminal sur Macintosh : Utilisez la syntaxe suivante (en ajoutant les informations requises concernant le chemin d'accs) :
osascript -e 'tell application "flash" to open alias "Mac OS X:Users:user:myTestFile.jsfl" '

La commande osascript peut elle aussi excuter du code AppleScript dans un fichier. Par exemple, vous pouvez placer le texte suivant dans un fichier nomm myScript :

EXTENSION DE FLASH CS4 PROFESSIONAL 5

Prsentation

tell application "flash" open alias "Mac OS X:Users:user:myTestFile.jsfl" end tell

Ensuite, pour excuter le script, utilisez la commande suivante :

osascript myScript

Nouveauts de l'API JavaScript

Dans Flash CS4, certains objets, mthodes et proprits ont t ajouts et d'autres supprims. Ces modifications sont rsumes ci-dessous. Si vous navez encore jamais utilis l'API JavaScript, vous pouvez passer directement la section Objets de l'API JavaScript la page 8.

Nouveaux objets
Les objets suivants sont une nouveaut de Flash CS4 : Objet presetPanel Objet presetItem Objet swfPanel

Nouvelles mthodes et proprits

Les mthodes et proprits suivantes des objets existants constituent une nouveaut dans Flash CS4 :

Objet BitmapItem
bitmapItem.exportToFile() bitmapItem.fileLastModifiedDate bitmapItem.originalCompressionType bitmapItem.sourceFileExists bitmapItem.sourceFileIsCurrent bitmapItem.sourceFilePath bitmapItem.useDeblocking

Objet Contour
contour.fill

Objet Document
document.addNewPrimitiveOval() document.addNewPrimitiveRectangle() document.exportPublishProfileString() document.externalLibraryPath document.importPublishProfileString() document.libraryPath

EXTENSION DE FLASH CS4 PROFESSIONAL 6

Prsentation

document.pathURI document.rotate3DSelection document.setStageVanishingPoint() document.setStageViewAngle() document.sourcePath document.translate3DCenter() document.translate3DSelection()

Objet Edge
edge.cubicSegmentIndex edge.stroke

Objet Fill
fill.bitmapIsClipped fill.bitmapPath

Objet flash (fl)

fl.externalLibraryPath fl.flexSDKPath fl.isFontInstalled() fl.libraryPath fl.presetPanel fl.sourcePath fl.swfPanels

Objet FLfile
FLfile.platformPathToURI() FLfile.uriToPlatformPath()

Objet fontItem
fontItem.bitmap fontItem.bold fontItem.embedVariantGlyphs fontItem.font fontItem.isDefineFont4Symbol fontItem.italic fontItem.size

Objet Shape
shape.getCubicSegmentPoints() shape.members shape.numCubicSegments

EXTENSION DE FLASH CS4 PROFESSIONAL 7

Prsentation

Objet SoundItem
soundItem.exportToFile() soundItem.fileLastModifiedDate soundItem.originalCompressionType soundItem.sourceFileExists soundItem.sourceFileIsCurrent soundItem.sourceFilePath

Objet Text
text.embedVariantGlyphs

Objet Timeline
timeline.getGuidelines() timeline.setGuidelines()

Objet VideoItem
videoItem.exportToFLV() videoItem.fileLastModifiedDate videoItem.sourceFileExists videoItem.sourceFileIsCurrent

Autres modifications
La proprit suivante a une nouvelle valeur dans Flash CS4 :

fill.style

Les objets, mthodes et proprits suivants ne sont plus disponibles dans Flash CS4 :

Objet Project Objet ProjectItem

fl.openProject() fl.closeProject() fl.createProject() fl.getProject()

Objet Effect
configureEffect() executeEffect() removeEffect() fl.activeEffect fl.effects fl.enableImmediateUpdates() fl.reloadEffects()

EXTENSION DE FLASH CS4 PROFESSIONAL 8

Prsentation

Objets de l'API JavaScript

Cette section rsume les objets disponibles dans l'API JavaScript de Flash et dcrit leur utilisation. Toutes les commandes JavaScript habituelles sont galement disponibles avec l'API JavaScript. Le tableau suivant dcrit brivement chacun des objets de l'API JavaScript. Les objets apparaissent par ordre alphabtique.
Objet Objet actionsPanel Objet BitmapInstance Description L'objet actionsPanel reprsente le panneau Actions actuellement affich. L'objet BitmapInstance est une sous-classe de lobjet Instance et reprsente un bitmap dans une image. L'objet BitmapItem fait rfrence une image bitmap dans la bibliothque dun document. Lobjet BitmapItem est une sous-classe de lobjet Item. Lobjet CompiledClipInstance est une sous-classe de lobjet Instance. Lobjet compilerErrors reprsente le panneau Erreurs de compilation. Il s'agit d'une proprit de lobjet flash (fl.compilerErrors). Lobjet ComponentInstance est une sous-classe de lobjet SymbolInstance et reprsente un composant dans une image. Lobjet componentsPanel, qui reprsente le panneau Composants, est une proprit de lobjet flash (fl.componentsPanel). L'objet Contour reprsente un trac ferm en tirets marquant les limites dune forme. Lobjet Document reprsente la scne. Lobjet drawingLayer est accessible en JavaScript sous forme dun enfant de lobjet flash. Lobjet Edge reprsente les limites dune forme sur la scne. Tout ce qui apparat sur la scne est du type Element. Lobjet Fill contient toutes les proprits du paramtre de couleur de remplissage du panneau Outils ou de la forme slectionne. L'objet Filter contient toutes les proprits de tous les filtres. Lobjet flash reprsente lapplication Flash. Lobjet FLfile permet de crer des extensions Flash capables daccder aux dossiers et fichiers locaux, de les modifier et de les supprimer. Lobjet folderItem est une sous-classe de lobjet Item. Lobjet fontItem est une sous-classe de lobjet Item. Lobjet Frame reprsente les images du calque. Ct dirig du bord dun objet Shape. Lobjet Instance est une sous-classe de lobjet Element. Lobjet Item est une classe de base abstraite. Lobjet Layer reprsente un calque dans le scnario. Lobjet library reprsente le panneau Bibliothque. L'objet Math est disponible sous forme de proprit en lecture seule de l'objet flash (fl.Math).

Objet BitmapItem

Objet CompiledClipInstance Objet compilerErrors

Objet ComponentInstance

Objet componentsPanel

Objet Contour Objet Document Objet drawingLayer Objet Edge Objet Element Objet Fill

Objet Filter Objet flash (fl) Objet FLfile

Objet folderItem Objet fontItem Objet Frame Objet halfEdge Objet Instance Objet Item Objet Layer Objet library Objet Math

EXTENSION DE FLASH CS4 PROFESSIONAL 9

Prsentation

Objet Objet Matrix Objet outputPanel

Description Lobjet Matrix reprsente une matrice de transformation. Lobjet outputPanel reprsente le panneau Sortie, qui affiche des informations facilitant le dbogage, par exemple les erreurs de syntaxe. Il s'agit d'une proprit de lobjet flash (fl.outputPanel). L'objet Oval est une forme trace l'aide de l'outil Ovale. Pour savoir si un lment est un objet Oval, utilisez shape.isOvalObject. Le type dobjet Parameter figure dans le tableau screen.parameters (qui correspond la fentre de linspecteur Proprits dans lenvironnement de programmation Flash) ou dans le tableau componentInstance.parameters (qui correspond au composant inspecteur Proprits dans lenvironnement de programmation). Lobjet Path dfinit une squence de segments de ligne (droite, courbe ou les deux), qui est particulirement destine la cration doutils extensibles. L'objet presetItem reprsente un lment (prslection ou dossier) du panneau Prslections de mouvement. L'objet presetPanel reprsente le panneau Prslections de mouvement (Fentre > Prslections de mouvement). Il s'agit d'une proprit de l'objet flash (fl.presetPanel). L'objet Rectangle est une forme trace l'aide de l'outil Rectangle. Pour savoir si un lment est un objet Rectangle, utilisez shape.isRectangleObject. Lobjet Screen reprsente un seul cran dans une diapositive ou un formulaire. Lobjet ScreenOutline reprsente le groupe dcrans dune diapositive ou dun formulaire. Lobjet Shape est une sous-classe de lobjet Element. Lobjet Shape autorise un contrle plus prcis que les API de dessin pour la manipulation ou la cration de formes gomtriques sur la scne. Lobjet SoundItem est une sous-classe de lobjet Item. Il reprsente un lment de bibliothque qui est utilis pour crer un son. Lobjet Stroke contient tous les paramtres dun trait, y compris les paramtres personnaliss. Lobjet swfPanel reprsente un panneau Windows SWF. Les panneaux Windows SWF sont des fichiers SWF qui implmentent des applications excutables dans lenvironnement de programmation Flash. Le tableau d'objets swfPanel est une proprit de l'objet flash (fl.swfPanels). Lobjet SymbolInstance est une sous-classe de lobjet Instance et reprsente un symbole dans une image. Lobjet SymbolItem est une sous-classe de lobjet Item. Lobjet Text reprsente un lment de texte unique dans un document. Lobjet TextAttrs contient toutes les proprits de texte pouvant tre appliques une sousslection. Cet objet est une sous-classe de lobjet Texte. Lobjet TextRun reprsente un flux de caractres dont les attributs correspondent toutes les proprits de lobjet TextAttrs. Lobjet Timeline reprsente le scnario Flash, qui est accessible, pour le document actuel, laide de fl.getDocumentDOM().getTimeline(). L'objet toolObj reprsente un outil individuel dans le panneau Outils. Lobjet Tools est accessible partir de lobjet flash (fl.tools).

Objet Oval

Objet Parameter

Objet Path

Objet presetItem

Objet presetPanel

Objet Rectangle

Objet Screen Objet ScreenOutline Objet Shape

Objet SoundItem

Objet Stroke Objet swfPanel

Objet SymbolInstance

Objet SymbolItem Objet Text Objet TextAttrs

Objet TextRun

Objet Timeline

Objet ToolObj Objet Tools

EXTENSION DE FLASH CS4 PROFESSIONAL 10

Prsentation

Objet Objet Vertex

Description Lobjet Vertex est la partie de la structure des donnes dune forme qui contient les coordonnes. Lobjet VideoItem est une sous-classe de lobjet Item. Lobjet XMLUI permet de lire et dfinir les proprits dune bote de dialogue XMLUI, et den accepter ou d'en annuler une.

Objet VideoItem Objet XMLUI

Modle d'objet document (DOM) de Flash

Le DOM de l'API JavaScript de Flash se compose dun ensemble de fonctions de haut niveau (voir Fonctions et mthodes de haut niveau la page 16) et de deux objets de haut niveau : FLfile et flash (fl). La disponibilit de chaque objet dans les scripts est assure, puisqu'il existe ds l'ouverture de l'environnement de programmation de Flash. Pour plus d'informations, consultez les sections Objet FLfile et Objet flash (fl). La rfrence l'objet flash peut tre flash ou fl. Par exemple, pour fermer tous les fichiers FLA ouverts, vous pouvez utiliser l'une des instructions suivantes :
flash.closeAll(); fl.closeAll();

Lobjet flash contient les objets enfant suivants :

Objet Objet actionsPanel Accs Utilisez fl.actionsPanel pour accder l'objet actionsPanel. Cet objet correspond au panneau Actions de lenvironnement de programmation Flash. Utilisez fl.compilerErrors pour accder l'objet compilerErrors. Cet objet correspond au panneau Erreurs de compilation dans l'environnement de programmation Flash. Utilisez fl.componentsPanel pour accder l'objet componentsPanel. Cet objet correspond au panneau Composants de l'environnement de programmation Flash. Utilisez fl.documents pour rcuprer dans un tableau la liste de tous les documents ouverts ; utilisez fl.documents[index] pour accder un document particulier ; et utilisez fl.getDocumentDOM() pour accder au document actif (celui qui a le focus). Utilisez fl.drawingLayer pour accder l'objet drawingLayer. Utilisez fl.Math pour accder l'objet Math. Utilisez fl.outputPanel pour accder l'objet outputPanel. Cet objet correspond au panneau Sortie de lenvironnement de programmation Flash. Utilisez fl.presetPanel pour accder l'objet presetPanel. Cet objet correspond au panneau Prslections de mouvement (Fentre > Prslections de mouvement). Utilisez fl.swfPanels pour accder un tableau d'objets swfPanel. Ces objets correspondent aux panneaux Window SWF. Utilisez fl.tools pour accder un tableau d'objets Tools. Utilisez fl.xmlui pour accder un objet de linterface utilisateur XML (XMLUI). L'objet XMLUI permet de lire et dfinir les proprits d'une bote de dialogue de XMLUI.

Objet compilerErrors

Objet componentsPanel

Objet Document

Objet drawingLayer Objet Math Objet outputPanel

Objet presetPanel

Objet swfPanel

Objet Tools Objet XMLUI

EXTENSION DE FLASH CS4 PROFESSIONAL 11

Prsentation

Objet Document
La proprit fl.documents est lune des plus importantes de lobjet de haut niveau flash. Cette proprit contient un tableau d'objets Document, reprsentant chacun l'un des fichiers FLA actuellement ouverts dans l'environnement de programmation. Les proprits de chaque objet Document reprsentent la plupart des lments que peut contenir un fichier FLA. Une grande partie du DOM est donc compose d'objets et de proprits enfant de l'objet Document. Pour plus d'informations, consultez la section Objet Document. Ainsi, pour vous rfrer au premier document ouvert, vous pouvez utiliser l'instruction flash.documents[0] ou
fl.documents[0]. Il s'agit du premier document Flash qui a t ouvert dans l'environnement de programmation au

cours de la session actuelle. Lors de la fermeture du premier document, les index des autres documents ouverts sont dcrments. Pour connatre lindex dun document particulier, utilisez flash.findDocumentIndex(nomDuDocument) ou
fl.findDocumentIndex(nomDuDocument). Voir fl.findDocumentIndex().

Pour accder au document qui a le focus, utilisez l'instruction flash.getDocumentDOM() ou fl.getDocumentDOM(). Voir fl.getDocumentDOM(). Cette dernire est la syntaxe utilise dans la plupart des exemples de ce guide. Pour trouver un document particulier dans le tableau fl.documents, crez une boucle qui testera la proprit
document.name de chaque document. Voir fl.documents et document.name.

Vous pouvez accder tous les objets du DOM qui ne figurent pas dans la liste ci-dessus (voir Modle d'objet document (DOM) de Flash la page 10) laide de lobjet Document. Par exemple, pour accder la bibliothque dun document, utilisez la proprit document.library, qui renvoie un objet library :
fl.getDocumentDOM().library

Pour accder au tableau des lments prsents dans la bibliothque, utilisez la proprit library.items ; chaque lment de ce tableau est un objet Item :
fl.getDocumentDOM().library.items

Pour accder un lment spcifique de la bibliothque, indiquez un membre du tableau library.items :

fl.getDocumentDOM().library.items[0]

Autrement dit, lobjet Item est un enfant de lobjet library, qui est lui-mme un enfant de lobjet Document. Pour plus d'informations, consultez les sections document.library, Objet library, library.itemslibrary.items et Objet Item.

Dsignation de la cible dune action

Sauf indication contraire, les mthodes affectent la slection ou l'lment qui a le focus. Par exemple, le script cidessous double la taille de la slection actuelle, car aucun objet prcis n'est spcifi :
fl.getDocumentDOM().scaleSelection(2, 2);

Il peut tre ncessaire de dfinir comme cible dune action llment actuellement slectionn dans le document Flash. Pour ce faire, utilisez le tableau renvoy par la proprit document.selection (voir document.selection). Le premier lment de ce tableau reprsente l'lment actuellement slectionn, comme le montre l'exemple ci-dessous :
var accDescription = fl.getDocumentDOM().selection[0].description;

Le script ci-dessous double la taille du premier lment de la scne contenu dans le tableau dlments, et non pas llment slectionn :

EXTENSION DE FLASH CS4 PROFESSIONAL 12

Prsentation

var element = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0]; if (element) { element.width = element.width*2; element.height = element.height*2; }

Il est galement possible de parcourir en boucle la liste de tous les lments de la scne pour augmenter leur largeur et leur hauteur dun pourcentage spcifique, comme dans lexemple suivant :
var elementArray = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements; for (var i=0; i < elementArray.length; i++) { var offset = 10; elementArray[i].width += offset; elementArray[i].height += offset; }

Rsum de la structure du DOM

La liste suivante prsente la structure arborescente du DOM. Les chiffres qui apparaissent au dbut de chaque ligne reprsentent le niveau de chaque objet. Par exemple, un objet prcd de 03 est un enfant de l'objet de niveau 02 qui le prcde immdiatement, et celui-ci est lui-mme un enfant de l'objet de niveau 01 qui le prcde. Dans certains cas, il est possible de rfrencer un objet en spcifiant une proprit de son objet parent. Par exemple, la proprit document.timelines contient un tableau d'objets Timeline. Ces proprits sont indiques dans l'arborescence ci-dessous. Certains objets sont des sous-classes (et non pas des enfants) d'autres objets. Un objet qui est une sous-classe d'un autre possde ses propres mthodes et/ou proprits, outre les mthodes et proprits de l'objet parent dont il est driv (superclasse). Dans la hirarchie des objets, les sous-classes sont au mme niveau que leur superclasse. Par exemple, l'objet Item est une superclasse de l'objet BitmapItem. Ces relations sont indiques dans l'arborescence ci-dessous :
01 Top-Level Functions and Methods 01 FLfile object 01 flash object (fl) 02 compilerErrors object 02 componentsPanel object 02 Document object (fl.documents array) 03 Filter object 03 Matrix object 03 Fill object 03 Stroke object 03 library object 04 Item object (library.items array) 04 BitmapItem object(subclass of Item object) 04 folderItem object (subclass of Item object) 04 fontItem object (subclass of Item object) 04 SoundItem object (subclass of Item object) 04 SymbolItem object (subclass of Item object) 04 VideoItem object (subclass of Item object) 03 Timeline object (document.timelines array) 04 Layer object (timeline.layers array) 05 Frame object (layer.frames array) 06 Element object (frame.elements array) 07 Matrix object (element.matrix) 06 Instance object (abstract class, subclass of Element object) 06 BitmapInstance object (subclass of Instance object)

EXTENSION DE FLASH CS4 PROFESSIONAL 13

Prsentation

06 CompiledClipInstance object (subclass of Instance object) 06 ComponentInstance object (subclass of SymbolInstance object) 07 Parameter object (componentInstance.parameters array) 06 SymbolInstance object (subclass of Instance object) 06 Text object (subclass of Element object) 07 TextRun object (text.textRuns array) 08 TextAttrs object (textRun.textAttrs array) 06 Shape object (subclass of Element object) 07 Oval object 07 Rectangle object 07 Contour object (shape.contours array) 08 HalfEdge object 09 Vertex object 09 Edge object 07 Edge object (shape.edges array) 08 HalfEdge object 09 Vertex object 09 Edge object 07 Vertex object(shape.vertices array) 08 HalfEdge object 09 Vertex object 09 Edge object 03 ScreenOutline object 04 Screen object (screenOutline.screens array) 05 Parameter object (screen.parameters array) 02 drawingLayer object 03 Path object 04 Contour object 02 Math object 02 outputPanel object 02 presetPanel object 03 presetItem object(presetPanel.items array) 02 swfPanel object 02 Tools object (fl.tools array) 03 ToolObj object (tools.toolObjs array) 02 XMLUI object

Exemples dimplmentation
Plusieurs exemples d'implmentation JSFL sont disponibles pour Adobe Flash CS4 Professional. Examinez ces fichiers et installez-les pour vous familiariser avec l'API JavaScript. Les exemples sont stocks dans un dossier Samples/ExtendingFlash dans le fichier Samples.zip l'adresse www.adobe.com/go/learn_fl_samples_fr.

Exemple de commande Shape

Un exemple de script d'API JavaScript appel Shape.jsfl est disponible dans le dossier ExtendingFlash/Shape (voir " Exemples dimplmentation " ci-dessus). Ce script affiche des informations sur les contours de la forme dans le panneau Sortie.

EXTENSION DE FLASH CS4 PROFESSIONAL 14

Prsentation

Pour installer et excuter le script Shape : 1 Copiez le fichier Shape.jsfl dans le dossier Configuration/Commands (voir Enregistrement des fichiers JSFL la page 2).
2 Dans un document Flash (fichier FLA), slectionnez un objet shape. 3 Slectionnez Commandes > Forme pour excuter le script.

Exemple de commande de filtres get et set

Un exemple de script d'API JavaScript nomm filtersGetSet.jsfl est disponible dans le dossier ExtendingFlash/filtersGetSet (voir " Exemples dimplmentation " ci-dessus). Ce script ajoute des filtres un objet slectionn et affiche des informations sur les filtres en cours d'ajout dans le panneau Sortie. Pour installer et excuter le script filtersGetSet : 1 Copiez le fichier filtersGetSet.jsfl dans le dossier Configuration/Commands (voir Enregistrement des fichiers JSFL la page 2).
2 Dans un document Flash (fichier FLA), slectionnez un objet de type texte, clip ou bouton. 3 Slectionnez Commandes > filtersGetSet pour excuter le script.

Exemple d'outil PolyStar

Un exemple de script d'API JavaScript nomm PolyStar.jsfl est disponible dans le dossier ExtendingFlash/PolyStar (voir " Exemples dimplmentation " ci-dessus). Le fichier PolyStar.jsfl duplique l'outil Polygone intgr au panneau Outils de Flash. Le script illustre la construction de l'outil Polygone l'aide de l'API JavaScript et comprend des commentaires dtaills sur l'action du code. La lecture attentive de ce fichier permet de mieux comprendre le fonctionnement de l'API JavaScript. Consultez galement le fichier PolyStar.xml dans le rpertoire Tools pour vous familiariser avec la compilation de vos propres outils.

Exemple du panneau de trac de bitmap

Les fichiers nomms TraceBitmap.fla et TraceBitmap.swf se trouvent dans le dossier ExtendingFlash/TraceBitmapPanel (voir " Exemples dimplmentation " ci-dessus). Ces fichiers illustrent la manire de concevoir et crer un panneau pour contrler les fonctions de Flash. Ils montrent galement l'emploi de la fonction MMExecute() pour appeler des commandes JavaScript depuis un script ActionScript. Pour excuter l'exemple TraceBitmap : 1 Si Flash est en cours d'excution, fermez-le.
2 Copiez le fichier TraceBitmap.swf dans le dossier WindowSWF, un sous-dossier de Configuration (voir

Enregistrement des fichiers JSFL la page 2). Par exemple, sous Windows XP, le chemin du dossier est lecteur d'amorage\Documents and Settings\utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\WindowSWF.
3 Dmarrez Flash. 4 Crez ou ouvrez un document Flash (fichier FLA), puis importez-y un fichier bitmap ou une image JPEG.

Vous pouvez utiliser le fichier flower.jpg qui se trouve dans le dossier TraceBitmapPanel, ou toute autre image de votre choix.

EXTENSION DE FLASH CS4 PROFESSIONAL 15

Prsentation

5 Lorsque l'image importe est slectionne, choisissez Fentre > Autres panneaux > TraceBitmap. 6 Cliquez sur Envoyer.

L'image est convertie en un groupe de formes.

Exemple de DLL
Un exemple de dploiement d'une DLL se trouve dans le dossier ExtendingFlash/dllSampleComputeSum (voir " Exemples dimplmentation " ci-dessus). Pour plus d'informations sur le dveloppement des DLL, consultez la section Extensibilit de niveau C la page 534.

16

Chapitre 2 : Fonctions et mthodes de haut niveau

A propos de cette section Cette section dcrit les fonctions et les mthodes de haut niveau disponibles lorsque vous utilisez l'API JavaScript d'Adobe Flash. Pour plus d'informations sur l'emplacement de stockage des fichiers de l'API JavaScript, consultez la section Enregistrement des fichiers JSFL la page 2. Mthodes globales Vous pouvez appeler les mthodes suivantes partir de tout script de l'API JavaScript :
alert() confirm() prompt()

Outils extensibles Les fonctions suivantes sont disponibles dans les scripts qui crent des outils extensibles :
activate() configureTool() deactivate() keyDown() keyUp() mouseDoubleClick() mouseDown() mouseMove() mouseUp() notifySettingsChanged() setCursor()

activate()
Disponibilit Flash MX 2004. Utilisation
function activate() { // statements }

Paramtres Aucun. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 17

Fonctions et mthodes de haut niveau

Description Fonction appele lorsque loutil extensible est activ (cest--dire lorsquil est slectionn dans le panneau Outils). Cette fonction vous permet d'excuter toute tche d'initialisation requise par l'outil. Exemple L'exemple suivant dfinit la valeur de tools.activeTool lorsque l'outil extensible est slectionn dans le panneau Outils :
function activate() { var theTool = fl.tools.activeTool }

Voir aussi
tools.activeTool

alert()
Disponibilit Flash MX 2004. Utilisation
alert ( alertText )

Paramtres
alertText Chane qui spcifie le message devant apparatre dans la bote de dialogue d'alerte.

Valeur renvoye Aucune. Description Mthode qui affiche une chane et un bouton OK dans une bote de dialogue modale. Exemple Lexemple suivant affiche le message Process Complete (Traitement termin) dans une bote de dialogue d'alerte.
alert("Process Complete");

Voir aussi
confirm(), prompt()

configureTool()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 18

Fonctions et mthodes de haut niveau

Utilisation
function configureTool() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Fonction appele l'ouverture de Flash et lorsque l'outil extensible est charg dans le panneau Outils. Elle permet de dfinir toutes les informations dont Flash a besoin propos de cet outil. Exemple Les exemples suivants montrent deux implmentations possibles de cette fonction :
function configureTool() { theTool = fl.tools.activeTool; theTool.setToolName("myTool"); theTool.setIcon("myTool.png"); theTool.setMenuString("My Tool's menu string"); theTool.setToolTip("my tool's tool tip"); theTool.setOptionsFile( "mtTool.xml" ); } function configureTool() { theTool = fl.tools.activeTool; theTool.setToolName("ellipse"); theTool.setIcon("Ellipse.png"); theTool.setMenuString("Ellipse"); theTool.setToolTip("Ellipse"); theTool.showTransformHandles( true ); }

confirm()
Disponibilit Flash 8. Utilisation
confirm ( strAlert )

Paramtres strAlert Chane qui spcifie le message devant apparatre dans la bote de dialogue d'alerte. Valeur renvoye Valeur boolenne : true si l'utilisateur clique sur OK, false si l'utilisateur clique sur Annuler.

EXTENSION DE FLASH CS4 PROFESSIONAL 19

Fonctions et mthodes de haut niveau

Description Cette mthode affiche dans une bote de dialogue modale une chane accompagne des boutons OK et Annuler. Remarque : si aucun document (fichier FLA) n'est ouvert, cette mthode choue en produisant une condition d'erreur. Exemple Lexemple suivant affiche le message Sort data? (Trier les donnes ?) dans une bote de dialogue d'alerte.
confirm("Sort data?");

Voir aussi alert(), prompt()

deactivate()
Disponibilit Flash MX 2004. Utilisation
function deactivate() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Cette fonction est appele lorsque loutil extensible est dsactiv (cest--dire lorsque lutilisateur slectionne un autre outil). Elle permet deffectuer toute opration de nettoyage ncessaire avant la dsactivation de cet outil. Exemple L'exemple suivant affiche un message dans le panneau Sortie lorsque l'outil devient inactif.
function deactivate() { fl.trace( "Tool is no longer active" ); }

keyDown()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 20

Fonctions et mthodes de haut niveau

Utilisation
function keyDown() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Cette fonction est appele si loutil extensible est actif lorsque lutilisateur appuie sur une touche. Le script doit alors appeler tools.getKeyDown() pour identifier la touche en question. Exemple L'exemple suivant affiche des informations sur la touche presse par l'utilisateur lorsque l'outil extensible est actif.
function keyDown() { fl.trace("key " + fl.tools.getKeyDown() + " was pressed"); }

Voir aussi keyUp(), tools.getKeyDown()

keyUp()
Disponibilit Flash MX 2004. Utilisation
function keyUp() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Cette fonction est appele si loutil extensible est actif lorsque lutilisateur relche une touche. Exemple L'exemple suivant affiche un message dans le panneau Sortie lorsque l'outil extensible est actif et que l'utilisateur relche une touche.

EXTENSION DE FLASH CS4 PROFESSIONAL 21

Fonctions et mthodes de haut niveau

function keyUp() { fl.trace("Key is released"); }

Voir aussi
keyDown()

mouseDoubleClick()
Disponibilit Flash MX 2004. Utilisation
function mouseDoubleClick() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Fonction appele lorsque l'outil extensible est actif et que l'utilisateur double-clique sur la scne. Exemple L'exemple suivant affiche un message dans le panneau Sortie lorsque l'outil extensible est actif et que l'utilisateur double-clique sur le bouton de sa souris.
function mouseDoubleClick() { fl.trace("Mouse was double-clicked"); }

mouseDown()
Disponibilit Flash MX 2004. Utilisation
function mouseDown( [ pt ] ) { // statements }

EXTENSION DE FLASH CS4 PROFESSIONAL 22

Fonctions et mthodes de haut niveau

Paramtres pt Point indiquant l'emplacement de la souris lors du clic. Il est transmis la fonction lors de lappui sur le bouton de la souris. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Cette fonction est appele si loutil extensible est actif lors dun clic de souris alors que le pointeur se trouve sur la scne. Exemple Les exemples suivants illustrent l'utilisation de cette fonction lorsque l'outil extensible est actif. Le premier exemple affiche un message dans le panneau Sortie pour signaler un clic de souris. Le second exemple affiche les coordonnes x et y de la souris lors du clic.
function mouseDown() { fl.trace("Mouse button has been pressed"); } function mouseDown(pt) { fl.trace("x = "+ pt.x+" :: y = "+pt.y); }

mouseMove()
Disponibilit Flash MX 2004. Utilisation
function mouseMove( [ pt ] ) { // statements }

Paramtres pt Point indiquant les coordonnes actuelles de la souris. Il est transmis la fonction lors de tout mouvement de la souris, ce qui permet de toujours connatre lemplacement de celle-ci. Si la scne est en mode Modification ou Modification sur place, les coordonnes du point sont relatives lobjet en cours de modification. Sinon, les coordonnes du point sont relatives la scne. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Fonction appele lorsque l'outil extensible est actif et que l'utilisateur survole un point prcis de la scne avec sa souris. Le ou les boutons de la souris peuvent tre enfoncs ou non.

EXTENSION DE FLASH CS4 PROFESSIONAL 23

Fonctions et mthodes de haut niveau

Exemple Les exemples suivants illustrent les utilisations possibles de cette fonction. Le premier exemple affiche un message dans le panneau Sortie pour signaler un dplacement de la souris. Le second exemple affiche les coordonnes x et y de la souris lors de son dplacement.
function mouseMove() { fl.trace("moving"); } function mouseMove(pt) { fl.trace("x = "+ pt.x + " :: y = " + pt.y); }

mouseUp()
Disponibilit Flash MX 2004. Utilisation
function mouseUp() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Fonction appele lorsque l'outil extensible est actif et que l'utilisateur relche le bouton de sa souris aprs avoir cliqu sur la scne. Exemple L'exemple suivant affiche un message dans le panneau Sortie lorsque l'outil extensible est actif et que l'utilisateur relche le bouton de sa souris.
function mouseUp() { fl.trace("mouse is up"); }

notifySettingsChanged()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 24

Fonctions et mthodes de haut niveau

Utilisation
function notifySettingsChanged() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Cette fonction est appele lorsquun outil est actif et que lutilisateur en modifie les options dans linspecteur Proprits. Vous pouvez utiliser la proprit tools.activeTool pour demander les valeurs actuelles des options (voir tools.activeTool). Exemple L'exemple suivant affiche un message dans le panneau Sortie lorsque l'outil extensible est actif et que l'utilisateur modifie ses options dans l'inspecteur Proprits.
function notifySettingsChanged() { var theTool = fl.tools.activeTool; var newValue = theTool.myProp; }

prompt()
Disponibilit Flash MX 2004. Utilisation
prompt(promptMsg [,text])

Paramtres
promptMsg Chane afficher dans la bote de dialogue Invite (limite 256 caractres dans Mac OS X). text Chane facultative afficher comme valeur par dfaut pour le champ de texte.

Valeur renvoye La chane saisie par lutilisateur, si celui-ci a ensuite cliqu sur OK, ou null s'il a cliqu sur Annuler. Description Cette mthode affiche dans une bote de dialogue modale une invite et un texte facultatif, accompagns des boutons OK et Annuler. Exemple Lexemple suivant invite lutilisateur taper son nom d'utilisateur. Si lutilisateur saisit un nom et clique sur OK, ce nom s'affiche dans le panneau Sortie.

EXTENSION DE FLASH CS4 PROFESSIONAL 25

Fonctions et mthodes de haut niveau

var userName = prompt("Enter user name", "Type user name here"); fl.trace(userName);

Voir aussi alert(), confirm()

setCursor()
Disponibilit Flash MX 2004. Utilisation
function setCursor() { // statements }

Paramtres Aucun. Valeur renvoye Aucune. Description Cette fonction est appele lorsque l'outil extensible est actif et que l'utilisateur dplace sa souris, ce qui permet au script de dfinir des pointeurs personnaliss. Le script doit appeler tools.setCursor() pour dsigner le pointeur utiliser. La liste des pointeurs et des valeurs entires correspondantes figure dans la section tools.setCursor(). Exemple
function setCursor() { fl.tools.setCursor( 1 ); }

26

Chapitre 3 : Objet actionsPanel

Disponibilit Flash CS3 Professional. Description L'objet actionsPanel, qui reprsente le panneau Actions affich actuellement, est une proprit de l'objet flash (voir fl.actionsPanel). Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet actionsPanel :
Mthode
actionsPanel.getClassForObject() actionsPanel.getScriptAssistMode() actionsPanel.getSelectedText() actionsPanel.getText() actionsPanel.hasSelection()

Description Renvoie la classe d'une variable spcifie. Prcise si le mode Assistant de script est activ ou non. Renvoie le texte actuellement slectionn dans le panneau Actions. Renvoie le texte du panneau Actions. Indique si du texte est actuellement slectionn dans le panneau Actions. Remplace le texte actuellement slectionn par celui qui est spcifi. Active ou dsactive le mode Assistant de script. Slectionne un jeu de caractres particulier dans le panneau Actions. Efface le texte affich dans le panneau Actions pour ensuite y ajouter celui qui est spcifi.

actionsPanel.replaceSelectedText() actionsPanel.setScriptAssistMode() actionsPanel.setSelection() actionsPanel.setText()

actionsPanel.getClassForObject()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.getClassForObject(ASvariableName)

Paramtres
ASvariableName Chane reprsentant le nom d'une variable ActionScript.

Valeur renvoye Chane reprsentant la classe dont ASvariableName est membre.

EXTENSION DE FLASH CS4 PROFESSIONAL 27

Objet actionsPanel

Description Mthode qui renvoie la classe de la variable spcifie devant tre dfinie dans le panneau Actions actuellement affich. En outre, le curseur ou le texte slectionn dans le panneau Actions doit tre positionn aprs la dfinition de la variable. Exemple L'exemple suivant affiche la classe attribue la variable myVar si le curseur est plac aprs l'instruction varmyVar:ActivityEvent; dans le panneau Actions.
// Place the following code in the Actions panel, // and position the cursor somewhere after the end of the line var myVar:ActivityEvent; // Place the following code in the JSFL file var theClass = fl.actionsPanel.getClassForObject("myVar"); fl.trace(theClass); // traces: "ActivityEvent"

actionsPanel.getScriptAssistMode()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.getScriptAssistMode()

Paramtres Aucun. Valeur renvoye Valeur boolenne prcisant si le mode Assistant de script est activ (true) ou pas (false). Description Mthode qui prcise si le mode Assistant de script est activ ou non. Exemple L'exemple suivant affiche un message si le mode Assistant de script n'est pas activ.
mAssist = fl.actionsPanel.getScriptAssistMode(); if (!mAssist) { alert("For more guidance when writing ActionScript code, try Script Assist mode"); }

Voir aussi
actionsPanel.setScriptAssistMode()

EXTENSION DE FLASH CS4 PROFESSIONAL 28

Objet actionsPanel

actionsPanel.getSelectedText()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.getSelectedText()

Paramtres Aucun. Valeur renvoye Chane contenant le texte actuellement slectionn dans le panneau Actions. Description Mthode qui renvoie le texte actuellement slectionn dans le panneau Actions. Exemple L'exemple suivant affiche le texte actuellement slectionn dans le panneau Actions.
var apText = fl.actionsPanel.getSelectedText(); fl.trace(apText);

Voir aussi
actionsPanel.getText(), actionsPanel.hasSelection(), actionsPanel.replaceSelectedText(), actionsPanel.setSelection()

actionsPanel.getText()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.getText()

Paramtres Aucun. Valeur renvoye Chane contenant tout le texte affich dans le panneau Actions. Description Mthode qui renvoie le texte prsent dans le panneau Actions. Exemple L'exemple suivant affiche le texte prsent dans le panneau Actions.

EXTENSION DE FLASH CS4 PROFESSIONAL 29

Objet actionsPanel

var apText = fl.actionsPanel.getText(); fl.trace(apText);

Voir aussi
actionsPanel.getSelectedText(), actionsPanel.setText()

actionsPanel.hasSelection()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.hasSelection()

Paramtres Aucun. Valeur renvoye Valeur boolenne spcifiant si du texte est slectionn (true) ou non (false) dans le panneau Actions. Description Mthode qui indique si du texte est actuellement slectionn dans le panneau Actions. Exemple L'exemple suivant affiche le texte actuellement slectionn dans le panneau Actions. Si aucun texte n'est slectionn, l'intgralit du texte contenu dans le panneau Actions est affich.
if (fl.actionsPanel.hasSelection()) { var apText = fl.actionsPanel.getSelectedText(); } else { var apText = fl.actionsPanel.getText(); } fl.trace(apText);

Voir aussi
actionsPanel.getSelectedText(), actionsPanel.getText(), actionsPanel.replaceSelectedText(), actionsPanel.setSelection()

actionsPanel.replaceSelectedText()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.replaceSelectedText(replacementText)

EXTENSION DE FLASH CS4 PROFESSIONAL 30

Objet actionsPanel

Paramtres
replacementText Chane reprsentant le texte qui doit remplacer le texte slectionn dans le panneau Actions.

Valeur renvoye Valeur boolenne, true si le panneau Actions est trouv, sinon false. Description Mthode qui remplace le texte actuellement slectionn par celui qui est spcifi dans replacementText. Si replacementText contient plus de caractres que le texte slectionn, tout caractre situ aprs le texte slectionn suivra dsormais replacementText et ne sera donc pas cras. Exemple L'exemple suivant remplace le texte actuellement slectionn dans le panneau Actions.
if (fl.actionsPanel.hasSelection()) { fl.actionsPanel.replaceSelectedText("// 2006 Adobe Inc."); }

Voir aussi
actionsPanel.getSelectedText(), actionsPanel.hasSelection(), actionsPanel.setSelection(), actionsPanel.setText()

actionsPanel.setScriptAssistMode()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.setScriptAssistMode(bScriptAssist)

Paramtres
bScriptAssist Valeur boolenne spcifiant si le mode Assistant de script doit tre activ ou dsactiv.

Valeur renvoye Valeur boolenne prcisant si le mode Assistant de script a bien t activ ou dsactiv. Description Mthode qui active ou dsactive le mode Assistant de script. Exemple L'exemple suivant active/dsactive le mode Assistant de script.

EXTENSION DE FLASH CS4 PROFESSIONAL 31

Objet actionsPanel

fl.trace(fl.actionsPanel.getScriptAssistMode()); if (fl.actionsPanel.getScriptAssistMode()){ fl.actionsPanel.setScriptAssistMode(false); } else { fl.actionsPanel.setScriptAssistMode(true); } fl.trace(fl.actionsPanel.getScriptAssistMode());

Voir aussi
actionsPanel.getScriptAssistMode()

actionsPanel.setSelection()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.setSelection(startIndex, numberOfChars)

Paramtres
startIndex Nombre entier (commenant zro) qui indique le premier caractre slectionner. numberOfChars Nombre entier spcifiant le nombre de caractres slectionner.

Valeur renvoye Valeur boolenne qui indique si les caractres demands peuvent tre slectionns (true) ou non (false). Description Mthode qui slectionne un jeu de caractres spcifi dans le panneau Actions. Exemple L'exemple suivant remplace les caractres 2006 , affichs dans le panneau Actions, par le texte spcifi.
// Type the following as the first line in the Actions panel // 2006 - Addresses user request 40196 // Type the following in the JSFL file fl.actionsPanel.setSelection(3,4); fl.actionsPanel.replaceSelectedText("// Last updated: 2007");

Voir aussi
actionsPanel.getSelectedText(), actionsPanel.hasSelection(), actionsPanel.replaceSelectedText()

EXTENSION DE FLASH CS4 PROFESSIONAL 32

Objet actionsPanel

actionsPanel.setText()
Disponibilit Flash CS3 Professional. Utilisation
actionsPanel.setText(replacementText)

Paramtres
replacementText Chane reprsentant le texte introduire dans le panneau Actions.

Valeur renvoye Valeur boolenne, true si le texte spcifi a t plac dans le panneau Actions, sinon false. Description Mthode qui efface le texte affich dans le panneau Actions pour ensuite y ajouter celui qui est spcifi dans replacementText. Exemple L'exemple suivant remplace le texte actuellement affich dans le panneau Actions par le texte spcifi.
fl.actionsPanel.setText("// Deleted this code - no longer needed");

Voir aussi
actionsPanel.getText(), actionsPanel.replaceSelectedText()

33

Chapitre 4 : Objet BitmapInstance

Hritage

Objet Element > Objet Instance > Objet BitmapInstance

Disponibilit Flash MX 2004. Description Lobjet BitmapInstance est une sous-classe de lobjet Instance et reprsente un bitmap dans une image (voir Objet Instance). Rsum des mthodes Outre les mthodes de lobjet Objet Instance, l'objet BitmapInstance gre les mthodes suivantes :
Mthode
bitmapInstance.getBits()

Description Vous permet de crer des effets de bitmap en extrayant les bits du bitmap, en les manipulant et en les renvoyant Flash. Dfinit les bits dun lment bitmap existant.

bitmapInstance.setBits()

Rsum des proprits Outre les proprits de lobjet Objet Instance, l'objet BitmapInstance gre les proprits suivantes :
Proprit
bitmapInstance.hPixels bitmapInstance.vPixels

Description En lecture seule ; nombre entier indiquant la largeur du bitmap, en pixels. En lecture seule ; nombre entier indiquant la hauteur du bitmap, en pixels.

bitmapInstance.getBits()
Disponibilit Flash MX 2004. Utilisation
bitmapInstance.getBits()

Paramtres Aucun. Valeur renvoye Objet qui contient les proprits width (largeur), height (hauteur), depth (profondeur), bits et, si le bitmap comporte une table de couleurs, cTab. Llment bits est un tableau doctets. Llment cTab est un tableau de valeurs colorimtriques sous la forme "#RRGGBB". La longueur du tableau est celle de la table de couleurs.

EXTENSION DE FLASH CS4 PROFESSIONAL 34

Objet BitmapInstance

le tableau doctets nest pertinent que sil est rfrenc par une DLL ou une bibliothque partage. En rgle gnrale, il est uniquement destin la cration dun outil extensible ou dun effet. Pour plus d'informations sur la cration de DLL utiliser avec Flash JavaScript, consultez Extensibilit de niveau C la page 534. Description Mthode permettant de crer des effets de bitmap en extrayant les bits du bitmap, en les manipulant et en les renvoyant Flash. Exemple Le code suivant cre une rfrence lobjet slectionn, teste sil est de type bitmap, et lit la hauteur, la largeur et la profondeur de couleurs du bitmap :
var isBitmap = fl.getDocumentDOM().selection[0].instanceType; if(isBitmap == "bitmap"){ var bits = fl.getDocumentDOM().selection[0].getBits(); fl.trace("height = " + bits.height); fl.trace("width = " + bits.width); fl.trace("depth = " + bits.depth); }

Voir aussi
bitmapInstance.setBits()

bitmapInstance.hPixels
Disponibilit Flash MX 2004. Utilisation
bitmapInstance.hPixels

Description Proprit en lecture seule ; nombre entier indiquant la largeur du bitmap, c'est--dire le nombre de pixels dans sa dimension horizontale. Exemple Le code suivant rcupre la largeur du bitmap, en pixels :
// Get the number of pixels in the horizontal dimension. var bmObj = fl.getDocumentDOM().selection[0]; var isBitmap = bmObj.instanceType; if(isBitmap == "bitmap"){ var numHorizontalPixels = bmObj.hPixels; }

Voir aussi
bitmapInstance.vPixels

EXTENSION DE FLASH CS4 PROFESSIONAL 35

Objet BitmapInstance

bitmapInstance.setBits()
Disponibilit Flash MX 2004. Utilisation
bitmapInstance.setBits(bitmap)

Paramtres bitmap Objet qui contient les proprits height (hauteur), width (largeur), depth (profondeur), bits et cTab. Les proprits height, width et depth sont des entiers. La proprit bits est un tableau doctets. La proprit cTab nest ncessaire que pour les bitmaps ayant une profondeur de couleurs gale ou infrieure 8 bits. Il s'agit d'une chane qui reprsente une valeur colorimtrique sous la forme "#RRGGBB". Remarque : le tableau doctets nest pertinent que sil est rfrenc par une bibliothque externe. En rgle gnrale, il est uniquement destin la cration dun outil extensible ou dun effet. Valeur renvoye Aucune. Description Mthode qui dfinit les bits dun lment bitmap existant. Elle permet de crer des effets de bitmap en extrayant les bits du bitmap, en les manipulant et en renvoyant le bitmap Flash. Exemple Le code suivant vrifie si la slection est de type bitmap, puis dfinit la hauteur de ce bitmap sur 150 pixels :
var isBitmap = fl.getDocumentDOM().selection[0].instanceType; if(isBitmap == "bitmap"){ var bits = fl.getDocumentDOM().selection[0].getBits(); bits.height = 150; fl.getDocumentDOM().selection[0].setBits(bits); }

Voir aussi
bitmapInstance.getBits()

bitmapInstance.vPixels
Disponibilit Flash MX 2004. Utilisation
bitmapInstance.vPixels

EXTENSION DE FLASH CS4 PROFESSIONAL 36

Objet BitmapInstance

Description Proprit en lecture seule ; nombre entier indiquant la hauteur du bitmap, c'est--dire le nombre de pixels dans sa dimension verticale. Exemple Le code suivant rcupre la hauteur du bitmap, en pixels :
// Get the number of pixels in the vertical dimension. var bmObj = fl.getDocumentDOM().selection[0]; var isBitmap = bmObj.instanceType; if(isBitmap == "bitmap"){ var numVerticalPixels = bmObj.vPixels; }

Voir aussi
bitmapInstance.hPixels

37

Chapitre 5 : Objet BitmapItem

Hritage

Objet Item > Objet BitmapItem

Disponibilit Flash MX 2004. Description L'objet BitmapItem fait rfrence une image bitmap dans la bibliothque dun document. Lobjet BitmapItem est une sous-classe de lobjet Item (voir Objet Item). Rsum des proprits Outre les proprits de l'Objet Item, l'objet BitmapItem a les proprits suivantes :
Proprit
bitmapItem.allowSmoothing

Description Valeur boolenne qui spcifie si le lissage d'un bitmap est autoris ou non. Chane qui dtermine le type de la compression dimage applique au bitmap. Nombre de secondes coules entre le 1er janvier 1970 et la date de modification du fichier original. Spcifie si l'lment a t import sous forme de fichier jpeg. Spcifie si le fichier import dans la bibliothque existe toujours l'emplacement d'o il provient. Spcifie si la date de modification du fichier de l'lment de la bibliothque correspond celle trouve sur le disque du fichier import. Chemin et nom du fichier import dans la bibliothque. Spcifie si le dgroupage est activ. Valeur boolenne qui spcifie si la qualit JPEG importe par dfaut doit tre utilise ou non.

bitmapItem.compressionType

bitmapItem.fileLastModifiedDate

bitmapItem.originalCompressionType

bitmapItem.sourceFileExists

bitmapItem.sourceFileIsCurrent

bitmapItem.sourceFilePath bitmapItem.useDeblocking bitmapItem.useImportedJPEGQuality

Rsum des mthodes Outre les proprits de l'Objet Item, l'objet BitmapItem a les mthodes suivantes :
Mthode
bitmapItem.exportToFile()

Description Exporte l'lment spcifi dans un fichier PNG ou JPG.

bitmapItem.allowSmoothing
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 38

Objet BitmapItem

Utilisation
bitmapItem.allowSmoothing

Description Proprit : valeur boolenne indiquant si le lissage d'un bitmap est autoris (true) ou non (false). Exemple Le code suivant dfinit la proprit allowSmoothing du premier lment de la bibliothque du document actif sur true :
fl.getDocumentDOM().library.items[0].allowSmoothing = true; alert(fl.getDocumentDOM().library.items[0].allowSmoothing);

bitmapItem.compressionType
Disponibilit Flash MX 2004. Utilisation
bitmapItem.compressionType

Description Proprit : chane dterminant le type de la compression d'image applique au bitmap. Les valeurs acceptables sont photo ou lossless. Si la valeur de bitmapItem.useImportedJPEGQuality est false, photo correspond une qualit JPEG comprise entre 0 et 100 ; si la valeur de bitmapItem.useImportedJPEGQuality est true, photo correspond la qualit JPEG avec la valeur de qualit par dfaut du document. La valeur lossless correspond aux formats GIF et PNG (voir bitmapItem.useImportedJPEGQuality). Exemple Le code suivant dfinit la proprit compressionType du premier lment de la bibliothque du document actuel sur photo :
fl.getDocumentDOM().library.items[0].compressionType = "photo"; alert(fl.getDocumentDOM().library.items[0].compressionType);

bitmapItem.exportToFile()
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.exportToFile(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et spcifiant le chemin et le nom du fichier export.

EXTENSION DE FLASH CS4 PROFESSIONAL 39

Objet BitmapItem

Valeur renvoye Valeur boolenne, true si le fichier a bien t export, false dans le cas contraire. Description Mthode qui exporte l'lment spcifi dans un fichier PNG ou JPG. Exemple En supposant que le premier lment de la bibliothque soit un lment bitmap, le code suivant l'exporte sous forme de fichier JPG :
var imageFileURL = "file:///C|/exportTest/out.jpg"; var libItem = fl.getDocumentDOM().library.items[0]; libItem.exportToFile(imageFileURL);

bitmapItem.fileLastModifiedDate
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.fileLastModifiedDate

Description Proprit en lecture seule ; chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1er janvier 1970 et la date de modification du fichier original au moment o il a t import dans la bibliothque. Si le fichier n'existe plus, cette valeur est 00000000 . Exemple En supposant que le premier lment de la bibliothque soit un lment bitmap, le code suivant affiche un nombre hexadcimal tel que dcrit ci-dessus :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("Mod date when imported = " + libItem.fileLastModifiedDate);

Voir aussi
bitmapItem.sourceFileExists, bitmapItem.sourceFileIsCurrent, bitmapItem.sourceFilePath, FLfile.getModificationDate()

bitmapItem.originalCompressionType
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.originalCompressionType

EXTENSION DE FLASH CS4 PROFESSIONAL 40

Objet BitmapItem

Description Proprit en lecture seule ; chane indiquant si l'lment spcifi est import sous forme de fichier jpeg. Les valeurs possibles de cette proprit sont photo (pour les fichiers jpeg) et lossless (pour les types de fichiers non compresss tels que GIF et PNG). Exemple En supposant que le premier lment de la bibliothque soit un lment bitmap, le code suivant affiche photo si le fichier a t import dans la bibliothque sous forme de fichier jpeg, ou lossless si ce n'est pas le cas :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("Imported compression type = "+ libItem.originalCompressionType);

Voir aussi
bitmapItem.compressionType

bitmapItem.quality
Disponibilit Flash MX 2004. Utilisation
bitmapItem.quality

Description Proprit ; entier dfinissant la qualit du bitmap. Pour utiliser la qualit par dfaut du document, spcifiez -1 ; sinon, spcifiez un entier entre 0 et 100. Uniquement disponible pour la compression JPEG. Exemple Le code suivant dfinit la proprit quality du premier lment de la bibliothque du document actuel sur 65 :
fl.getDocumentDOM().library.items[0].quality = 65; alert(fl.getDocumentDOM().library.items[0].quality);

bitmapItem.sourceFileExists
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.sourceFileExists

Description Proprit en lecture seule ; valeur boolenne, true si le fichier import dans la bibliothque existe toujours l'emplacement d'o il provient ; false dans le cas contraire.

EXTENSION DE FLASH CS4 PROFESSIONAL 41

Objet BitmapItem

Exemple En supposant que le premier lment de la bibliothque soit un lment bitmap, le code suivant affiche true si le fichier import dans la bibliothque existe toujours :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("sourceFileExists = "+ libItem.sourceFileExists);

Voir aussi
bitmapItem.sourceFileIsCurrent, bitmapItem.sourceFilePath

bitmapItem.sourceFileIsCurrent
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.sourceFileIsCurrent

Description Proprit en lecture seule ; valeur boolenne, true si la date de modification du fichier de l'lment de la bibliothque correspond la date de modification sur disque du fichier import, false dans le cas contraire. Exemple En supposant que le premier lment de la bibliothque soit un lment bitmap, le code suivant affiche true si le fichier import n'a pas t modifi sur le disque depuis son importation :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("fileIsCurrent = "+ libItem.sourceFileIsCurrent);

Voir aussi
bitmapItem.fileLastModifiedDate, bitmapItem.sourceFilePath

bitmapItem.sourceFilePath
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.sourceFilePath

Description Proprit en lecture seule ; chane de type fichier:///URI qui reprsente le chemin et le nom du fichier import dans la bibliothque.

EXTENSION DE FLASH CS4 PROFESSIONAL 42

Objet BitmapItem

Exemple L'exemple suivant affiche le nom et le chemin du fichier source de tout lment de la bibliothque de type bitmap :
for (idx in fl.getDocumentDOM().library.items) { if (fl.getDocumentDOM().library.items[idx].itemType == "bitmap") { var myItem = fl.getDocumentDOM().library.items[idx]; fl.trace(myItem.name + " source is " + myItem.sourceFilePath); } }

Voir aussi
bitmapItem.sourceFileExists

bitmapItem.useDeblocking
Disponibilit Flash CS4 Professional. Utilisation
bitmapItem.useDeblocking

Description Proprit ; valeur boolenne indiquant si le dgroupage est activ (true) ou non (false). Exemple En supposant que le premier lment de la bibliothque soit un lment bitmap, le code suivant active le dgroupage pour l'lment :
var libItem = fl.getDocumentDOM().library.items[0]; libItem.useDeblocking = true;

bitmapItem.useImportedJPEGQuality
Disponibilit Flash MX 2004. Utilisation
bitmapItem.useImportedJPEGQuality

Description Proprit: valeur boolenne indiquant si la qualit JPEG importe par dfaut doit tre utilise (true) ou non (false). Uniquement disponible pour la compression JPEG.

EXTENSION DE FLASH CS4 PROFESSIONAL 43

Objet BitmapItem

Exemple Le code suivant dfinit la proprit useImportedJPEGQuality du premier lment de la bibliothque du document actuel sur true :
fl.getDocumentDOM().library.items[0].useImportedJPEGQuality = true; alert(fl.getDocumentDOM().library.items[0].useImportedJPEGQuality);

44

Chapitre 6 : Objet CompiledClipInstance

Hritage

Objet Element > Objet Instance > Objet CompiledClipInstance

Disponibilit Flash MX 2004. Description Lobjet CompiledClipInstance est une sous-classe de lobjet Instance. Il s'agit gnralement d'une occurrence d'un clip qui a t converti en lment de bibliothque de clips compil (voir Objet Instance). Rsum des proprits Outre les proprits de l'Objet Instance, l'objet CompiledClipInstance possde les proprits suivantes :
Proprit
compiledClipInstance.accName compiledClipInstance.actionScript

Description Chane quivalente au champ Nom du panneau Accessibilit. Chane qui reprsente le code ActionScript de cette occurrence ; quivalent symbolInstance.actionScript. Chane quivalente au champ Description du panneau Accessibilit. Valeur boolenne qui active et dsactive laccessibilit aux enfants de lobjet. Chane quivalente au champ Raccourci du panneau Accessibilit. Valeur boolenne qui active et dsactive laccessibilit lobjet ; quivalente linverse de la fonction Rendre l'objet accessible dans le panneau Accessibilit. Nombre entier quivalent au champ Index de tabulation du panneau Accessibilit.

compiledClipInstance.description compiledClipInstance.forceSimple

compiledClipInstance.shortcut compiledClipInstance.silent

compiledClipInstance.tabIndex

compiledClipInstance.accName
Disponibilit Flash MX 2004. Utilisation
compiledClipInstance.accName

Description Proprit ; chane quivalente au champ Nom du panneau Accessibilit. Les logiciels de lecture vocale identifient lobjet en prononant ce nom. Exemple Lexemple suivant rcupre et dfinit le nom d'accessibilit du premier objet slectionn :

EXTENSION DE FLASH CS4 PROFESSIONAL 45

Objet CompiledClipInstance

// Get the name of the object. var theName = fl.getDocumentDOM().selection[0].accName; // Set the name of the object. fl.getDocumentDOM().selection[0].accName = 'Home Button';

compiledClipInstance.actionScript
Disponibilit Flash MX 2004. Utilisation
compiledClipInstance.actionScript

Description Proprit ; chane qui reprsente le code ActionScript de cette occurrence ; quivalent symbolInstance.actionScript. Exemple Le code suivant assigne du code ActionScript aux lments spcifis :
// Assign some ActionScript to a specified Button compiled clip instance. fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0] .actionScript = "on(click) {trace('button is clicked');}"; // Assign some ActionScript to the currently selected Button compiled clip instance. fl.getDocumentDOM().selection[0].actionScript = "on(click) {trace('button is clicked');}";

compiledClipInstance.description
Disponibilit Flash MX 2004. Utilisation
compiledClipInstance.description

Description Proprit ; chane quivalente au champ Description du panneau Accessibilit. Cette description est lue par les logiciels de lecture vocale. Exemple Lexemple suivant montre comment rcuprer et dfinir la proprit description :
// Get the description of the current selection. var theDescription = fl.getDocumentDOM().selection[0].description; // Set the description of the current selection. fl.getDocumentDOM().selection[0].description = "This is compiled clip number 1";

EXTENSION DE FLASH CS4 PROFESSIONAL 46

Objet CompiledClipInstance

compiledClipInstance.forceSimple
Disponibilit Flash MX 2004. Utilisation
compiledClipInstance.forceSimple

Description Proprit ; valeur boolenne qui active et dsactive laccessibilit aux enfants de lobjet. Cette proprit est quivalente linverse du paramtre Rendre les objets enfant accessibles du panneau Accessibilit. Si forceSimple est true, son effet est similaire la dsactivation de loption Rendre les objets enfant accessibles. Si forceSimple est false, son effet est similaire lactivation de loption Rendre les objets enfant accessibles. Exemple Lexemple suivant montre comment rcuprer et dfinir la proprit forceSimple :
// Query if the children of the object are accessible. var areChildrenAccessible = fl.getDocumentDOM().selection[0].forceSimple; // Allow the children of the object to be accessible. fl.getDocumentDOM().selection[0].forceSimple = false;

compiledClipInstance.shortcut
Disponibilit Flash MX 2004. Utilisation
compiledClipInstance.shortcut

Description Proprit ; chane quivalente au champ Raccourci du panneau Accessibilit. Ce raccourci est lu par les logiciels de lecture vocale. Cette proprit n'est pas disponible pour les champs de texte dynamiques. Exemple Lexemple suivant montre comment rcuprer et dfinir la proprit shortcut :
// Get the shortcut key of the object. var theShortcut = fl.getDocumentDOM().selection[0].shortcut; // Set the shortcut key of the object. fl.getDocumentDOM().selection[0].shortcut = "Ctrl+I";

compiledClipInstance.silent
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 47

Objet CompiledClipInstance

Utilisation
compiledClipInstance.silent

Description Proprit ; valeur boolenne qui active et dsactive laccessibilit lobjet ; quivalente linverse de la fonction Rendre l'objet accessible dans le panneau Accessibilit. Ainsi, si silent est true, loption Rendre l'objet accessible est dsactive. Si silent est false, loption Rendre l'objet accessible est active. Exemple Lexemple suivant montre comment rcuprer et dfinir la proprit silent :
// Query if the object is accessible. var isSilent = fl.getDocumentDOM().selection[0].silent; // Set the object to be accessible. fl.getDocumentDOM().selection[0].silent = false;

compiledClipInstance.tabIndex
Disponibilit Flash MX 2004. Utilisation
compiledClipInstance.tabIndex

Description Proprit ; nombre entier quivalent au champ Index de tabulation du panneau Accessibilit. Cette proprit cre lordre de tabulation dans lequel les objets seront slectionns lorsque lutilisateur appuiera sur la touche de tabulation. Exemple Lexemple suivant montre comment rcuprer et dfinir la proprit tabIndex :
// Get the tabIndex of the object. var theTabIndex = fl.getDocumentDOM().selection[0].tabIndex; // Set the tabIndex of the object. fl.getDocumentDOM().selection[0].tabIndex = 1;

48

Chapitre 7 : Objet compilerErrors

Disponibilit Flash CS3 Professional. Description Lobjet compilerErrors, qui reprsente le panneau Erreurs de compilation, est une proprit de lobjet flash (fl) et est accessible via fl.compilerErrors (voir Objet flash (fl)). Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet compilerErrors :
Mthode
compilerErrors.clear() compilerErrors.save()

Description Efface le contenu du panneau Erreurs de compilation. Enregistre le contenu du panneau Erreurs de compilation dans un fichier texte local.

compilerErrors.clear()
Disponibilit Flash CS3 Professional. Utilisation
compilerErrors.clear()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui efface le contenu du panneau Erreurs de compilation. Exemple L'exemple suivant efface le contenu du panneau Erreurs de compilation :
fl.compilerErrors.clear();

Voir aussi
compilerErrors.save()

EXTENSION DE FLASH CS4 PROFESSIONAL 49

Objet compilerErrors

compilerErrors.save()
Disponibilit Flash CS3 Professional. Utilisation
compilerErrors.save(fileURI [, bAppendToFile [, bUseSystemEncoding]])

Paramtres fileURI <Check Alignment of PHs>Chane exprime sous la forme fichier:///URI et spcifiant le nom du fichier enregistr. Si fileURI existe dj alors que vous n'avez pas spcifi de valeur true pour bAppendToFile, le remplacement de fileURI s'effectue sans message d'avertissement.
bAppendToFile Valeur boolenne facultative spcifiant si le contenu du panneau Erreurs de compilation doit tre ajout fileURI (true) ou non (false). La valeur par dfaut est false. bUseSystemEncoding Valeur boolenne facultative spcifiant si le texte du panneau Erreur de compilation doit tre

enregistr ou non en utilisant le codage systme. Si cette valeur est false (valeur par dfaut), le texte du panneau Erreurs de compilation est enregistr en codage UTF-8 et intgre des caractres marqueurs d'ordre d'octets au dbut du texte. La valeur par dfaut est false. Valeur renvoye Aucune. Description Mthode qui enregistre le contenu du panneau Erreurs de compilation dans un fichier texte local. Exemple L'exemple suivant enregistre le contenu du panneau Erreurs de compilation dans le fichier nomm errors.log qui est stock dans le dossier C:\tests :
fl.compilerErrors.save("file:///c|/tests/errors.log");

Voir aussi
compilerErrors.clear()

50

Chapitre 8 : Objet ComponentInstance

Hritage

Objet Element > Objet Instance > Objet SymbolInstance > Objet ComponentInstance

Disponibilit Flash MX 2004. Description Lobjet ComponentInstance est une sous-classe de lobjet SymbolInstance et reprsente un composant dans une image (voir Objet SymbolInstance) Rsum des proprits Outre toutes les proprits de l'Objet SymbolInstance, l'objet ComponentInstance possde les proprits suivantes :
Proprit
componentInstance.parameters

Description Lecture seule ; tableau contenant les proprits ActionScript 2.0, accessibles laide de lInspecteur de proprits du composant.

componentInstance.parameters
Disponibilit Flash MX 2004. Utilisation
componentInstance.parameters

Description Proprit en lecture seule ; tableau contenant les proprits ActionScript 2.0 accessibles laide de lInspecteur de proprits du composant. Voir l'Objet Parameter. Exemple Lexemple suivant montre comment rcuprer et dfinir la proprit parameters :
var parms = fl.getDocumentDOM().selection[0].parameters; parms[0].value = "some value";

Voir aussi Objet Parameter

51

Chapitre 9 : Objet componentsPanel

Disponibilit Flash MX 2004. Description Lobjet componentsPanel, qui reprsente le panneau Composants, est une proprit de lobjet flash (fl) et est accessible via fl.componentsPanel (voir Objet flash (fl)). Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet componentsPanel :
Mthode
componentsPanel.addItemToDocument()

Description Ajoute le composant spcifi au document l'emplacement indiqu. Actualise la liste de composants affiche dans le panneau Composants.

componentsPanel.reload()

componentsPanel.addItemToDocument()
Disponibilit Flash MX 2004. Utilisation
componentsPanel.addItemToDocument(position, categoryName, componentName)

Paramtres position Point (par exemple, {x:0,y:100}) indiquant lemplacement o le composant doit tre ajout. Spcifiez le paramtre position par rapport au point central du composant, et non par rapport son point dalignement (galement point d'origine ou point zro).
categoryName Chane spcifiant le nom de la catgorie du composant (par exemple, "Data"). Les noms de catgories

valides sont numrs dans le panneau Composants.

componentName Chane spcifiant le nom du composant dans la catgorie spcifie (par exemple, "WebServiceConnector"). Les noms de composants valides sont numrs dans le panneau Composants.

Valeur renvoye Aucune. Description Ajoute le composant spcifi au document l'emplacement indiqu. Exemple Les exemples ci-dessous illustrent diverses faons dutiliser cette mthode :

EXTENSION DE FLASH CS4 PROFESSIONAL 52

Objet componentsPanel

fl.componentsPanel.addItemToDocument({x:0, y:0}, "User Interface", "CheckBox"); fl.componentsPanel.addItemToDocument({x:0, y:100}, "Data", "WebServiceConnector"); fl.componentsPanel.addItemToDocument({x:0, y:200}, "User Interface", "Button");

componentsPanel.reload()
Disponibilit Flash 8. Utilisation
componentsPanel.reload()

Paramtres Aucun. Valeur renvoye Valeur boolenne true si la liste du panneau Composants est actualise, et false dans le cas contraire. Description Mthode qui actualise la liste de composants affiche dans le panneau Composants. Exemple L'exemple suivant actualise le panneau Composants :
fl.componentsPanel.reload();

53

Chapitre 10 : Objet Contour

Disponibilit Flash MX 2004. Description Un objet Contour reprsente une trajectoire en tirets ferme marquant les limites dune forme. Rsum des mthodes Vous pouvez utiliser la mthode suivante avec lobjet Contour :
Mthode
contour.getHalfEdge()

Description Renvoie un objet Objet halfEdge sur le contour de la slection.

Rsum des proprits Vous pouvez utiliser les proprits suivantes avec lobjet Contour :
Proprit
contour.fill contour.interior contour.orientation

Description Objet Objet Fill. Lecture seule ; sa valeur est true si le contour enferme une zone, false dans le cas contraire. Lecture seule ; nombre entier indiquant lorientation du contour.

contour.fill
Disponibilit Flash CS4 Professional. Utilisation
contour.fill

Description Proprit ; Objet Fill. Exemple En supposant que vous avez un contour avec un remplissage slectionn, l'exemple suivant affiche la couleur de remplissage du contour dans le panneau Sortie :
var insideContour = fl.getDocumentDOM().selection[0].contours[1]; var insideFill = insideContour.fill; fl.trace(insideFill.color);

EXTENSION DE FLASH CS4 PROFESSIONAL 54

Objet Contour

contour.getHalfEdge()
Disponibilit Flash MX 2004. Utilisation
contour.getHalfEdge()

Paramtres Aucun. Valeur renvoye Objet Objet halfEdge. Description Mthode qui renvoie un objet Objet halfEdge sur le contour de la slection. Exemple Cet exemple analyse tous les contours de la forme slectionne et affiche les coordonnes des sommets dans le panneau Sortie :
// with a shape selected var elt = fl.getDocumentDOM().selection[0]; elt.beginEdit(); var contourArray = elt.contours; var contourCount = 0; for (i=0;i<contourArray.length;i++) { var contour = contourArray[i]; contourCount++; var he = contour.getHalfEdge(); var iStart = he.id; var id = 0; while (id != iStart) { // Get the next vertex. var vrt = he.getVertex();

var x = vrt.x; var y = vrt.y; fl.trace("vrt: " + x + ", " + y); he = he.getNext(); id = he.id; } } elt.endEdit();

EXTENSION DE FLASH CS4 PROFESSIONAL 55

Objet Contour

contour.interior
Disponibilit Flash MX 2004. Utilisation
contour.interior

Description Proprit en lecture seule ; la valeur est true si le contour enferme une zone ou false dans le cas contraire. Exemple Cet exemple analyse tous les contours de la forme slectionne et affiche la valeur de la proprit interior pour chaque contour dans le panneau Sortie :
var elt = fl.getDocumentDOM().selection[0]; elt.beginEdit(); var contourArray = elt.contours; var contourCount = 0; for (i=0;i<contourArray.length;i++) { var contour = contourArray[i]; fl.trace("Next Contour, interior:" + contour.interior ); contourCount++; } elt.endEdit();

contour.orientation
Disponibilit Flash MX 2004. Utilisation
contour.orientation

Description Proprit en lecture seule ; nombre entier indiquant lorientation du contour. La valeur de lentier est -1 si lorientation est anti-horaire, 1 si lobjet est orient dans le sens horaire, et 0 si ce contour ne renferme pas de surface. Exemple Cet exemple analyse tous les contours de la forme slectionne et affiche la valeur de la proprit orientation pour chaque contour dans le panneau Sortie :

EXTENSION DE FLASH CS4 PROFESSIONAL 56

Objet Contour

var elt = fl.getDocumentDOM().selection[0]; elt.beginEdit(); var contourArray = elt.contours; var contourCount = 0; for (i=0;i<contourArray.length;i++) { var contour = contourArray[i]; fl.trace("Next Contour, orientation:" + contour.orientation); contourCount++; } elt.endEdit();

57

Chapitre 11 : Objet Document

Disponibilit Flash MX 2004. Description Lobjet Document reprsente la scne. En dautres termes, seuls les fichiers FLA sont considrs comme des documents. Pour renvoyer l'objet Document du document actif, utilisez fl.getDocumentDOM(). Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet Document :
Mthode
document.addDataToDocument() document.addDataToSelection()

Description Enregistre les donnes spcifies avec un document. Enregistre les donnes spcifies avec le ou les objets slectionns. Applique un filtre aux objets slectionns. Ajoute lobjet Document spcifi un lment provenant dun document ouvert ou dune bibliothque. Ajoute un nouveau trac entre deux points. Ajoute un nouvel objet Oval dans le rectangle de dlimitation spcifi. Ajoute une nouvelle primitive ovale adapte aux limites spcifies. Ajoute une nouvelle primitive rectangle adapte aux limites spcifies. Ajoute un nouveau profil de publication et lactive. Ajoute un nouveau rectangle ou rectangle arrondi dans la dlimitation spcifie. Ajoute une nouvelle squence (Objet Timeline) aprs la squence actuellement slectionne, puis fait de cette nouvelle squence la squence slectionne. Insre un nouveau champ de texte vide. Aligne la slection. Cette mthode doit tre utilise avant la proprit document.screenOutline. Organise la slection sur la scne. Effectue une opration de sparation sur la slection en cours. Indique si le menu Modifier les symboles et ses fonctionnalits sont activs. Dtermine s'il est possible d'utiliser la mthode document.revert() ou fl.revertDocument().

document.addFilter() document.addItem()

document.addNewLine() document.addNewOval()

document.addNewPrimitiveOval()

document.addNewPrimitiveRectangle()

document.addNewPublishProfile() document.addNewRectangle()

document.addNewScene()

document.addNewText() document.align() document.allowScreens()

document.arrange() document.breakApart() document.canEditSymbol()

document.canRevert()

EXTENSION DE FLASH CS4 PROFESSIONAL 58

Objet Document

Mthode
document.canSaveAVersion()

Description Dtermine si une version du document spcifi peut tre enregistre sur le serveur Version Cue. Dtermine s'il est possible d'utiliser la mthodedocument.testMovie(). Dtermine s'il est possible d'utiliser la mthodedocument.testScene(). Change lindex du filtre dans la liste Filtres. Copie la slection actuelle du document dans le Pressepapiers. Coupe la slection actuelle du document et la place dans le Presse-papiers. Colle le contenu du Presse-papiers dans le document. Ferme le document spcifi. Convertit des lignes en remplissages pour les objets slectionns. Convertit le ou les lments slectionns sur la scne en un nouveau symbole. Sur la base de lobjet de dessin slectionn qui se trouve audessus, recadre tous les objets de dessin de niveau infrieur. Supprime lenveloppe (cadre de slection contenant un ou plusieurs objets) de lobjet slectionn. Supprime le profil actif, sil existe plusieurs profils. Supprime la squence actuelle (Objet Timeline) et, si cette squence ntait pas la dernire, dfinit la prochaine comme l'objet Timeline actif. Supprime la slection actuelle sur la scne. Dsactive tous les filtres des objets slectionns. Dans la liste Filtres, dsactive le filtre spcifi. Dans la liste Filtres, dsactive tous les filtres lexception de celui qui se trouve la position spcifie. Rpartit la slection. Effectue sur la slection actuelle une opration de rpartition vers les calques ; cette mthode est lquivalent de loption de menu Rpartir vers les calques. Recherche dans le document des donnes persistantes portant le nom spcifi. Duplique le profil actuellement actif et donne le focus ce duplicata. Cre une copie de la squence actuellement slectionne, en donnant cette nouvelle squence un nom unique et en en faisant la squence active. Duplique la slection sur la scne.

document.canTestMovie()

document.canTestScene()

document.changeFilterOrder() document.clipCopy()

document.clipCut()

document.clipPaste() document.close() document.convertLinesToFills()

document.convertToSymbol()

document.crop()

document.deleteEnvelope()

document.deletePublishProfile() document.deleteScene()

document.deleteSelection() document.disableAllFilters() document.disableFilter() document.disableOtherFilters()

document.distribute() document.distributeToLayers()

document.documentHasData()

document.duplicatePublishProfile()

document.duplicateScene()

document.duplicateSelection()

EXTENSION DE FLASH CS4 PROFESSIONAL 59

Objet Document

Mthode
document.editScene() document.enableAllFilters()

Description Slectionne la squence spcifie pour modification. Active tous les filtres de la liste Filtres pour le ou les objets slectionns. Active le filtre spcifi pour le ou les objets slectionns. Bascule lenvironnement de programmation dans le mode de modification spcifi par le paramtre. Quitte le mode Modification de symbole et renvoie le focus au niveau suprieur suivant. Exporte le document dans un ou plusieurs fichiers PNG. Exporte le profil actif dans un fichier XML. Renvoie une chane reprsentant le profil spcifi, au format XML. Exporte le document au format Flash SWF. Rcupre la valeur du bouton Sur la scne dans le panneau Aligner. Renvoie une chane indiquant le mode de fondu pour le ou les objets slectionns. Rcupre lobjet de remplissage (Fill) de la forme slectionne ou, selon le paramtre, du panneau Outils et de l'inspecteur Proprits. Renvoie lobjet trait (Stroke) de la forme slectionne ou, selon le paramtre, du panneau Outils et de l'inspecteur Proprits. Rcupre la valeur des donnes spcifies. Rcupre la proprit Element spcifie pour la slection. Rcupre la proprit TextAttrs spcifie pour les objets Text slectionns. Renvoie un tableau contenant la liste des filtres appliqus aux objets actuellement slectionns. Renvoie une chane contenant les mtadonnes XML associes au document. Renvoie la chane transmise
document.setMobileSettings().

document.enableFilter() document.enterEditMode()

document.exitEditMode()

document.exportPNG() document.exportPublishProfile() document.exportPublishProfileString()

document.exportSWF() document.getAlignToDocument()

document.getBlendMode()

document.getCustomFill()

document.getCustomStroke()

document.getDataFromDocument() document.getElementProperty() document.getElementTextAttr()

document.getFilters()

document.getMetadata()

document.getMobileSettings()

document.getPlayerVersion()

Renvoie une chane reprsentant la version de Flash Player cible pour le document spcifi. Rcupre les coordonnes du rectangle de dlimitation de la slection. Rcupre le texte slectionn. Rcupre l'Objet Timeline dans le document. Rcupre lemplacement du point de transformation de la slection. Convertit la slection en un groupe.

document.getSelectionRect()

document.getTextString() document.getTimeline() document.getTransformationPoint()

document.group()

EXTENSION DE FLASH CS4 PROFESSIONAL 60

Objet Document

Mthode
document.importFile() document.importPublishProfile() document.importPublishProfileString()

Description Importe un fichier dans le document. Importe un profil partir dun fichier. Importe une chane XML reprsentant un profil de publication et la dfinit en tant que profil actuel. Importe un fichier SWF dans le document. Cre un objet de dessin Intersection partir de tous les objets de dessin slectionns. Donne la mme taille tous les objets slectionns. Effectue un clic de souris partir de loutil Slection. Effectue un double clic de souris partir de loutil Slection. Si la slection contient au moins un trac comptant au moins un point de courbe de Bzier, cette mthode dplace de la valeur spcifie tous les points de courbe de Bzier de tous les tracs slectionns. Dplace les objets slectionns de la distance spcifie. Optimise le lissage de la slection, le cas chant en autorisant plusieurs passages pour obtenir un lissage optimal quivalent au choix de loption Modifier > Forme > Optimiser. Publie le document en fonction des paramtres de publication actuels (Fichier > Paramtres de publication) ; cette mthode est lquivalent de loption Fichier > Publier. Sur la base de lobjet de dessin slectionn le plus lev, poinonne tous les objets de dessin de niveau infrieur slectionns. Supprime tous les filtres du ou des objets slectionns. Supprime les donnes persistantes associes au document et correspondant au nom spcifi. Supprime les donnes persistantes associes la slection et correspondant au nom spcifi. Supprime le filtre spcifi de la liste Filtres pour le ou les objets slectionns. Renomme le profil actuel. Renomme la squence slectionne dans le panneau Squences. Place la squence spcifie devant une autre squence spcifie. Dans l'inspecteur Proprits, dfinit toutes les valeurs sur les paramtres par dfaut de l'objet Oval. Dans l'inspecteur Proprits, dfinit toutes les valeurs sur les paramtres par dfaut de l'objet Rectangle. Rinitialise la matrice de transformation ; cette mthode est lquivalent de loption de menu Modification > Transformer > Supprimer la transformation.

document.importSWF() document.intersect()

document.match() document.mouseClick() document.mouseDblClk() document.moveSelectedBezierPointsBy()

document.moveSelectionBy() document.optimizeCurves()

document.publish()

document.punch()

document.removeAllFilters() document.removeDataFromDocument()

document.removeDataFromSelection()

document.removeFilter()

document.renamePublishProfile() document.renameScene()

document.reorderScene()

document.resetOvalObject()

document.resetRectangleObject()

document.resetTransformation()

EXTENSION DE FLASH CS4 PROFESSIONAL 61

Objet Document

Mthode
document.revert()

Description Restaure la dernire version enregistre du document spcifi ; cette mthode est lquivalent de loption de menu Fichier > Rtablir. Remplace la version du document spcifi par celle qui est stocke sur le serveur Version Cue et consigne les ventuelles erreurs dans le panneau Sortie. Applique une rotation 3D la slection. Fait pivoter la slection du nombre de degrs spcifi. Enregistre le document son emplacement par dfaut ; cette mthode est lquivalent de loption de menu Fichier > Enregistrer. Enregistre et compresse le fichier ; cette mthode est lquivalent de loption de menu Fichier > Enregistrer et compresser. Enregistre une version du document spcifi sur le serveur Version Cue. Effectue une mise lchelle de la slection de la valeur spcifie ; cette mthode est lquivalent de loutil Transformation libre utilis pour modifier lchelle de lobjet. Slectionne tous les lments figurant sur la scne ; cette mthode est lquivalent des raccourcis clavier Ctrl+A (Windows) ou Commande+A (Macintosh), ou de loption de menu Edition > Slectionner tout. Dslectionne les lments slectionns. Dfinit les prfrences afin d'activer document.align(), document.distribute(), document.match() et document.space() pour le document. Cette commande est quivalente lactivation de l'option Sur la scne du panneau Aligner. Dfinit le mode de fondu pour les objets slectionns. Dfinit les paramtres de remplissage pour le panneau Outils, l'inspecteur Proprits et les formes slectionnes, le cas chant. Dfinit les paramtres de trait pour le panneau Outils, l'inspecteur Proprits et les formes slectionnes, le cas chant. Dfinit la proprit Element spcifie pour le ou les objets slectionns du document. Dfinit selon la valeur spcifie la proprit TextAttrs spcifie pour les lments de texte slectionns. Modifie la couleur de remplissage de la slection avec la couleur spcifie. Dfinit la proprit de filtre spcifie pour le ou les objets slectionns. Applique des filtres aux objets slectionns. Dfinit lopacit de loccurrence.

document.revertToLastVersion()

document.rotate3DSelection() document.rotateSelection() document.save()

document.saveAndCompact()

document.saveAVersion()

document.scaleSelection()

document.selectAll()

document.selectNone() document.setAlignToDocument()

document.setBlendMode() document.setCustomFill()

document.setCustomStroke()

document.setElementProperty()

document.setElementTextAttr()

document.setFillColor()

document.setFilterProperty()

document.setFilters() document.setInstanceAlpha()

EXTENSION DE FLASH CS4 PROFESSIONAL 62

Objet Document

Mthode
document.setInstanceBrightness() document.setInstanceTint() document.setMetadata()

Description Dfinit la luminosit de loccurrence. Dfinit la teinte de loccurrence. Dfinit les mtadonnes XML du document spcifi, en remplacement des mtadonnes existantes. Dfinit la valeur d'une chane de paramtres XML dans un fichier FLA mobile. Spcifie la valeur d'une proprit spcifie des objets Oval de type primitif. Dfinit la version de Flash Player cible par le document spcifi. Spcifie la valeur d'une proprit spcifie des objets Rectangle de type primitif. Dplace et redimensionne la slection en une seule opration. Trace un cadre de slection rectangulaire sur la scne, partir des coordonnes spcifies. Spcifie le point de fuite pour l'affichage des objets 3D. Spcifie l'angle de perspective pour l'affichage des objets 3D. Dfinit la couleur, la largeur et le style des traits slectionns. Modifie la couleur de trait de la slection avec la couleur spcifie. Modifie la taille de trait de la slection avec la taille spcifie. Modifie le style de trait de la slection avec le style spcifi. Modifie le rectangle de dlimitation de llment de texte slectionn en lui donnant la taille spcifie. Dfinit la slection de texte du champ de texte slectionn avec les valeurs spcifies dans startIndex et endIndex. Insre une chane de texte. Dplace le point de transformation de la slection. Incline la slection de la valeur spcifie. Lisse la courbe de chaque contour de remplissage ou segment incurv slectionn. Espace rgulirement les objets slectionns. Redresse les traits slectionns ; cette mthode est lquivalent du bouton Redresser dans le panneau Outils. Intervertit la slection actuelle avec la slection spcifie. Permute les couleurs de trait et de remplissage. Synchronise le document spcifi avec la version la plus rcente trouve sur le serveur Version Cue et consigne les ventuelles erreurs dans le panneau Sortie. Excute une opration Tester l'animation sur le document.

document.setMobileSettings()

document.setOvalObjectProperty()

document.setPlayerVersion()

document.setRectangleObjectProperty()

document.setSelectionBounds() document.setSelectionRect()

document.setStageVanishingPoint() document.setStageViewAngle() document.setStroke() document.setStrokeColor()

document.setStrokeSize() document.setStrokeStyle() document.setTextRectangle()

document.setTextSelection()

document.setTextString() document.setTransformationPoint() document.skewSelection() document.smoothSelection()

document.space() document.straightenSelection()

document.swapElement() document.swapStrokeAndFill() document.synchronizeWithHeadVersion()

document.testMovie()

EXTENSION DE FLASH CS4 PROFESSIONAL 63

Objet Document

Mthode
document.testScene()

Description Excute une opration Tester la squence sur la squence active dans le document. Convertit le bitmap slectionn en graphique vectoriel ; cette mthode est lquivalent de loption de menu Modification > Bitmap > Tracer le bitmap. Effectue une transformation gnrale de la slection, en appliquant la matrice transmise en arguments. Dfinit la position XYZ autour de laquelle est effectue la translation ou la rotation de la slection. Applique une translation 3D la slection. Dissocie la slection. Combine toutes les formes slectionnes sous forme dun objet de dessin. Dverrouille tous les lments verrouills dans limage slectionne. Envoie une bote de dialogue XMLUI.

document.traceBitmap()

document.transformSelection()

document.translate3DCenter()

document.translate3DSelection() document.unGroup() document.union()

document.unlockAllElements()

document.xmlPanel()

Rsum des proprits Vous pouvez utiliser les proprits suivantes avec lobjet Document :
Proprit
document.accName document.as3AutoDeclare

Description Chane quivalente au champ Nom du panneau Accessibilit. Valeur boolenne indiquant si les occurrences places sur la scne sont automatiquement ajoutes aux classes Timeline (scnario) dfinies par l'utilisateur. Chane dcrivant le dialecte d'ActionScript 3.0 utilis dans le document spcifi. Entier spcifiant dans quelle image exporter les classes ActionScript 3.0. Valeur boolenne spcifiant si le compilateur ActionScript 3.0 doit compiler avec l'option du mode strict active ou non. Valeur boolenne spcifiant si le compilateur ActionScript 3.0 doit compiler avec l'option Mode avertissements active ou non. Entier indiquant la version ActionScript utilise dans le fichier spcifi. Valeur boolenne quivalente la case cocher Etiquetage auto du panneau Accessibilit. Chane, valeur hexadcimale ou entier reprsentant la couleur d'arrireplan. Chane spcifiant le nom du profil de publication actif pour le document spcifi. Nombre entier spcifiant lindex du scnario actif. Chane quivalente au champ Description du panneau Accessibilit. Spcifie la classe ActionScript 3.0 de niveau suprieur qui est associe au document.

document.as3Dialect

document.as3ExportFrame document.as3StrictMode

document.as3WarningsMode

document.asVersion document.autoLabel

document.backgroundColor

document.currentPublishProfile

document.currentTimeline document.description document.docClass

EXTENSION DE FLASH CS4 PROFESSIONAL 64

Objet Document

Proprit
document.externalLibraryPath

Description Chane qui contient la liste des lments du chemin de bibliothque externe ActionScript 3.0 du document, spcifiant l'emplacement des fichiers SWC utiliss en tant que bibliothques partages par le moteur d'excution. Valeur boolenne indiquant si les enfants de lobjet spcifi sont accessibles. Nombre en virgule flottante indiquant le nombre dimages affiches par seconde pendant la lecture du fichier SWF ; cette valeur est 12 par dfaut. Nombre entier indiquant la hauteur en pixels du document (scne). Nombre entier unique (attribu automatiquement) qui identifie un document pendant une session Flash. Lecture seule ; Objet library d'un document. Chane qui contient la liste des lments de chemin de la bibliothque ActionScript 3.0 du document, spcifiant l'emplacement des fichiers SWC ou des dossiers les contenant. Valeur boolenne indiquant si la fonction Aperu en direct est active. Lecture seule ; chane reprsentant le nom dun document (fichier FLA). Lecture seule ; chane reprsentant le chemin daccs du document dans un format spcifique la plate-forme. Lecture seule ; chane reprsentant le chemin daccs du document, exprime sous la forme fichier:/// URI . Lecture seule ; tableau des noms des profils de publication du document. Lecture seule ; Objet ScreenOutline actuel du document. Tableau des objets slectionns dans le document. Valeur boolenne indiquant si lobjet est accessible. Proprit ; chane qui contient la liste des lments du chemin source ActionScript 3.0 du document, spcifiant l'emplacement des fichiers de classe ActionScript. Lecture seule ; tableau des objets Timeline (voir Objet Timeline). Lecture seule ; Objet Matrix. Nombre entier indiquant la largeur en pixels du document (scne). Spcifie le pourcentage de zoom de la scne lors de la programmation.

document.forceSimple

document.frameRate

document.height document.id

document.library document.libraryPath

document.livePreview document.name document.path

document.pathURI

document.publishProfiles document.screenOutline document.selection document.silent document.sourcePath

document.timelines document.viewMatrix document.width document.zoomFactor

document.accName
Disponibilit Flash MX 2004. Utilisation
document.accName

EXTENSION DE FLASH CS4 PROFESSIONAL 65

Objet Document

Description Proprit ; chane quivalente au champ Nom du panneau Accessibilit. Les logiciels de lecture vocale identifient l'objet en prononant ce nom. Exemple Lexemple suivant dfinit le nom daccessibilit du document sur "Main Movie" :
fl.getDocumentDOM().accName = "Main Movie";

Lexemple suivant rcupre le nom daccessibilit du document :

fl.trace(fl.getDocumentDOM().accName);

document.addDataToDocument()
Disponibilit Flash MX 2004. Utilisation
document.addDataToDocument(name, type, data)

Paramtres name Chane spcifiant le nom des donnes ajouter.

type Chane dfinissant le type de donnes ajouter. Les valeurs possibles sont "integer", "integerArray", "double", "doubleArray", "string" et "byteArray". data Valeur ajouter. Les types valides dpendent du paramtre type.

Valeur renvoye Aucune. Description Mthode qui enregistre les donnes spcifies avec un document. Les donnes sont crites dans le fichier FLA et sont accessibles en JavaScript la rouverture du fichier. Exemple Lexemple suivant ajoute un entier ayant la valeur 12 au document actif :
fl.getDocumentDOM().addDataToDocument("myData", "integer", 12);

Lexemple suivant renvoie la valeur des donnes nommes "myData" et affiche le rsultat dans le panneau Sortie :
fl.trace(fl.getDocumentDOM().getDataFromDocument("myData"));

Voir aussi
document.getDataFromDocument(), document.removeDataFromDocument()

EXTENSION DE FLASH CS4 PROFESSIONAL 66

Objet Document

document.addDataToSelection()
Disponibilit Flash MX 2004. Utilisation
document.addDataToSelection(name, type, data)

Paramtres name Chane spcifiant le nom des donnes persistantes.

type Dfinit le type de donnes. Les valeurs possibles sont "integer", "integerArray", "double", "doubleArray", "string" et "byteArray". data Valeur ajouter. Les types valides dpendent du paramtre type.

Valeur renvoye Aucune. Description Mthode qui enregistre les donnes spcifies avec le ou les objets slectionns. Les donnes sont crites dans le fichier FLA et sont accessibles en JavaScript la rouverture du fichier. Seuls les symboles et les bitmaps acceptent des donnes persistantes. Exemple L'exemple suivant ajoute un entier ayant la valeur 12 lobjet slectionn :
fl.getDocumentDOM().addDataToSelection("myData", "integer", 12);

Voir aussi
document.removeDataFromSelection()

document.addFilter()
Disponibilit Flash 8. Utilisation
document.addFilter(filterName)

Paramtres
filterName Chane indiquant le filtre ajouter la liste Filtres et activer pour le ou les objets slectionns. Les

valeurs possibles sont "adjustColorFilter", "bevelFilter", "blurFilter", "dropShadowFilter", "glowFilter", "gradientBevelFilter" et "gradientGlowFilter". Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 67

Objet Document

Description Mthode qui applique un filtre aux objets slectionns et le place la fin de la liste Filtres. Exemple Lexemple suivant applique un effet non aux objets slectionns :
fl.getDocumentDOM().addFilter("glowFilter");

Voir aussi
document.changeFilterOrder(), document.disableFilter(), document.enableFilter(), document.getFilters(), document.removeFilter(), document.setBlendMode(), document.setFilterProperty()

document.addItem()
Disponibilit Flash MX 2004. Utilisation
document.addItem(position, item)

Paramtres position Point indiquant les coordonnes x et y de lemplacement auquel le composant doit tre ajout. Ce point est le centre pour un symbole ou le coin suprieur gauche pour une image bitmap ou une vido.
item Objet Item spcifiant l'lment ajouter et la bibliothque dont il est extrait (voir Objet Item).

Valeur renvoye Valeur boolenne : true en cas de russite, false sinon. Description Mthode qui ajoute l'objet Document spcifi un lment provenant d'un document ouvert ou d'une bibliothque. Exemple Lexemple suivant ajoute le premier lment de la bibliothque au premier document, lemplacement indiqu pour le symbole, le bitmap ou la vido slectionn(e) :
var item = fl.documents[0].library.items[0]; fl.documents[0].addItem({x:0,y:0}, item);

Lexemple suivant ajoute le symbole myMovieClip au document actif partir de sa propre bibliothque :
var itemIndex = fl.getDocumentDOM().library.findItemIndex("myMovieClip"); var theItem = fl.getDocumentDOM().library.items[itemIndex]; fl.getDocumentDOM().addItem({x:0,y:0}, theItem);

Lexemple suivant ajoute le symbole myMovieClip du deuxime document du tableau des documents au troisime document de ce tableau :

EXTENSION DE FLASH CS4 PROFESSIONAL 68

Objet Document

var itemIndex = fl.documents[1].library.findItemIndex("myMovieClip"); var theItem = fl.documents[1].library.items[itemIndex]; fl.documents[2].addItem({x:0,y:0}, theItem);

document.addNewLine()
Disponibilit Flash MX 2004. Utilisation
document.addNewLine(startPoint, endpoint)

Paramtres
startpoint Paire de nombres en virgule flottante indiquant les coordonnes x et y de dpart de la ligne. endpoint Paire de nombres en virgule flottante indiquant les coordonnes x et y de fin de la ligne.

Valeur renvoye Aucune. Description Mthode qui ajoute un nouveau trajet entre deux points. La mthode utilise les attributs de trait actuels du document et ajoute le trajet dans limage et le calque actifs. Cette mthode est lquivalent dun clic sur loutil Ligne et du traage dune ligne. Exemple Lexemple suivant ajoute une ligne entre le point de dbut et le point de fin spcifis :
fl.getDocumentDOM().addNewLine({x:216.7, y:122.3}, {x:366.8, y:165.8});

document.addNewOval()
Disponibilit Flash MX 2004. Utilisation
document.addNewOval(boundingRectangle [, bSuppressFill [, bSuppressStroke ]])

Paramtres
boundingRectangle Rectangle dlimitant lovale ajouter. Pour plus d'informations sur le format de

boundingRectangle, consultez la mthode document.addNewRectangle().

bSuppressFill Valeur boolenne. Si elle est dfinie sur true, la mthode cre la forme sans remplissage. La valeur par dfaut est false. Ce paramtre est facultatif. bSuppressStroke Valeur boolenne. Si elle est true, la mthode cre la forme sans trait. La valeur par dfaut est false. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 69

Objet Document

Valeur renvoye Aucune. Description Mthode qui ajoute un nouvel objet Oval dans le rectangle de dlimitation spcifi. Cette mthode effectue la mme opration que loutil Ovale. La mthode utilise les attributs de trait et de remplissage par dfaut actuels du document et ajoute lovale dans limage et le calque actifs. Si les valeurs de bSuppressFill et bSuppressStroke sont toutes deux dfinies sur true, la mthode est sans effet. Exemple L'exemple suivant ajoute un ovale de 164 pixels de large sur 178 pixels de haut dans la zone dfinie par les coordonnes spcifies :
fl.getDocumentDOM().addNewOval({left:72,top:50,right:236,bottom:228});

L'exemple suivant trace l'ovale sans remplissage :

fl.getDocumentDOM().addNewOval({left:72,top:50,right:236,bottom:228}, true);

L'exemple suivant trace l'ovale sans trait :

fl.getDocumentDOM().addNewOval({left:72,top:50,right:236,bottom:228}, false, true);

Voir aussi
document.addNewPrimitiveOval()

document.addNewPrimitiveOval()
Disponibilit Flash CS4 Professional. Utilisation
document.addNewPrimitiveOval( boundingRectangle [, bSpupressFill [, bSuppressStroke ]] ))

Paramtres
boundingRectangle Rectangle qui dlimite la zone de cration dans laquelle la nouvelle primitive ovale est ajoute.

Pour plus d'informations sur le format de boundingRectangle, consultez document.addNewRectangle().

bSuppressFill Valeur boolenne qui, lorsqu'elle est dfinie sur true, oblige la mthode crer l'ovale sans remplissage. La valeur par dfaut est false. Ce paramtre est facultatif. bSuppressStroke Valeur boolenne qui, lorsqu'elle est dfinie sur true, oblige la mthode crer l'ovale sans trait. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 70

Objet Document

Description Mthode qui ajoute une nouvelle primitive ovale adapte aux limites spcifies. Cette mthode effectue la mme opration que l'outil Primitive ovale. La primitive ovale utilise les attributs de trait et de remplissage par dfaut du document et est ajoute dans limage et le calque actifs. Si les valeurs de bSuppressFill et bSuppressStroke sont toutes deux dfinies sur true, la mthode est sans effet. Exemple L'exemple suivant ajoute des primitives ovales aux coordonnes spcifies, avec ou sans remplissage et trait :
// Add an oval primitive with fill and stroke fl.getDocumentDOM().addNewPrimitiveOval({left:0,top:0,right:100,bottom:100}); // Add an oval primitive without a fill fl.getDocumentDOM().addNewPrimitiveOval({left:100,top:100,right:200,bottom:200}, true); // Add an oval primitive without a stroke fl.getDocumentDOM().addNewPrimitiveOval({left:200,top:200,right:300,bottom:300},false,true);

Voir aussi
document.addNewOval()

document.addNewPrimitiveRectangle()
Disponibilit Flash CS4 Professional. Utilisation
document.addNewPrimitiveRectangle( boundingRectangle, roundness, [, bSuppressFill [, bSuppressStroke ]] ))

Paramtres rect Rectangle qui dlimite la zone de cration du nouveau rectangle. Pour plus d'informations sur le format de boundingRectangle, consultez document.addNewRectangle().
roundness Nombre entier compris entre 0 et 999 reprsentant le nombre de points utiliss pour spcifier l'arrondi

des angles.
bSuppressFill Valeur boolenne qui, lorsqu'elle est dfinie sur true, oblige la mthode crer le rectangle sans remplissage. La valeur par dfaut est false. Ce paramtre est facultatif. bSuppressStroke Valeur boolenne. Si elle est true, la mthode cre le rectangle sans trait. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui ajoute une nouvelle primitive rectangle adapte aux limites spcifies. Cette mthode effectue la mme opration que loutil Primitive rectangle. La primitive rectangle utilise les attributs de trait et de remplissage par dfaut du document et est ajoute dans limage et le calque actifs. Si les valeurs de bSuppressFill et bSuppressStroke sont toutes deux dfinies sur true, la mthode est sans effet.

EXTENSION DE FLASH CS4 PROFESSIONAL 71

Objet Document

Exemple L'exemple suivant ajoute des primitives rectangle aux coordonnes spcifies, avec et sans remplissage et trait, et avec des niveaux d'arrondis diffrents :
// Add a rectangle primitive with fill and stroke fl.getDocumentDOM().addNewPrimitiveRectangle({left:0,top:0,right:100,bottom:100}, 0); // Add a rectangle primitive without a fill fl.getDocumentDOM().addNewPrimitiveRectangle({left:100,top:100,right:200,bottom:200}, 20, true); // Add a rectangle primitive without a stroke fl.getDocumentDOM().addNewPrimitiveRectangle({left:200,top:200,right:300,bottom:300}, 50,false,true);

Voir aussi
document.addNewRectangle()

document.addNewPublishProfile()
Disponibilit Flash MX 2004. Utilisation
document.addNewPublishProfile([profileName])

Paramtres
profileName Nom unique du nouveau profil. Si vous ne spcifiez pas de nom, un nom par dfaut est utilis. Ce paramtre est facultatif.

Valeur renvoye Nombre entier correspondant lindex du nouveau profil dans la liste des profils. Renvoie -1 s'il est impossible de crer un nouveau profil. Description Mthode qui ajoute un nouveau profil de publication et lactive. Exemple Lexemple suivant ajoute un nouveau profil de publication avec un nom par dfaut, puis affiche le nom du profil dans le panneau Sortie :
fl.getDocumentDOM().addNewPublishProfile(); fl.outputPanel.trace(fl.getDocumentDOM().currentPublishProfile);

L'exemple suivant ajoute un nouveau profil de publication avec le nom "my profile" :
fl.getDocumentDOM().addNewPublishProfile("my profile");

Voir aussi
document.deletePublishProfile()

EXTENSION DE FLASH CS4 PROFESSIONAL 72

Objet Document

document.addNewRectangle()
Disponibilit Flash MX 2004. Utilisation
document.addNewRectangle(boundingRectangle, roundness [, bSuppressFill [, bSuppressStroke]])

Paramtres
boundingRectangle Rectangle qui dlimite la zone de cration du nouveau rectangle, exprim au format {left:value1,top:value2,right:value3,bottom:value4}. Les valeurs left et top spcifient l'emplacement du

coin suprieur gauche (exemple : left:0,top:0 reprsente le coin suprieur gauche de la scne), et les valeurs right et bottom indiquent l'emplacement du coin infrieur droit. De ce fait, la largeur du rectangle correspond l'cart entre left et right, et sa hauteur l'cart entre top et bottom. En d'autres termes, les limites du rectangle ne correspondent pas toutes aux valeurs indiques dans l'inspecteur Proprits. Les valeurs left et top correspondent respectivement aux valeurs X et Y de l'inspecteur Proprits. Toutefois, les valeurs right et bottom ne correspondent pas aux valeurs L et H de l'inspecteur Proprits. Par exemple, supposons un rectangle possdant les limites suivantes :
{left:10,top:10,right:50,bottom:100}

Ce rectangle possderait les valeurs suivantes dans l'inspecteur Proprits :

X = 10, Y = 10, W = 40, H = 90 roundness Valeur entire comprise entre 0 et 999 qui reprsente le niveau darrondi des angles. La valeur est

exprime sous la forme dun nombre de points. Plus elle est leve, plus larrondi est important.
bSuppressFill Valeur boolenne. Si elle est dfinie sur true, la mthode cre la forme sans remplissage. La valeur

par dfaut est false. Ce paramtre est facultatif.

bSuppressStroke Valeur boolenne. Si elle est true, la mthode cre le rectangle sans trait. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui ajoute un nouveau rectangle ou un rectangle arrondi dans la dlimitation spcifie. Cette mthode effectue la mme opration que loutil Rectangle. La mthode utilise les attributs de trait et de remplissage par dfaut actuels du document et ajoute le rectangle dans limage et le calque actifs. Si les valeurs de bSuppressFill et bSuppressStroke sont toutes deux dfinies sur true, la mthode est sans effet. Exemple L'exemple suivant ajoute un rectangle sans angles arrondis aux coordonnes indiques, de 100 pixels de large sur 100 pixels de haut :
fl.getDocumentDOM().addNewRectangle({left:0,top:0,right:100,bottom:100},0);

L'exemple suivant ajoute un rectangle, sans angles arrondis ni remplissage, de 100 pixels de large sur 200 pixels de haut :

EXTENSION DE FLASH CS4 PROFESSIONAL 73

Objet Document

fl.getDocumentDOM().addNewRectangle({left:10,top:10,right:110,bottom:210},0, true);

L'exemple suivant ajoute un rectangle, sans angles arrondis ni contour, de 200 pixels de large sur 100 pixels de haut :
fl.getDocumentDOM().addNewRectangle({left:20,top:20,right:220,bottom:120},0, false, true);

Voir aussi
document.addNewPrimitiveRectangle()

document.addNewScene()
Disponibilit Flash MX 2004. Utilisation
document.addNewScene([name])

Paramtres name Spcifie le nom de la squence. Si vous ne spcifiez pas de nom, un nouveau nom de squence par dfaut est cr. Valeur renvoye Valeur boolenne, true si la squence a bien t ajoute, false dans le cas contraire. Description Mthode qui ajoute une nouvelle squence (Objet Timeline) aprs la squence actuellement slectionne, puis fait de cette nouvelle squence la squence slectionne. Si le nom de squence indiqu existe dj, la squence nest pas ajoute et la mthode renvoie une erreur. Exemple Lexemple suivant ajoute une nouvelle squence nomme myScene aprs la squence actuelle dans le document actif. La variable success est dfinie sur true aprs la cration de la squence, sur false dans le cas contraire.
var success = fl.getDocumentDOM().addNewScene("myScene");

L'exemple suivant ajoute une nouvelle squence en utilisant la convention de nom par dfaut. Sil nexiste encore qu'une seule squence, la nouvelle squence sera nomme "Scene 2".
fl.getDocumentDOM().addNewScene();

document.addNewText()
Disponibilit Flash MX 2004 ; paramtre text facultatif ajout dans Flash CS3 Professional. Utilisation
document.addNewText(boundingRectangle [, text ])

EXTENSION DE FLASH CS4 PROFESSIONAL 74

Objet Document

Paramtres
boundingRectangle Spcifie la taille et l'emplacement du champ de texte. Pour plus d'informations sur le format de

boundingRectangle, consultez la mthode document.addNewRectangle().

text Chane facultative qui spcifie le texte placer dans le champ. Si vous omettez ce paramtre, la slection dans le

panneau Outils bascule sur l'outil Texte. Par consquent, si vous ne voulez pas changer d'outil, transmettez une valeur pour text. Valeur renvoye Aucune. Description Mthode qui insre un nouveau champ de texte et, le cas chant, y place du texte. Si vous omettez le paramtre text, vous pouvez appeler document.setTextString() pour remplir le champ de texte. Exemple L'exemple suivant cre un nouveau champ de texte dans le coin suprieur gauche de la scne et y insre la chane de texte Hello World :
fl.getDocumentDOM().addNewText({left:0, top:0, right:100, bottom:100} , "Hello World!" ); fl.getDocumentDOM().setTextString('Hello World!');

Voir aussi
document.setTextString()

document.align()
Disponibilit Flash MX 2004. Utilisation
document.align(alignmode [, bUseDocumentBounds])

Paramtres
alignmode Chane indiquant comment aligner la slection. Les valeurs possibles sont "left", "right", "top", "bottom", "vertical center" et "horizontal center". bUseDocumentBounds Valeur boolenne. Si elle est true, la mthode aligne les objets slectionns sur les limites du document. Sinon, la mthode utilise les limites des objets slectionns. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui aligne la slection.

EXTENSION DE FLASH CS4 PROFESSIONAL 75

Objet Document

Exemple Lexemple suivant aligne les objets gauche et sur les limites de la scne. Cette commande est quivalente l'activation de l'option Sur la scne du panneau Aligner, puis un clic sur le bouton Aligner gauche :
fl.getDocumentDOM().align("left", true);

Voir aussi
document.distribute(), document.getAlignToDocument(), document.setAlignToDocument()

document.allowScreens()
Disponibilit Flash MX 2004. Utilisation
document.allowScreens()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si document.screenOutline peut tre utilis en toute scurit, false dans le cas contraire. Description Mthode, utilise avant la proprit document.screenOutline. Si la mthode renvoie la valeur true, il est possible daccder sans risque la proprit document.screenOutline. Flash affiche une erreur si la proprit document.screenOutline est appele dans un document ne comportant pas dcrans. Exemple Lexemple suivant dtermine s'il est possible dutiliser les mthodes screens dans le document actif :
if(fl.getDocumentDOM().allowScreens()) { fl.trace("screen outline is available."); } else { fl.trace("whoops, no screens."); }

Voir aussi
document.screenOutline

document.arrange()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 76

Objet Document

Utilisation
document.arrange(arrangeMode)

Paramtres
arrangeMode Spcifie la direction dans laquelle la slection doit tre dplace. Les valeurs gres sont "back", "backward", "forward" et "front". Offre les mmes possibilits que les options quivalentes du menu Modification > Disposer.

Valeur renvoye Aucune. Description Mthode qui organise la slection sur la scne. Cette mthode sapplique uniquement aux objets qui ne sont pas des formes. Exemple L'exemple suivant place la slection au premier plan :
fl.getDocumentDOM().arrange("front");

document.as3AutoDeclare
Disponibilit Flash CS3 Professional. Utilisation
document.as3AutoDeclare

Description Proprit ; valeur boolenne indiquant si les occurrences places sur la scne sont automatiquement ajoutes aux classes Timeline (scnario) dfinies par l'utilisateur. La valeur par dfaut est true. Exemple L'exemple suivant prcise que les occurrences places sur la scne dans le document actif doivent tre ajoutes manuellement aux classes Timeline (scnario) dfinies par l'utilisateur.
fl.getDocumentDOM().as3AutoDeclare=false;

document.as3Dialect
Disponibilit Flash CS3 Professional. Utilisation
document.as3Dialect

EXTENSION DE FLASH CS4 PROFESSIONAL 77

Objet Document

Description Proprit ; chane dcrivant le dialecte d'ActionScript 3.0 utilis dans le document spcifi. La valeur par dfaut est "AS3". Si vous souhaitez autoriser des classes de prototype, telles qu'elles ont t admises dans les prcdentes spcifications ECMAScript, dfinissez cette valeur sur "ES". Exemple L'exemple suivant prcise que le dialecte utilis dans le document actif est ECMAScript :
fl.getDocumentDOM().as3Dialect="ES";

Voir aussi
document.asVersion

document.as3ExportFrame
Disponibilit Flash CS3 Professional. Utilisation
document.as3ExportFrame

Description Proprit ; nombre entier spcifiant dans quelle image exporter les classes ActionScript 3.0. Par dfaut, les classes sont exportes dans l'image1. Exemple L'exemple suivant change l'image dans laquelle les classes sont exportes, l'image5 remplace l'image par dfaut1.
var myDocument = fl.getDocumentDOM(); fl.outputPanel.trace("'Export classes in frame:' value before modification is " + myDocument.as3ExportFrame); myDocument.as3ExportFrame = 5; fl.outputPanel.trace("'Export classes in frame:' value after modification is " + myDocument.as3ExportFrame);

document.as3StrictMode
Disponibilit Flash CS3 Professional. Utilisation
document.as3StrictMode

EXTENSION DE FLASH CS4 PROFESSIONAL 78

Objet Document

Description Proprit ; valeur boolenne indiquant si le compilateur ActionScript 3.0 doit compiler avec l'option du mode strict active (true) ou non (false). Le Mode strict signale les avertissements comme des erreurs, ce qui signifie que la compilation chouera tant que ces erreurs persisteront. La valeur par dfaut est true. Exemple L'exemple suivant dsactive l'option Mode strict du compilateur.
var myDocument = fl.getDocumentDOM(); fl.outputPanel.trace("Strict Mode value before modification is " + myDocument.as3StrictMode); myDocument.as3StrictMode = false; fl.outputPanel.trace("Strict Mode value after modification is " + myDocument.as3StrictMode);

Voir aussi
document.as3WarningsMode

document.as3WarningsMode
Disponibilit Flash CS3 Professional. Utilisation
document.as3WarningsMode

Description Proprit ; valeur boolenne spcifiant si le compilateur ActionScript 3.0 doit compiler avec l'option Mode avertissements active (true) ou non (false). Le mode avertissements dclenche des alarmes supplmentaires devant tre signales, utiles lors de la mise jour du code ActionScript 2.0 vers ActionScript 3.0 pour reprer d'ventuelles incompatibilits. La valeur par dfaut est true. Exemple L'exemple suivant dsactive l'option Mode avertissements du compilateur.
var myDocument = fl.getDocumentDOM(); fl.outputPanel.trace("Warnings Mode value before modification is " + myDocument.as3WarningsMode); myDocument.as3WarningsMode = false; fl.outputPanel.trace("Warnings Mode value after modification is " + myDocument.as3WarningsMode);

Voir aussi
document.as3StrictMode

document.asVersion
Disponibilit Flash CS3 Professional.

EXTENSION DE FLASH CS4 PROFESSIONAL 79

Objet Document

Utilisation
document.asVersion

Description Proprit ; nombre entier spcifiant quelle version d'ActionScript est utilise dans le document spcifi. Les valeurs possibles sont 1, 2 et 3. Pour dterminer la version de Flash Player cible pour le document spcifi, utilisez document.getPlayerVersion() ; cette mthode renvoie une chane, elle est donc utilisable par les lecteurs Flash Lite. Exemple L'exemple suivant dfinit la version d'ActionScript dans le document actif sur ActionScript 2.0 si elle est actuellement dfinie sur ActionScript 1.0.
if(fl.getDocumentDOM().asVersion == 1){ fl.getDocumentDOM().asVersion = 2; }

Voir aussi
document.as3Dialect, document.getPlayerVersion()

document.autoLabel
Disponibilit Flash MX 2004. Utilisation
document.autoLabel

Description Proprit ; valeur boolenne quivalente la case cocher Etiquetage auto du panneau Accessibilit. Cette proprit permet dindiquer Flash d'tiqueter automatiquement les objets sur la scne avec le texte qui leur est associ. Exemple Lexemple suivant rcupre la valeur de la proprit autoLabel et affiche le rsultat dans le panneau Sortie :
var isAutoLabel = fl.getDocumentDOM().autoLabel; fl.trace(isAutoLabel);

Lexemple suivant dfinit la proprit autoLabel sur true, indiquant ainsi Flash que les objets prsents sur la scne doivent tre tiquets automatiquement :
fl.getDocumentDOM().autoLabel = true;

EXTENSION DE FLASH CS4 PROFESSIONAL 80

Objet Document

document.backgroundColor
Disponibilit Flash MX 2004. Utilisation
document.backgroundColor

Description Proprit ; couleur de l'arrire-plan, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Exemple Lexemple suivant dfinit la couleur darrire-plan sur Noir :
fl.getDocumentDOM().backgroundColor = '#000000';

document.breakApart()
Disponibilit Flash MX 2004. Utilisation
document.breakApart()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui effectue une opration de sparation sur la slection en cours. Exemple Lexemple suivant spare la slection :
fl.getDocumentDOM().breakApart();

EXTENSION DE FLASH CS4 PROFESSIONAL 81

Objet Document

document.canEditSymbol()
Disponibilit Flash MX 2004. Utilisation
document.canEditSymbol()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si le menu et la fonctionnalit Modifier les symboles sont disponibles, false dans le cas contraire. Description Mthode qui indique si le menu Modifier les symboles et ses fonctionnalits sont activs. Cette mthode n'indique pas s'il est possible de modifier la slection. Elle ne doit pas tre utilise pour tester si l'appel de fl.getDocumentDOM().enterEditMode() est autoris. Exemple Lexemple suivant affiche dans le panneau Sortie l'tat du menu Modifier les symboles et ses fonctionnalits :
fl.trace("fl.getDocumentDOM().canEditSymbol() returns: " + fl.getDocumentDOM().canEditSymbol());

document.canRevert()
Disponibilit Flash MX 2004. Utilisation
document.canRevert()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si vous pouvez utiliser les mthodes document.revert() ou fl.revertDocument(), false dans le cas contraire. Description Mthode qui dtermine s'il est possible d'utiliser la mthode document.revert() ou fl.revertDocument().

EXTENSION DE FLASH CS4 PROFESSIONAL 82

Objet Document

Exemple Lexemple suivant vrifie s'il est possible de restaurer le document actif avec sa dernire version enregistre. Dans laffirmative, fl.getDocumentDOM().revert() rtablit la dernire version enregistre.
if(fl.getDocumentDOM().canRevert()){ fl.getDocumentDOM().revert(); }

document.canSaveAVersion()
Disponibilit Flash CS3 Professional. Utilisation
document.canSaveAVersion()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si une version du fichier peut tre enregistre sur le serveur Version Cue, sinon false. Description Mthode qui dtermine si une version du document spcifi peut tre enregistre sur le serveur Version Cue. Exemple L'exemple suivant vrifie si document.saveAVersion() est utilisable. Si c'est le cas, la mthode est ensuite appele.
if(fl.getDocumentDOM().canSaveAVersion()){ fl.getDocumentDOM().saveAVersion; }

Voir aussi
document.revertToLastVersion(), document.saveAVersion()

document.canTestMovie()
Disponibilit Flash MX 2004. Utilisation
document.canTestMovie()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 83

Objet Document

Valeur renvoye Valeur boolenne, true si vous pouvez utiliser la mthode document.testMovie(), false dans le cas contraire. Description Mthode qui dtermine s'il est possible dutiliser la mthode document.testMovie(). Exemple Lexemple suivant vrifie si fl.getDocumentDOM().testMovie() peut tre utilise. Si c'est le cas, la mthode est ensuite appele.
if(fl.getDocumentDOM().canTestMovie()){ fl.getDocumentDOM().testMovie(); }

Voir aussi
document.canTestScene(), document.testScene()

document.canTestScene()
Disponibilit Flash MX 2004. Utilisation
document.canTestScene()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si vous pouvez utiliser la mthode document.testScene(), false dans le cas contraire. Description Mthode qui dtermine s'il est possible dutiliser la mthode document.testScene(). Exemple Lexemple suivant vrifie d'abord si fl.getDocumentDOM().testScene() est utilisable. Si c'est le cas, la mthode est ensuite appele.
if(fl.getDocumentDOM().canTestScene()){ fl.getDocumentDOM().testScene(); }

Voir aussi
document.canTestMovie(), document.testMovie()

EXTENSION DE FLASH CS4 PROFESSIONAL 84

Objet Document

document.changeFilterOrder()
Disponibilit Flash 8. Utilisation
document.changeFilterOrder(oldIndex, newIndex)

Paramtres oldIndex Nombre entier reprsentant la position dindex (en base 0) du filtre dplacer au sein de la liste Filtres.
newIndex Nombre entier reprsentant la nouvelle position d'index du filtre dans la liste.

Valeur renvoye Aucune. Description Mthode qui modifie la position d'index du filtre dans la liste Filtres. Tout filtre qui suit ou prcde newIndex est dcal en consquence vers le haut ou vers le bas. Par exemple, avec les filtres indiqus ci-dessous, aprs la commande fl.getDocumentDOM().changeFilterOrder(3, 0), les filtres sont rorganiss comme suit :
Avant
blurFilterdropShadowFilterglowFiltergradien tBevelFilter

Aprs
gradientBevelFilterblurFilterdropShadowFilterglo wFilter

Si vous appelez ensuite la commande fl.getDocumentDOM().changeFilterOrder(0, 2), les filtres sont rorganiss comme suit :
Avant
gradientBevelFilterblurFilterdropShadowFilt erglowFilter

Aprs
blurFilterdropShadowFiltergradientBevelFilterglo wFilter

Exemple Lexemple suivant dplace le Filtre actuellement en seconde position dans la liste Filtres et le fait passer en premire position :
fl.getDocumentDOM().changeFilterOrder(1,0);

Voir aussi
document.addFilter(), document.disableFilter(), document.enableFilter(), document.getFilters(), document.removeFilter(), Objet Filter

document.clipCopy()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 85

Objet Document

Utilisation
document.clipCopy()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui copie la slection actuelle du document dans le Presse-papiers. Pour copier une chane dans le Presse-papiers, utilisez fl.clipCopyString(). Exemple L'exemple suivant copie la slection actuelle du document dans le Presse-papiers :
fl.getDocumentDOM().clipCopy();

Voir aussi
document.clipCut(), document.clipPaste()

document.clipCut()
Disponibilit Flash MX 2004. Utilisation
document.clipCut()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui coupe la slection actuelle du document et la place dans le Presse-papiers. Exemple L'exemple suivant coupe la slection actuelle du document et la place dans le Presse-papiers :
fl.getDocumentDOM().clipCut();

Voir aussi
document.clipCopy(), document.clipPaste(), fl.clipCopyString()

EXTENSION DE FLASH CS4 PROFESSIONAL 86

Objet Document

document.clipPaste()
Disponibilit Flash MX 2004. Utilisation
document.clipPaste([bInPlace])

Paramtres bInPlace Valeur boolenne. Si elle est true, la mthode effectue une opration de Coller en place. La valeur par dfaut est false. La mthode effectue dans ce cas une opration Coller dans le centre du document. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui colle le contenu du Presse-papiers dans le document. Exemple L'exemple suivant colle le contenu du Presse-papiers au centre du document :
fl.getDocumentDOM().clipPaste();

L'exemple suivant colle le contenu du Presse-papiers sa place dans le document actif :

fl.getDocumentDOM().clipPaste(true);

Voir aussi
document.clipCopy(), document.clipCut(), fl.clipCopyString()

document.close()
Disponibilit Flash MX 2004. Utilisation
document.close([bPromptToSaveChanges])

Paramtres
bPromptToSaveChanges Valeur boolenne. Si elle est true, la mthode affiche une bote de dialogue pour inviter

lutilisateur enregistrer les modifications du document. Si bPromptToSaveChanges est dfini sur false, l'utilisateur n'est pas invit enregistrer les ventuelles modifications. La valeur par dfaut est true. Ce paramtre est facultatif. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 87

Objet Document

Description Mthode qui ferme le document spcifi. Exemple L'exemple suivant ferme le document actif et affiche une bote de dialogue pour inviter l'utilisateur enregistrer les modifications :
fl.getDocumentDOM().close();

L'exemple suivant ferme le document sans enregistrer les modifications :

fl.getDocumentDOM().close(false);

document.convertLinesToFills()
Disponibilit Flash MX 2004. Utilisation
document.convertLinesToFills()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui convertit des lignes en remplissages pour les objets slectionns. Exemple L'exemple suivant convertit en remplissages les lignes slectionnes :
fl.getDocumentDOM().convertLinesToFills();

document.convertToSymbol()
Disponibilit Flash MX 2004. Utilisation
document.convertToSymbol(type, name, registrationPoint)

Paramtres type Chane spcifiant le type de symbole crer. Les valeurs possibles sont "button" (bouton), "movie clip" (clip) et "graphic".

EXTENSION DE FLASH CS4 PROFESSIONAL 88

Objet Document

name Chane spcifiant le nom du nouveau symbole. Ce nom doit tre unique. Il est possible de transmettre une chane

vide. La mthode cre alors un nom de symbole unique.

registration point Spcifie le point dalignement, qui reprsente les coordonnes 0,0 du symbole. Les valeurs

possibles sont : "top left" (haut gauche), "top center" (haut centre), "top right" (haut droite), "center left" (centre gauche), "center" (centre), "center right" (centre droite), "bottom left" (bas gauche), "bottom center" (bas centre) et "bottom right" (bas droite). Valeur renvoye Un objet pour le nouveau symbole, ou null sil est impossible de crer le symbole. Description Mthode qui convertit le ou les lments slectionns dans la scne en un nouveau symbole. Pour plus d'informations sur la dfinition des liaisons et des proprits des actifs partags pour un symbole, consultez la section Objet Item. Exemple Les exemples suivants crent un symbole de clip avec le nom spcifi, un symbole de bouton avec le nom spcifi, et un symbole de clip avec un nom par dfaut :
newMc = fl.getDocumentDOM().convertToSymbol("movie clip", "mcSymbolName", "top left"); newButton = fl.getDocumentDOM().convertToSymbol("button", "btnSymbolName", "bottom right"); newClipWithDefaultName = fl.getDocumentDOM().convertToSymbol("movie clip", "", "top left");

document.crop()
Disponibilit Flash 8. Utilisation
document.crop()

Paramtres Aucun. Valeur renvoye Valeur boolenne : true en cas de russite, false sinon. Description Mthode qui, sur la base de lobjet de dessin slectionn le plus lev, recadre tous les objets de dessin de niveau infrieur. La mthode renvoie false s'il nexiste pas dobjets de dessin slectionns, ou si lun des lments slectionns n'est pas un objet de dessin. Exemple L'exemple suivant recadre les objets actuellement slectionns :
fl.getDocumentDOM().crop();

EXTENSION DE FLASH CS4 PROFESSIONAL 89

Objet Document

Voir aussi
document.deleteEnvelope(), document.intersect(), document.punch(), document.union(), shape.isDrawingObject

document.currentPublishProfile
Disponibilit Flash MX 2004. Utilisation
document.currentPublishProfile

Description Proprit ; chane spcifiant le nom du profil de publication actif pour le document spcifi. Exemple Lexemple suivant ajoute un nouveau profil de publication avec le nom par dfaut, puis affiche le nom du profil dans le panneau Sortie :
fl.getDocumentDOM().addNewPublishProfile(); fl.outputPanel.trace(fl.getDocumentDOM().currentPublishProfile);

L'exemple suivant remplace le profil slectionn par le profil par dfaut ("Default") :
fl.getDocumentDOM().currentPublishProfile = "Default";

document.currentTimeline
Disponibilit Flash MX 2004. Utilisation
document.currentTimeline

Description Proprit ; nombre entier spcifiant lindex du scnario actif. Il est possible de dfinir le scnario actif en changeant la valeur de cette proprit ; leffet est pratiquement identique un appel de document.editScene(). La seule diffrence rside dans le fait quaucun message derreur nest affich si lindex du scnario nest pas valide. La proprit nest pas modifie, ce qui provoque un chec silencieux. Exemple L'exemple suivant affiche l'index du scnario actif :
var myCurrentTL = fl.getDocumentDOM().currentTimeline; fl.trace("The index of the current timeline is: "+ myCurrentTL);

L'exemple suivant change le scnario actif en remplaant le scnario principal par une squence nomme "myScene".

EXTENSION DE FLASH CS4 PROFESSIONAL 90

Objet Document

var i = 0; var curTimelines = fl.getDocumentDOM().timelines; while(i < fl.getDocumentDOM().timelines.length){ if(curTimelines[i].name == "myScene"){ fl.getDocumentDOM().currentTimeline = i; } ++i; }

Voir aussi
document.getTimeline()

document.deleteEnvelope()
Disponibilit Flash 8. Utilisation
document.deleteEnvelope()

Paramtres Aucun. Valeur renvoye Valeur boolenne : true en cas de russite, false sinon. Description Mthode qui supprime lenveloppe (cadre contenant un ou plusieurs objets) de lobjet slectionn. Exemple L'exemple suivant supprime lenveloppe des objets slectionns :
fl.getDocumentDOM().deleteEnvelope();

Voir aussi
document.crop(), document.intersect(), document.punch(), document.union(), shape.isDrawingObject

document.deletePublishProfile()
Disponibilit Flash MX 2004. Utilisation
document.deletePublishProfile()

EXTENSION DE FLASH CS4 PROFESSIONAL 91

Objet Document

Paramtres Aucun. Valeur renvoye Nombre entier qui reprsente lindex du nouveau profil actif. Si aucun nouveau profil nest disponible, la mthode conserve le profil actuel et renvoie son index. Description Mthode qui supprime le profil actif, sil existe plusieurs profils. Il doit rester au moins un profil. Exemple L'exemple suivant supprime le profil actif sil existe plusieurs profils et affiche lindex du nouveau profil actif :
alert(fl.getDocumentDOM().deletePublishProfile());

Voir aussi
document.addNewPublishProfile()

document.deleteScene()
Disponibilit Flash MX 2004. Utilisation
document.deleteScene()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si la squence a bien t supprime, false dans le cas contraire. Description Mthode qui supprime la squence actuelle (Objet Timeline) et, si cette squence ntait pas la dernire, dfinit la prochaine comme objet Timeline actif. Si la squence supprime tait la dernire, le premier objet est dfini comme objet Timeline actif. Sil nexiste quun seul objet Timeline (squence), la mthode renvoie la valeur false. Exemple En supposant quil existe trois squences (Scene0, Scene1 et Scene2) dans le document actif, l'exemple suivant active la squence Scene2, puis la supprime :
fl.getDocumentDOM().editScene(2); var success = fl.getDocumentDOM().deleteScene();

EXTENSION DE FLASH CS4 PROFESSIONAL 92

Objet Document

document.deleteSelection()
Disponibilit Flash MX 2004. Utilisation
document.deleteSelection()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui supprime la slection actuelle sur la scne. Un message derreur est affich sil nexiste pas de slection. Exemple L'exemple suivant supprime la slection du document :
fl.getDocumentDOM().deleteSelection();

document.description
Disponibilit Flash MX 2004. Utilisation
document.description

Description Proprit ; chane quivalente au champ Description du panneau Accessibilit. Cette description est lue par les logiciels de lecture vocale. Exemple Lexemple suivant dfinit la description du document :
fl.getDocumentDOM().description= "This is the main movie";

Lexemple suivant rcupre la description du document et laffiche dans le panneau Sortie :

fl.trace(fl.getDocumentDOM().description);

EXTENSION DE FLASH CS4 PROFESSIONAL 93

Objet Document

document.disableAllFilters()
Disponibilit Flash 8. Utilisation
document.disableAllFilters()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui dsactive tous les filtres des objets slectionns. Exemple L'exemple suivant dsactive tous les filtres des objets slectionns :
fl.getDocumentDOM().disableAllFilters();

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableFilter(), document.disableOtherFilters(), document.enableAllFilters(), document.getFilters(), document.removeAllFilters(), Objet Filter

document.disableFilter()
Disponibilit Flash 8. Utilisation
document.disableFilter(filterIndex)

Paramtres
filterIndex Nombre entier reprsentant lindex (en base 0) du filtre dans la liste Filtres.

Valeur renvoye Aucune. Description Mthode qui dans la liste Filtres, dsactive le filtre spcifi.

EXTENSION DE FLASH CS4 PROFESSIONAL 94

Objet Document

Exemple L'exemple suivant dsactive des objets slectionns les premier et troisime filtres (valeur d'index 0 et 2) de la liste Filtres.
fl.getDocumentDOM().disableFilter(0); fl.getDocumentDOM().disableFilter(2);

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableAllFilters(), document.disableOtherFilters(), document.enableFilter(), document.getFilters(), document.removeFilter(), Objet Filter

document.disableOtherFilters()
Disponibilit Flash 8. Utilisation
document.disableOtherFilters(enabledFilterIndex)

Paramtres
enabledFilterIndex Nombre entier reprsentant lindex (en base 0) du filtre qui doit rester activ aprs que tous les

autres filtres ont t dsactivs. Valeur renvoye Aucune. Description Mthode qui, dans la liste Filtres, dsactive tous les filtres lexception de celui qui se trouve la position spcifie. Exemple L'exemple suivant dsactive tous les filtres, lexception du deuxime filtre de la liste (index 1).
fl.getDocumentDom().disableOtherFilters(1);

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableAllFilters(), document.disableFilter(), document.enableFilter(), document.getFilters(), document.removeFilter(), Objet Filter

document.distribute()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 95

Objet Document

Utilisation
document.distribute(distributemode [, bUseDocumentBounds])

Paramtres
distributemode Chane spcifiant o rpartir les objets slectionns. Les valeurs possibles sont "left edge", "horizontal center", "right edge", "top edge", "vertical center" et "bottom edge". bUseDocumentBounds Valeur boolenne. Si elle est true, la mthode rpartit les objets slectionns dans les limites

du document. Sinon, la mthode utilise les limites des objets slectionns. La valeur par dfaut est false. Valeur renvoye Aucune. Description Mthode qui rpartit la slection. Exemple L'exemple suivant rpartit les objets slectionns sur leurs bords suprieurs :
fl.getDocumentDOM().distribute("top edge");

L'exemple suivant rpartit les objets slectionns sur leurs bords suprieurs et dfinit explicitement le paramtre bUseDcoumentBounds :
fl.getDocumentDOM().distribute("top edge", false);

L'exemple suivant rpartit les objets slectionns sur leurs bords suprieurs, en les alignant sur les limites du document :
fl.getDocumentDOM().distribute("top edge", true);

Voir aussi
document.getAlignToDocument(), document.setAlignToDocument()

document.distributeToLayers()
Disponibilit Flash MX 2004. Utilisation
document.distributeToLayers()

Paramtres Aucun. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 96

Objet Document

Description Mthode qui effectue sur la slection actuelle une opration de rpartition vers les calques ; cette mthode est lquivalent de loption de menu Rpartir vers les calques. Un message derreur est affich sil nexiste pas de slection. Exemple L'exemple suivant rpartit la slection dans les calques :
fl.getDocumentDOM().distributeToLayers();

document.docClass
Disponibilit Flash CS3 Professional. Utilisation
document.docClass

Description Proprit ; chane spcifiant la classe ActionScript 3.0 de niveau suprieur qui sera associe au document. Si le document n'est pas configur pour utiliser ActionScript 3.0, cette proprit est ignore. Exemple L'exemple suivant spcifie que la classe ActionScript 3.0 associe au document est com.mycompany.ManagerClass et qu'elle est dfinie dans com/mycompany/ManagerClass.as :
var myDocument = fl.getDocumentDOM(); // set the property myDocument.docClass = "com.mycompany.ManagerClass"; // get the property fl.outputPanel.trace("document.docClass has been set to " + myDocument.docClass);

Voir aussi
item.linkageBaseClass

document.documentHasData()
Disponibilit Flash MX 2004. Utilisation
document.documentHasData(name)

Paramtres name Chane spcifiant le nom des donnes vrifier.

EXTENSION DE FLASH CS4 PROFESSIONAL 97

Objet Document

Valeur renvoye Valeur boolenne, true si le document comporte des donnes persistantes, false dans le cas contraire. Description Mthode qui recherche dans le document des donnes persistantes ayant le nom spcifi. Exemple L'exemple suivant recherche dans le document des donnes persistantes ayant le nom "myData" :
var hasData = fl.getDocumentDOM().documentHasData("myData");

Voir aussi
document.addDataToDocument(), document.getDataFromDocument(), document.removeDataFromDocument()

document.duplicatePublishProfile()
Disponibilit Flash MX 2004. Utilisation
document.duplicatePublishProfile([profileName])

Paramtres
profileName Chane spcifiant le nom unique du profil dupliqu. Si vous ne spcifiez pas de nom, le nom par dfaut est utilis. Ce paramtre est facultatif.

Valeur renvoye Nombre entier qui est lindex du nouveau profil dans la liste des profils. Renvoie -1 sil est impossible de dupliquer le profil. Description Mthode qui duplique le profil actuellement actif et donne le focus ce duplicata. Exemple Lexemple suivant duplique le profil actuellement actif et affiche lindex du nouveau profil dans le panneau Sortie :
fl.trace(fl.getDocumentDOM().duplicatePublishProfile("dup profile"));

document.duplicateScene()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 98

Objet Document

Utilisation
document.duplicateScene()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si la squence a bien t duplique, false dans le cas contraire. Description Mthode qui cre une copie de la squence actuellement slectionne, en donnant cette nouvelle squence un nom unique et en en faisant la squence active. Exemple L'exemple suivant duplique la seconde squence du document actif :
fl.getDocumentDOM().editScene(1); //Set the middle scene to current scene. var success = fl.getDocumentDOM().duplicateScene();

document.duplicateSelection()
Disponibilit Flash MX 2004. Utilisation
document.duplicateSelection()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui duplique la slection sur la scne. Exemple L'exemple suivant duplique la slection. Cette opration est semblable un appui sur la touche Alt suivi dun clic et dun glisser-dposer de lobjet :
fl.getDocumentDOM().duplicateSelection();

document.editScene()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 99

Objet Document

Utilisation
document.editScene(index)

Paramtres index Nombre entier en base zro indiquant la squence modifier. Valeur renvoye Aucune. Description Mthode qui slectionne la squence spcifie pour modification. Exemple En supposant quil existe trois squences (Scene0, Scene1 et Scene2) dans le document actif, l'exemple suivant active la squence Scene2, puis la supprime :
fl.getDocumentDOM().editScene(2); fl.getDocumentDOM().deleteScene();

document.enableAllFilters()
Disponibilit Flash 8. Utilisation
document.enableAllFilters()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui active tous les filtres de la liste Filtres pour les objets slectionns. Exemple L'exemple suivant active tous les filtres de la liste Filtres pour les objets slectionns :
fl.getDocumentDOM().enableAllFilters();

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableAllFilters(), document.enableFilter(), document.getFilters(), document.removeAllFilters(), Objet Filter

EXTENSION DE FLASH CS4 PROFESSIONAL 100

Objet Document

document.enableFilter()
Disponibilit Flash 8. Utilisation
document.enableFilter(filterIndex)

Paramtres
filterIndex Nombre entier indiquant lindex (en base 0) dans la liste Filtres du filtre activer.

Valeur renvoye Aucune. Description Mthode qui active le filtre spcifi pour le ou les objets slectionns. Exemple Lexemple suivant active le second filtre des objets slectionns :
fl.getDocumentDOM().enableFilter(1);

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableFilter(), document.enableAllFilters(), document.getFilters(), document.removeFilter(), Objet Filter

document.enterEditMode()
Disponibilit Flash MX 2004. Utilisation
document.enterEditMode([editMode])

Paramtres editMode Chane qui spcifie le mode de modification. Les valeurs gres sont "inPlace" ou "newWindow". Si aucun paramtre nest spcifi, le mode par dfaut est celui de modification de symbole. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui bascule lenvironnement de programmation dans le mode de modification spcifi par le paramtre. Si aucun paramtre nest spcifi, le mode par dfaut est Modification de symbole. Le rsultat est semblable un clic droit sur le symbole pour afficher le menu contextuel, puis au choix de loption Modifier.

EXTENSION DE FLASH CS4 PROFESSIONAL 101

Objet Document

Exemple L'exemple suivant met Flash en mode Modification en place pour le symbole slectionn :
fl.getDocumentDOM().enterEditMode('inPlace');

L'exemple suivant met Flash en mode Modifier dans une nouvelle fentre pour le symbole slectionn :
fl.getDocumentDOM().enterEditMode('newWindow');

Voir aussi
document.exitEditMode()

document.exitEditMode()
Disponibilit Flash MX 2004. Utilisation
document.exitEditMode()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui quitte le mode Modification de symbole et renvoie le focus au niveau suprieur suivant. Par exemple, si vous modifiez un symbole insr dans un autre symbole, cette mthode remonte dun niveau partir du symbole en cours de modification, soit au niveau du symbole parent. Exemple L'exemple suivant quitte le mode Modification de symbole :
fl.getDocumentDOM().exitEditMode();

Voir aussi
document.enterEditMode()

document.exportPNG()
Disponibilit Flash 8. Utilisation
document.exportPNG([fileURI [, bCurrentPNGSettings [, bCurrentFrame]]])

EXTENSION DE FLASH CS4 PROFESSIONAL 102

Objet Document

Paramtres fileURI Chane de type fichier:///URI qui spcifie le nom du fichier exporter. Si fileURI est une chane vide ou non spcifie, Flash affiche la bote de dialogue Exporter l'animation.
bCurrentPNGSettings Valeur boolenne indiquant s'il faut utiliser les paramtres de publication PNG actuels (true) ou bien afficher la bote de dialogue Exporter (false). Ce paramtre est facultatif. La valeur par dfaut est false. bCurrentFrame Valeur boolenne indiquant s'il faut exporter uniquement l'image actuelle (true) ou bien exporter

toutes les images, chacune dans un fichier PNG distinct (false). Ce paramtre est facultatif. La valeur par dfaut est false. Valeur renvoye Valeur boolenne, true si le fichier a bien t export sous forme de fichier PNG, false dans le cas contraire. Description Mthode qui exporte le document sous forme d'un ou plusieurs fichiers PNG. Si fileURI est spcifi et que le fichier existe dj, il est cras sans avertissement. Exemple L'exemple suivant exporte l'image actuelle du document actif vers myFile.png, en utilisant les paramtres de publication PNG actuels :
fl.getDocumentDOM().exportPNG("file:///C|/myProject/myFile.png", true, true);

document.exportPublishProfile()
Disponibilit Flash MX 2004. Utilisation
document.exportPublishProfile(fileURI)

Paramtres fileURI Chane de type fichier:///URI qui spcifie le chemin daccs du fichier XML dans lequel le profil est export. Valeur renvoye Aucune. Description Mthode qui exporte le profil actif dans un fichier XML. Exemple L'exemple suivant exporte le profil actif dans le fichier profile.xml, qui rside dans le dossier /Documents and Settings/utilisateur/Desktop sur le lecteur C :
fl.getDocumentDOM().exportPublishProfile('file:///C|/Documents and Settings/username/Desktop/profile.xml');

EXTENSION DE FLASH CS4 PROFESSIONAL 103

Objet Document

Voir aussi
document.exportPublishProfileString(), document.importPublishProfile()

document.exportPublishProfileString()
Disponibilit Flash CS4 Professional. Utilisation
document.exportPublishProfileString( [profileName] )

Paramtres
profileName Chane qui spcifie le nom du profil exporter dans une chane XML. Ce paramtre est facultatif.

Valeur renvoye Chane XML. Description Mthode qui renvoie une chane spcifiant, au format XML, le profil spcifi. Si vous ne transmettez pas de valeur pour profileName, le profil actuel est export. Exemple L'exemple suivant stocke une chane XML reprsentant le profil actuel dans une variable nomme profileXML, puis l'affiche dans le panneau Sortie :
var profileXML=fl.getDocumentDOM().exportPublishProfileString(); fl.trace(profileXML);

Voir aussi
document.exportPublishProfile(), document.importPublishProfileString()

document.exportSWF()
Disponibilit Flash MX 2004. Utilisation
document.exportSWF([fileURI [, bCurrentSettings]])

Paramtres fileURI Chane de type fichier:///URI qui spcifie le nom du fichier export. Si fileURI est vide ou non spcifi, Flash affiche la bote de dialogue Exporter l'animation. Ce paramtre est facultatif.
bCurrentSettings Valeur boolenne. Si elle est true, Flash utilise les paramtres de publication en SWF actuels. Sinon, Flash affiche la bote de dialogue Exporter au format Flash Player. La valeur par dfaut est false. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 104

Objet Document

Valeur renvoye Aucune. Description Mthode qui exporte le document au format Flash SWF. Exemple L'exemple suivant exporte le document lemplacement spcifi avec les paramtres de publication actuels :
fl.getDocumentDOM().exportSWF("file:///C|/Documents and Settings/joe_user/Desktop/qwerty.swf");

L'exemple suivant affiche les botes de dialogue Exporter l'animation, puis Exporter au format Flash Player, et exporte le document selon les paramtres spcifis :
fl.getDocumentDOM().exportSWF("", true);

L'exemple suivant affiche la bote de dialogue Exporter l'animation, puis exporte le document selon les paramtres spcifis :
fl.getDocumentDOM().exportSWF();

document.externalLibraryPath
Disponibilit Flash CS4 Professional. Utilisation
document.externalLibraryPath

Description Proprit ; chane qui contient la liste des lments du chemin de bibliothque externe ActionScript 3.0 du document, spcifiant l'emplacement des fichiers SWC utiliss au moment de l'excution en tant que bibliothques partages. Les lments de la chane sont dlimits par des points-virgules. Dans l'outil de programmation, les lments sont spcifis en slectionnant Fichier > Paramtres de publication, puis en cliquant sur le bouton Paramtres de Script ActionScript 3.0 dans l'onglet Flash. Exemple L'exemple suivant dfinit le chemin de bibliothque externe du document sur "." et "../mySWCLibrary" :
var myDocument = fl.getDocumentDOM(); myDocument.externalLibraryPath = ".;../mySWCLibrary"; fl.trace(myDocument.externalLibraryPath);

Voir aussi
document.libraryPath, document.sourcePath,fl.externalLibraryPath

EXTENSION DE FLASH CS4 PROFESSIONAL 105

Objet Document

document.forceSimple
Disponibilit Flash MX 2004. Utilisation
document.forceSimple

Description Proprit ; valeur boolenne indiquant si les enfants de lobjet spcifi sont accessibles. Cette proprit est quivalente linverse du paramtre Rendre les objets enfant accessibles du panneau Accessibilit. Ainsi, si forceSimple est true, son effet est similaire la dsactivation de loption Rendre les objets enfant accessibles. Si forceSimple est false, son effet est similaire lactivation de loption Rendre les objets enfant accessibles. Exemple L'exemple suivant donne la variable areChildrenAccessible la valeur de la proprit forceSimple ; une valeur false signifie que les enfants sont accessibles :
var areChildrenAccessible = fl.getDocumentDOM().forceSimple;

L'exemple suivant modifie la proprit forceSimple pour rendre les enfants du document accessibles :
fl.getDocumentDOM().forceSimple = false;

document.frameRate
Disponibilit Flash MX 2004. Utilisation
document.frameRate

Description Proprit ; nombre en virgule flottante indiquant le nombre dimages affiches par seconde pendant la lecture du fichier SWF ; la valeur par dfaut est 12. Cette proprit quivaut dfinir la cadence dans la bote de dialogue Proprits du document (Modification > Document) dans le fichier FLA. Exemple L'exemple suivant dfinit la cadence de 25,5 images par seconde :
fl.getDocumentDOM().frameRate = 25.5;

document.getAlignToDocument()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 106

Objet Document

Utilisation
document.getAlignToDocument()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si lalignement des objets par rapport la scne est dfini dans les prfrences, false dans le cas contraire. Description Mthode qui a le mme effet que la rcupration de la valeur du bouton Sur la scne dans le panneau Aligner. La prfrence ainsi rcupre peut tre utilise sur ce document pour les mthodes document.align(), document.distribute(), document.match() et document.space(). Exemple L'exemple suivant rcupre la valeur du bouton Sur la scne dans le panneau Aligner. Si la valeur renvoye est true, le bouton Sur la scne est activ, sinon, il est dsactiv.
var isAlignToDoc = fl.getDocumentDOM().getAlignToDocument(); fl.getDocumentDOM().align("left", isAlignToDoc);

Voir aussi
document.setAlignToDocument()

document.getBlendMode()
Disponibilit Flash 8. Utilisation
document.getBlendMode()

Paramtres Aucun. Valeur renvoye Chane indiquant le mode de fondu pour les objets slectionns. Si plusieurs objets aux modes de fondu distincts sont slectionns, la chane reflte le mode de fondu de l'objet dont la profondeur est la plus leve. Remarque : la valeur renvoye est imprvisible si certains objets slectionns ne grent pas les modes de fondu ou si leur mode de fondu est dfini sur la valeur "normal". Description Mthode qui renvoie une chane indiquant le mode de fondu pour les objets slectionns.

EXTENSION DE FLASH CS4 PROFESSIONAL 107

Objet Document

Exemple Lexemple suivant affiche le nom du mode de fondu dans le panneau Sortie :
fl.trace(fl.getDocumentDom().getBlendMode());

document.getCustomFill()
Disponibilit Flash MX 2004. Utilisation
document.getCustomFill([objectToFill])

Paramtres
objectToFill Chane indiquant lemplacement de l'objet Fill (remplissage). Les valeurs suivantes sont possibles :

"toolbar" renvoie lobjet Fill (remplissage) du panneau Outils et de l'inspecteur Proprits. "selection" renvoie lobjet Fill (remplissage) de la slection.

Si vous omettez ce paramtre, la valeur par dfaut est "selection". S'il n'y a aucune slection, la mthode renvoie undefined. Ce paramtre est facultatif. Valeur renvoye Objet Fill spcifi par le paramtre objectToFill, en cas de russite, undefined dans le cas contraire. Description Mthode qui rcupre lobjet Fill (remplissage) de la forme slectionne ou, selon le paramtre, du panneau Outils et de l'inspecteur Proprits. Exemple L'exemple suivant rcupre lobjet Fill (remplissage) de la slection, puis change la couleur de la slection en blanc :
var fill = fl.getDocumentDOM().getCustomFill(); fill.color = '#FFFFFF'; fill.style = "solid"; fl.getDocumentDOM().setCustomFill(fill);

L'exemple suivant renvoie lobjet de remplissage du panneau Outils et de l'inspecteur Proprits, puis active un dgrad linaire dans le nuancier :
var fill = fl.getDocumentDOM().getCustomFill("toolbar"); fill.style = "linearGradient"; fill.colorArray = [ 0x00ff00, 0xff0000, 0x0000ff ]; fill.posArray = [0, 100, 200]; fl.getDocumentDOM().setCustomFill( fill );

Voir aussi
document.setCustomFill()

EXTENSION DE FLASH CS4 PROFESSIONAL 108

Objet Document

document.getCustomStroke()
Disponibilit Flash MX 2004. Utilisation
document.getCustomStroke([locationOfStroke])

Paramtres
locationOfStroke Chane indiquant lemplacement de l'objet trait. Les valeurs suivantes sont possibles :

"toolbar" renvoie lobjet Stroke du panneau Outils et de l'inspecteur Proprits, si elle est dfinie. "selection" renvoie lobjet Stroke de la slection, si elle est dfinie.

Si vous omettez ce paramtre, la valeur par dfaut est "selection". S'il n'y a aucune slection, la mthode renvoie undefined. Ce paramtre est facultatif. Valeur renvoye Objet Stroke spcifi par le paramtre locationOfStroke en cas de russite, undefined dans le cas contraire. Description Renvoie lobjet Stroke de la forme slectionne ou, selon le paramtre, du panneau Outils et de l'inspecteur Proprits. Exemple L'exemple suivant renvoie les paramtres de trait actuels de la slection et dfinit lpaisseur de trait sur 2 :
var stroke = fl.getDocumentDOM().getCustomStroke("selection"); stroke.thickness = 2; fl.getDocumentDOM().setCustomStroke(stroke);

L'exemple suivant renvoie les paramtres de trait actuels du panneau Outils et de l'inspecteur Proprits, puis change la couleur de trait en rouge :
var stroke = fl.getDocumentDOM().getCustomStroke("toolbar"); stroke.color = "#FF0000"; fl.getDocumentDOM().setCustomStroke(stroke);

Voir aussi
document.setCustomStroke()

document.getDataFromDocument()
Disponibilit Flash MX 2004. Utilisation
document.getDataFromDocument(name)

EXTENSION DE FLASH CS4 PROFESSIONAL 109

Objet Document

Paramtres name Chane spcifiant le nom des donnes renvoyer. Valeur renvoye Les donnes spcifies. Description Mthode qui rcupre la valeur des donnes spcifies. Le type renvoy dpend du type des donnes stockes. Exemple L'exemple suivant ajoute une valeur entire de 12 au document actif et appelle cette mthode pour afficher la valeur dans le panneau Sortie :
fl.getDocumentDOM().addDataToDocument("myData", "integer", 12); fl.trace(fl.getDocumentDOM().getDataFromDocument("myData"));

Voir aussi
document.addDataToDocument(), document.documentHasData(), document.removeDataFromDocument()

document.getElementProperty()
Disponibilit Flash MX 2004. Utilisation
document.getElementProperty(propertyName)

Paramtres
propertyName Chane spcifiant le nom de la proprit Element dont la valeur est recherche.

Valeur renvoye La valeur de la proprit spcifie. Renvoie null si la proprit est dans un tat indtermin, par exemple lorsque plusieurs lments possdant des valeurs diffrentes pour cette proprit sont slectionns. Renvoie undefined si la proprit nest pas une proprit valide de llment slectionn. Description Mthode qui rcupre la proprit Element spcifie pour la slection. La liste des valeurs possibles est indique dans le tableau Rsum des proprits de l'Objet Element. Exemple L'exemple suivant rcupre le nom (name) de la proprit Element de la slection :
// elementName = the instance name of the selected object. var elementName = fl.getDocumentDOM().getElementProperty("name");

Voir aussi
document.setElementProperty()

EXTENSION DE FLASH CS4 PROFESSIONAL 110

Objet Document

document.getElementTextAttr()
Disponibilit Flash MX 2004. Utilisation
document.getElementTextAttr(attrName [, startIndex [, endIndex]])

Paramtres attrName Chane spcifiant le nom de la proprit TextAttrs renvoyer. La liste des noms de proprit et des valeurs possibles est indique dans le tableau Rsum des proprits de l'Objet TextAttrs.
startIndex Nombre entier spcifiant lindex du premier caractre, 0 (zro) tant lindex de la premire position. Ce

paramtre est facultatif.

endIndex Nombre entier qui spcifie lindex du dernier caractre. Ce paramtre est facultatif.

Valeur renvoye Si un champ de texte est slectionn, la proprit est renvoye si une seule valeur est utilise dans tout le texte. Renvoie undefined si le champ de texte comporte plusieurs valeurs pour cette proprit. Si plusieurs champs de texte sont slectionns, et si toutes les valeurs dalignement de texte sont gales, la mthode renvoie cette valeur. Si plusieurs champs de texte sont slectionns, mais que toutes les valeurs dalignement de texte ne sont pas gales, la mthode renvoie undefined. Si les arguments facultatifs ne sont pas transmis, ces rgles sappliquent la plage de texte slectionne, ou tout le champ de texte si le texte nest pas en cours de modification. Si seul le paramtre startIndex est transmis, la proprit du caractre situ droite de lindex est renvoye, sous rserve que tous les objets Text slectionns aient une valeur identique. Si startIndex et endIndex sont transmis, la valeur renvoye correspond toute la plage de caractres comprise entre startIndex et le caractre prcdant endIndex. Description Mthode qui rcupre la proprit TextAttrs spcifie pour les objets Text slectionns. Les objets slectionns qui ne sont pas des champs de texte sont ignors. La liste des noms de proprit et des valeurs possibles est indique dans le tableau Rsum des proprits de l'Objet TextAttrs. Voir aussi document.setElementTextAttr(). Exemple L'exemple suivant rcupre la taille des champs de texte slectionns :
fl.getDocumentDOM().getElementTextAttr("size");

L'exemple suivant rcupre la couleur du caractre dindice 3 des champs de texte slectionns :
fl.getDocumentDOM().getElementTextAttr("fillColor", 3);

L'exemple suivant rcupre le nom de la police de caractres du texte partir de l'index 2 et jusqu l'index 10 (non inclus) des champs de texte slectionns :
fl.getDocumentDOM().getElementTextAttr("face", 2, 10);

EXTENSION DE FLASH CS4 PROFESSIONAL 111

Objet Document

document.getFilters()
Disponibilit Flash 8. Utilisation
document.getFilters()

Paramtres Aucun. Valeur renvoye Tableau contenant la liste des filtres appliqus aux objets actuellement slectionns. Description Mthode qui renvoie un tableau contenant la liste des filtres appliqus aux objets actuellement slectionns. Si plusieurs objets sont slectionns et que leurs filtres ne sont pas identiques, cette mthode renvoie la liste des filtres appliqus au premier objet slectionn. Exemple Voir document.setFilters(). Voir aussi
document.addFilter(), document.changeFilterOrder(), document.setFilters(), Objet Filter

document.getMetadata()
Disponibilit Flash 8. Utilisation
document.getMetadata()

Paramtres Aucun. Valeur renvoye Chane contenant les mtadonnes XML associes au document, ou une chane vide sil nexiste pas de mtadonnes. Description Mthode qui renvoie une chane contenant les mtadonnes XML associes au document, ou une chane vide sil nexiste pas de mtadonnes. Exemple L'exemple suivant affiche dans le panneau Sortie les mtadonnes XML du document actif :

EXTENSION DE FLASH CS4 PROFESSIONAL 112

Objet Document

fl.trace("XML Metadata is :" + fl.getDocumentDOM().getMetadata());

Voir aussi
document.setMetadata()

document.getMobileSettings()
Disponibilit Flash CS3 Professional. Utilisation
document.getMobileSettings()

Paramtres Aucun. Valeur renvoye Chane reprsentant les paramtres XML pour le document. Si aucune valeur n'est spcifie, une chane vide est renvoye. Description Mthode qui renvoie les paramtres XML mobiles pour le document. Exemple L'exemple suivant affiche la chane des paramtres XML pour le document actif :
fl.trace(fl.getDocumentDOM().getMobileSettings()); //traces a string like the following"<? xml version="1.0" encoding="UTF-16" standalone="no" ?><mobileSettings> <contentType id="standalonePlayer" name="Standalone Player"/> <testDevices> <testDevice id="1170" name="Generic Phone" selected="yes"/> </testDevices> <outputMsgFiltering info="no" trace="yes" warning="yes"/> <testWindowState height="496" splitterClosed="No" splitterXPos="400" width="907"/> </mobileSettings>"

Voir aussi
document.setMobileSettings()

document.getPlayerVersion()
Disponibilit Flash CS3 Professional. Utilisation
document.getPlayerVersion()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 113

Objet Document

Valeur renvoye Chane reprsentant la version de Flash Player spcifie par l'intermdiaire de document.setPlayerVersion(). Si aucune valeur n'est dfinie, renvoie la valeur spcifie dans la bote de dialogue Paramtres de publication. Description Mthode qui renvoie une chane reprsentant la version de Flash Player cible pour le document spcifi. Pour obtenir la liste des valeurs pouvant tre renvoyes par cette mthode, consultez la mthode document.setPlayerVersion(). Pour dterminer la version d'ActionScript vise dans le fichier spcifi, utilisez document.asVersion. Exemple L'exemple suivant illustre le ciblage des versions du lecteur spcifies pour le document actif, puis la rcupration de ces valeurs :
fl.getDocumentDOM().setPlayerVersion("6"); var version = fl.getDocumentDOM().getPlayerVersion(); fl.trace(version) // displays "6" fl.getDocumentDOM().setPlayerVersion("FlashPlayer10"); var version = fl.getDocumentDOM().getPlayerVersion(); fl.trace(version) // displays ""FlashPlayer10""

Voir aussi
document.setPlayerVersion()

document.getSelectionRect()
Disponibilit Flash MX 2004. Utilisation
document.getSelectionRect()

Paramtres Aucun. Valeur renvoye Le rectangle de dlimitation de la slection actuelle, ou 0 sil nexiste pas de slection. Pour plus d'informations sur le format de la valeur renvoye, consultez la mthode document.addNewRectangle(). Description Mthode qui rcupre les coordonnes du rectangle de dlimitation de la slection. Pour une slection non rectangulaire, cest le plus petit rectangle encadrant la slection entire qui est renvoy. Le rectangle est bas sur lespace du document ou, en mode de modification, sur le point d'alignement (galement point d'origine ou point zro) du symbole en cours de modification. Exemple L'exemple suivant rcupre le rectangle de dlimitation de la slection actuelle, puis affiche ses proprits :

EXTENSION DE FLASH CS4 PROFESSIONAL 114

Objet Document

var newRect = fl.getDocumentDOM().getSelectionRect(); var outputStr = "left: " + newRect.left + " top: " + newRect.top + " right: " + newRect.right + " bottom: " + newRect.bottom; alert(outputStr);

Voir aussi
document.selection, document.setSelectionRect()

document.getTextString()
Disponibilit Flash MX 2004. Utilisation
document.getTextString([startIndex [, endIndex]])

Paramtres
startIndex Nombre entier qui spcifie lindex du premier caractre rcuprer. Ce paramtre est facultatif. endIndex Nombre entier qui spcifie lindex du dernier caractre rcuprer. Ce paramtre est facultatif.

Valeur renvoye Chane qui contient le texte slectionn. Description Mthode qui rcupre le texte slectionn. Si les paramtres facultatifs ne sont pas transmis, la slection de texte actuelle est utilise. Si le texte nest pas en cours de modification, toute la chane de texte est renvoye. Si seul le paramtre startIndex est transmis, la mthode renvoie la chane qui commence cet index et se termine la fin du champ. Si startIndex et endIndex sont transmis, la valeur renvoye correspond toute la plage de caractres comprise entre startIndex et le caractre prcdant endIndex. Si plusieurs champs de texte sont slectionns, une concatnation de toutes les chanes est renvoye. Exemple L'exemple suivant rcupre le contenu des champs de texte slectionns :
fl.getDocumentDOM().getTextString();

L'exemple suivant rcupre le contenu des champs de texte slectionns partir du caractre dindice 5 :
fl.getDocumentDOM().getTextString(5);

L'exemple suivant rcupre la chane partir du caractre dindex 2 et jusquau caractre dindex 10 non compris :
fl.getDocumentDOM().getTextString(2, 10);

Voir aussi
document.setTextString()

EXTENSION DE FLASH CS4 PROFESSIONAL 115

Objet Document

document.getTimeline()
Disponibilit Flash MX 2004. Utilisation
document.getTimeline()

Paramtres Aucun. Valeur renvoye L'objet Timeline actuel. Description Mthode qui rcupre l'Objet Timeline dans le document. Le scnario actuel peut tre la squence actuelle, le symbole en cours de modification, ou lcran actuel. Exemple L'exemple suivant rcupre lobjet Timeline et renvoie le nombre dimages du calque le plus long :
var longestLayer = fl.getDocumentDOM().getTimeline().frameCount; fl.trace("The longest layer has" + longestLayer + "frames");

L'exemple suivant passe au mode de modification en place pour le symbole slectionn sur la scne et insre une image dans le scnario du symbole.
fl.getDocumentDOM().enterEditMode("inPlace"); fl.getDocumentDOM().getTimeline().insertFrames();

Lexemple suivant rcupre lobjet Timeline et affiche son nom :

var timeline = fl.getDocumentDOM().getTimeline(); alert(timeline.name);

Voir aussi
document.currentTimeline, document.timelines, symbolItem.timeline

document.getTransformationPoint()
Disponibilit Flash MX 2004. Utilisation
document.getTransformationPoint()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 116

Objet Document

Valeur renvoye Un point (par exemple, {x:10,y:20}, sachant que x et y sont des nombres virgule flottante) qui prcise la position du point de transformation (galement point d'origine ou point zro) dans le systme de coordonnes de l'lment slectionn. Description Mthode qui rcupre lemplacement du point de transformation de la slection. Le point de transformation peut tre utilis pour des permutations, par exemple rotation et inclinaison. Remarque : les points de transformation sont dfinis par rapport diffrents emplacements, en fonction du type d'lment slectionn. Pour plus d'informations, consultez la mthode document.setTransformationPoint(). Exemple L'exemple suivant rcupre lemplacement du point de transformation de la slection. La proprit transPoint.x donne la coordonne x du point de transformation. La proprit transPoint.y donne la coordonne y du point de transformation.
var transPoint = fl.getDocumentDOM().getTransformationPoint();

Voir aussi
document.setTransformationPoint(), element.getTransformationPoint()

document.group()
Disponibilit Flash MX 2004. Utilisation
document.group()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui convertit la slection en un groupe. Exemple L'exemple suivant convertit en groupe les objets de la slection actuelle :
fl.getDocumentDOM().group();

Voir aussi
document.unGroup()

EXTENSION DE FLASH CS4 PROFESSIONAL 117

Objet Document

document.height
Disponibilit Flash MX 2004. Utilisation
document.height

Description Proprit ; nombre entier indiquant la hauteur en pixels du document (scne). Exemple Lexemple suivant dfinit la hauteur de la scne sur 400 pixels :
fl.getDocumentDOM().height = 400;

Voir aussi
document.width

document.id
Disponibilit Flash CS3 Professional. Utilisation
document.id

Description Proprit en lecture seule ; nombre entier unique (attribu automatiquement) qui identifie un document lors d'une session Flash. Utilisez cette proprit conjointement avec fl.findDocumentDOM() afin de spcifier un document particulier pour une action. Exemple L'exemple suivant affiche l'ID de document du document actif :
fl.trace("Current doc's internal ID is: " + fl.getDocumentDOM().id);

Voir aussi
fl.findDocumentDOM()

document.importFile()
Disponibilit Flash 8.

EXTENSION DE FLASH CS4 PROFESSIONAL 118

Objet Document

Utilisation
document.importFile(fileURI [, importToLibrary])

Paramtres fileURI Chane de type fichier:///URI qui spcifie le nom du fichier importer.
importToLibrary Valeur boolenne indiquant s'il faut importer le fichier uniquement dans la bibliothque du

document (true) ou bien en placer galement une copie sur la scne (false). La valeur par dfaut est false. Valeur renvoye Aucune. Description Mthode qui importe un fichier dans un document. Cette mthode a le mme effet que la commande Importer dans la bibliothque ou Importer vers la scne. Pour importer un profil de publication, utilisez document.importPublishProfile(). Exemple L'exemple suivant permet l'utilisateur de rechercher un fichier importer vers la scne :
var dom = fl.getDocumentDOM(); var URI = fl.browseForFileURL("select", "Import File"); dom.importFile(URI);

Voir aussi
document.importSWF(), fl.browseForFileURL()

document.importPublishProfile()
Disponibilit Flash MX 2004. Utilisation
document.importPublishProfile( fileURI )

Paramtres fileURI Chane de type fichier:///URI qui spcifie le chemin daccs du fichier XML dfinissant le profil importer. Valeur renvoye Nombre entier qui est lindex du profil import dans la liste des profils. Renvoie -1 sil est impossible dimporter le profil. Description Mthode qui importe un profil partir dun fichier.

EXTENSION DE FLASH CS4 PROFESSIONAL 119

Objet Document

Exemple L'exemple suivant importe le profil contenu dans le fichier profile.xml et affiche son index dans la liste des profils :
alert(fl.getDocumentDOM().importPublishProfile('file:///C|/Documents and Settings/janeUser/Desktop/profile.xml'));

document.importPublishProfileString()
Disponibilit Flash CS4 Professional. Utilisation
document.importPublishProfileString(xmlString)

Paramtres
xmlString Chane contenant les donnes XML importer en tant que profil actuel.

Valeur renvoye Valeur boolenne, true si la chane a bien t importe, false dans le cas contraire. Description Mthode qui importe une chane XML reprsentant un profil de publication et la dfinit en tant que profil actif. Pour gnrer une chane XML importer, utilisez document.exportPublishProfileString() avant cette mthode. Exemple Dans l'exemple suivant, le profil par dfaut est export sous forme de chane XML. La commande JavaScript standard replace est utilise pour modifier la chane XML. La chane est alors importe et le paramtre de sortie ActionScript 3 par dfaut est dfini sur ActionScript 1.
var profileXML=fl.getDocumentDOM().exportPublishProfileString('Default'); fl.trace(profileXML); var newProfileXML = profileXML.replace("<ActionScriptVersion>3</ActionScriptVersion>", "<ActionScriptVersion>1</ActionScriptVersion>"); fl.getDocumentDOM().importPublishProfileString(newProfileXML);

document.importSWF()
Disponibilit Flash MX 2004. Utilisation
document.importSWF(fileURI)

Paramtres fileURI Chane de type fichier:///URI qui spcifie le nom du fichier SWF exporter.

EXTENSION DE FLASH CS4 PROFESSIONAL 120

Objet Document

Valeur renvoye Aucune. Description Mthode qui importe un fichier SWF dans le document. Cette mthode effectue une opration identique lutilisation de la commande Importer pour spcifier un fichier SWF. Dans Flash8 et les versions ultrieures, vous pouvez galement utiliser document.importFile() pour importer un fichier SWF (ainsi que d'autres types de fichiers). Exemple L'exemple suivant importe le fichier "mySwf.swf" depuis le dossier de configuration de Flash :
fl.getDocumentDOM().importSWF(fl.configURI+"mySwf.swf");

Voir aussi
document.importFile()

document.intersect()
Disponibilit Flash 8. Utilisation
document.intersect()

Paramtres Aucun. Valeur renvoye Valeur boolenne : true en cas de russite, false sinon. Description Mthode qui cre un objet de dessin Intersection partir de tous les objets de dessin slectionns. La mthode renvoie false sil nexiste pas dobjets de dessin slectionns, ou si lun des lments slectionns nest pas un objet de dessin. Exemple L'exemple suivant cre un objet de dessin Intersection partir de tous les objets de dessin slectionns :
fl.getDocumentDOM().intersect();

Voir aussi
document.crop(), document.deleteEnvelope(), document.punch(), document.union(), shape.isDrawingObject

EXTENSION DE FLASH CS4 PROFESSIONAL 121

Objet Document

document.library
Disponibilit Flash MX 2004. Utilisation
document.library

Description Proprit en lecture seule ; Objet library d'un document. Exemple L'exemple suivant rcupre la bibliothque du document actif.
var myCurrentLib = fl.getDocumentDOM().library;

En supposant que le document actuellement actif nest pas fl.documents[1], lexemple suivant rcupre la bibliothque non active ou une bibliothque ouverte laide de la commande Fichier > Ouvrir comme bibliothque externe :
var externalLib = fl.documents[1].library;

document.libraryPath
Disponibilit Flash CS4 Professional. Utilisation
document.libraryPath

Description Proprit ; chane qui contient la liste des lments de chemin de la bibliothque ActionScript 3.0 du document, spcifiant l'emplacement des fichiers SWC ou des dossiers contenant les fichiers SWC. Les lments de la chane sont dlimits par des points-virgules. Dans l'outil de programmation, les lments sont spcifis en slectionnant Fichier > Paramtres de publication, puis en cliquant sur le bouton Paramtres de Script ActionScript 3.0 dans l'onglet Flash. Exemple L'exemple suivant ajoute le dossier ../Files au chemin de bibliothque du document, puis affiche ce chemin dans le panneau Sortie :
var myDoc = fl.getDocumentDOM() fl.trace(myDoc.libraryPath); myDoc.libraryPath = "../Files;" + myDoc.libraryPath; fl.trace(myDoc.libraryPath);

Voir aussi
document.externalLibraryPath,document.sourcePath, fl.libraryPath

EXTENSION DE FLASH CS4 PROFESSIONAL 122

Objet Document

document.livePreview
Disponibilit Flash MX 2004. Utilisation
document.livePreview

Description Proprit ; valeur boolenne indiquant si la fonction Aperu en direct est active. Si cette proprit est true, les composants apparaissent sur la scne tels qu'ils apparatront dans le contenu Flash publi, avec leur taille approximative. Si elle est false, seuls les contours des composants apparaissent. La valeur par dfaut est true. Exemple L'exemple suivant dfinit la fonction Aperu en direct sur false :
fl.getDocumentDOM().livePreview = false;

document.match()
Disponibilit Flash MX 2004. Utilisation
document.match(bWidth, bHeight [, bUseDocumentBounds])

Paramtres bWidth Valeur boolenne. Si elle est true, la mthode donne une largeur identique tous les lments slectionns.
bHeight Valeur boolenne. Si elle est true, la mthode donne une hauteur identique tous les lments slectionns. bUseDocumentBounds Valeur boolenne. Si elle est true, la mthode aligne la taille des objets sur les limites du document. Sinon, la mthode utilise les limites de lobjet ayant la plus grande taille. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui donne la mme taille tous les objets slectionns. Exemple L'exemple suivant donne une largeur identique tous les lments slectionns :
fl.getDocumentDOM().match(true,false);

L'exemple suivant donne une hauteur identique tous les lments slectionns :
fl.getDocumentDOM().match(false,true);

EXTENSION DE FLASH CS4 PROFESSIONAL 123

Objet Document

L'exemple suivant donne une largeur correspondant aux limites du document :

fl.getDocumentDOM().match(true,false,true);

Voir aussi
document.getAlignToDocument(), document.setAlignToDocument()

document.mouseClick()
Disponibilit Flash MX 2004. Utilisation
document.mouseClick(position, bToggleSel, bShiftSel)

Paramtres position Paire de valeurs numriques virgule flottante indiquant les coordonnes x et y du clic, en pixels.
bToggleSel Valeur boolenne indiquant ltat de la touche Maj : true si la touche est enfonce, false si elle ne l'est pas. bShiftSel Valeur boolenne indiquant ltat de la prfrence Slection avec la touche Maj : true si la prfrence est

active, false si elle ne l'est pas. Valeur renvoye Aucune. Description Mthode qui effectue un clic de souris laide de loutil Slection. Exemple L'exemple suivant simule un clic de souris lemplacement indiqu :
fl.getDocumentDOM().mouseClick({x:300, y:200}, false, false);

Voir aussi
document.mouseDblClk()

document.mouseDblClk()
Disponibilit Flash MX 2004. Utilisation
document.mouseDblClk(position, bAltDown, bShiftDown, bShiftSelect)

Paramtres position Paire de valeurs numriques virgule flottante indiquant les coordonnes x et y du clic, en pixels.

EXTENSION DE FLASH CS4 PROFESSIONAL 124

Objet Document

bAltdown Valeur boolenne qui indique si la touche Alt est enfonce au moment de lvnement : true si la touche est enfonce, false si elle ne l'est pas. bShiftDown Valeur boolenne qui indique si la touche Maj est enfonce au moment de lvnement : true si la touche

est enfonce, false si elle ne l'est pas.

bShiftSelect Valeur boolenne indiquant ltat de la prfrence Slection avec la touche Maj : true si la prfrence

est active, false si elle ne l'est pas. Valeur renvoye Aucune. Description Mthode qui effectue un double-clic de souris laide de loutil Slection. Exemple L'exemple suivant simule un double-clic de souris lemplacement indiqu :
fl.getDocumentDOM().mouseDblClk({x:392.9, y:73}, false, false, true);

Voir aussi
document.mouseClick()

document.moveSelectedBezierPointsBy()
Disponibilit Flash MX 2004. Utilisation
document.moveSelectedBezierPointsBy(delta)

Paramtres delta Paire de nombres en virgule flottante indiquant les coordonnes x et y de dplacement, en pixels, des points de courbe de Bzier slectionns. Par exemple, les paramtres ({x:1,y:2}) spcifient un emplacement situ droite (de un pixel) et en dessous (de deux pixels) de lemplacement actuel. Valeur renvoye Aucune. Description Mthode qui, si la slection contient au moins un trajet comptant au moins un point de courbe de Bzier, dplace de la valeur spcifie tous les points de courbe de Bzier de tous les trajets slectionns. Exemple L'exemple suivant dplace les points de courbe de Bzier slectionns de 10 pixels vers la droite et de 5 pixels vers le bas :
fl.getDocumentDOM().moveSelectedBezierPointsBy({x:10, y:5});

EXTENSION DE FLASH CS4 PROFESSIONAL 125

Objet Document

document.moveSelectionBy()
Disponibilit Flash MX 2004. Utilisation
document.moveSelectionBy(distanceToMove)

Paramtres
distanceToMove Paire de nombres en virgule flottante indiquant les valeurs de dplacement x et y de la slection. Par

exemple, les paramtres ({x:1,y:2}) spcifient un emplacement situ droite (de un pixel) et en dessous (de deux pixels) de lemplacement actuel. Valeur renvoye Aucune. Description Mthode qui dplace les objets slectionns de la distance spcifie. Remarque : lorsque l'utilisateur se sert des touches de direction (flches) pour dplacer un lment, le panneau Historique combine tous les appuis de touches flches en un seul dplacement. Lorsque lutilisateur appuie rptition sur les touches flches, plutt que denregistrer plusieurs tapes dans le panneau Historique, la mthode effectue tous les dplacements en une seule tape, et les arguments sont actualiss pour reproduire les actions rptes sur les touches flches. Pour plus d'informations sur les slections, consultez les sections document.setSelectionRect(), document.mouseClick(), document.mouseDblClk() et Objet Element. Exemple L'exemple suivant dplace llment slectionn de 62 pixels vers la droite et 84 pixels vers le bas :
fl.getDocumentDOM().moveSelectionBy({x:62, y:84});

document.name
Disponibilit Flash MX 2004. Utilisation
document.name

Description Proprit en lecture seule ; chane reprsentant le nom dun document (fichier FLA). Exemple L'exemple suivant donne la variable fileName le nom de fichier du premier document du tableau des documents :
var fileName = flash.documents[0].name;

EXTENSION DE FLASH CS4 PROFESSIONAL 126

Objet Document

Lexemple suivant affiche dans le panneau Sortie les noms de tous les documents ouverts :
var openDocs = fl.documents; for(var i=0;i < openDocs.length; i++){ fl.trace(i + " " + openDocs[i].name +"\n"); }

document.optimizeCurves()
Disponibilit Flash MX 2004. Utilisation
document.optimizeCurves(smoothing, bUseMultiplePasses)

Paramtres
smoothing Nombre entier compris entre 0 et 100, avec 0 signifiant pas de lissage, et 100 signifiant un lissage

maximum.
bUseMultiplePasses Valeur boolenne. Si elle est true, la mthode doit utiliser plusieurs passages. Cette option est plus lente mais produit de meilleurs rsultats. Ce paramtre a le mme effet quun clic sur le bouton Appliquer plusieurs passages dans la bote de dialogue Optimiser les courbes.

Valeur renvoye Aucune. Description Mthode qui optimise le lissage de la slection, le cas chant en autorisant plusieurs passages pour obtenir un lissage optimal. Cette mthode est lquivalent de loption de menu Modification > Forme > Optimiser. Exemple L'exemple suivant optimise la courbe de la slection 50 de lissage en plusieurs passages :
fl.getDocumentDOM().optimizeCurves(50, true);

document.path
Disponibilit Flash MX 2004. Utilisation
document.path

Description Proprit en lecture seule ; chane reprsentant le chemin daccs du document dans un format spcifique la plateforme. Si le document na pas encore t enregistr, cette proprit renvoie undefined.

EXTENSION DE FLASH CS4 PROFESSIONAL 127

Objet Document

Exemple L'exemple suivant affiche dans le panneau Sortie le chemin daccs du premier document du tableau des documents. Enregistrez le document avant d'excuter ce script. Dans l'exemple, le fichier est nomm test.fla et est enregistr dans le dossier Mes documents sur un ordinateur Windows.
var filePath = flash.documents[0].path; fl.trace(filePath); // displays C:\Documents and Settings\<user name>\My Documents\test.fla

Voir aussi
document.pathURI

document.pathURI
Disponibilit Flash CS4 Professional. Utilisation
document.pathURI

Description Proprit en lecture seule ; chane reprsentant le chemin du document, exprime sous la forme fichier:///URI . Si le document na pas encore t enregistr, cette proprit renvoie undefined. Exemple L'exemple suivant affiche le chemin du premier document du tableau des documents sous forme de chane fichier:///URI dans le panneau Sortie. Enregistrez le document avant d'excuter ce script. Dans l'exemple, le fichier est nomm test.fla et est enregistr dans le dossier Mes documents sur un ordinateur Windows.
var filePathURI = flash.documents[0].pathURI; fl.trace(filePathURI); // displays file:///C|/Documents%20and%20Settings/<userName>/My%20Documents/test.fla

Voir aussi
document.path

document.publish()
Disponibilit Flash MX 2004. Utilisation
document.publish()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 128

Objet Document

Valeur renvoye Aucune. Description Mthode qui publie le document en fonction des paramtres de publication actuels (Fichier > Paramtres de publication). Cette mthode est lquivalent de loption de menu Fichier > Publier. Exemple Lexemple suivant publie le document actif :
fl.getDocumentDOM().publish();

document.publishProfiles
Disponibilit Flash MX 2004. Utilisation
document.publishProfiles

Description Proprit en lecture seule ; tableau des noms des profils de publication du document. Exemple L'exemple suivant affiche les noms des profils de publication du document :
var myPubProfiles = fl.getDocumentDOM().publishProfiles; for (var i=0; i < myPubProfiles.length; i++){ fl.trace(myPubProfiles[i]); }

document.punch()
Disponibilit Flash 8. Utilisation
document.punch()

Paramtres Aucun. Valeur renvoye Valeur boolenne : true en cas de russite, false sinon.

EXTENSION DE FLASH CS4 PROFESSIONAL 129

Objet Document

Description Mthode qui, sur la base de lobjet de dessin slectionn le plus lev, poinonne tous les objets de dessin de niveau infrieur. La mthode renvoie false s'il nexiste pas dobjets de dessin slectionns, ou si lun des lments slectionns n'est pas un objet de dessin. Exemple L'exemple suivant poinonne tous les objets de dessin de niveau infrieur lobjet de dessin slectionn :
fl.getDocumentDOM().punch();

Voir aussi
document.crop(), document.deleteEnvelope(), document.intersect(), document.union(), shape.isDrawingObject

document.removeAllFilters()
Disponibilit Flash 8. Utilisation
document.removeAllFilters()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui supprime tous les filtres des objets slectionns. Exemple L'exemple suivant supprime tous les filtres des objets slectionns :
fl.getDocumentDOM().removeAllFilters();

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableAllFilters(), document.getFilters(), document.removeFilter(), Objet Filter

document.removeDataFromDocument()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 130

Objet Document

Utilisation
document.removeDataFromDocument(name)

Paramtres name Chane spcifiant le nom des donnes supprimer. Valeur renvoye Aucune. Description Mthode qui supprime les donnes persistantes associes au document et correspondant au nom spcifi. Exemple L'exemple suivant supprime du document les donnes persistantes ayant le nom "myData" :
fl.getDocumentDOM().removeDataFromDocument("myData");

Voir aussi
document.addDataToDocument(), document.documentHasData(), document.getDataFromDocument()

document.removeDataFromSelection()
Disponibilit Flash MX 2004. Utilisation
document.removeDataFromSelection(name)

Paramtres name Chane spcifiant le nom des donnes persistantes supprimer. Valeur renvoye Aucune. Description Mthode qui supprime les donnes persistantes associes la slection et correspondant au nom spcifi. Exemple L'exemple suivant supprime de la slection les donnes persistantes ayant le nom "myData" :
fl.getDocumentDOM().removeDataFromSelection("myData");

Voir aussi
document.addDataToSelection()

EXTENSION DE FLASH CS4 PROFESSIONAL 131

Objet Document

document.removeFilter()
Disponibilit Flash 8. Utilisation
document.removeFilter(filterIndex)

Paramtres
filterIndex Nombre entier indiquant dans la liste Filtres lindex (en base 0) du filtre supprimer des objets

slectionns. Valeur renvoye Aucune. Description Mthode qui supprime le filtre spcifi de la liste Filtres des objets slectionns. Exemple L'exemple suivant supprime le premier filtre (index 0) de la liste Filtres des objets slectionns :
fl.getDocumentDOM().removeFilter(0);

Voir aussi
document.addFilter(), document.changeFilterOrder(), document.disableFilter(), document.getFilters(), document.removeAllFilters(), Objet Filter

document.renamePublishProfile()
Disponibilit Flash MX 2004. Utilisation
document.renamePublishProfile([profileNewName])

Paramtres
profileNewName Paramtre facultatif qui indique le nouveau nom du profil. Ce nouveau nom doit tre unique. Si vous ne spcifiez pas de nom, un nom par dfaut est utilis.

Valeur renvoye Valeur boolenne, true si le nom a bien t modifi, false dans le cas contraire. Description Mthode qui renomme le profil actuel.

EXTENSION DE FLASH CS4 PROFESSIONAL 132

Objet Document

Exemple L'exemple suivant renomme le profil actuel avec un nom par dfaut qui est ensuite affich :
alert(fl.getDocumentDOM().renamePublishProfile());

document.renameScene()
Disponibilit Flash MX 2004. Utilisation
document.renameScene(name)

Paramtres name Chane spcifiant le nouveau nom de la squence. Valeur renvoye Valeur boolenne, true si le nom a bien t modifi, false dans le cas contraire. Si le nouveau nom nest pas unique, par exemple, la mthode renvoie false. Description Mthode qui renomme la squence slectionne dans le panneau Squences. Le nouveau nom de la squence doit tre unique. Exemple L'exemple suivant renomme la squence active avec le nom "new name" :
var success = fl.getDocumentDOM().renameScene("new name");

document.reorderScene()
Disponibilit Flash MX 2004. Utilisation
document.reorderScene(sceneToMove, sceneToPutItBefore)

Paramtres
sceneToMove Nombre entier spcifiant lindex de la squence dplacer, 0 (zro) tant la premire squence. sceneToPutItBefore Nombre entier spcifiant la squence devant laquelle la squence dfinie par sceneToMove doit tre place. Indiquez 0 (zro) pour la premire squence. Par exemple, si vous spcifiez 1 pour sceneToMove et 0 pour sceneToPutItBefore, la seconde squence est place devant la premire. Spcifiez -1 pour placer la squence la fin.

Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 133

Objet Document

Description Mthode qui place la squence spcifie devant une autre squence spcifie. Exemple L'exemple suivant place la seconde squence devant la premire :
fl.getDocumentDOM().reorderScene(1, 0);

document.resetOvalObject()
Disponibilit Flash CS3 Professional. Utilisation
document.resetOvalObject()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui, dans l'inspecteur Proprits, dfinit toutes les valeurs sur les paramtres par dfaut de l'objet Oval. Si des objets Oval sont slectionns, leurs proprits sont galement redfinies sur les valeurs par dfaut. Exemple L'exemple suivant redfinit les proprits de l'objet Oval du document actif sur les valeurs par dfaut :
fl.getDocumentDOM().resetOvalObject();

Voir aussi
document.resetRectangleObject()

document.resetRectangleObject()
Disponibilit Flash CS3 Professional. Utilisation
document.resetRectangleObject()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 134

Objet Document

Valeur renvoye Aucune. Description Mthode qui, dans l'inspecteur Proprits, dfinit toutes les valeurs sur les paramtres par dfaut de l'objet Rectangle. Si des objets Rectangle sont slectionns, leurs proprits sont galement redfinies sur les valeurs par dfaut. Exemple L'exemple suivant redfinit les proprits de l'objet Rectangle du document actif sur les valeurs par dfaut :
fl.getDocumentDOM().resetRectangleObject();

Voir aussi
document.resetOvalObject()

document.resetTransformation()
Disponibilit Flash MX 2004. Utilisation
document.resetTransformation()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui rinitialise la matrice de transformation. Cette mthode est lquivalent de loption de menu Modification > Transformer > Supprimer la transformation. Exemple L'exemple suivant rinitialise la matrice de transformation de la slection.
fl.getDocumentDOM().resetTransformation();

document.revert()
Disponibilit Flash MX 2004. Utilisation
document.revert()

EXTENSION DE FLASH CS4 PROFESSIONAL 135

Objet Document

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui restaure la dernire version enregistre du document spcifi. Cette mthode est lquivalent de loption de menu Fichier > Rtablir. Exemple Lexemple suivant restaure la dernire version enregistre du document actif.
fl.getDocumentDOM().revert();

Voir aussi
document.canRevert(), fl.revertDocument()

document.revertToLastVersion()
Disponibilit Flash CS3 Professional. Utilisation
document.revertToLastVersion()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si le rtablissement du document a russi, false dans le cas contraire. Description Mthode qui, s'il est possible de rtablir le fichier, affiche une bote de dialogue permettant l'utilisateur de confirmer cette restauration. En cas de confirmation de l'utilisateur, cette mthode remplace la version du fichier par celle stocke sur le serveur Version Cue et consigne les ventuelles erreurs dans le panneau Sortie. Exemple Lexemple suivant remplace la version du document actif par celle qui est stocke sur le serveur Version Cue :
fl.getDocumentDOM().revertToLastVersion();

Voir aussi
document.canSaveAVersion(), document.saveAVersion(), document.synchronizeWithHeadVersion(), fl.revertDocumentToLastVersion()

EXTENSION DE FLASH CS4 PROFESSIONAL 136

Objet Document

document.rotate3DSelection()
Disponibilit Flash CS4 Professional. Utilisation
document.rotate3DSelection(xyzCoordinate, bGlobalTransform)

Paramtres
xyzCoordinate Point de coordonnes XYZ spcifiant les axes d'une rotation 3D. bGlobalTransform Valeur boolenne qui spcifie si le mode de transformation doit tre global (true) ou local

(false). Valeur renvoye Aucune. Description Mthode qui applique une rotation 3D la slection. Cette mthode n'est disponible que pour les clips. Exemple Dans l'exemple suivant, la slection pivote d'abord par rapport la scne (globalement), puis sur elle-mme (localement).
var myDocument = fl.getDocumentDOM(); myDocument.rotate3DSelection({x:52.0, y:0, z:0}, true); myDocument.rotate3DSelection({x:52.0, y:0, z:-55.2}, false);

document.rotateSelection()
Disponibilit Flash MX 2004. Utilisation
document.rotateSelection(angle [, rotationPoint])

Paramtres angle Valeur en virgule flottante spcifiant langle de rotation.

rotationPoint Chane spcifiant le ct du rectangle de dlimitation sur lequel doit seffectuer la rotation. Les valeurs gres sont "top right" (haut droite), "top left" (haut gauche), "bottom right" (bas droite), "bottom left" (bas gauche), "top center" (centre haut), "right center" (centre droite), "bottom center" (centre bas) et "left center" (centre gauche). Si ce paramtre nest pas spcifi, la mthode utilise le point de transformation. Ce paramtre est facultatif.

Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 137

Objet Document

Description Mthode qui effectue sur la slection une rotation du nombre de degrs spcifi. Leffet est identique celui de loutil Transformation libre utilis pour une rotation de lobjet. Exemple L'exemple suivant effectue une rotation de 45 de la slection autour de son point de transformation :
fl.getDocumentDOM().rotateSelection(45);

L'exemple suivant effectue une rotation de 45 degrs de la slection autour de son coin infrieur gauche :
fl.getDocumentDOM().rotateSelection(45, "bottom left");

document.save()
Disponibilit Flash MX 2004. Utilisation
document.save([bOkToSaveAs])

Paramtres
bOkToSaveAs Paramtre facultatif. Sil est dfini sur true ou omis, et si le fichier na jamais t enregistr, la bote de

dialogue Enregistrer sous apparat. Si sa valeur est false, le fichier nest pas enregistr, mme sil ne la jamais t. Valeur renvoye Valeur boolenne, true en cas de russite de lenregistrement, false dans le cas contraire. Description Mthode qui enregistre le document son emplacement par dfaut. Cette mthode est lquivalent de loption de menu Fichier > Enregistrer. Pour donner un autre nom au fichier (au lieu de l'enregistrer avec un nom identique), utilisez fl.saveDocument(). Remarque : si le fichier est nouveau et qu'il n'a t ni enregistr ni modifi, ou s'il existe et n'a pas t modifi depuis son dernier enregistrement, cette mthode n'a aucun effet et la valeur false est renvoye. Pour permettre l'enregistrement d'un fichier qui n'a pas t enregistr ni modifi, utilisez document.saveAndCompact() ou fl.saveDocumentAs(). Exemple L'exemple suivant enregistre le document actif son emplacement par dfaut :
fl.getDocumentDOM().save();

Voir aussi
document.saveAndCompact(), fl.saveAll(), fl.saveDocument(), fl.saveDocumentAs()

EXTENSION DE FLASH CS4 PROFESSIONAL 138

Objet Document

document.saveAndCompact()
Disponibilit Flash MX 2004. Utilisation
document.saveAndCompact([bOkToSaveAs])

Paramtres
bOkToSaveAs Paramtre facultatif. Sil est true ou sil est omis, et si le fichier na jamais t enregistr, la bote de dialogue Enregistrer sous apparat. Si sa valeur est false, le fichier nest pas enregistr, mme sil ne la jamais t. La valeur par dfaut est true.

Valeur renvoye Valeur boolenne, true en cas de russite de lenregistrement avec compression, false dans le cas contraire. Description Mthode qui enregistre et compresse le fichier. Cette mthode est lquivalent de loption de menu Fichier > Enregistrer et compresser. Remarque : si le fichier n'a jamais t enregistr, cette mthode renvoie true mme si l'utilisateur annule la bote de dialogue Enregistrer sous. Pour dterminer prcisment si le fichier a t enregistr ou non, utilisez fl.saveDocumentAs(). Exemple Lexemple suivant enregistre et compresse le document actif :
fl.getDocumentDOM().saveAndCompact();

Voir aussi
document.save(), fl.saveDocumentAs(), fl.saveDocument(), fl.saveAll()

document.saveAVersion()
Disponibilit Flash CS3 Professional. Utilisation
document.saveAVersion()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si une version du document est correctement enregistre sur le serveur Version Cue, sinon false.

EXTENSION DE FLASH CS4 PROFESSIONAL 139

Objet Document

Description Mthode qui, si le fichier peut tre enregistr sur le serveur Version Cue, affiche une bote de dialogue permettant l'utilisateur d'entrer des commentaires sur la version, puis enregistre une version du document spcifi sur le serveur et consigne les ventuelles erreurs dans le panneau Sortie. Remarque : si l'enregistrement du fichier par Flash est impossible car les informations d'identification du serveur n'ont pas t mises en cache dans la session de l'application active, un message d'erreur signalant l'chec de l'authentification s'affiche dans le panneau Sortie. Si cette erreur se produit, l'utilisateur doit se servir de la bote de dialogue Fichier > Ouvrir pour ouvrir l'espace de travail de Version Cue avec les informations d'identification appropries. Les prochains appels de l'API JavaScript ce serveur aboutiront ensuite sans problme. Exemple
See document.canSaveAVersion().

Voir aussi
document.canSaveAVersion(), document.revertToLastVersion(), document.synchronizeWithHeadVersion()

document.scaleSelection()
Disponibilit Flash MX 2004. Utilisation
document.scaleSelection(xScale, yScale [, whichCorner])

Paramtres xScale Valeur en virgule flottante spcifiant la valeur x de mise lchelle horizontale.
yScale Valeur en virgule flottante spcifiant la valeur y de mise lchelle verticale. whichCorner Chane indiquant le coin partir duquel est applique la transformation. Si ce paramtre nest pas spcifi, la mthode utilise le point de transformation. Les valeurs possibles sont : "bottom left" (bas gauche), "bottom right" (bas droite), "top right" (haut droite), "top left" (haut gauche), "top center" (centre haut), "right center" (centre droite), "bottom center" (centre bas) et "left center" (centre gauche). Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui effectue sur la slection une mise lchelle de la valeur spcifie. Leffet est identique celui de loutil Transformation libre utilis pour une mise lchelle de lobjet. Exemple L'exemple suivant double la largeur originale de la slection et rduit sa hauteur de moiti :
fl.getDocumentDOM().scaleSelection(2.0, 0.5);

EXTENSION DE FLASH CS4 PROFESSIONAL 140

Objet Document

L'exemple suivant fait pivoter la slection sur laxe vertical :

fl.getDocumentDOM().scaleSelection(1, -1);

L'exemple suivant fait pivoter la slection sur laxe horizontal :

fl.getDocumentDOM().scaleSelection(-1, 1);

Lexemple suivant effectue une mise lchelle verticale de la slection, avec un facteur de 1,9 partir du centre haut :
fl.getDocumentDOM().scaleSelection(1, 1.90, 'top center');

document.screenOutline
Disponibilit Flash MX 2004. Utilisation
document.screenOutline

Description Proprit en lecture seule ; objet ScreenOutline actuel du document. Avant daccder cet objet pour la premire fois, il est conseill dutiliser document.allowScreens() pour vrifier l'existence de la proprit. Exemple L'exemple suivant affiche un tableau des valeurs de la proprit screenOutline :
var myArray = new Array(); for(var i in fl.getDocumentDOM().screenOutline) { myArray.push(" "+i+" : "+fl.getDocumentDOM().screenOutline[i]) ; } fl.trace("Here is the property dump for screenOutline: "+myArray);

Voir aussi
document.allowScreens(), Objet ScreenOutline

document.selectAll()
Disponibilit Flash MX 2004. Utilisation
document.selectAll()

Paramtres Aucun. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 141

Objet Document

Description Mthode qui slectionne tous les lments sur la scne. Cette mthode est lquivalent des raccourcis clavier Ctrl+A (Windows) ou Commande+A (Macintosh), ou de loption de menu Edition > Slectionner tout. Exemple L'exemple suivant slectionne tous les lments actuellement visibles pour lutilisateur :
fl.getDocumentDOM().selectAll();

Voir aussi
document.selection, document.selectNone()

document.selection
Disponibilit Flash MX 2004. Utilisation
document.selection

Description Proprit ; tableau des objets slectionns dans le document. Si rien nest slectionn, la proprit renvoie un tableau de longueur zro. Si aucun document nest ouvert, elle renvoie null. Pour ajouter des objets au tableau, vous devez dabord les slectionner laide de lune des techniques suivantes :

Slectionnez manuellement les objets sur la scne. Utilisez lune des mthodes de slection, telles que document.setSelectionRect(),
document.setSelectionBounds(), document.mouseClick(), document.mouseDblClk() ou document.selectAll().

Slectionnez manuellement une ou plusieurs images. Utilisez lune des mthodes de lObjet Timeline pour slectionner une ou plusieurs images, telles que
timeline.getSelectedFrames(), timeline.setSelectedFrames() ou timeline.selectAllFrames().

Spcifiez tous les lments dans une image particulire (voir Objet Element). Reportez-vous au premier exemple
ci-dessous.

Crez un tableau d'un ou plusieurs lments, puis attribuez-le au tableau document.selection. Reportez-vous au
troisime exemple ci-dessous. Exemple L'exemple suivant assigne tous les lments de limage 11 la slection actuelle (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().currentFrame = 10; fl.getDocumentDOM().selection = fl.getDocumentDOM().getTimeline().layers[0].frames[10].elements;

EXTENSION DE FLASH CS4 PROFESSIONAL 142

Objet Document

Lexemple suivant cre un rectangle dans le coin suprieur gauche de la scne, puis une chane de texte sous ce rectangle. Ces deux objets sont ensuite slectionns l'aide de document.setSelectionRect() et ajouts au tableau document.selection. Enfin, le contenu de document.selection est affich dans le panneau Sortie.
fl.getDocumentDOM().addNewRectangle({left:0, top:0, right:99, bottom:99}, 0); fl.getDocumentDOM().addNewText({left:-1, top:117.3, right:9.2, bottom:134.6}); fl.getDocumentDOM().setTextString('Hello World'); fl.getDocumentDOM().setSelectionRect({left:-28, top:-22, right:156.0, bottom:163}); var theSelectionArray = fl.getDocumentDOM().selection; for(var i=0;i<theSelectionArray.length;i++){ fl.trace("fl.getDocumentDOM().selection["+i+"] = " + theSelectionArray[i]); }

L'exemple suivant est plus complexe. Il montre comment parcourir en boucle le tableau des calques et le tableau des lments pour retrouver les occurrences dun symbole particulier et les slectionner. Cet exemple pourrait tre tendu en y ajoutant des boucles analysant les images ou les squences. Cet exemple affecte la slection active toutes les occurrences du clip myMovieClip figurant dans la premire image :
// Assigns the layers array to the variable "theLayers". var theLayers = fl.getDocumentDOM().getTimeline().layers; // Creates an array to hold all the elements // that are instances of "myMovieClip". var myArray = new Array(); // Counter variable var x = 0; // Begin loop through all the layers. for (var i = 0; i < theLayers.length; i++) { // Gets the array of elements in Frame 1 // and assigns it to the array "theElems". var theElems = theLayers[i].frames[0].elements; // Begin loop through the elements on a layer. for (var c = 0; c < theElems.length; c++) { // Checks to see if the element is of type "instance". if (theElems[c].elementType == "instance") { // If the element is an instance, it checks // if it is an instance of "myMovieClip". if (theElems[c].libraryItem.name == "myMovieClip") { // Assigns elements that are instances of "myMovieClip" to "myArray". myArray[x] = theElems[c]; // Increments counter variable. x++; } } } } // Now that you have assigned all the instances of "myMovieClip" // to "myArray", you then set the document.selection array // equal to myArray. This selects the objects on the Stage. fl.getDocumentDOM().selection = myArray;

EXTENSION DE FLASH CS4 PROFESSIONAL 143

Objet Document

document.selectNone()
Disponibilit Flash MX 2004. Utilisation
document.selectNone()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui dslectionne les lments slectionns. Exemple L'exemple suivant dslectionne tous les lments slectionns :
fl.getDocumentDOM().selectNone();

Voir aussi
document.selectAll(), document.selection

document.setAlignToDocument()
Disponibilit Flash MX 2004. Utilisation
document.setAlignToDocument(bToStage)

Paramtres bToStage Valeur boolenne. Si elle est dfinie sur true, la mthode aligne les objets sur la scne. Si elle est false, elle ne les aligne pas. Valeur renvoye Aucune. Description Mthode qui dfinit les prfrences afin d'activer document.align(), document.distribute(), document.match() et document.space() pour le document. Cette commande est quivalente lactivation de l'option Sur la scne dans le panneau Aligner.

EXTENSION DE FLASH CS4 PROFESSIONAL 144

Objet Document

Exemple L'exemple suivant active le bouton Sur la scne dans le panneau Aligner, afin daligner les objets sur la scne :
fl.getDocumentDOM().setAlignToDocument(true);

Voir aussi
document.getAlignToDocument()

document.setBlendMode()
Disponibilit Flash 8. Utilisation
document.setBlendMode(mode)

Paramtres mode Chane reprsentant le mode de fondu dsir pour les objets slectionns. Les valeurs gres sont "normal", "layer", "multiply", "screen", "overlay", "hardlight", "lighten", "darken", "difference", "add", "subtract", "invert", "alpha" et "erase". Valeur renvoye Aucune. Description Mthode qui dfinit le mode de fondu pour les objets slectionns. Exemple L'exemple suivant dfinit sur "add" le mode de fondu pour l'objet slectionn.
fl.getDocumentDOM().setBlendMode("add");

Voir aussi
document.addFilter(), document.setFilterProperty(), symbolInstance.blendMode

document.setCustomFill()
Disponibilit Flash MX 2004. Utilisation
document.setCustomFill(fill)

Paramtres fill Objet Fill qui spcifie les paramtres de remplissage requis. Voir Objet Fill.

EXTENSION DE FLASH CS4 PROFESSIONAL 145

Objet Document

Valeur renvoye Aucune. Description Mthode qui dfinit les paramtres de remplissage pour le panneau Outils, l'inspecteur Proprits et les formes slectionnes, le cas chant. Cette opration permet au script de dfinir les paramtres de remplissage avant de tracer un objet, ce qui est plus lgant que dessiner lobjet, le slectionner et modifier ses paramtres de remplissage. Elle permet aussi de modifier par script les paramtres de remplissage du panneau Outils et de l'inspecteur Proprits. Exemple L'exemple suivant dfinit le blanc comme couleur active dans la palette des couleurs de remplissage du panneau Outils, de l'inspecteur Proprits et des ventuelles formes slectionnes :
var fill = fl.getDocumentDOM().getCustomFill(); fill.color = '#FFFFFF'; fill.style = "solid"; fl.getDocumentDOM().setCustomFill(fill);

Voir aussi
document.getCustomFill()

document.setCustomStroke()
Disponibilit Flash MX 2004. Utilisation
document.setCustomStroke(stroke)

Paramtres stroke Objet Objet Stroke. Valeur renvoye Aucune. Description Mthode qui dfinit les paramtres de trait pour le panneau Outils, l'inspecteur Proprits et les formes slectionnes, le cas chant. Cette opration permet au script de dfinir les paramtres de trait avant de tracer un objet, ce qui est plus lgant que dessiner lobjet, le slectionner et modifier ses paramtres de trait. Elle permet aussi de modifier par script les paramtres de trait du panneau Outils et de l'inspecteur Proprits. Exemple L'exemple suivant modifie les paramtres dpaisseur de trait du panneau Outils, de l'inspecteur Proprits et des formes slectionnes, le cas chant :
var stroke = fl.getDocumentDOM().getCustomStroke(); stroke.thickness += 2; fl.getDocumentDOM().setCustomStroke(stroke);

EXTENSION DE FLASH CS4 PROFESSIONAL 146

Objet Document

Voir aussi
document.getCustomStroke()

document.setElementProperty()
Disponibilit Flash MX 2004. Utilisation
document.setElementProperty(property, value)

Paramtres property Chane spcifiant le nom de la proprit Element dfinir. La liste complte des proprits et des valeurs est indique dans le tableau Rsum des proprits de l'Objet Element. Cette mthode ne permet pas de modifier les proprits en lecture seule, telles que element.elementType, element.top ou element.left.
value Nombre entier spcifiant la valeur attribuer la proprit Element spcifie.

Valeur renvoye Aucune. Description Mthode qui dfinit la proprit Element spcifie pour les objets slectionns du document. La mthode est inoprante sil nexiste pas de slection. Exemple L'exemple suivant dfinit la largeur de tous les lments slectionns sur 100 et leur hauteur sur 50 :
fl.getDocumentDOM().setElementProperty("width", 100); fl.getDocumentDOM().setElementProperty("height", 50);

document.setElementTextAttr()
Disponibilit Flash MX 2004. Utilisation
document.setElementTextAttr(attrName, attrValue [, startIndex [, endIndex]])

Paramtres attrName Chane spcifiant le nom de la proprit TextAttrs modifier.

attrValue Valeur affecter la proprit TextAttrs. La liste des noms de proprit et des valeurs possibles est

indique dans le tableau Rsum des proprits de l'Objet TextAttrs.

startIndex Nombre entier spcifiant lindex du premier caractre concern. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 147

Objet Document

endIndex Nombre entier spcifiant lindex du dernier caractre concern. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne, true si au moins une proprit dattribut de texte est modifie, false dans le cas contraire. Description Mthode qui dfinit sur la valeur spcifie la proprit TextAttrs des lments de texte slectionns. La liste des noms de proprit et des valeurs possibles est indique dans le tableau Rsum des proprits de l'Objet TextAttrs. Si les paramtres facultatifs ne sont pas transmis, la mthode dfinit le style de la plage de texte slectionne, ou de tout le champ de texte si aucun texte nest slectionn. Si seul le paramtre startIndex est transmis, la mthode dfinit les attributs de ce caractre. Si startIndex et endIndex sont transmis, la mthode dfinit les attributs de toute la plage de caractres comprise entre startIndex et le caractre prcdant endIndex. Si des styles de paragraphe sont spcifis, tous les paragraphes de la plage slectionne sont modifis. Exemple Les exemples suivants affectent les attributs de texte fillColor, italic et bold aux lments de texte slectionns :
var success = fl.getDocumentDOM().setElementTextAttr("fillColor", "#00ff00"); var pass = fl.getDocumentDOM().setElementTextAttr("italic", true, 10); var ok = fl.getDocumentDOM().setElementTextAttr("bold", true, 5, 15);

document.setFillColor()
Disponibilit Flash MX 2004. Utilisation
document.setFillColor(color)

Paramtres color Couleur du remplissage, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Si la valeur du paramtre est null, aucune couleur de remplissage nest dfinie, ce qui est lquivalent du choix de loption Pas de remplissage dans la palette des couleurs de remplissage. Valeur renvoye Aucune. Description Mthode qui modifie la couleur de remplissage de la slection avec la couleur spcifie. Pour plus d'informations sur la modification de la couleur de remplissage dans le panneau Outils et l'inspecteur Proprits, consultez la mthode document.setCustomFill().

EXTENSION DE FLASH CS4 PROFESSIONAL 148

Objet Document

Exemple Dans l'exemple suivant, les trois premires instructions dfinissent la couleur de remplissage laide des trois diffrents formats de dfinition de la couleur. La quatrime instruction annule le remplissage.
fl.getDocumentDOM().setFillColor("#cc00cc"); fl.getDocumentDOM().setFillColor(0xcc00cc); fl.getDocumentDOM().setFillColor(120000); fl.getDocumentDOM().setFillColor(null);

document.setFilterProperty()
Disponibilit Flash 8. Utilisation
document.setFilterProperty(property, filterIndex, value)

Paramtres property Chane spcifiant la proprit dfinir. Les valeurs gres sont "blurX", "blurY", "quality", "angle", "distance", "strength", "knockout", "inner", "bevelType", "color", "shadowColor" et "highlightColor".
filterIndex Nombre entier spcifiant lindex (en base 0) du filtre dans la liste Filtres. value Nombre ou chane spcifiant la valeur attribuer la proprit de filtre spcifie. Les valeurs acceptables dpendent de la proprit et du filtre dfinir.

Valeur renvoye Aucune. Description Mthode qui dfinit la proprit filter spcifie pour les objets slectionns (en supposant que l'objet prenne en charge le filtre spcifi). Exemple L'exemple suivant affecte la proprit quality la valeur 2 pour le second filtre (index 1) de la liste Filtres des objets slectionns, puis dfinit la proprit shadowColor du premier filtre de la liste Filtres sur les objets slectionns :
fl.getDocumentDOM().setFilterProperty("quality", 1, 2); fl.getDocumentDOM().setFilterProperty("shadowColor", 0, "#FF00FF");

Voir aussi
document.addFilter(), document.getFilters(), document.setBlendMode(), document.setFilters(),

Objet Filter

document.setFilters()
Disponibilit Flash 8.

EXTENSION DE FLASH CS4 PROFESSIONAL 149

Objet Document

Utilisation
document.setFilters(filterArray)

Paramtres
filterArray Tableau des filtres spcifis.

Valeur renvoye Aucune. Description Mthode qui applique des filtres aux objets slectionns. Utilisez cette mthode aprs avoir appel document.getFilters() et effectu toute modification requise dans les filtres. Exemple L'exemple suivant rcupre la liste des filtres appliqus lobjet slectionn et dfinit la proprit blurX de tous les filtres Blur sur 50 :
var myFilters = fl.getDocumentDOM().getFilters(); for (i=0; i < myFilters.length; i++) { if (myFilters[i].name == "blurFilter"){ myFilters[i].blurX = 50; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.addFilter(), document.getFilters(), document.setFilterProperty(), Objet Filter

document.setInstanceAlpha()
Disponibilit Flash MX 2004. Utilisation
document.setInstanceAlpha(opacity)

Paramtres opacity Nombre entier compris entre 0 (transparent) et 100 (opacit complte) qui dfinit la transparence de loccurrence. Valeur renvoye Aucune. Description Mthode qui dfinit lopacit de loccurrence.

EXTENSION DE FLASH CS4 PROFESSIONAL 150

Objet Document

Exemple Lexemple suivant dfinit lopacit de la teinte sur 50 :

fl.getDocumentDOM().setInstanceAlpha(50);

document.setInstanceBrightness()
Disponibilit Flash MX 2004. Utilisation
document.setInstanceBrightness(brightness)

Paramtres
brightness Nombre entier dfinissant la luminosit, avec une valeur comprise entre -100 (noir) et 100 (blanc).

Valeur renvoye Aucune. Description Mthode qui dfinit la luminosit de loccurrence. Exemple Lexemple suivant dfinit la luminosit de loccurrence sur 50 :
fl.getDocumentDOM().setInstanceBrightness(50);

document.setInstanceTint()
Disponibilit Flash MX 2004. Utilisation
document.setInstanceTint( color, strength )

Paramtres color Couleur de la teinte, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
strength Entier compris entre 0 et 100 qui dfinit lopacit de la teinte.

Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 151

Objet Document

Description Mthode qui dfinit la teinte de loccurrence. Exemple Lexemple suivant dfinit sur rouge la teinte de loccurrence slectionne, avec une opacit de 50 :
fl.getDocumentDOM().setInstanceTint(0xff0000, 50);

document.setMetadata()
Disponibilit Flash 8. Utilisation
document.setMetadata(strMetadata)

Paramtres
strMetadata Chane contenant les mtadonnes XML associes au document. Pour plus d'informations, consultez la description ci-dessous.

Valeur renvoye Valeur boolenne : true en cas de russite, false sinon. Description Mthode qui dfinit les mtadonnes XML du document spcifi, en remplacement des mtadonnes existantes. Avant dtre enregistr, le code XML transmis dans strMetadata fait lobjet dune validation et est susceptible dtre rcrit. Sil est impossible de les valider comme XML standard ou si elles enfreignent des rgles spcifiques, les mtadonnes XML ne sont pas appliques et la mthode renvoie false. (Si la valeur false est renvoye, il nest pas possible dobtenir plus dinformations sur lerreur.) Remarque : mme si la mthode renvoie true, il est possible que le code XML appliqu ne soit pas exactement identique la chane transmise. Pour extraire la valeur exacte du code XML, appelez document.getMetadata(). Les mtadonnes sont au format RDF qui est conforme la spcification XMP. Pour plus d'informations sur RDF et XMP, consultez les ressources suivantes :

Le guide RDF l'adresse www.w3.org/TR/rdf-primer/ La spcification RDF l'adresse www.w3.org/TR/1999/REC-rdf-syntax-19990222/ La page d'accueil de XMP l'adresse www.adobe.com/products/xmp/
Exemple Les exemples suivants illustrent diverses mthodes autorises de reprsentation de donnes identiques. Dans tous les cas de figure, l'exception du deuxime, si les donnes taient transmises Document.setMetadata(), elles ne seraient pas rcrites (mis part la suppression des sauts de ligne). Dans le premier exemple, les mtadonnes sont imbriques dans les balises, les diffrents schmas tant placs dans des balises rdf:Description distinctes :

EXTENSION DE FLASH CS4 PROFESSIONAL 152

Objet Document

<rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'> <rdf:Description rdf:about='' xmlns:dc='http://purl.org/dc/1.1/'> <dc:title>Simple title</dc:title> <dc:description>Simple description</dc:description> </rdf:Description> <rdf:Description rdf:about='' xmlns:xmp='http://ns.adobe.com/xap/1.0/'> <xmp:CreateDate>2004-10-12T10:29-07:00</xmp:CreateDate> <xmp:CreatorTool>Flash Authoring WIN 8,0,0,215</xmp:CreatorTool> </rdf:Description> </rdf:RDF>

Dans le deuxime exemple, les mtadonnes sont imbriques dans les balises, mais tous les schmas sont regroups dans la balise rdf:Description. Cet exemple comprend galement des commentaires, qui ne seront pas pris en compte et seront ignors par Document.setMetadata() :
<rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'> <!-- This is before the first rdf:Description tag --> <rdf:Description rdf:about='' xmlns:dc='http://purl.org/dc/1.1/'> <dc:title>Simple title</dc:title> <dc:description>Simple description</dc:description> </rdf:Description> <!-- This is between the two rdf:Description tags --> <rdf:Description rdf:about='' xmlns:xmp='http://ns.adobe.com/xap/1.0/'> <xmp:CreateDate>2004-10-12T10:29-07:00</xmp:CreateDate> <xmp:CreatorTool>Flash Authoring WIN 8,0,0,215</xmp:CreatorTool> </rdf:Description> <!-- This is after the second rdf:Description tag --> </rdf:RDF>

Dans le troisime exemple, les mtadonnes sont imbriques dans des attributs et tous les schmas sont regroups dans une balise rdf:Description :
<rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'> <rdf:Description rdf:about='' xmlns:dc='http://purl.org/dc/1.1/' dc:title='Simple title' dc:description='Simple description' /> <rdf:Description rdf:about='' xmlns:xmp='http://ns.adobe.com/xap/1.0/' xmp:CreateDate='2004-10-12T10:29-07:00' xmp:CreatorTool='Flash Authoring WIN 8,0,0,215' /> </rdf:RDF>

Voir aussi
document.getMetadata()

document.setMobileSettings()
Disponibilit Flash CS3 Professional. Utilisation
document.setMobileSettings(xmlString)

Paramtres
xmlString Chane dcrivant les paramtres XML dans un fichier FLA mobile.

EXTENSION DE FLASH CS4 PROFESSIONAL 153

Objet Document

Valeur renvoye Valeur true si les paramtres ont t correctement dfinis, false dans le cas contraire. Description Mthode qui dfinit la valeur d'une chane de paramtres XML dans un fichier FLA mobile. (La plupart des fichiers FLA mobiles sont pourvus d'une chane XML servant dcrire les paramtres dans le document.) Exemple L'exemple suivant dfinit la chane de paramtres XML pour un fichier FLA mobile. Vous remarquerez que l'exemple ci-dessous reprsente une seule ligne de code.
fl.getDocumentDOM().setMobileSettings("<? xml version="1.0" encoding="UTF-16" standalone="no" ?> <mobileSettings> <contentType id="standalonePlayer" name="Standalone Player"/> <testDevices> <testDevice id="1170" name="Generic Phone" selected="yes"/> </testDevices> <outputMsgFiltering info="no" trace="yes" warning="yes"/> <testWindowState height="496" splitterClosed="No" splitterXPos="400" width="907"/> </mobileSettings>");

Voir aussi
document.getMobileSettings()

document.setOvalObjectProperty()
Disponibilit Flash CS3 Professional. Utilisation
document.setOvalObjectProperty(propertyName, value)

Paramtres
propertyName Chane prcisant la proprit dfinir. La liste des valeurs possibles est indique dans le tableau

Rsum des proprits de l'Objet Oval.

value Valeur affecter la proprit. Les valeurs gres varient en fonction de la proprit que vous spcifiez dans propertyName.

Valeur renvoye Aucune. Description Mthode qui dfinit une valeur pour une proprit spcifie des objets Oval de type primitif. Exemple Reportez-vous aux proprits individuelles de l'Objet Oval pour les exemples. Voir aussi Objet Oval, shape.isOvalObject

EXTENSION DE FLASH CS4 PROFESSIONAL 154

Objet Document

document.setPlayerVersion()
Disponibilit Flash CS3 Professional. Utilisation
document.setPlayerVersion(version)

Paramtres version Chane reprsentant la version de Flash Player cible par le document spcifi. Les valeurs possibles sont "FlashLite", "FlashLite11", "FlashLite20", "FlashLite30", "1", "2", "3", "4", "5", "6", "7", "8", "9", "FlashPlayer10" et "AdobeAIR1_1". Valeur renvoye Valeur true si la version du lecteur a t correctement dfinie, false dans le cas contraire. Description Mthode qui dfinit la version de Flash Player cible par le document spcifi. Il s'agit de la mme valeur que celle qui a t dfinie dans la bote de dialogue Paramtres de publication. Exemple L'exemple suivant cible Flash Player 6 comme version de lecteur pour le document actif :
fl.getDocumentDOM().setPlayerVersion("6");

Voir aussi
document.getPlayerVersion()

document.setRectangleObjectProperty()
Disponibilit Flash CS3 Professional. Utilisation
document.setRectangleObjectProperty(propertyName, value)

Paramtres
propertyName Chane prcisant la proprit dfinir. Les valeurs possibles sont indiques dans le tableau Rsum

des proprits de l'Objet Rectangle.

value Valeur affecter la proprit. Les valeurs gres varient en fonction de la proprit que vous spcifiez dans

propertyName. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 155

Objet Document

Description Mthode qui spcifie une valeur pour une proprit spcifie des objets Rectangle de type primitif. Exemple Reportez-vous aux proprits individuelles de l'Objet Rectangle pour les exemples. Voir aussi Objet Rectangle, shape.isRectangleObject

document.setSelectionBounds()
Disponibilit Flash MX 2004 ; paramtre bContactSensitiveSelection intgr Flash 8. Utilisation
document.setSelectionBounds(boundingRectangle [, bContactSensitiveSelection])

Paramtres
boundingRectangle Rectangle dlimitant le nouvel emplacement et la nouvelle taille de la slection. Pour plus

d'informations sur le format de boundingRectangle, consultez la mthode document.addNewRectangle().

bContactSensitiveSelection Une valeur boolenne indiquant si le mode de slection Activer au contact est activ

(true) ou non (false) lors de la slection d'un objet. La valeur par dfaut est false. Valeur renvoye Aucune. Description Mthode qui dplace et redimensionne la slection en une seule opration. Si une valeur est transmise pour bContactSensitiveSelection, elle n'est valide que pour cette mthode et n'affecte pas le mode de slection Activer au contact du document (voir fl.contactSensitiveSelection). Exemple L'exemple suivant dplace la slection aux coordonnes 10, 20 et la redimensionne 100 sur 200 pixels :
var l = 10; var t = 20; fl.getDocumentDOM().setSelectionBounds({left:l, top:t, right:(100+l), bottom:(200+t)});

Voir aussi
document.selection, document.setSelectionRect()

EXTENSION DE FLASH CS4 PROFESSIONAL 156

Objet Document

document.setSelectionRect()
Disponibilit Flash MX 2004 ; paramtre bContactSensitiveSelection intgr Flash 8. Utilisation
document.setSelectionRect(rect [, bReplaceCurrentSelection [, bContactSensitiveSelection]])

Paramtres rect Objet rectangle dfinir comme slectionn. Pour plus d'informations sur le format de rect, voir document.addNewRectangle().
bReplaceCurrentSelection Valeur boolenne qui indique si la mthode remplace la slection actuelle (true) ou

ajoute l'lment cette dernire (false). La valeur par dfaut est true.
bContactSensitiveSelection Une valeur boolenne indiquant si le mode de slection Activer au contact est activ

(true) ou non (false) lors de la slection d'un objet. La valeur par dfaut est false. Valeur renvoye Aucune. Description Mthode qui trace un cadre de slection rectangulaire sur la scne, partir des coordonnes spcifies. Cette opration est diffrente de document.getSelectionRect(), avec laquelle lemplacement du rectangle est relatif lobjet en cours de modification. Cette mthode revient faire glisser un rectangle l'aide de loutil Slection. Pour tre slectionne, une occurrence doit tre entirement enferme dans ce rectangle. Si une valeur est transmise pour bContactSensitiveSelection, elle n'est valide que pour cette mthode et n'affecte pas le mode de slection Activer au contact du document (voir fl.contactSensitiveSelection). Remarque : la rptition de setSelectionRect() laide du panneau ou de llment de menu Historique rpte l'tape qui prcde lopration setSelectionRect(). Exemple Dans l'exemple suivant, la seconde slection remplace la premire :
fl.getDocumentDOM().setSelectionRect({left:1, top:1, right:200, bottom:200}); fl.getDocumentDOM().setSelectionRect({left:364.0, top:203.0, right:508.0, bottom:434.0}, true);

Dans l'exemple suivant, la seconde slection est ajoute la premire. Cette opration est identique un appui maintenu sur la touche Maj tout en slectionnant un second objet.
fl.getDocumentDOM().setSelectionRect({left:1, top:1, right:200, bottom:200}); fl.getDocumentDOM().setSelectionRect({left:364.0, top:203.0, right:508.0, bottom:434.0}, false);

Voir aussi
document.getSelectionRect(), document.selection, document.setSelectionBounds()

EXTENSION DE FLASH CS4 PROFESSIONAL 157

Objet Document

document.setStageVanishingPoint()
Disponibilit Flash CS4 Professional. Utilisation
document.setStageVanishingPoint(point)

Paramtres point Point qui spcifie les coordonnes x et y de l'emplacement auquel doit tre dfini le point de fuite pour l'affichage des objets 3D. Valeur renvoye Aucune. Description Spcifie le point de fuite pour l'affichage des objets 3D. Exemple L'exemple suivant dfinit le point de fuite de la scne :
fl.getDocumentDOM().setStageVanishingPoint({x:45, y:45});

document.setStageViewAngle()
Disponibilit Flash CS4 Professional. Utilisation
document.setStageViewAngle(angle)

Paramtres angle Valeur en virgule flottante comprise entre 0.0 et 179.0. Valeur renvoye Aucune. Description Spcifie l'angle de perspective pour l'affichage des objets 3D. Exemple L'exemple suivant dfinit l'angle de perspective de la scne sur 70 :
fl.getDocumentDOM().setStageViewAngle(70);

EXTENSION DE FLASH CS4 PROFESSIONAL 158

Objet Document

document.setStroke()
Disponibilit Flash MX 2004. Utilisation
document.setStroke(color, size, strokeType)

Paramtres color Couleur du trait, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
size Valeur en virgule flottante spcifiant la nouvelle taille du trait de la slection. strokeType Chane spcifiant le nouveau type du trait de la slection. Les valeurs possibles sont : "hairline" (filet), "solid" (uni), "dashed" (discontinu), "dotted" (pointill), "ragged" (irrgulier), "stipple" (pointill fin) et "hatched" (hachur).

Valeur renvoye Aucune. Description Mthode qui dfinit la couleur, la largeur et le style du trait slectionn. Pour plus d'informations sur la modification du trait dans le panneau Outils ou dans l'inspecteur Proprits, consultez la mthode document.setCustomStroke(). Exemple L'exemple suivant modifie le trait en lui donnant la couleur rouge, une taille de 3,25 et le type pointill :
fl.getDocumentDOM().setStroke("#ff0000", 3.25, "dashed");

document.setStrokeColor()
Disponibilit Flash MX 2004. Utilisation
document.setStrokeColor(color)

Paramtres color Couleur du trait, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal

EXTENSION DE FLASH CS4 PROFESSIONAL 159

Objet Document

Valeur renvoye Aucune. Description Mthode qui modifie la couleur du trait de la slection avec la couleur spcifie. Pour plus d'informations sur la modification du trait dans le panneau Outils ou dans l'inspecteur Proprits, consultez la mthode document.setCustomStroke(). Exemple Dans l'exemple suivant, les trois instructions dfinissent la couleur du trait laide des trois diffrents formats de dfinition de la couleur.
fl.getDocumentDOM().setStrokeColor("#cc00cc"); fl.getDocumentDOM().setStrokeColor(0xcc00cc); fl.getDocumentDOM().setStrokeColor(120000);

document.setStrokeSize()
Disponibilit Flash MX 2004. Utilisation
document.setStrokeSize(size)

Paramtres size Valeur en virgule flottante comprise entre 0,25 et 10 qui dtermine la taille du trait. La mthode ignore toute prcision suprieure deux dcimales. Valeur renvoye Aucune. Description Mthode qui modifie la taille de trait de la slection avec la taille spcifie. Pour plus d'informations sur la modification du trait dans le panneau Outils ou dans l'inspecteur Proprits, consultez la mthode document.setCustomStroke(). Exemple L'exemple suivant dfinit sur 5 points la taille du trait de la slection :
fl.getDocumentDOM().setStrokeSize(5);

document.setStrokeStyle()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 160

Objet Document

Utilisation
document.setStrokeStyle(strokeType)

Paramtres
strokeType Chane spcifiant le style du trait de la slection. Les valeurs possibles sont : "hairline" (filet), "solid" (uni), "dashed" (discontinu), "dotted" (pointill), "ragged" (irrgulier), "stipple" (pointill fin) et "hatched" (hachur).

Valeur renvoye Aucune. Description Mthode qui modifie le style du trait de la slection avec le style spcifi. Pour plus d'informations sur la modification du trait dans le panneau Outils ou dans l'inspecteur Proprits, consultez la mthode document.setCustomStroke(). Exemple L'exemple suivant dfinit un style de trait discontinu ("dashed") pour la slection :
fl.getDocumentDOM().setStrokeStyle("dashed");

document.setTextRectangle()
Disponibilit Flash MX 2004. Utilisation
document.setTextRectangle(boundingRectangle)

Paramtres
boundingRectangle Rectangle qui spcifie la nouvelle taille dans laquelle llment texte doit sinsrer. Pour plus

d'informations sur le format de boundingRectangle, consultez document.addNewRectangle(). Valeur renvoye Valeur boolenne, true si la taille dau moins un champ de texte est modifie, false dans le cas contraire. Description Mthode qui modifie le rectangle de dlimitation de llment texte slectionn en lui donnant la taille spcifie. Cette mthode provoque un reformatage du texte dans le nouveau rectangle ; llment texte nest ni mis lchelle ni transform. Les valeurs transmises dans boundingRectangle sont utilises comme suit :

Si le texte est horizontal et statique, la mthode ne prend en compte que la largeur transmise dans
boundingRectangle. La hauteur est automatiquement calcule pour inclure la totalit du texte.

Si le texte est vertical, donc statique, la mthode ne prend en compte que la hauteur transmise dans
boundingRectangle. La largeur est automatiquement calcule pour inclure la totalit du texte.

EXTENSION DE FLASH CS4 PROFESSIONAL 161

Objet Document

Si le texte est dynamique ou saisi, la mthode prend en compte la largeur et la hauteur transmises dans
boundingRectangle, et la taille du rectangle gnr risque d'tre suprieure la taille requise par le texte. Cependant, si les paramtres spcifient une taille trop rduite pour le texte, la mthode ne prend en compte que la largeur transmise dans boundingRectangle, la hauteur tant automatiquement calcule pour inclure la totalit du texte. Exemple L'exemple suivant adapte la taille du rectangle de dlimitation de texte aux dimensions spcifies :
fl.getDocumentDOM().setTextRectangle({left:0, top:0, right:50, bottom:200})

document.setTextSelection()
Disponibilit Flash MX 2004. Utilisation
document.setTextSelection(startIndex, endIndex)

Paramtres
startIndex Nombre entier spcifiant la position du premier caractre slectionner. La position du premier

caractre est zro.

endIndex Nombre entier spcifiant la position du dernier caractre de la slection, endIndex non compris. La position

du premier caractre est zro. Valeur renvoye Valeur boolenne, true si la mthode dfinit bien la slection du texte, false dans le cas contraire. Description Mthode qui dfinit la slection de texte du champ de texte slectionn avec les valeurs spcifies dans startIndex et endIndex. Le mode de modification de texte est activ sil ne ltait pas dj. Exemple L'exemple suivant slectionne le texte du 6e au 25e caractre :
fl.document.setTextSelection(5, 25);

document.setTextString()
Disponibilit Flash MX 2004. Utilisation
document.setTextString(text [, startIndex [, endIndex]])

EXTENSION DE FLASH CS4 PROFESSIONAL 162

Objet Document

Paramtres text Chane de caractres insrer dans le champ de texte.

startIndex Entier qui spcifie le premier caractre remplacer. La position du premier caractre est zro. Ce

paramtre est facultatif.

endIndex Nombre entier spcifiant la position du dernier caractre remplacer. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne, true si le texte dau moins une chane de texte est modifi, false dans le cas contraire. Description Mthode qui insre une chane de texte. Si les paramtres facultatifs ne sont pas transmis, la mthode remplace la slection de texte existante. Si lobjet Text nest pas en cours de modification, toute la chane de texte est remplace. Si seul le paramtre startIndex est transmis, la chane transmise est insre cette position. Si startIndex et endIndex sont transmis, la chane transmise remplace le segment de texte compris entre startIndex et le caractre prcdant endIndex. Exemple L'exemple suivant remplace la slection de texte actuelle par la chane Hello World :
var success = fl.getDocumentDOM().setTextString("Hello World!");

L'exemple suivant insre hello la position 6 de la slection de texte actuelle :

var pass = fl.getDocumentDOM().setTextString("hello", 6);

L'exemple suivant insre Howdy entre la position 2 et la position 7 (non comprise) de la slection de texte actuelle :
var ok = fl.getDocumentDOM().setTextString("Howdy", 2, 7);

Voir aussi
document.getTextString()

document.setTransformationPoint()
Disponibilit Flash MX 2004. Utilisation
document.setTransformationPoint( transformationPoint )

Paramtres
transformationPoint Point (par exemple, {x:10,y:20}, o x et y sont des nombres virgule flottante) spcifiant des valeurs pour le point de transformation de chacun des lments suivants :

Formes : transformationPoint est dfini par rapport au document (0,0 est le coin suprieur gauche de la scne). Symboles : transformationPoint est dfini par rapport au point d'alignement du symbole (0,0 est situ au point
d'alignement).

Texte : transformationPoint est dfini par rapport au champ de texte (0,0 est le coin suprieur gauche du champ de
texte).

EXTENSION DE FLASH CS4 PROFESSIONAL 163

Objet Document

Bitmaps/vidos : transformationPoint est dfini par rapport l'image bitmap ou la vido (0,0 est le coin suprieur
gauche de l'image bitmap ou de la vido).

Objets de dessin, ovales et rectangles de type primitif, groupes : transformationPoint est dfini par rapport au
document (0,0 tant le coin suprieur gauche de la scne). Pour dfinir transformationPoint par rapport au point central de l'objet, de la primitive ou du groupe, utilisez la mthode element.setTransformationPoint(). Valeur renvoye Aucune. Description Mthode qui dfinit la position du point de transformation de la slection actuelle. Exemple L'exemple suivant dfinit lemplacement du point de transformation de la slection sur les coordonnes 100, 200 :
fl.getDocumentDOM().setTransformationPoint({x:100, y:200});

Voir aussi
document.getTransformationPoint(), element.setTransformationPoint()

document.silent
Disponibilit Flash MX 2004. Utilisation
document.silent

Description Proprit ; valeur boolenne indiquant si lobjet est accessible. Cette proprit est quivalente linverse du paramtre Rendre l'animation accessible du panneau Accessibilit. Ainsi, si document.silent est true, son effet est similaire la dsactivation de loption Rendre l'animation accessible. Si le paramtre est false, son effet est similaire lactivation de loption Rendre lanimation accessible. Exemple L'exemple suivant dfinit la valeur de la variable isSilent sur la valeur de la proprit silent :
var isSilent = fl.getDocumentDOM().silent;

L'exemple suivant dfinit la proprit silent sur false indiquant ainsi que le document est accessible :
fl.getDocumentDOM().silent = false;

document.skewSelection()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 164

Objet Document

Utilisation
document.skewSelection(xSkew, ySkew [, whichEdge])

Paramtres xSkew Valeur en virgule flottante spcifiant la valeur x dinclinaison, exprime en degrs.
ySkew Valeur en virgule flottante spcifiant la valeur y dinclinaison, exprime en degrs. whichEdge Chane indiquant le ct sur lequel la transformation doit tre applique. Si ce paramtre est omis,

linclinaison est applique au niveau du point de transformation. Les valeurs gres sont "top center" (centre haut),
"right center" (centre droite), "bottom center" (centre bas) et "left center" (centre gauche). Ce paramtre

est facultatif. Valeur renvoye Aucune. Description Mthode qui effectue sur la slection une inclinaison de la valeur spcifie. Leffet est identique celui de loutil Transformation libre utilis pour incliner lobjet. Exemple Les exemples suivants inclinent l'objet slectionn de 2 verticalement et de 1,5 horizontalement. Le second exemple transforme lobjet sur le bord centre haut :
fl.getDocumentDOM().skewSelection(2.0, 1.5); fl.getDocumentDOM().skewSelection(2.0, 1.5, "top center");

document.smoothSelection()
Disponibilit Flash MX 2004. Utilisation
document.smoothSelection()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui lisse la courbe de chaque contour de remplissage ou segment incurv slectionn. Cette mthode effectue la mme opration que le bouton Lisser dans le panneau Outils. Exemple L'exemple suivant lisse la courbe de la slection :
fl.getDocumentDOM().smoothSelection();

EXTENSION DE FLASH CS4 PROFESSIONAL 165

Objet Document

document.sourcePath
Disponibilit Flash CS4 Professional. Utilisation
document.sourcePath

Description Proprit ; chane qui contient la liste des lments du chemin source ActionScript 3.0 du document, spcifiant l'emplacement des fichiers de classe ActionScript. Les lments de la chane sont dlimits par des points-virgules. Dans l'outil de programmation, les lments sont spcifis en slectionnant Fichier > Paramtres de publication, puis en cliquant sur le bouton Paramtres de Script ActionScript 3.0 dans l'onglet Flash. Exemple L'exemple suivant ajoute le dossier /Class files dans le chemin source du document :
var myDoc = fl.getDocumentDOM(); fl.trace(myDoc.sourcePath); myDoc.sourcePath = "./Class files;" + myDoc.sourcePath; fl.trace(myDoc.sourcePath);

Voir aussi
document.externalLibraryPath,document.libraryPath, fl.sourcePath

document.space()
Disponibilit Flash MX 2004. Utilisation
document.space(direction [, bUseDocumentBounds])

Paramtres
direction Chane spcifiant la direction dans laquelle doivent tre espacs les objets de la slection. Les valeurs

gres sont "horizontal" ou "vertical".

bUseDocumentBounds Valeur boolenne. Si elle est true, la mthode espace les objets sur les limites du document. Sinon, la mthode utilise les limites des objets slectionns. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui espace rgulirement les objets slectionns.

EXTENSION DE FLASH CS4 PROFESSIONAL 166

Objet Document

Exemple L'exemple suivant espace les objets horizontalement par rapport aux limites de la scne :
fl.getDocumentDOM().space("horizontal",true);

Lexemple suivant espace les objets entre eux sur le plan horizontal :
fl.getDocumentDOM().space("horizontal");

Lexemple suivant espace les objets horizontalement les uns par rapport aux autres, mais avec bUseDcoumentBounds dfini explicitement sur false :
fl.getDocumentDOM().space("horizontal",false);

Voir aussi
document.getAlignToDocument(), document.setAlignToDocument()

document.straightenSelection()
Disponibilit Flash MX 2004. Utilisation
document.straightenSelection()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui redresse les traits slectionns. Cette mthode est l'quivalent du bouton Redresser du panneau Outils. Exemple L'exemple suivant redresse la courbe de la slection :
fl.getDocumentDOM().straightenSelection();

document.swapElement()
Disponibilit Flash MX 2004. Utilisation
document.swapElement(name)

EXTENSION DE FLASH CS4 PROFESSIONAL 167

Objet Document

Paramtres name Chane spcifiant le nom de llment de bibliothque utiliser. Valeur renvoye Aucune. Description Mthode qui intervertit la slection actuelle avec la slection spcifie. La slection doit contenir un graphisme, un bouton, un clip, une vido ou un bitmap. S'il n'existe pas de slection ou si l'objet indiqu est introuvable, un message derreur s'affiche. Exemple L'exemple suivant intervertit la slection avec lobjet Symbol 1 de la bibliothque :
fl.getDocumentDOM().swapElement('Symbol 1');

document.swapStrokeAndFill()
Disponibilit Flash 8. Utilisation
document.swapStrokeAndFill()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui permute les couleurs du contour et du remplissage. Exemple L'exemple suivant permute les couleurs du contour et du remplissage dans le document actuel :
fl.getDocumentDOM().swapStrokeAndFill();

document.synchronizeWithHeadVersion()
Disponibilit Flash CS3 Professional. Utilisation
fldocument.getDocumentDOMsynchronizeWithHeadVersion().swapStrokeAndFill();

EXTENSION DE FLASH CS4 PROFESSIONAL 168

Objet Document

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si la synchronisation du fichier spcifi s'est droule correctement sur le serveur Version Cue, sinon false. Description Mthode qui synchronise le document spcifi avec la version la plus rcente trouve sur le serveur Version Cue et consigne les ventuelles erreurs dans le panneau Sortie. Cette mthode fonctionne uniquement avec les documents actuellement ouverts. Pour rcuprer la version la plus rcente d'un fichier qui n'est pas ouvert actuellement, utilisez fl.downloadLatestVersion(). Exemple Lexemple suivant synchronise le document actif avec la version stocke sur le serveur Version Cue :
fl.getDocumentDOM().synchronizeWithHeadVersion();

Voir aussi
document.canSaveAVersion(), fl.downloadLatestVersion(), document.revertToLastVersion(), document.saveAVersion(), fl.synchronizeDocumentWithHeadVersion()

document.testMovie()
Disponibilit Flash MX 2004. Utilisation
document.testMovie()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui excute une opration de test de l'animation sur le document. Exemple L'exemple suivant teste lanimation du document actif :
fl.getDocumentDOM().testMovie();

Voir aussi
document.canTestMovie(), document.testScene()

EXTENSION DE FLASH CS4 PROFESSIONAL 169

Objet Document

document.testScene()
Disponibilit Flash MX 2004. Utilisation
document.testScene()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui excute une opration Tester la squence sur la squence active dans le document. Exemple L'exemple suivant teste la squence active du document :
fl.getDocumentDOM().testScene();

Voir aussi
document.canTestScene(), document.testMovie()

document.timelines
Disponibilit Flash MX 2004. Utilisation
document.timelines

Description Proprit en lecture seule ; tableau des objets Timeline (voir Objet Timeline). Exemple L'exemple suivant rcupre le tableau des scnarios du document actif et affiche leurs noms dans le panneau Sortie :
var i = 0; var curTimelines = fl.getDocumentDOM().timelines; while(i < fl.getDocumentDOM().timelines.length){ alert(curTimelines[i].name); ++i; }

EXTENSION DE FLASH CS4 PROFESSIONAL 170

Objet Document

Voir aussi
document.currentTimeline, document.getTimeline()

document.traceBitmap()
Disponibilit Flash MX 2004. Utilisation
document.traceBitmap(threshold, minimumArea, curveFit, cornerThreshold)

Paramtres
threshold Nombre entier limitant le nombre de couleurs du bitmap faisant lobjet du trac. Les valeurs gres sont

des entiers compris entre 0 et 500.

minimumArea Nombre entier spcifiant le rayon, indiqu en pixels. Les valeurs gres sont des entiers compris entre

1 et 1000.
curveFit Chane spcifiant le niveau de lissage des contours. Les valeurs gres sont "pixels", "very tight" (trs serr), "tight" (serr), "normal", "smooth" (lisse) et "very smooth" (trs lisse). cornerThreshold Chane dont leffet est similaire celui de curveFit, mais concernant les angles de limage bitmap.

Les valeurs gres sont "many corners" (nombreux angles), "normal" et "few corners" (peu d'angles). Valeur renvoye Aucune. Description Mthode qui effectue une opration de trac de bitmap sur la slection en cours. Cette mthode est lquivalent de loption de menu Modification > Bitmap > Tracer le bitmap. Exemple L'exemple suivant trace le bitmap slectionn sur la base des paramtres spcifis :
fl.getDocumentDOM().traceBitmap(0, 500, 'normal', 'normal');

document.translate3DCenter()
Disponibilit Flash CS4 Professional. Utilisation
document.translate3DCenter(xyzCoordinate)

Paramtres
xyzCoordinate Coordonnes XYZ dfinissant le point central d'une translation ou d'une rotation 3D.

EXTENSION DE FLASH CS4 PROFESSIONAL 171

Objet Document

Valeur renvoye Aucune. Description Mthode qui dfinit la position XYZ autour de laquelle est effectue la translation ou la rotation de la slection. Cette mthode n'est disponible que pour les clips. Exemple L'exemple suivant spcifie les axes XYZ d'une translation 3D :
fl.getDocumentDOM().translate3DCenter({x:180, y:18,z:-30});

document.translate3DSelection()
Disponibilit Flash CS4 Professional. Utilisation
document.translate3DSelection(xyzCoordinate, bGlobalTransform)

Paramtres
xyzCoordinate Coordonnes XYZ qui spcifient les axes d'une translation 3D. bGlobalTransform Valeur boolenne qui spcifie si le mode de transformation doit tre global (true) ou local

(false). Valeur renvoye Aucune. Description Mthode qui applique une translation 3D la slection. Cette mthode n'est disponible que pour les clips. Exemple Dans l'exemple suivant, une translation est d'abord applique la slection par rapport la scne (globalement), puis par rapport elle-mme (localement).
var myDocument = fl.getDocumentDOM(); myDocument.translate3DSelection({x:52.0, y:0, z:0}, true); myDocument.translate3DSelection({x:52.0, y:0, z:-55.2}, false);

Voir aussi document.translate3DCenter()

EXTENSION DE FLASH CS4 PROFESSIONAL 172

Objet Document

document.transformSelection()
Disponibilit Flash MX 2004. Utilisation
document.transformSelection(a, b, c, d)

Paramtres a Nombre en virgule flottante spcifiant llment (0,0) de la matrice de transformation.

b Nombre en virgule flottante spcifiant llment (0,1) de la matrice de transformation. c Nombre en virgule flottante spcifiant llment (1,0) de la matrice de transformation. d Nombre en virgule flottante spcifiant llment (1,1) de la matrice de transformation.

Valeur renvoye Aucune. Description Mthode qui effectue une transformation gnrale de la slection, en appliquant la matrice spcifie dans les arguments. Pour plus d'informations, consultez la proprit element.matrix. Exemple L'exemple suivant tire la slection dun facteur 2 dans la direction x :
fl.getDocumentDOM().transformSelection(2.0, 0.0, 0.0, 1.0);

document.unGroup()
Disponibilit Flash MX 2004. Utilisation
document.unGroup()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui dissocie la slection. Exemple L'exemple suivant dissocie les lments de la slection :

EXTENSION DE FLASH CS4 PROFESSIONAL 173

Objet Document

fl.getDocumentDOM().unGroup();

Voir aussi
document.group()

document.union()
Disponibilit Flash 8. Utilisation
document.union()

Paramtres Aucun. Valeur renvoye Valeur boolenne : true en cas de russite, false sinon. Description Mthode qui combine toutes les formes slectionnes dans un objet de dessin. Exemple L'exemple suivant combine toutes les formes slectionnes dans un objet de dessin :
fl.getDocumentDOM().union();

Voir aussi
document.crop(), document.deleteEnvelope(), document.intersect(), document.punch(), shape.isDrawingObject

document.unlockAllElements()
Disponibilit Flash MX 2004. Utilisation
document.unlockAllElements()

Paramtres Aucun. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 174

Objet Document

Description Mthode qui dverrouille tous les lments verrouills dans limage slectionne. Exemple L'exemple suivant dverrouille tous les lments verrouills dans limage active :
fl.getDocumentDOM().unlockAllElements();

Voir aussi
element.locked

document.viewMatrix
Disponibilit Flash MX 2004. Utilisation
document.viewMatrix

Description Proprit en lecture seule ; objet Matrix. La proprit viewMatrix permet de passer de l'espace de l'objet l'espace du document lorsque ce dernier est en mode de modification. Les coordonnes de la souris, telles qu'elles sont reues par un outil, sont relatives l'objet en cours de modification. Voir Objet Matrix. Par exemple, si vous crez un symbole, double-cliquez sur son entre pour le modifier et dessinez laide de loutil Polygone, le point (0,0) se trouve sur le point d'alignement du symbole. Toutefois, lobjet drawingLayer attend des valeurs situes dans lespace du document. Donc, si vous tracez une ligne partir des coordonnes (0,0) avec drawingLayer, ces coordonnes seront relatives au coin suprieur gauche de la scne. La proprit viewMatrix permet de passer de l'espace de l'objet modifi l'espace du document. Exemple L'exemple suivant rcupre la valeur de la proprit viewMatrix :
var mat = fl.getDocumentDOM().viewMatrix;

document.width
Disponibilit Flash MX 2004. Utilisation
document.width

Description Proprit ; nombre entier indiquant la largeur en pixels du document (scne).

EXTENSION DE FLASH CS4 PROFESSIONAL 175

Objet Document

Exemple Lexemple suivant dfinit la largeur de la scne sur 400 pixels.

fl.getDocumentDOM().width= 400;

Voir aussi
document.height

document.xmlPanel()
Disponibilit Flash MX 2004. Utilisation
document.xmlPanel(fileURI)

Paramtres fileURI Chane de type fichier:///URI qui spcifie le chemin daccs du fichier XML dfinissant les contrles apparaissant dans le panneau. Le chemin complet est ncessaire. Valeur renvoye Un objet dont les proprits sont dfinies pour tous les contrles dfinis dans le fichier XML. Toutes les proprits sont renvoyes sous forme de chanes. Lobjet renvoy comporte une proprit prdfinie appele "dismiss" qui possde la valeur de chane "accept" ou "cancel". Description Mthode qui transmet une bote de dialogue XMLUI. Voir fl.xmlui. Exemple L'exemple suivant charge le fichier Test.xml et affiche chacune de ses proprits :
var obj = fl.getDocumentDOM().xmlPanel(fl.configURI + "Commands/Test.xml"); for (var prop in obj) { fl.trace("property " + prop + " = " + obj[prop]); }

document.zoomFactor
Disponibilit Flash 8. Utilisation
document.zoomFactor

EXTENSION DE FLASH CS4 PROFESSIONAL 176

Objet Document

Description Proprit qui spcifie le pourcentage de zoom de la scne lors de la programmation. Une valeur de 1 quivaut un zoom de 100 %, 8 800 %, 0.5 50 %, etc. Exemple Lexemple suivant dfinit le facteur de zoom de la scne sur 200 %.
fl.getDocumentDOM().zoomFactor = 2;

177

Chapitre 12 : Objet drawingLayer

Disponibilit Flash MX 2004. Description Lobjet drawingLayer est accessible en JavaScript sous forme dun enfant de lobjet flash. Lobjet drawingLayer est employ par les outils extensibles lorsque lutilisateur dessine un trac temporaire laide de la souris, par exemple pour crer un cadre de slection. Il est conseill dappeler drawingLayer.beginFrame() avant dappeler toute autre mthode de drawingLayer. Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet drawingLayer :
Mthode
drawingLayer.beginDraw() drawingLayer.beginFrame()

Description Active le mode Dessin de Flash. Efface ce qui a t dessin prcdemment avec drawingLayer et prpare le programme pour dautres commandes de dessin. Dessine une courbe cubique partir de lemplacement actuel du curseur, en utilisant les paramtres comme coordonnes du segment cubique. Dessine un segment de courbe quadratique commenant lemplacement actuel du curseur et se terminant au point spcifi. Dessine le trac spcifi. Dsactive le mode Dessin. Signale la fin dun groupe de commandes de dessin. Dessine une ligne partir de la position du curseur et jusquau point (x,y). Dfinit la position de dessin actuelle. Renvoie un nouvel Objet Path. Dfinit la couleur des prochains dessins. Cette mthode n'est pas disponible. Cette mthode n'est pas disponible.

drawingLayer.cubicCurveTo()

drawingLayer.curveTo()

drawingLayer.drawPath() drawingLayer.endDraw() drawingLayer.endFrame() drawingLayer.lineTo() drawingLayer.moveTo() drawingLayer.newPath() drawingLayer.setColor() drawingLayer.setFill() drawingLayer.setStroke()

drawingLayer.beginDraw()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.beginDraw([persistentDraw])

EXTENSION DE FLASH CS4 PROFESSIONAL 178

Objet drawingLayer

Paramtres
persistentDraw Valeur boolenne (facultative) Si sa valeur est true, elle indique que le dessin dans le dernier cadre reste sur la scne jusquau prochain appel de beginDraw() ou beginFrame(). (Dans ce contexte, cadre fait rfrence lespace du dessin, pas aux images dans le scnario.) Par exemple, lorsque lutilisateur trace un rectangle, il peut avoir un aperu du contour de cette forme pendant quil dplace sa souris. Si vous souhaitez que ce contour reste visible lorsque lutilisateur relche le bouton de sa souris, donnez au paramtre persistentDraw la valeur true.

Valeur renvoye Aucune. Description Mthode qui active le mode Dessin de Flash. Le mode dessin est utilis pour les tracs temporaires avec le bouton de la souris enfonc. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant active le mode Dessin de Flash :
fl.drawingLayer.beginDraw();

drawingLayer.beginFrame()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.beginFrame()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui efface ce qui a t dessin prcdemment avec drawingLayer et prpare le programme pour dautres commandes de dessin. Cette mthode doit tre appele aprs drawingLayer.beginDraw(). Tout ce qui est trac entre un appel de drawingLayer.beginFrame() et un appel de drawingLayer.endFrame() reste sur la scne jusquaux prochains appels de beginFrame() et endFrame(). (Dans ce contexte, cadre fait rfrence lespace du dessin, pas aux images dans le scnario.) En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Voir drawingLayer.beginDraw().

drawingLayer.cubicCurveTo()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 179

Objet drawingLayer

Utilisation
drawingLayer.cubicCurveTo(x1Ctrl, y1Ctrl, x2Ctl, y2Ctl, xEnd, yEnd)

Paramtres x1Ctl Valeur en virgule flottante indiquant la coordonne x du premier point de contrle.
y1Ctl Valeur en virgule flottante indiquant la coordonne y du premier point de contrle. x2Ctl Valeur en virgule flottante indiquant la coordonne x du point de contrle central. y2Ctl Valeur en virgule flottante indiquant la coordonne y du point de contrle central. xEnd Valeur en virgule flottante indiquant la coordonne x du point de contrle final. yEnd Valeur en virgule flottante indiquant la coordonne y du point de contrle final.

Valeur renvoye Aucune. Description Mthode qui dessine une courbe cubique partir de lemplacement actuel du curseur, en utilisant les paramtres comme coordonnes du segment cubique. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant trace une courbe cubique en utilisant les points de contrle spcifis :
fl.drawingLayer.cubicCurveTo(0, 0, 1, 1, 2, 0);

drawingLayer.curveTo()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.curveTo(xCtl, yCtl, xEnd, yEnd)

Paramtres xCtl Valeur en virgule flottante indiquant la coordonne x du point de contrle.

yCtl Valeur en virgule flottante indiquant la coordonne y du point de contrle. xEnd Valeur en virgule flottante indiquant la coordonne x du point de contrle final. yEnd Valeur en virgule flottante indiquant la coordonne y du point de contrle final.

Valeur renvoye Aucune. Description Mthode qui dessine un segment de courbe quadratique commenant lemplacement actuel du curseur et se terminant au point spcifi. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles.

EXTENSION DE FLASH CS4 PROFESSIONAL 180

Objet drawingLayer

Exemple L'exemple suivant trace une courbe quadratique en utilisant les points de contrle spcifis :
fl.drawingLayer.curveTo(0, 0, 2, 0);

drawingLayer.drawPath()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.drawPath(path)

Paramtres path Objet Objet Path dessiner. Valeur renvoye Aucune. Description Mthode qui dessine le trac spcifi par le paramtre path. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant dessine le trac spcifi par lobjet Path nomm gamePath :
fl.drawingLayer.drawPath(gamePath);

drawingLayer.endDraw()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.endDraw()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui quitte le mode dessin. Le mode dessin est utilis pour les tracs temporaires avec le bouton de la souris enfonc. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles.

EXTENSION DE FLASH CS4 PROFESSIONAL 181

Objet drawingLayer

Exemple L'exemple suivant quitte le mode dessin :

fl.drawingLayer.endDraw();

drawingLayer.endFrame()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.endFrame()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui signale la fin dun groupe de commandes de dessin. Un groupe de commandes de dessin reprsente tout ce qui est trac entre les appels de drawingLayer.beginFrame() et drawingLayer.endFrame(). Lappel suivant de drawingLayer.beginFrame() efface tout ce qui a t trac par ce groupe de commandes de dessin. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles.

drawingLayer.lineTo()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.lineTo(x, y)

Paramtres x Valeur en virgule flottante indiquant la coordonne x du point de contrle final de la ligne tracer.
y Valeur en virgule flottante indiquant la coordonne y du point de contrle final de la ligne tracer.

Valeur renvoye Aucune. Description Mthode qui dessine une ligne partir de la position actuelle du curseur et jusquau point (x,y). En gnral, cette mthode nest utilise que lors de la cration doutils extensibles.

EXTENSION DE FLASH CS4 PROFESSIONAL 182

Objet drawingLayer

Exemple L'exemple suivant dessine une ligne partir de la position actuelle du curseur et jusquau point (20,30) :
fl.drawingLayer.lineTo(20, 30);

drawingLayer.moveTo()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.moveTo(x, y)

Paramtres x Valeur en virgule flottante indiquant la coordonne x de la position de dbut du dessin.

y Valeur en virgule flottante indiquant la coordonne y de la position de dbut du dessin.

Valeur renvoye Aucune. Description Mthode qui dfinit la position actuelle de dessin. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant dfinit la position de dbut du dessin au point (10,15) :
fl.drawingLayer.moveTo(10, 15);

drawingLayer.newPath()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.newPath()

Paramtres Aucun. Valeur renvoye Un objet Path (trac).

EXTENSION DE FLASH CS4 PROFESSIONAL 183

Objet drawingLayer

Description Mthode qui renvoie un nouvel objet Path. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Voir l'Objet Path. Exemple L'exemple suivant renvoie un nouvel objet Path :
fl.drawingLayer.newPath();

drawingLayer.setColor()
Disponibilit Flash MX 2004. Utilisation
drawingLayer.setColor(color)

Paramtres color Dfinit la couleur des objets dessin venir, dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Valeur renvoye Aucune. Description Mthode qui dfinit la couleur des objets dessin venir. Sapplique uniquement aux donnes persistantes. Pour utiliser cette mthode, le paramtre transmis drawingLayer.beginDraw() doit tre dfini sur true. En gnral, cette mthode nest utilise que lors de la cration doutils extensibles. Voir drawingLayer.beginDraw(). Exemple L'exemple suivant trace une ligne rouge sur la scne :
fl.drawingLayer.beginDraw( true ); fl.drawingLayer.beginFrame(); fl.drawingLayer.setColor( "#ff0000" ); fl.drawingLayer.moveTo(0,0); fl.drawingLayer.lineTo(100,100); fl.drawingLayer.endFrame(); fl.drawingLayer.endDraw();

EXTENSION DE FLASH CS4 PROFESSIONAL 184

Objet drawingLayer

drawingLayer.setFill()
Cette mthode n'est pas disponible.

drawingLayer.setStroke()
Cette mthode n'est pas disponible.

185

Chapitre 13 : Objet Edge

Disponibilit Flash MX 2004. Description Lobjet Edge reprsente les limites dune forme sur la scne. Rsum des mthodes Les mthodes suivantes sont disponibles pour lobjet Edge :
Mthode
edge.getControl()

Description Rcupre un objet point situ lemplacement du point de contrle spcifi du bord. Renvoie un Objet halfEdge. Dfinit la position du point de contrle du bord. Fractionne le bord en deux parties.

edge.getHalfEdge() edge.setControl() edge.splitEdge()

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Edge :
Proprit
edge.cubicSegmentIndex edge.id edge.isLine edge.stroke

Description Nombre entier qui spcifie la valeur d'index d'un segment cubique du bord. En lecture seule ; entier reprsentant un identificateur unique pour le bord. Lecture seule ; entier dune valeur de 0 ou 1. Objet Objet Stroke.

edge.cubicSegmentIndex
Disponibilit Flash CS4 Professional. Utilisation
edge.cubicSegmentIndex

Description Proprit en lecture seule ; entier qui spcifie la valeur d'index d'un segment cubique du bord (voir shape.getCubicSegmentPoints()). Exemple Le code suivant affiche les valeurs d'index de tous les segments cubiques du bord spcifi :

EXTENSION DE FLASH CS4 PROFESSIONAL 186

Objet Edge

var theShape = fl.getDocumentDOM().selection[0]; var edgesArray = theShape.edges; for(var i=0;i<edgesArray.length; i++) { fl.trace(edgesArray[i].cubicSegmentIndex); }

edge.getControl()
Disponibilit Flash MX 2004. Utilisation
edge.getControl(i)

Paramtres i Entier qui spcifie les points de contrle du bord renvoyer. Indiquez 0 pour le premier point de contrle, 1 pour le point de contrle central ou 2 pour le point de contrle final. Si la proprit edge.isLine est true, le point de contrle central est dfini sur le milieu du segment joignant les points de contrle de dbut et de fin. Valeur renvoye Le point de contrle spcifi. Description Mthode qui rcupre un objet point situ lemplacement du point de contrle spcifi du bord. Exemple L'exemple suivant stocke dans la variable pt le premier point de contrle de la forme spcifie :
var shape = fl.getDocumentDOM().selection[0]; var pt = shape.edges[0].getControl(0);

edge.getHalfEdge()
Disponibilit Flash MX 2004. Utilisation
edge.getHalfEdge(index)

Paramtres index Entier qui spcifie le demi-bord renvoyer. La valeur de index doit tre 0 pour le premier demi-bord ou 1 pour le second demi-bord. Valeur renvoye Un objet HalfEdge.

EXTENSION DE FLASH CS4 PROFESSIONAL 187

Objet Edge

Description Mthode qui renvoie un objet Objet halfEdge. Exemple L'exemple suivant enregistre dans les variables hEdge0 et hEdge1 les deux moitis du bord spcifi :
var var var var shape = fl.getDocumentDOM().selection[0]; edge = shape.edges[0]; hEdge0 = edge.getHalfEdge(0); hEdge1 = edge.getHalfEdge(1);

edge.id
Disponibilit Flash MX 2004. Utilisation
edge.id

Description Proprit en lecture seule ; entier reprsentant un identifiant unique pour le bord. Exemple L'exemple suivant enregistre dans la variable my_shape_id un identificateur unique pour le bord spcifi :
var shape = fl.getDocumentDOM().selection[0]; var my_shape_id = shape.edges[0].id;

edge.isLine
Disponibilit Flash MX 2004. Utilisation
edge.isLine

Description Proprit en lecture seule ; entier ayant la valeur 0 ou 1. La valeur 1 indique que le bord est une ligne droite. Dans ce cas, le point de contrle central coupe en deux parts gales la ligne qui relie les deux points dextrmit. Exemple L'exemple suivant dtermine si le bord spcifi est une ligne droite, et affiche la valeur 1 (si cest une ligne droite) ou 0 (si ce nest pas le cas) dans le panneau Sortie :
var shape = fl.getDocumentDOM().selection[0]; fl.trace(shape.edges[0].isLine);

EXTENSION DE FLASH CS4 PROFESSIONAL 188

Objet Edge

edge.setControl()
Disponibilit Flash MX 2004. Utilisation
edge.setControl(index, x, y)

Paramtres index Nombre entier qui spcifie le point de contrle dfinir. Les valeurs 0, 1 ou 2 permettent respectivement de spcifier les points de contrle de dbut, de milieu et de fin.
x Valeur en virgule flottante indiquant la coordonne horizontale du point de contrle. Si la scne est en mode de modification ou de modification en place, les coordonnes du point sont calcules par rapport lobjet en cours de modification. Sinon, les coordonnes du point sont relatives la scne. y Valeur en virgule flottante indiquant la coordonne verticale du point de contrle. Si la scne est en mode de

modification ou de modification en place, les coordonnes du point sont calcules par rapport lobjet en cours de modification. Sinon, les coordonnes du point sont relatives la scne. Valeur renvoye Aucune. Description Mthode qui dfinit la position du point de contrle du bord. Il est ncessaire dappeler shape.beginEdit() avant d'utiliser cette mthode. Voir shape.beginEdit(). Exemple L'exemple suivant dfinit le point de contrle de dbut du bord spcifi sur les coordonnes (0, 1) :
x = 0; y = 1; var shape = fl.getDocumentDOM().selection[0]; shape.beginEdit(); shape.edges[0].setControl(0, x, y); shape.endEdit();

edge.splitEdge()
Disponibilit Flash MX 2004. Utilisation
edge.splitEdge(t)

Paramtres t Valeur en virgule flottante comprise entre 0 et 1 indiquant le point de fractionnement du bord. La valeur 0 reprsente un point d'extrmit et 1 l'autre extrmit. Par exemple, la valeur 0,5 fractionne le bord en son milieu, cest--dire en son centre exact pour une ligne. Si le bord forme une courbe, 0,5 reprsente le milieu paramtrique de la courbe.

EXTENSION DE FLASH CS4 PROFESSIONAL 189

Objet Edge

Valeur renvoye Aucune. Description Mthode qui fractionne le bord en deux parties. Il est ncessaire dappeler shape.beginEdit() avant d'utiliser cette mthode. Exemple L'exemple suivant fractionne le bord spcifi en deux moitis :
var shape = fl.getDocumentDOM().selection[0]; shape.beginEdit() shape.edges[0].splitEdge( 0.5 ); shape.endEdit()

edge.stroke
Disponibilit Flash CS4 Professional. Utilisation
edge.stroke

Description Proprit ; Objet Stroke. Exemple L'exemple suivant affiche la couleur de trait du premier bord de l'objet slectionn :
var shape = fl.getDocumentDOM().selection[0]; fl.trace(shape.edges[0].stroke.color);

190

Chapitre 14 : Objet Element

Disponibilit Flash MX 2004. Description Tout ce qui apparat sur la scne est du type Element. Par exemple, le code suivant permet de slectionner un lment :
var el = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0];

Rsum des mthodes Les mthodes suivantes sont disponibles pour lobjet Element :
Mthode
element.getPersistentData() element.getTransformationPoint() element.hasPersistentData() element.removePersistentData()

Description Rcupre la valeur des donnes spcifies par le paramtre name. Rcupre la valeur du point de transformation de l'lment spcifi. Dtermine si les donnes spcifies ont t associes llment spcifi. Supprime les donnes persistantes associes lobjet et correspondant au nom spcifi. Stocke des donnes avec un lment. Dfinit la position du point de transformation de l'lment.

element.setPersistentData() element.setTransformationPoint()

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Element :
Proprit
element.depth

Description Lecture seule ; entier ayant une valeur suprieure 0 et reprsentant la profondeur de lobjet dans laffichage. Lecture seule ; chane reprsentant le type de llment spcifi. Nombre en virgule flottante spcifiant la hauteur de llment, en pixels. Lecture seule ; reprsente l'objet Objet Layer sur lequel l'lment est situ. Lecture seule ; nombre en virgule flottante indiquant la coordonne gauche de llment. Valeur boolenne, true si l'lment est verrouill, false dans le cas contraire. Objet Matrix. La matrice possde les proprits a, b, c, d, tx et ty. Les proprits a, b, c et d sont des nombres en virgule flottante. Les proprits tx et ty sont des coordonnes. Chane spcifiant le nom de llment. Cette chane est gnralement appele nom doccurrence. Valeur en virgule flottante ou entier compris(e) entre -180 et 180 qui indique, en degrs, la rotation de l'objet dans le sens horaire. Valeur en virgule flottante qui prcise la valeur d'chelle x des rectangles et ovales de type primitif, des symboles et des objets de dessin.

element.elementType element.height element.layer element.left element.locked element.matrix

element.name

element.rotation

element.scaleX

EXTENSION DE FLASH CS4 PROFESSIONAL 191

Objet Element

Proprit
element.scaleY

Description Valeur en virgule flottante qui prcise la valeur d'chelle y des rectangles et ovales de type primitif, des symboles et des objets de dessin. Valeur boolenne indiquant si lobjet est slectionn ou non. Valeur en virgule flottante, comprise entre -180 et 180, et prcisant la valeur d'inclinaison x des rectangles et ovales de type primitif, des symboles et des objets de dessin. Valeur en virgule flottante, comprise entre -180 et 180, et prcisant la valeur d'inclinaison y des rectangles et ovales de type primitif, des symboles et des objets de dessin. Lecture seule ; coordonne suprieure de llment. Nombre virgule flottante spcifiant la valeur x du point de transformation de l'lment slectionn dans le systme de coordonnes du parent de l'lment. Nombre virgule flottante spcifiant la valeur y du point de transformation de l'lment slectionn dans le systme de coordonnes du parent de l'lment. Nombre en virgule flottante spcifiant la largeur de llment, en pixels. Valeur en virgule flottante prcisant la valeur x du point d'alignement de l'lment slectionn. Valeur en virgule flottante prcisant la valeur y du point d'alignement de l'lment slectionn.

element.selected element.skewX

element.skewY

element.top element.transformX

element.transformY

element.width element.x

element.y

element.depth
Disponibilit Flash MX 2004. Utilisation
element.depth

Description Proprit en lecture seule ; entier ayant une valeur suprieure 0 et reprsentant la profondeur de lobjet dans laffichage. Lordre dans lequel les objets sont tracs sur la scne spcifie lobjet qui figure au-dessus des autres. L'ordre des objets peut galement tre gr par l'option de menu Modification > Rorganisation. Exemple L'exemple suivant affiche la profondeur de l'lment spcifi dans le panneau Sortie :
// Select an object and run this script. fl.trace("Depth of selected object: " + fl.getDocumentDOM().selection[0].depth);

Voir lexemple relatif element.elementType.

element.elementType
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 192

Objet Element

Utilisation
element.elementType

Description Proprit en lecture seule ; chane reprsentant le type de llment spcifi. Valeurs possibles : "shape", "text", "instance" ou "shapeObj". Un "shapeObj" peut tre cr laide dun outil extensible. Exemple L'exemple suivant stocke dans la variable eType le type du premier lment :
// In a new file, place a movie clip on first frame top layer, and // then run this line of script. var eType = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].elementType; // eType = instance

L'exemple suivant affiche plusieurs proprits pour tous les lments de limage ou du calque actif :
var tl = fl.getDocumentDOM().getTimeline() var elts = tl.layers[tl.currentLayer].frames[tl.currentFrame].elements; for (var x = 0; x < elts.length; x++) { var elt = elts[x]; fl.trace("Element "+ x +" Name = " + elt.name + " Type = " + elt.elementType + " location = " + elt.left + "," + elt.top + " Depth = " + elt.depth); }

element.getPersistentData()
Disponibilit Flash MX 2004. Utilisation
element.getPersistentData(name)

Paramtres name Chane identifiant les donnes renvoyer. Valeur renvoye Les donnes spcifies par le paramtre name ; ou 0 si ces donnes nexistent pas. Description Mthode qui rcupre la valeur des donnes spcifies par le paramtre name. Le type de donnes dpend du type des donnes qui ont t stockes (voir element.setPersistentData()). Seuls les symboles et les bitmaps acceptent des donnes persistantes. Exemple L'exemple suivant dfinit et rcupre les donnes pour llment spcifi, affiche ses valeurs dans le panneau Sortie, puis supprime les donnes :

EXTENSION DE FLASH CS4 PROFESSIONAL 193

Objet Element

// At least one symbol or bitmap is selected in the first layer, first frame. var elt = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0]; elt.setPersistentData("myData","integer", 12); if (elt.hasPersistentData("myData")){ fl.trace("myData = "+ elt.getPersistentData("myData")); elt.removePersistentData( "myData" ); fl.trace("myData = "+ elt.getPersistentData("myData")); }

element.getTransformationPoint()
Disponibilit Flash CS3 Professional. Utilisation
element.getTransformationPoint()

Paramtres Aucun. Valeur renvoye Un point (par exemple, {x:10,y:20}, sachant que x et y sont des nombres virgule flottante) qui prcise la position du point de transformation (galement point d'origine ou point zro) dans le systme de coordonnes de l'lment. Description Mthode qui rcupre la valeur du point de transformation de l'lment spcifi. les points de transformation sont dfinis par rapport diffrents emplacements, en fonction du type d'lment slectionn. Pour plus d'informations, consultez element.setTransformationPoint(). Exemple L'exemple suivant lit le point de transformation pour le troisime lment de la neuvime image du premier calque dans le document. La proprit transPoint.x donne la coordonne x du point de transformation. La proprit transPoint.y donne la coordonne y du point de transformation.
var transPoint = fl.getDocumentDOM().getTimeline().layers[0].frames[8].elements[2].getTransformationPoint();

Voir aussi
document.getTransformationPoint(), element.setTransformationPoint(), element.transformX, element.transformY

element.hasPersistentData()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 194

Objet Element

Utilisation
element.hasPersistentData(name)

Paramtres name Chane spcifiant le nom de llment de donnes tester. Valeur renvoye Valeur boolenne : true si les donnes spcifies sont jointes l'objet, false dans le cas contraire. Description Mthode qui dtermine si les donnes spcifies ont t jointes llment spcifi. Seuls les symboles et les bitmaps acceptent des donnes persistantes. Exemple Voir element.getPersistentData().

element.height
Disponibilit Flash MX 2004. Utilisation
element.height

Description Proprit ; nombre en virgule flottante spcifiant la hauteur de llment, en pixels. Nutilisez pas cette proprit pour redimensionner un champ de texte. Mais slectionnez le champ de texte et utilisez document.setTextRectangle(). En effet, lutilisation de cette proprit avec un champ de texte met le texte lchelle. Exemple Lexemple suivant fixe la hauteur de llment spcifi 100 pixels :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].height = 100;

element.layer
Disponibilit Flash 8. Utilisation
element.layer

EXTENSION DE FLASH CS4 PROFESSIONAL 195

Objet Element

Description Proprit en lecture seule ; reprsente l'objet Objet Layer sur lequel l'lment est situ. Exemple L'exemple suivant stocke dans la variable theLayer lobjet Layer (calque) qui contient llment :
var theLayer = element.layer;

element.left
Disponibilit Flash MX 2004. Utilisation
element.left

Description Proprit en lecture seule ; nombre en virgule flottante indiquant la coordonne gauche de llment. Pour les lments qui se trouvent dans une squence, la valeur de element.left est calcule par rapport au coin suprieur gauche de la scne. Pour les lments qui se trouvent dans un symbole, elle est exprime par rapport au point d'alignement (galement point d'origine ou point zro) du symbole. Utilisez document.setSelectionBounds() ou document.moveSelectionBy() pour dfinir cette proprit. Exemple L'exemple suivant illustre le changement de valeur de cette proprit lorsquun lment est dplac :
// Select an element on the Stage and then run this script. var sel = fl.getDocumentDOM().selection[0]; fl.trace("Left (before) = " + sel.left); fl.getDocumentDOM().moveSelectionBy({x:100, y:0}); fl.trace("Left (after) = " + sel.left);

Voir l'exemple de element.elementType.

element.locked
Disponibilit Flash MX 2004. Utilisation
element.locked

Description Proprit : valeur boolenne, true si l'lment est verrouill, false dans le cas contraire. Si la valeur de element.elementType correspond "shape", cette proprit est ignore.

EXTENSION DE FLASH CS4 PROFESSIONAL 196

Objet Element

Exemple L'exemple suivant verrouille le premier lment de la premire image du calque suprieur :
// Similar to Modify > Arrange > Lock: fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].locked = true;

element.matrix
Disponibilit Flash MX 2004. Utilisation
element.matrix

Description Proprit ; objet Matrix. Une matrice possde les proprits a, b, c, d, tx et ty. Les proprits a, b, c et d sont des nombres en virgule flottante. Les proprits tx et ty sont des coordonnes. Voir Objet Matrix. Exemple L'exemple suivant dplace llment spcifi de 10 pixels sur laxe x, et de 20 pixels sur laxe y :
var mat = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].matrix; mat.tx += 10; mat.ty += 20; fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].matrix = mat;

element.name
Disponibilit Flash MX 2004. Utilisation
element.name

Description Proprit ; chane spcifiant le nom de llment. Cette chane est gnralement appele nom doccurrence . Si la valeur de element.elementType correspond "shape", cette proprit est ignore. Voir element.elementType. Exemple L'exemple suivant dfinit sur "clip_mc" le nom doccurrence du premier lment de l'image 1 au niveau du calque suprieur :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].name = "clip_mc";

Voir l'exemple de element.elementType.

EXTENSION DE FLASH CS4 PROFESSIONAL 197

Objet Element

element.removePersistentData()
Disponibilit Flash MX 2004. Utilisation
element.removePersistentData(name)

Paramtres name Chane spcifiant le nom des donnes supprimer. Valeur renvoye Aucune. Description Mthode qui supprime les donnes persistantes associes lobjet et correspondant au nom spcifi. Seuls les symboles et les bitmaps acceptent des donnes persistantes. Exemple Voir element.getPersistentData().

element.rotation
Disponibilit Flash CS3 Professional. Utilisation
element.rotation

Description Proprit ; entier ou valeur en virgule flottante compris(e) entre -180 et 180 qui spcifie la rotation horaire de l'objet, en degrs. Exemple L'exemple suivant dfinit sur 45 degrs la rotation de l'lment actuellement slectionn :
var element = fl.getDocumentDOM().selection[0]; fl.trace("Element rotation = " + element.rotation); element.rotation = 45; fl.trace("After setting rotation to 45: rotation = " + element.rotation);

element.scaleX
Disponibilit Flash CS3 Professional.

EXTENSION DE FLASH CS4 PROFESSIONAL 198

Objet Element

Utilisation
element.scaleX

Description Proprit ; valeur en virgule flottante qui prcise la valeur d'chelle x des rectangles et ovales de type primitif, des symboles et des objets de dessin. La valeur 1 indique une chelle de 100 %. Exemple L'exemple suivant dfinit la valeur d'chelle x de la slection en cours sur 2 (double sa valeur) :
var element = fl.getDocumentDOM().selection[0]; element.scaleX = 2;

Voir aussi
element.scaleY

element.scaleY
Disponibilit Flash CS3 Professional. Utilisation
element.scaleY

Description Proprit ; valeur en virgule flottante qui prcise la valeur d'chelle y des rectangles et ovales de type primitif, des symboles et des objets de dessin. La valeur 1 indique une chelle de 100 %. Exemple L'exemple suivant dfinit la valeur d'chelle y de la slection en cours sur 2 (double sa valeur) :
var element = fl.getDocumentDOM().selection[0]; element.scaleY = 2;

Voir aussi
element.scaleX

element.selected
Disponibilit Flash 8. Utilisation
element.selected

EXTENSION DE FLASH CS4 PROFESSIONAL 199

Objet Element

Description Proprit ; valeur boolenne indiquant si l'lment est slectionn (true) ou non (false). Exemple L'exemple suivant slectionne llment :
element.selected = true;

element.setPersistentData()
Disponibilit Flash MX 2004. Utilisation
element.setPersistentData(name, type, value)

Paramtres name Chane spcifiant le nom associer aux donnes. Ce nom est utilis pour rcuprer les donnes.
type Chane spcifiant le type des donnes. Les valeurs possibles sont les suivantes : "integer", "integerArray", "double", "doubleArray", "string" et "byteArray". value Spcifie la valeur associer lobjet. Le type de donnes de value dpend de la valeur du paramtre type. La valeur spcifie doit tre approprie pour le type de donnes spcifi par le paramtre type.

Valeur renvoye Aucune. Description Mthode qui stocke des donnes avec un lment. Ces donnes sont accessibles en JavaScript la rouverture du fichier FLA contenant llment. Seuls les symboles et les bitmaps acceptent des donnes persistantes. Exemple Voir element.getPersistentData().

element.setTransformationPoint()
Disponibilit Flash CS3 Professional. Utilisation
element.setTransformationPoint(transformationPoint)

EXTENSION DE FLASH CS4 PROFESSIONAL 200

Objet Element

Paramtres
transformationPoint Point (par exemple, {x:10,y:20}, sachant que x et y sont des nombres virgule flottante)

spcifiant des valeurs pour un point de transformation d'un lment ou d'un groupe.

Formes : transformationPoint est dfini par rapport au document (0,0 est le coin suprieur gauche de la scne). Symboles : transformationPoint est dfini par rapport au point d'alignement du symbole (0,0 est situ au point
d'alignement).

Texte : transformationPoint est dfini par rapport au champ de texte (0,0 est le coin suprieur gauche du champ de
texte).

Bitmaps/vidos : transformationPoint est dfini par rapport la bitmap/vido (0,0 est le coin suprieur gauche de
l'image bitmap ou de la vido).

Objets de dessin, objets primitifs et groupes : transformationPoint est dfini par rapport au centre de l'lment ou
du groupe (0,0 est le point central de l'lment ou du groupe). Valeur renvoye Aucune. Description Mthode qui dfinit la position du point de transformation de l'lment. Cette mthode est pratiquement identique document.setTransformationPoint(), mais diffre cependant sur certains aspects :

Le point de transformation des objets de dessin, des objets de type primitif et des groupes est calcul par rapport au
centre de l'lment ou du groupe, et non par rapport la scne.

Il est possible de dfinir des points de transformation d'lments sans les slectionner au pralable.
Cette mthode dplace le point de transformation, mais ne dplace pas l'lment A l'inverse, les proprits element.transformX et element.transformY dplacent l'lment. Exemple L'exemple suivant dfinit sur 100, 200 le point de transformation du troisime lment sur la scne :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[2].setTransformationPoint({x: 100, y:200});

Voir aussi
document.setTransformationPoint(). element.getTransformationPoint(), element.transformX, element.transformY

element.skewX
Disponibilit Flash CS3 Professional. Utilisation
element.skewX

EXTENSION DE FLASH CS4 PROFESSIONAL 201

Objet Element

Description Proprit ; valeur code en virgule flottante, comprise entre -180 et 180, et prcisant la valeur d'inclinaison x des rectangles et ovales de type primitif, des symboles et des objets de dessin. Exemple L'exemple suivant dfinit la valeur d'inclinaison x de la slection en cours sur 10 :
var element = fl.getDocumentDOM().selection[0]; element.skewX = 10;

Voir aussi
document.setTransformationPoint(), element.skewY

element.skewY
Disponibilit Flash CS3 Professional. Utilisation
element.skewY

Description Proprit ; valeur en virgule flottante, comprise entre -180 et 180, et prcisant la valeur d'inclinaison y des rectangles et ovales de type primitif, des symboles et des objets de dessin. Exemple L'exemple suivant dfinit la valeur d'inclinaison y de la slection en cours sur 10 :
var element = fl.getDocumentDOM().selection[0]; element.skewY = 10;

Voir aussi
document.setTransformationPoint(), element.skewX

element.top
Disponibilit Flash MX 2004. Utilisation
element.top

EXTENSION DE FLASH CS4 PROFESSIONAL 202

Objet Element

Description Proprit en lecture seule ; coordonne suprieure de llment. Pour les lments qui se trouvent dans une squence, la valeur de element.top est exprime relativement au coin suprieur gauche de la scne. Pour les lments qui se trouvent dans un symbole, elle est exprime relativement au point d'alignement du symbole. Utilisez document.setSelectionBounds() ou document.moveSelectionBy() pour dfinir cette proprit. Exemple L'exemple suivant illustre le changement de valeur de cette proprit lorsquun lment est dplac :
// Select an element on the Stage and then run this script. var sel = fl.getDocumentDOM().selection[0]; fl.trace("Top (before) = " + sel.top); fl.getDocumentDOM().moveSelectionBy({x:0, y:100}); fl.trace("Top (after) = " + sel.top);

Voir l'exemple de element.elementType.

element.transformX
Disponibilit Flash CS3 Professional. Utilisation
element.transformX

Description Proprit ; nombre virgule flottante spcifiant la valeur x du point de transformation de l'lment slectionn dans le systme de coordonnes du parent de l'lment. La dfinition d'une nouvelle valeur pour cette proprit dplace l'lment. A l'inverse, la mthode element.setTransformationPoint() dplace le point de transformation, mais pas l'lment. Exemple Voir aussi
element.getTransformationPoint(), element.setTransformationPoint(), element.transformY

element.transformY
Disponibilit Flash CS3 Professional. Utilisation
element.transformY

EXTENSION DE FLASH CS4 PROFESSIONAL 203

Objet Element

Description Proprit ; nombre virgule flottante spcifiant la valeur y du point de transformation de l'lment slectionn dans le systme de coordonnes du parent de l'lment. La dfinition d'une nouvelle valeur pour cette proprit dplace l'lment. A l'inverse, la mthode element.setTransformationPoint() dplace le point de transformation, mais pas l'lment. Voir aussi
element.getTransformationPoint(), element.setTransformationPoint(), element.transformX

element.width
Disponibilit Flash MX 2004. Utilisation
element.width

Description Proprit ; nombre en virgule flottante spcifiant la largeur de llment, en pixels. Nutilisez pas cette proprit pour redimensionner un champ de texte. Mais slectionnez le champ de texte et utilisez document.setTextRectangle(). En effet, lutilisation de cette proprit avec un champ de texte met le texte lchelle. Exemple Lexemple suivant fixe la largeur de llment spcifi 100 pixels :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].width= 100;

element.x
Disponibilit Flash CS3 Professional. Utilisation
element.x

Description Proprit ; valeur en virgule flottante et prcisant la valeur x du point d'alignement de l'lment slectionn. Exemple L'exemple suivant dfinit la valeur du point d'alignement de l'lment spcifi sur 100, 200 :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].x= 100; fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].y= 200;

EXTENSION DE FLASH CS4 PROFESSIONAL 204

Objet Element

Voir aussi
element.y

element.y
Disponibilit Flash CS3 Professional. Utilisation
element.y

Description Proprit ; valeur en virgule flottante prcisant la valeur y du point d'alignement de l'lment slectionn. Exemple Voir element.x.

205

Chapitre 15 : Objet Fill

Disponibilit Flash MX 2004. Description Lobjet Fill contient toutes les proprits du paramtre de couleur de remplissage (Fill color) du panneau Outils ou de la forme slectionne. Pour rcuprer un objet Fill, utilisez document.getCustomFill(). Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Fill :
Proprit
fill.bitmapIsClippe d fill.bitmapPath fill.color fill.colorArray fill.focalPoint

Description Valeur boolenne qui spcifie si le remplissage bitmap d'une forme plus grande que le bitmap est recadr ou rpt. Chane qui spcifie le chemin et le nom du remplissage bitmap dans la bibliothque. Chane, valeur hexadcimale ou entire reprsentant la couleur du remplissage. Tableau de couleurs en dgrad. Entier spcifiant le dcalage horizontal du point focal du dgrad par rapport au point de transformation. Valeur boolenne qui indique si le remplissage doit tre effectu sous forme de dgrad RVB linaire ou radial. Objet Matrix qui dfinit lemplacement, lorientation et les chelles des remplissages avec dgrad. Chane qui indique le comportement d'un dbordement de dgrad. Tableau de nombres entiers, compris entre zro et 255, indiquant la position de la couleur correspondante. Chane qui spcifie le style du remplissage.

fill.linearRGB

fill.matrix fill.overflow fill.posArray

fill.style

fill.bitmapIsClipped
Disponibilit Flash CS4 Professional. Utilisation
fill.bitmapIsClipped

Description Proprit ; valeur boolenne qui spcifie si le remplissage bitmap d'une forme plus grande que le bitmap est recadr (true) ou rpt (false). Cette proprit n'est disponible que si la valeur de la proprit fill.style est "bitmap". Si la forme est plus petite que le bitmap, cette valeur est false.

EXTENSION DE FLASH CS4 PROFESSIONAL 206

Objet Fill

Exemple L'exemple suivant affiche des informations sur le recadrage du remplissage du bitmap, le cas chant, dans le panneau Sortie :
var fill = fl.getDocumentDOM().getCustomFill(); if (fill.style == "bitmap") fl.trace("Fill image is clipped: " + fill.bitmapIsClipped);

Voir aussi
fill.bitmapPath

fill.bitmapPath
Disponibilit Flash CS4 Professional. Utilisation
fill.bitmapPath

Description Proprit ; chane qui spcifie le chemin et le nom du remplissage bitmap dans la bibliothque. Cette proprit n'est disponible que si la valeur de la proprit fill.style est "bitmap". Exemple L'exemple suivant dfinit le style du remplissage de l'lment spcifi sur une image bitmap de la bibliothque :
var fill = fl.getDocumentDOM().getCustomFill(); fill.style = "bitmap"; fill.bitmapPath = "myBitmap.jpg"; fl.getDocumentDOM().setCustomFill(fill);

Voir aussi
fill.bitmapIsClipped

fill.color
Disponibilit Flash MX 2004. Utilisation
fill.color

Description Proprit ; couleur du remplissage, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB

EXTENSION DE FLASH CS4 PROFESSIONAL 207

Objet Fill

Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal

Exemple L'exemple suivant dfinit la couleur de remplissage de la slection :
var fill = fl.getDocumentDOM().getCustomFill(); fill.color = "#FFFFFF"; fl.getDocumentDOM().setCustomFill( fill );

fill.colorArray
Disponibilit Flash MX 2004. Utilisation
fill.colorArray

Description Proprit ; tableau de couleurs du dgrad, exprimes sous forme d'entiers. Cette proprit nest disponible que si la valeur de la proprit fill.style est "radialGradient" ou "linearGradient". Voir fill.style Exemple L'exemple suivant affiche le tableau des couleurs de la slection dans le panneau Sortie :
var fill = fl.getDocumentDOM().getCustomFill(); if(fill.style == "linearGradient" || fill.style == "radialGradient") alert(fill.colorArray);

L'exemple suivant dfinit le remplissage sur le dgrad linaire spcifi :

var fill = fl.getDocumentDOM().getCustomFill(); fill.style = "linearGradient"; fill.colorArray = ["#00ff00","#ff00ff"]; fill.posArray = [0, 255]; fl.getDocumentDOM().setCustomFill(fill);

fill.focalPoint
Disponibilit Flash 8. Utilisation
fill.focalPoint

Description Proprit ; entier spcifiant le dcalage horizontal du point focal du dgrad par rapport au point de transformation. Par exemple, une valeur de 10 place le point focal 10/255 de la distance entre le point de transformation et le bord du dgrad. Une valeur de -255 place le point focal sur le bord gauche du dgrad. La valeur par dfaut est 0.

EXTENSION DE FLASH CS4 PROFESSIONAL 208

Objet Fill

Cette proprit n'est disponible que si la valeur de la proprit fill.style est "radialGradient". Exemple L'exemple suivant dfinit, pour la slection en cours, le point focal dun dgrad radial sur 100 pixels droite du centre de la forme.
var fill = fl.getDocumentDOM().getCustomFill(); fill.style = "radialGradient"; fill.colorArray = ["#00ff00","#ff00ff"]; fill.posArray = [0, 255]; fill.focalPoint = 10100; fl.getDocumentDOM().setCustomFill(fill);

fill.linearRGB
Disponibilit Flash 8. Utilisation
fill.linearRGB

Description Proprit ; valeur boolenne qui indique si le remplissage doit tre effectu sous forme de dgrad RVB linaire ou radial. Cette proprit doit tre dfinie sur true pour obtenir une interpolation linaire du dgrad, sur false pour obtenir une interpolation radiale. La valeur par dfaut est false. Exemple L'exemple suivant spcifie un rendu par interpolation RVB linaire du dgrad de la slection en cours :
var fill = fl.getDocumentDOM().getCustomFill(); fill.linearRGB style = true"radialGradient"; fill.colorArray = ["#00ff00","#ff00ff"]; fill.posArray = [0, 255]; fill.focalPoint = 100; fill.linearRGB = true; fl.getDocumentDOM().setCustomFill(fill);

fill.matrix
Disponibilit Flash MX 2004. Utilisation
fill.matrix

Description Proprit ; Objet Matrix qui dfinit lemplacement, lorientation et les chelles des remplissages avec dgrads.

EXTENSION DE FLASH CS4 PROFESSIONAL 209

Objet Fill

Exemple L'exemple suivant utilise la proprit fill.matrix pour appliquer un remplissage dgrad sur la slection en cours :
var fill = fl.getDocumentDOM().getCustomFill(); fill.style = 'radialGradient'; fill.colorArray = ['#00ff00','#ff00ff']; fill.posArray = [0, 255]; fill.focalPoint = 100; fill.linearRGB = false; fill.overflow = 'repeat'; var mat = fl.getDocumentDOM().selection[0].matrix; mat.a = 0.0167083740234375; mat.b = -0.0096435546875; mat.c = 0.0312957763671875; mat.d = 0.05419921875; mat.tx = 288.65; mat.ty = 193.05; for (i in mat) { fl.trace(i+' : '+mat[i]); } fl.getDocumentDOM().setCustomFill(fill);

fill.overflow
Disponibilit Flash 8. Utilisation
fill.overflow

Description Proprit ; chane qui indique le comportement du dbordement d'un dgrad. Les valeurs possibles sont "extend" (extension), "repeat" (rptition) et "reflect" (rflexion) ; ces trois chanes ne sont pas sensibles la casse. La valeur par dfaut est "extend". Exemple L'exemple suivant spcifie un dbordement de type "extend" pour la slection en cours :
var fill = fl.getDocumentDOM().getCustomFill(); fill.overflow = "extend"; fl.getDocumentDOM().setCustomFill(fill);

fill.posArray
Disponibilit Flash MX 2004. Utilisation
fill.posArray

EXTENSION DE FLASH CS4 PROFESSIONAL 210

Objet Fill

Description Proprit ; tableau de nombres entiers, compris entre zro et 255, indiquant la position de la couleur correspondante. Cette proprit nest disponible que si la valeur de la proprit fill.style est "radialGradient" ou "linearGradient". Exemple L'exemple suivant spcifie les couleurs utiliser pour un dgrad linaire dans la slection actuelle :
var fill = fl.getDocumentDOM().getCustomFill(); fill.style = "linearGradient"; fill.colorArray = [ 0x00ff00, 0xff0000, 0x0000ff ]; fill.posArray= [0,100, 200]; fl.getDocumentDOM().setCustomFill( fill );

fill.style
Disponibilit Flash MX 2004. Valeur bitmap ajoute dans Flash CS4 Professional. Utilisation
fill.style

Description Proprit ; chane qui spcifie le style du remplissage. Les valeurs possibles sont "bitmap", "solid" (uni), "linearGradient" (dgrad linaire), "radialGradient" (dgrad radial) et "noFill" (pas de remplissage). Si cette valeur est "linearGradient" ou "radialGradient", les proprits fill.colorArray et fill.posArray sont galement disponibles. Si cette valeur est "bitmap", les proprits fill.bitmapIsClipped et fill.bitmapPath sont galement disponibles. Exemple L'exemple suivant spcifie les couleurs utiliser pour un dgrad linaire dans la slection actuelle :
var fill = fl.getDocumentDOM().getCustomFill(); fill.style= "linearGradient"; fill.colorArray = [ 0x00ff00, 0xff0000, 0x0000ff ]; fill.posArray= [0,100, 200]; fl.getDocumentDOM().setCustomFill( fill );

211

Chapitre 16 : Objet Filter

Disponibilit Flash 8. Description L'objet Filter contient toutes les proprits de tous les filtres. La proprit filter.name spcifie le type de filtre et dtermine les proprits qui s'appliquent chaque filtre. Voir filter.name. Pour renvoyer la liste de filtres associe un ou plusieurs objets, utilisez document.getFilters(). Pour appliquer des filtres un ou plusieurs objets, utilisez document.setFilters(). Voir document.getFilters() et document.setFilters(). Rsum des proprits L'objet Filter gre les proprits suivantes :
Proprit
filter.angle

Description Nombre en virgule flottante spcifiant l'angle de l'ombre ou de la couleur de surbrillance, exprim en degrs. Valeur en virgule flottante et spcifiant la quantit de flou dans la direction x, exprime en pixels. Valeur en virgule flottante et spcifiant la quantit de flou dans la direction y, exprime en pixels. Nombre en virgule flottante spcifiant la luminosit du filtre. Chane, valeur hexadcimale ou entier reprsentant la couleur du filtre. Nombre en virgule flottante spcifiant la valeur de contraste du filtre. Nombre en virgule flottante spcifiant la distance, en pixels, entre l'effet du filtre et un objet. Valeur boolenne indiquant si le filtre spcifi est activ ou non. Valeur boolenne indiquant si l'image source est masque ou non. Chane, valeur hexadcimale ou entier reprsentant la couleur de surbrillance. Nombre en virgule flottante spcifiant la teinte du filtre. Valeur boolenne indiquant si lombre est une ombre interne. Valeur boolenne indiquant si le filtre est un filtre masque. Lecture seule ; chane indiquant le type de filtre. Chane spcifiant la qualit du flou. Nombre en virgule flottante spcifiant la valeur de saturation du filtre. Chane, valeur hexadcimale ou entier reprsentant la couleur de l'ombre. Entier spcifiant l'intensit du filtre en pourcentage. Chane spcifiant le type de biseau ou de rayonnement.

filter.blurX

filter.blurY

filter.brightness filter.color filter.contrast filter.distance

filter.enabled filter.hideObject filter.highlightColor filter.hue filter.inner filter.knockout filter.name filter.quality filter.saturation filter.shadowColor filter.strength filter.type

EXTENSION DE FLASH CS4 PROFESSIONAL 212

Objet Filter

filter.angle
Disponibilit Flash 8. Utilisation
filter.angle

Description Proprit ; nombre en virgule flottante spcifiant l'angle de l'ombre ou de la couleur de surbrillance, exprim en degrs. Les valeurs gres sont comprises entre 0 et 360. Cette proprit est dfinie pour les objets Filter avec une valeur de "bevelFilter", "dropShadowFilter", "gradientBevelFilter", ou "gradientGlowFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit un angle de 120 pour les filtres Biseau sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++) { if(myFilters[i].name == 'bevelFilter'){ myFilters[i].angle = 120; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.blurX
Disponibilit Flash 8. Utilisation
filter.blurX

Description Proprit ; valeur en virgule flottante et spcifiant la quantit de flou dans la direction x, exprime en pixels. Les valeurs gres sont comprises entre 0 et 255. Cette proprit est dfinie pour des objets Filter avec une valeur de "bevelFilter", "blurFilter", "dropShadowFilter", "glowFilter", "gradientBevelFilter" ou "gradientGlowFilter" pour la proprit filter.namefilter.name. Exemple L'exemple suivant dfinit la valeur blurX sur 30 et la valeur blurY sur 20 pour les filtres Flou sur les objets slectionns :

EXTENSION DE FLASH CS4 PROFESSIONAL 213

Objet Filter

var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'blurFilter'){ myFilters[i].blurX = 30; myFilters[i].blurY = 20; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty(), filter.blurY

filter.blurY
Disponibilit Flash 8. Utilisation
filter.blurY

Description Proprit ; valeur en virgule flottante et spcifiant la quantit de flou dans la direction y, exprime en pixels. Les valeurs gres sont comprises entre 0 et 255. Cette proprit est dfinie pour des objets Filter avec une valeur de "bevelFilter", "blurFilter", "dropShadowFilter", "glowFilter", "gradientBevelFilter" ou "gradientGlowFilter" pour la proprit filter.namefilter.name. Exemple Voir filter.blurX. Voir aussi
document.setFilterProperty(), filter.blurX

filter.brightness
Disponibilit Flash 8. Utilisation
filter.brightness

Description Proprit ; nombre en virgule flottante spcifiant la luminosit du filtre. Les valeurs gres sont comprises entre -100 et 100. Cette proprit est dfinie pour des objets Filter avec une valeur de "adjustColorFilter" pour la proprit filter.name.

EXTENSION DE FLASH CS4 PROFESSIONAL 214

Objet Filter

Exemple L'exemple suivant dfinit une luminosit de 30,5 pour les filtres de rglage de la couleur sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'adjustColorFilter'){ myFilters[i].brightness = 30.5; } } fl.getDocumentDOM().setFilters(myFilters);

filter.color
Disponibilit Flash 8. Utilisation
filter.color

Description Proprit ; couleur du filtre, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Cette proprit est dfinie pour des objets Filter avec une valeur de "dropShadowFilter" ou "glowFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la couleur sur "#ff00003e" pour les filtres d'ombre porte sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'dropShadowFilter'){ myFilters[i].color = '#ff00003e'; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.contrast
Disponibilit Flash 8.

EXTENSION DE FLASH CS4 PROFESSIONAL 215

Objet Filter

Utilisation
filter.contrast

Description Proprit ; nombre en virgule flottante spcifiant la valeur de contraste du filtre. Les valeurs gres sont comprises entre -100 et 100. Cette proprit est dfinie pour des objets Filter avec une valeur de "adjustColorFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit un contraste de -15,5 pour les filtres de rglage de la couleur sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'adjustColorFilter'){ myFilters[i].contrast = -15.5; } } fl.getDocumentDOM().setFilters(myFilters);

filter.distance
Disponibilit Flash 8. Utilisation
filter.distance

Description Proprit ; nombre en virgule flottante spcifiant la distance, en pixels, entre l'effet du filtre et un objet. Les valeurs acceptes sont comprises entre -255 et 255. Cette proprit est dfinie pour les objets Filter avec une valeur de "bevelFilter", "dropShadowFilter", "gradientBevelFilter", ou "gradientGlowFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la distance sur 10 pixels pour les filtres d'ombre porte sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'dropShadowFilter'){ myFilters[i].distance = 10; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

EXTENSION DE FLASH CS4 PROFESSIONAL 216

Objet Filter

filter.enabled
Disponibilit Flash CS3 Professional. Utilisation
filter.enabled

Description Proprit; valeur boolenne indiquant si le filtre spcifi est activ (true) ou non (false). Exemple Lexemple suivant dsactive les filtres de couleurs appliqus aux objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'adjustColorFilter'){ myFilters[i].enabled = false; } } fl.getDocumentDOM().setFilters(myFilters);

filter.hideObject
Disponibilit Flash 8. Utilisation
filter.hideObject

Description Proprit ; valeur boolenne indiquant si l'image source est masque (true) ou affiche (false). Cette proprit est dfinie pour des objets Filter avec une valeur de "dropShadowFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la valeur hideObject sur true pour les filtres d'ombre porte sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'dropShadowFilter'){ myFilters[i].hideObject = true; } } fl.getDocumentDOM().setFilters(myFilters);

EXTENSION DE FLASH CS4 PROFESSIONAL 217

Objet Filter

filter.highlightColor
Disponibilit Flash 8. Utilisation
filter.highlightColor

Description Proprit ; couleur de surbrillance, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Cette proprit est dfinie pour des objets Filter avec une valeur de "bevelFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la couleur de surbrillance sur "#ff00003e" pour les filtres de biseau sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'bevelFilter'){ myFilters[i].highlightColor = '#ff00003e'; } } fl.getDocumentDOM().setFilters(myFilters);

filter.hue
Disponibilit Flash 8. Utilisation
filter.hue

Description Proprit ; nombre en virgule flottante spcifiant la teinte du filtre. Les valeurs gres sont comprises entre -180 et 180. Cette proprit est dfinie pour des objets Filter avec une valeur de "adjustColorFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit une teinte de 120 pour les filtres de rglage de la couleur sur les objets slectionns :

EXTENSION DE FLASH CS4 PROFESSIONAL 218

Objet Filter

var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'adjustColorFilter'){ myFilters[i].hue = 120; } } fl.getDocumentDOM().setFilters(myFilters);

filter.inner
Disponibilit Flash 8. Utilisation
filter.inner

Description Proprit ; valeur boolenne indiquant si l'ombre est intrieure (true) ou non (false). Cette proprit est dfinie pour des objets Filter avec une valeur de "dropShadowFilter" ou "glowFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la valeur de la proprit inner sur true pour les filtres de rayonnement sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'glowFilter'){ myFilters[i].inner = true; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.knockout
Disponibilit Flash 8. Utilisation
filter.knockout

Description Proprit ; valeur boolenne indiquant si le filtre masque (true) ou non (false) l'image source. Cette proprit est dfinie pour les objets Filter avec une valeur de "bevelFilter", "dropShadowFilter", "glowFilter", "gradientBevelFilter", ou "gradientGlowFilter" pour la proprit filter.name.

EXTENSION DE FLASH CS4 PROFESSIONAL 219

Objet Filter

Exemple L'exemple suivant dfinit la proprit knockout sur true pour les filtres de rayonnement sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'glowFilter'){ myFilters[i].knockout = true; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.name
Disponibilit Flash 8. Utilisation
filter.name

Description Proprit en lecture seule ; chane indiquant le type de filtre. La valeur de cette proprit identifie les autres proprits disponibles pour l'objet Filter. La valeur est l'une des suivantes : "adjustColorFilter", "bevelFilter", "blurFilter", "dropShadowFilter", "glowFilter", "gradientBevelFilter" ou "gradientGlowFilter". Exemple L'exemple suivant affiche le nom des filtres et les positions d'index dans le panneau Sortie :
var myFilters = fl.getDocumentDOM().getFilters(); var traceStr = ""; for(i=0; i < myFilters.length; i++){ traceStr = traceStr + " At index " + i + ": " + myFilters[i].name; } fl.trace(traceStr);

Voir aussi
document.getFilters(), document.setFilterProperty()

filter.quality
Disponibilit Flash 8. Utilisation
filter.quality

EXTENSION DE FLASH CS4 PROFESSIONAL 220

Objet Filter

Description Proprit ; chane spcifiant la qualit du flou. Les valeurs gres sont "low", "medium" et "high" ("high" est similaire un flou gaussien). Cette proprit est dfinie pour les objets Filter avec une valeur de "bevelFilter", "blurFilter", "dropShadowFilter", "glowFilter", "gradientGlowFilter" ou "gradientBevelFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la qualit de flou sur "medium" pour les filtres de flou sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'glowFilter'){ myFilters[i].quality = 'medium'; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.saturation
Disponibilit Flash 8. Utilisation
filter.saturation

Description Proprit ; nombre en virgule flottante spcifiant la valeur de saturation du filtre. Les valeurs acceptes sont comprises entre -100 et 100. Cette proprit est dfinie pour des objets Filter avec une valeur de "adjustColorFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la saturation sur 100 (niveaux de gris) pour les filtres de rglage de la couleur sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'adjustColorFilter'){ myFilters[i].saturation = 0-100; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

EXTENSION DE FLASH CS4 PROFESSIONAL 221

Objet Filter

filter.shadowColor
Disponibilit Flash 8. Utilisation
filter.shadowColor

Description Proprit ; couleur de l'ombre, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Cette proprit est dfinie pour des objets Filter avec une valeur de "bevelFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit la couleur de l'ombre sur "#ff00003e" pour les filtres de biseau sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'bevelFilter'){ myFilters[i].shadowColor = '#ff00003e'; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.strength
Disponibilit Flash 8. Utilisation
filter.strength

Description Proprit ; entier spcifiant l'intensit du filtre en pourcentage. Les valeurs gres sont comprises entre 0 et 25 500. Cette proprit est dfinie pour les objets Filter avec une valeur de "bevelFilter", "dropShadowFilter", "glowFilter", "gradientGlowFilter" ou "gradientBevelFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit l'intensit sur 50 pour les filtres de rayonnement sur les objets slectionns :

EXTENSION DE FLASH CS4 PROFESSIONAL 222

Objet Filter

var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'glowFilter'){ myFilters[i].strength = 50; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

filter.type
Disponibilit Flash 8. Utilisation
filter.type

Description Proprit ; chane spcifiant le type de filtre de biseau ou de rayonnement. Les valeurs gres sont "inner", "outer" et "full". Cette proprit est dfinie pour les objets Filter avec une valeur de "bevelFilter", "gradientGlowFilter" ou "gradientBevelFilter" pour la proprit filter.name. Exemple L'exemple suivant dfinit sur "full" le type de tous les filtres de biseau sur les objets slectionns :
var myFilters = fl.getDocumentDOM().getFilters(); for(i=0; i < myFilters.length; i++){ if(myFilters[i].name == 'bevelFilter'){ myFilters[i].type = 'full'; } } fl.getDocumentDOM().setFilters(myFilters);

Voir aussi
document.setFilterProperty()

223

Chapitre 17 : Objet flash (fl)

Disponibilit Flash MX 2004. Description Lobjet flash reprsente lapplication Flash. Pour vous rfrer cet objet, utilisez le nom flash ou fl. Cette documentation utilise systmatiquement le terme fl dans les exemples de code. Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet flash :
Mthode
fl.addEventListener()

Description Enregistre une fonction appeler lors de la rception d'un vnement spcifique. Ouvre une bote de dialogue Fichier Ouvrir ou Fichier Enregistrer pour permettre lutilisateur dindiquer un nom de fichier ouvrir ou enregistrer. Affiche la bote de dialogue Rechercher un dossier et permet lutilisateur de slectionner un dossier. Copie la chane spcifie dans le Presse-papiers. Ferme tous les documents ouverts et affiche la bote de dialogue Enregistrer sous pour les documents qui nont pas encore t enregistrs. Ferme tous les fichiers SWF qui ont t ouverts par la commande Contrle > Tester l'animation. Ferme le document spcifi. Ouvre un nouveau document et le slectionne. A partir du serveur Version Cue, tlcharge la dernire version d'un fichier qui n'est pas actuellement ouvert. Vrifie si un fichier existe dj sur le disque. Permet de cibler un fichier spcifique au moyen de son identificateur unique. Renvoie un tableau d'entiers reprsentant la position d'un document dans le tableau fl.documents. Expose les lments dont les noms d'occurrence correspondent un texte particulier. Expose des lments d'un type spcifi dans un document. Renvoie un entier reprsentant le nombre doctets occups dans la zone mmoire de Flash.exe spcifie. Rcupre le DOM (Objet Document) du document actuellement actif. Dtermine si la police spcifie est installe.

fl.browseForFileURL()

fl.browseForFolderURL()

fl.clipCopyString() fl.closeAll()

fl.closeAllPlayerDocuments()

fl.closeDocument() fl.createDocument() fl.downloadLatestVersion()

fl.fileExists() fl.findDocumentDOM()

fl.findDocumentIndex()

fl.findObjectInDocByName()

fl.findObjectInDocByType() fl.getAppMemoryInfo()

fl.getDocumentDOM() fl.isFontInstalled()

EXTENSION DE FLASH CS4 PROFESSIONAL 224

Objet flash (fl)

Mthode
fl.mapPlayerURL()

Description Convertit une adresse URL avec squences d'chappement Unicode en une URL en UTF-8 ou MBCS. Ouvre dans une nouvelle fentre de document un document Flash (FLA) modifier, et active cette fentre. Ouvre un script (JSFL, AS, ASC) ou tout autre fichier (XML, TXT) dans lditeur de texte de Flash. Ferme Flash en proposant lutilisateur denregistrer tous les documents modifis. Reconstruit le panneau Outils partir du contenu du fichier toolconfig.xml. Cette mthode nest utilise que lors de la cration doutils extensibles. Annule l'inscription d'une fonction enregistre l'aide de fl.addEventListener(). Rinitialise le paramtre de chemin de classe global sur la valeur par dfaut dans la bote de dialogue des paramtres d'ActionScript 3.0. Rinitialise le paramtre de chemin de classe global sur la valeur par dfaut dans la bote de dialogue des paramtres d'ActionScript 2.0. Remplace la version du document spcifi par celle du serveur Version Cue. Excute un fichier JavaScript. Enregistre tous les documents ouverts et affiche la bote de dialogue Enregistrer sous pour ceux qui nont pas encore t enregistrs. Enregistre une version du document spcifi sur le serveur Version Cue. Enregistre le document spcifi sous forme de fichier FLA. Affiche la bote de dialogue Enregistrer sous pour le document spcifi. Active l'option de slection ou d'dition d'un lment. Slectionne l'outil spcifi dans le panneau Outils. Dfinit le document spcifi comme fentre active. Vous permet de dsactiver l'avertissement relatif un script dont l'excution est trop longue. Synchronise le document spcifi avec la dernire version prsente sur le serveur Version Cue. Envoie une chane de texte dans le panneau Sortie.

fl.openDocument()

fl.openScript()

fl.quit()

fl.reloadTools()

fl.removeEventListener()

fl.resetAS3PackagePaths()

fl.resetPackagePaths()

fl.revertDocumentToLastVersion()

fl.runScript() fl.saveAll()

fl.saveAVersionOfDocument()

fl.saveDocument() fl.saveDocumentAs()

fl.selectElement() fl.selectTool() fl.setActiveWindow() fl.showIdleMessage()

fl.synchronizeDocumentWithHeadVersion()

fl.trace()

Rsum des proprits Vous pouvez utiliser les proprits suivantes avec lobjet flash :

EXTENSION DE FLASH CS4 PROFESSIONAL 225

Objet flash (fl)

Proprit
fl.actionsPanel fl.as3PackagePaths

Description Lecture seule ; Objet actionsPanel. Chane correspondant au paramtre de chemin de classe global dans la bote de dialogue des paramtres d'ActionScript 3.0. Lecture seule ; Objet compilerErrors. Lecture seule ; Objet componentsPanel reprsentant le panneau Composants. Lecture seule ; chane indiquant le chemin daccs complet du dossier Configuration de lutilisateur local. Ce chemin est spcifique chaque plateforme. Lecture seule ; chane indiquant le chemin daccs complet du dossier Configuration de lutilisateur local sous la forme fichier:///URI . Valeur boolenne spcifiant si le mode de slection Activer au contact est activ ou non. Lecture seule ; tableau de chanes reprsentant les divers types de documents quil est possible de crer. Lecture seule ; tableau de chanes reprsentant les extensions de fichier des divers types de documents quil est possible de crer. Lecture seule ; tableau de chanes reprsentant les divers types de modles quil est possible de crer. Lecture seule ; tableau d'objets Document (voir Objet Document) reprsentant les documents (fichiers FLA) actuellement ouverts pour modification. Lecture seule ; Objet drawingLayer que doit utiliser un outil extensible lorsque lutilisateur dessine un trac temporaire laide de sa souris. Chane contenant la liste des lments dans le chemin de bibliothque externe ActionScript 3.0 global, spcifiant l'emplacement des fichiers SWC utiliss en tant que bibliothques partages au moment de l'excution. Chane spcifiant le chemin du dossier du kit de dveloppement Flex, qui contient la corbeille, les structures, les bibliothques et d'autres dossiers. Chane qui contient la liste des lments du chemin de bibliothque ActionScript 3.0 global, spcifiant l'emplacement des fichiers SWC ou des dossiers contenant des fichiers SWC. Lecture seule ; Objet Math qui fournit les mthodes ncessaires pour les oprations de matrice et de point. Lecture seule ; tableau des noms de fichier complets de la liste des fichiers rcemment utiliss (MRU, Most Recently Used) gre par l'outil de programmation Flash. Lecture seule ; tableau des types de fichiers de la liste des fichiers rcemment utiliss (MRU, Most Recently Used) gre par l'outil de programmation Flash. Chane correspondant au paramtre de chemin de classe global dans la bote de dialogue des paramtres d'ActionScript 2.0. Entier reprsentant le mode de dessin d'objet qui est activ. Lecture seule ; rfrence lObjet outputPanel. Lecture seule ; Objet presetPanel. Lecture seule ; chane reprsentant le chemin daccs du script JSFL actuellement en cours d'excution et exprime sous la forme fichier:/// URI .

fl.compilerErrors fl.componentsPanel fl.configDirectory

fl.configURI

fl.contactSensitiveSelection

fl.createNewDocList

fl.createNewDocListType

fl.createNewTemplateList

fl.documents

fl.drawingLayer

fl.externalLibraryPath

fl.flexSDKPath

fl.libraryPath

fl.Math

fl.mruRecentFileList

fl.mruRecentFileListType

fl.packagePaths

fl.objectDrawingMode fl.outputPanel fl.presetPanel fl.scriptURI

EXTENSION DE FLASH CS4 PROFESSIONAL 226

Objet flash (fl)

Proprit
fl.sourcePath

Description Chane qui contient la liste des lments du chemin source ActionScript 3.0 global, spcifiant l'emplacement des fichiers de classes ActionScript. Tableau des objets swfPanel enregistrs (voir Objet swfPanel). Lecture seule ; tableau des objets Tools. Lecture seule ; chane longue de la version de l'outil de programmation Flash, plate-forme comprise. Lecture seule ; Objet XMLUI.

fl.swfPanels fl.tools fl.version

fl.xmlui

fl.actionsPanel
Disponibilit Flash CS3 Professional. Utilisation
fl.actionsPanel

Description Proprit en lecture seule ; objet actionsPanel reprsentant le panneau Action actuellement affich. Pour plus d'informations sur l'utilisation de cette proprit, consultez la section Objet actionsPanel.

fl.addEventListener()
Disponibilit Flash CS3 Professional. Utilisation
fl.addEventListener(eventType, callbackFunction)

Paramtres
eventType Chane spcifiant le type dvnement transmettre cette fonction de rappel. Les valeurs possibles sont : "documentNew", "documentOpened", "documentClosed", "mouseMove", "documentChanged", "layerChanged" et "frameChanged".

La valeur documentChanged ne signifie pas que le contenu d'un document a t modifi, mais qu'un autre document se trouve prsent au premier plan. Ainsi, fl.getDocumentDOM() renverra une valeur diffrente de celle qui a t envoye avant que cet vnement se produise.
callbackFunction Nom de la fonction que vous souhaitez excuter chaque fois que l'vnement se produit.

Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 227

Objet flash (fl)

Description Mthode qui enregistre une fonction appeler quand un vnement particulier se produit. Si vous dcidez d'utiliser cette mthode, sachez que lorsque l'vnement se produit frquemment (comme cela peut tre le cas avec mouseMove) et que la fonction demande un certain temps pour s'excuter, votre application peut se bloquer ou ventuellement devenir instable et gnrer des erreurs. Exemple L'exemple suivant affiche un message dans le panneau Sortie la fermeture d'un document :
myFunction = function () { fl.trace('document was closed'); } fl.addEventListener("documentClosed", myFunction);

Voir aussi
fl.removeEventListener()

fl.as3PackagePaths
Disponibilit Flash CS3 Professional. Utilisation
fl.as3PackagePaths

Description Proprit ; chane correspondant au paramtre de chemin de classe global dans la bote de dialogue des paramtres d'ActionScript 3.0. Les lments de la chane sont dlimits par des points-virgules. Pour afficher ou modifier des paramtres de chemin de classe d'ActionScript 2.0, utilisez fl.packagePaths. Exemple Lexemple suivant montre comment modifier les paramtres de chemin de classe d'ActionScript 3.0:
fl.trace(fl.as3PackagePaths); // Output (assuming started with default value) // .;$(AppConfig)/ActionScript 3.0/Classes fl.as3PackagePaths="buying;selling"; fl.trace(fl.as3PackagePaths); // Output // buying; selling

Voir aussi
fl.resetAS3PackagePaths()

EXTENSION DE FLASH CS4 PROFESSIONAL 228

Objet flash (fl)

fl.browseForFileURL()
Disponibilit Flash MX 2004. Utilisation
fl.browseForFileURL(browseType [, title [, previewArea]])

Paramtres
browseType Chane spcifiant le type dopration effectuer sur les fichiers. Les valeurs gres sont "open" (ouvrir), "select" (slectionner) ou "save" (enregistrer). Les valeurs "open" et "select" ouvrent la bote de dialogue douverture de fichier. Chaque valeur est prvue pour tre compatible avec Dreamweaver. La valeur "save" ouvre la bote de dialogue denregistrement de fichier. title Chane indiquant le titre de la bote de dialogue douverture ou denregistrement de fichier. Si ce paramtre est omis, une chane par dfaut est utilise. Ce paramtre est facultatif. previewArea Paramtre facultatif qui est ignor par Flash et Fireworks, et uniquement destin la compatibilit avec

Dreamweaver. Valeur renvoye URL du fichier, exprime sous la forme fichier:///URI . Renvoie la valeur null si lutilisateur a ferm la bote de dialogue en cliquant sur le bouton Annuler. Description Mthode qui ouvre une bote de dialogue Fichier Ouvrir ou Fichier Enregistrer pour permettre lutilisateur dindiquer un nom de fichier ouvrir ou enregistrer. Exemple L'exemple suivant permet lutilisateur de choisir un fichier FLA, et ouvre ce fichier. (La mthode fl.browseForFileURL() permet de rechercher tous les types de fichiers, mais fl.openDocument() ne permet douvrir que des fichiers FLA.)
var fileURL = fl.browseForFileURL("open", "Select file"); var doc = fl.openDocument(fileURL);

Voir aussi
fl.browseForFolderURL()

fl.browseForFolderURL()
Disponibilit Flash 8. Utilisation
fl.browseForFolderURL([description])

EXTENSION DE FLASH CS4 PROFESSIONAL 229

Objet flash (fl)

Paramtres
description Chane facultative spcifiant la description de la bote de dialogue Rechercher un dossier. Si ce paramtre est omis, rien napparat dans la zone de description.

Valeur renvoye URL du fichier, exprime sous la forme fichier:///URI . Renvoie la valeur null si lutilisateur a ferm la bote de dialogue en cliquant sur le bouton Annuler. Description Mthode qui affiche la bote de dialogue Rechercher un dossier et permet lutilisateur de slectionner un dossier. Remarque : le titre de la bote de dialogue est toujours Rechercher un dossier . Utilisez le paramtre description pour ajouter sous le titre des informations dans la zone de description, par exemple Slectionnez un dossier ou Slectionnez le chemin contenant le profil importer . Exemple L'exemple suivant permet lutilisateur de slectionner un dossier, puis affiche la liste des fichiers qu'il contient :
var folderURI = fl.browseForFolderURL("Select a folder."); var folderContents = FLfile.listFolder(folderURI);

Voir aussi
fl.browseForFileURL(), Objet FLfile

fl.clipCopyString()
Disponibilit Flash CS3 Professional. Utilisation
fl.clipCopyString(string)

Paramtres chane Chane copier dans le Presse-papiers. Valeur renvoye Aucune. Description Mthode qui copie la chane spcifie dans le Presse-papiers. Pour copier la slection actuelle dans le Presse-papiers, utilisez document.clipCopy(). Exemple Lexemple suivant copie le chemin d'accs du document actif dans le Presse-papiers :
var documentPath = fl.getDocumentDOM().path; fl.clipCopyString(documentPath);

EXTENSION DE FLASH CS4 PROFESSIONAL 230

Objet flash (fl)

fl.closeAll()
Disponibilit Flash MX 2004. Utilisation
fl.closeAll([bPromptToSave])

Paramtres
bPromptToSave Valeur boolenne facultative indiquant quelle bote de dialogue doit s'afficher : Enregistrer, pour les fichiers modifis depuis leur enregistrement ou Enregistrer sous, pour les fichiers qui n'ont jamais t enregistrs. La valeur par dfaut est true.

Valeur renvoye Aucune. Description Mthode qui ferme tous les fichiers ouverts (fichiers FLA, SWF, JSFL, etc.). Si vous souhaitez fermer tous ces fichiers sans enregistrer une seule modification dans l'un d'entre eux, transmettez la valeur false pour bPromptToSave. Cette mthode ne ferme pas l'application. Exemple Le code suivant ferme tous les fichiers ouverts en invitant l'utilisateur enregistrer les fichiers nouveaux ou modifis.
fl.closeAll();

Voir aussi
fl.closeAllPlayerDocuments(), fl.closeDocument()

fl.closeAllPlayerDocuments()
Disponibilit Flash CS3 Professional. Utilisation
fl.closeAllPlayerDocuments()

Paramtres Aucun. Valeur renvoye Valeur boolenne, true si une ou plusieurs fentres d'animation taient ouvertes, false dans le cas contraire. Description Mthode qui ferme tous les fichiers SWF qui ont t ouverts par la commande Contrle > Tester l'animation.

EXTENSION DE FLASH CS4 PROFESSIONAL 231

Objet flash (fl)

Exemple L'exemple suivant ferme tous les fichiers SWF qui ont t ouverts par la commande Contrle > Tester l'animation.
fl.closeAllPlayerDocuments();

Voir aussi
fl.closeAll(), fl.closeDocument()

fl.closeDocument()
Disponibilit Flash MX 2004. Utilisation
fl.closeDocument(documentObject [, bPromptToSaveChanges])

Paramtres
documentObject Objet Document. Si documentObject fait rfrence au document actif, il est possible que la fentre

Document ne se ferme pas avant la fin de lexcution du script qui appelle cette mthode.
bPromptToSaveChanges Valeur boolenne. Lorsque la valeur de bPromptToSaveChanges est false, lutilisateur nest

pas invit enregistrer le document si celui-ci contient des modifications non enregistres. Le fichier est simplement ferm et les changements ignors. Si bPromptToSaveChanges prend la valeur true et si le document contient des modifications non enregistres, lutilisateur en est averti par la bote de dialogue d'enregistrement standard avec les boutons Oui et Non. La valeur par dfaut est true. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui ferme le document spcifi. Exemple L'exemple suivant illustre deux faons de fermer un document.
// Closes the specified document and prompts to save changes. fl.closeDocument(fl.documents[0]); fl.closeDocument(fl.documents[0] , true); // Use of true is optional. // Closes the specified document without prompting to save changes. fl.closeDocument(fl.documents[0], false);

Voir aussi
fl.closeAll()

EXTENSION DE FLASH CS4 PROFESSIONAL 232

Objet flash (fl)

fl.compilerErrors
Disponibilit Flash CS3 Professional. Utilisation
fl.compilerErrors

Description Proprit en lecture seule ; objet compilerErrors reprsentant le panneau des erreurs. Pour plus d'informations sur l'utilisation de cette proprit, consultez la section Objet compilerErrors.

fl.componentsPanel
Disponibilit Flash MX 2004. Utilisation
fl.componentsPanel

Description Proprit en lecture seule ; Objet componentsPanel reprsentant le panneau Composants. Exemple L'exemple suivant stocke un objet componentsPanel dans la variable comPanel :
var comPanel = fl.componentsPanel;

fl.configDirectory
Disponibilit Flash MX 2004. Utilisation
fl.configDirectory

Description Proprit en lecture seule ; chane indiquant le chemin daccs complet du dossier Configuration de lutilisateur local. Le format de ce chemin est spcifique chaque plate-forme. Pour spcifier ce chemin sous la forme fichier:///URI , ce qui nest pas spcifique une plate-forme, utilisez fl.configURI. Exemple L'exemple suivant affiche le dossier Configuration dans le panneau Sortie.
fl.trace("My local configuration directory is " + fl.configDirectory);

EXTENSION DE FLASH CS4 PROFESSIONAL 233

Objet flash (fl)

fl.configURI
Disponibilit Flash MX 2004. Utilisation
fl.configURI

Description Proprit en lecture seule ; chane indiquant le chemin daccs complet du dossier Configuration de lutilisateur local sous la forme fichier:///URI . Voir aussi fl.configDirectory. Exemple L'exemple suivant excute le script spcifi. Lutilisation de fl.configURI permet de spcifier lemplacement du script sans savoir sur quelle plate-forme le script est excut.
// To run a command in your commands menu, change "Test.Jsfl" // to the command you want to run in the line below. fl.runScript( fl.configURI + "Commands/Test.jsfl" );

fl.contactSensitiveSelection
Disponibilit Flash 8. Utilisation
fl.contactSensitiveSelection

Description Valeur boolenne prcisant si le mode de slection Activer au contact est activ (true) ou non (false). Exemple L'exemple suivant montre comment dsactiver le mode de slection Activer au contact avant d'effectuer une slection, puis comment lui rendre sa valeur initiale aprs avoir effectu la slection :
var contact = fl.contactSensitiveSelection; fl.contactSensitiveSelection = false; // Insert selection code here. fl.contactSensitiveSelection = contact;

fl.createDocument()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 234

Objet flash (fl)

Utilisation
fl.createDocument([docType])

Paramtres docType Chane spcifiant le type de document crer. Les valeurs gres sont "timeline" (scnario), "presentation" et "application". La valeur par dfaut est "timeline" et revient slectionner Fichier > Nouveau > Fichier Flash (ActionScript 3.0). Ce paramtre est facultatif. Valeur renvoye En cas de succs de la mthode, l'objet Document associ au nouveau document. En cas derreur, elle renvoie la valeur undefined. Description Mthode qui ouvre un nouveau document et le slectionne. Les valeurs de taille, rsolution et couleur sont les valeurs par dfaut actuelles. Exemple L'exemple suivant cre diffrents types de documents :
// Create two Timeline-based Flash documents. fl.createDocument(); fl.createDocument("timeline"); // Create a Slide Presentation document. fl.createDocument("presentation"); // Create a Form Application document. fl.createDocument("application");

fl.createNewDocList
Disponibilit Flash MX 2004. Utilisation
fl.createNewDocList

Description Proprit en lecture seule ; tableau de chanes reprsentant les divers types de documents quil est possible de crer. Exemple L'exemple suivant affiche dans le panneau Sortie les types de documents quil est possible de crer :
fl.trace("Number of choices " + fl.createNewDocList.length); for (i = 0; i < fl.createNewDocList.length; i++) fl.trace("choice: " + fl.createNewDocList[i]);

EXTENSION DE FLASH CS4 PROFESSIONAL 235

Objet flash (fl)

fl.createNewDocListType
Disponibilit Flash MX 2004. Utilisation
fl.createNewDocListType

Description Proprit en lecture seule ; tableau de chanes reprsentant les extensions de fichier des divers types de documents quil est possible de crer. Les entres du tableau correspondent directement ( index identique) aux entres du tableau fl.createNewDocList. Exemple L'exemple suivant affiche dans le panneau Sortie les extensions des types de documents quil est possible de crer :
fl.trace("Number of types " + fl.createNewDocListType.length); for (i = 0; i < fl.createNewDocListType.length; i++) fl.trace("type: " + fl.createNewDocListType[i]);

fl.createNewTemplateList
Disponibilit Flash MX 2004. Utilisation
fl.createNewTemplateList

Description Proprit en lecture seule ; tableau de chanes reprsentant les divers types de modles quil est possible de crer. Exemple L'exemple suivant affiche dans le panneau Sortie les types de modles quil est possible de crer :
fl.trace("Number of template types: " + fl.createNewTemplateList.length); for (i = 0; i < fl.createNewTemplateList.length; i++) fl.trace("type: " + fl.createNewTemplateList[i]);

fl.documents
Disponibilit Flash MX 2004. Utilisation
fl.documents

EXTENSION DE FLASH CS4 PROFESSIONAL 236

Objet flash (fl)

Description Proprit en lecture seule ; tableau des objets Document (voir Objet Document) reprsentant les documents (fichiers FLA) actuellement ouverts pour modification. Exemple L'exemple suivant enregistre dans la variable docs un tableau des documents ouverts :
var docs = fl.documents;

Lexemple suivant affiche dans le panneau Sortie les noms de tous les documents actuellement ouverts :
for (doc in fl.documents) { fl.trace(fl.documents[doc].name); }

fl.downloadLatestVersion()
Disponibilit Flash CS3 Professional. Utilisation
fl.downloadLatestVersion(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et prcisant le chemin d'accs local du fichier tlcharger depuis le serveur Version Cue. Seuls les fichiers qui ne sont pas encore ouverts peuvent tre tlchargs. Si le fichier spcifi par fileURI est dj ouvert, cette mthode na aucun effet. Valeur renvoye Valeur boolenne, true si le fichier a bien t tlcharg, false dans le cas contraire. Description Mthode qui tlcharge, partir du serveur Version Cue, la version la plus rcente d'un fichier qui n'est pas actuellement ouvert. Pour tlcharger la dernire version d'un fichier ouvert, utilisez document.synchronizeWithHeadVersion(). Exemple L'exemple suivant tlcharge le fichier nomm myFile.fla partir du serveur Version Cue :
fl.downloadLatestVersion("file:///C|/MyFiles/Version Cue/docs/myFile.fla");

Voir aussi
document.synchronizeWithHeadVersion(), fl.revertDocumentToLastVersion(), fl.saveAVersionOfDocument(), fl.synchronizeDocumentWithHeadVersion()

EXTENSION DE FLASH CS4 PROFESSIONAL 237

Objet flash (fl)

fl.drawingLayer
Disponibilit Flash MX 2004. Utilisation
fl.drawingLayer

Description Proprit en lecture seule ; Objet drawingLayer que doit utiliser un outil extensible lorsque lutilisateur dessine un trac temporaire laide de la souris (par exemple, pour crer un rectangle de slection). Exemple Voir drawingLayer.setColor().

fl.externalLibraryPath
Disponibilit Flash CS4 Professional. Utilisation
fl.externalLibraryPath

Description Proprit ; chane contenant la liste des lments dans le chemin de bibliothque externe ActionScript 3.0 global, spcifiant l'emplacement des fichiers SWC utiliss en tant que bibliothques partages au moment de l'excution. Les lments de la chane sont dlimits par des points-virgules. Dans l'outil de programmation, les lments sont spcifis en slectionnant Modifier > Prfrences > ActionScript > Paramtres d'ActionScript 3.0. Exemple L'exemple suivant ajoute le dossier /SWC_runtime dans le chemin de bibliothque externe ActionScript 3.0 global :
fl.trace(fl.externalLibraryPath); fl.externalLibraryPath = "/SWC_runtime;" + fl.externalLibraryPath; fl.trace(fl.externalLibraryPath);

Voir aussi
fl.flexSDKPath, fl.libraryPath, fl.sourcePath, document.externalLibraryPath

fl.fileExists()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 238

Objet flash (fl)

Utilisation
fl.fileExists(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et contenant le chemin daccs du fichier. Valeur renvoye Valeur boolenne, true si le fichier existe, false dans le cas contraire. Description Mthode qui vrifie si un fichier existe dj sur le disque dur. Exemple Pour chaque fichier spcifi, l'exemple suivant affiche dans le panneau Sortie la valeur true si le fichier existe, false dans le cas contraire.
alert(fl.fileExists("file:///C|/example.fla")); alert(fl.fileExists("file:///C|/example.jsfl")); alert(fl.fileExists(""));

fl.findDocumentDOM()
Disponibilit Flash CS3 Professional. Utilisation
fl.findDocumentDOM(id)

Paramtres id Entier reprsentant un identificateur unique pour un document. Valeur renvoye Un objet Document, ou la valeur null s'il n'existe aucun document dot de l'id spcifi. Description Mthode qui permet de cibler un fichier spcifique au moyen de son identificateur unique (au lieu d'utiliser sa valeur d'index, par exemple). Utilisez cette mthode conjointement avec document.id. Exemple L'exemple suivant illustre la lecture de l'ID d'un document, puis son utilisation pour cibler le document en question.
var originalDocID = fl.getDocumentDOM().id; // other code here, maybe working in different files var targetDoc = fl.findDocumentDOM(originalDocID); // Set the height of the Stage in the original document to 400 pixels. targetDoc.height = 400;

EXTENSION DE FLASH CS4 PROFESSIONAL 239

Objet flash (fl)

Voir aussi
fl.findDocumentIndex()

fl.findDocumentIndex()
Disponibilit Flash MX 2004. Utilisation
fl.findDocumentIndex(name)

Paramtres name Nom du document dont vous souhaitez connatre lindex. Ce document doit tre ouvert. Valeur renvoye Tableau d'entiers reprsentant la position du document name dans le tableau fl.documents. Description Mthode qui renvoie un tableau d'entiers reprsentant la position du document name dans le tableau fl.documents. Il se peut que plusieurs documents du mme nom soient ouverts (s'ils se trouvent dans des dossiers diffrents). Exemple L'exemple suivant affiche, dans le panneau Sortie, des informations sur la position d'index de tous les fichiers appels test.fla :
var filename = "test.fla" var docIndex = fl.findDocumentIndex(filename); for (var index in docIndex) fl.trace(filename + " is open at index " + docIndex[index]);

Voir aussi
fl.documents, fl.findDocumentDOM()

fl.findObjectInDocByName()
Disponibilit Flash CS3 Professional. Utilisation
fl.findObjectInDocByName(instanceName, document)

Paramtres
instanceName Chane indiquant le nom d'occurrence d'un lment dans le document spcifi. document Objet Document dans lequel rechercher l'lment spcifi.

EXTENSION DE FLASH CS4 PROFESSIONAL 240

Objet flash (fl)

Valeur renvoye Un tableau d'objets gnriques. Utilisez la proprit .obj de chaque lment du tableau pour obtenir l'objet. L'objet possde les proprits suivantes : keyframe, layer, timeline et parent. Vous pouvez utiliser ces proprits pour accder la hirarchie de l'objet. Pour plus d'informations sur ces proprits et sur leur accs, consultez la section fl.findObjectInDocByType(). Vous pouvez galement accder aux mthodes et aux proprits des valeurs layer et timeline ; il s'agit respectivement des quivalents de l'Objet Layer et de l'Objet Timeline. Description Mthode qui expose les lments d'un document dont les noms d'occurrences correspondent un texte particulier. Remarque : dans certains cas, cette mthode ne fonctionne que si elle est excute en tant que commande issue d'un fichier FLA, et non pendant l'affichage ou la modification du fichier JSFL. Exemple L'exemple suivant recherche les lments nomms instance01 dans le document actuel.
var nameToSearchFor = "instance01"; var doc = fl.getDocumentDOM(); var results = fl.findObjectInDocByName(nameToSearchFor, doc); if (results.length > 0) { alert("success, found " + results.length + " objects"); } else { alert("failed, no objects named " + nameToSearchFor + " found"); }

Voir aussi
fl.findObjectInDocByType()

fl.findObjectInDocByType()
Disponibilit Flash CS3 Professional. Utilisation
fl.findObjectInDocByType(elementType, document)

Paramtres
elementType Chane reprsentant le type d'lment rechercher. Les valeurs possibles sont indiques la section element.elementType. document Objet Document dans lequel rechercher l'lment spcifi.

Valeur renvoye Un tableau d'objets gnriques. Utilisez la proprit .obj de chaque lment du tableau pour obtenir l'objet Element. Chaque objet possde les proprits keyframe, layer, timeline et parent. Vous pouvez utiliser ces proprits pour accder la hirarchie de l'objet.

EXTENSION DE FLASH CS4 PROFESSIONAL 241

Objet flash (fl)

Vous pouvez galement accder aux mthodes et aux proprits des valeurs layer et timeline ; il s'agit respectivement des quivalents de l'Objet Layer et de l'Objet Timeline. Le deuxime et le troisime exemple de la section Exemples montrent comment accder ces proprits. Description Mthode qui expose des lments d'un type particulier dans un document. Remarque : dans certains cas, cette mthode ne fonctionne que si elle est excute en tant que commande issue d'un fichier FLA, et non pendant l'affichage ou la modification du fichier JSFL. Exemple L'exemple suivant recherche des champs de texte dans le document actif, puis modifie leur contenu :
var doc = fl.getDocumentDOM(); var typeToSearchFor = "text"; var results = fl.findObjectInDocByType(typeToSearchFor, doc); if (results.length > 0) { for (var i = 0; i < results.length; i++) { results[i].obj.setTextString("new text"); } alert("success, found " + results.length + " objects"); } else { alert("failed, no objects of type " + typeToSearchFor + " found"); }

L'exemple suivant montre comment accder aux proprits spciales de l'objet renvoy par cette mthode :
var doc = fl.getDocumentDOM(); var resultsArray = findObjectInDocByType("text", doc); if (resultsArray.length > 0) { var firstItem = resultsArray[0]; // firstItem.obj- This is the element object that was found. // // // // // // } You can access the following properties of this object: firstItem.keyframe- The keyframe that the element is on. firstItem.layer- The layer that the keyframe is on. firstItem.timeline- The timeline that the layer is on. firstItem.parent- The parent of the timeline. For example, the timeline might be in a symbol instance.

L'exemple suivant montre comment sauvegarder le DOM pour trouver le nom d'un calque dans lequel un champ de texte a t trouv, par le biais de l'objet resultArray.obj :

EXTENSION DE FLASH CS4 PROFESSIONAL 242

Objet flash (fl)

var doc = fl.getDocumentDOM(); var typeToSearchFor = "text"; var resultsArray = fl.findObjectInDocByType(typeToSearchFor, doc); if (resultsArray.length > 0) { for (var i = 0; i < resultsArray.length; i++) { resultsArray[i].obj.setTextString("new text"); var firstItem = resultsArray[0]; firstItemObj = firstItem.obj; fl.trace(firstItemObj.layer.name+"layerName"); } } else { alert("failed, no objects of type " + typeToSearchFor + " found"); }

Voir aussi
fl.findObjectInDocByName()

fl.flexSDKPath
Disponibilit Flash CS4 Professional. Utilisation
fl.flexSDKPath

Description Proprit ; chane spcifiant le dossier du kit de dveloppement Flex, qui contient la corbeille, les structures, les bibliothques et d'autres dossiers. Dans l'outil de programmation, les lments sont spcifis en slectionnant Modifier > Prfrences > ActionScript > Paramtres d'ActionScript 3.0. Exemple Le code suivant affiche le chemin d'accs du kit de dveloppement Flex dans le panneau Sortie :
fl.trace(fl.flexSDKPath);

Voir aussi
fl.externalLibraryPath,fl.libraryPath, fl.sourcePath

fl.getAppMemoryInfo()
Disponibilit Flash 8 (Windows uniquement). Utilisation
fl.getAppMemoryInfo(memType)

EXTENSION DE FLASH CS4 PROFESSIONAL 243

Objet flash (fl)

Paramtres memType Nombre entier prcisant la zone dutilisation mmoire demander. La liste des valeurs gres est indique dans la description suivante. Valeur renvoye Entier reprsentant le nombre doctets utiliss dans la zone mmoire de Flash.exe spcifie. Description Mthode (Windows uniquement) qui renvoie un entier reprsentant le nombre doctets utiliss dans la zone mmoire de Flash.exe spcifie. Utilisez le tableau suivant pour dterminer la valeur transmettre comme memType :
memType 0 1 2 3 4 5 6 7 8 Donnes de ressource
PAGEFAULTCOUNT PEAKWORKINGSETSIZE WORKINGSETSIZE QUOTAPEAKPAGEDPOOLUSAGE QUOTAPAGEDPOOLUSAGE QUOTAPEAKNONPAGEDPOOLUSAGE QUOTANONPAGEDPOOLUSAGE PAGEFILEUSAGE PEAKPAGEFILEUSAGE

Exemple L'exemple suivant affiche la consommation actuelle de la mmoire de travail :

var memsize = fl.getAppMemoryInfo(2); fl.trace("Flash current memory consumption is " + memsize + " bytes or " + memsize/1024 + " KB");

fl.getDocumentDOM()
Disponibilit Flash MX 2004. Utilisation
fl.getDocumentDOM()

Paramtres Aucun. Valeur renvoye Un objet Document, ou la valeur null si aucun document nest ouvert.

EXTENSION DE FLASH CS4 PROFESSIONAL 244

Objet flash (fl)

Description Mthode qui rcupre le DOM (Objet Document) du document actuellement actif (fichier FLA). Si un ou plusieurs documents sont ouverts, mais quaucun deux na le focus (si, par exemple, un fichier JSFL a le focus), la mthode lit le DOM du dernier document actif. Exemple L'exemple suivant affiche dans le panneau Sortie le nom du document Flash actif, ou du document Flash qui a t actif le plus rcemment.
var currentDoc = fl.getDocumentDOM(); fl.trace(currentDoc.name);

fl.isFontInstalled()
Disponibilit Flash CS4 Professional. Utilisation
fl.isFontInstalled(fontName)

Paramtres fontName Chane qui spcifie le nom d'une police de priphrique. Valeur renvoye Valeur boolenne, true si la police spcifie est installe, false dans le cas contraire. Description Mthode qui dtermine si la police spcifie est installe. Exemple Le code suivant affiche true dans le panneau Sortie si la police Times est installe.
fl.trace(fl.isFontInstalled("Times"));

fl.libraryPath
Disponibilit Flash CS4 Professional. Utilisation
fl.libraryPath

EXTENSION DE FLASH CS4 PROFESSIONAL 245

Objet flash (fl)

Description Proprit ; chane qui contient la liste des lments du chemin de bibliothque ActionScript 3.0 global, spcifiant l'emplacement des fichiers SWC ou des dossiers contenant des fichiers SWC. Les lments de la chane sont dlimits par des points-virgules. Dans l'outil de programmation, les lments sont spcifis en slectionnant Modifier > Prfrences > ActionScript > Paramtres d'ActionScript 3.0. Exemple L'exemple suivant ajoute le dossier /SWC au chemin de bibliothque ActionScript 3.0 global :
fl.trace(fl.libraryPath); fl.libraryPath = "/SWC;" + fl.libraryPath; fl.trace(fl.libraryPath);

Voir aussi
fl.externalLibraryPath,fl.flexSDKPath, fl.sourcePath, document.libraryPath

fl.mapPlayerURL()
Disponibilit Flash MX 2004. Utilisation
fl.mapPlayerURL(URI [, returnMBCS])

Paramtres URI Chane contenant ladresse URL avec squences d'chappement en Unicode convertir.
returnMBCS Valeur boolenne devant tre dfinie sur true pour que le chemin soit renvoy converti en MBCS avec

squences d'chappement. Sinon, la mthode renvoie une chane en UTF-8. La valeur par dfaut est false. Ce paramtre est facultatif. Valeur renvoye Chane qui est ladresse URL convertie. Description Mthode qui convertit une adresse URL avec squences d'chappement Unicode en une URL en UTF-8 ou MBCS. Il est conseill dappeler cette mthode si la chane doit tre utilise dans ActionScript pour accder une ressource externe. De plus, il est ncessaire de lutiliser pour manipuler des caractres multi-octets. Exemple L'exemple suivant convertit une URL en UTF-8 pour permettre Flash Player de la charger :
var url = MMExecute( "fl.mapPlayerURL(" + myURL + ", false);" ); mc.loadMovie( url);

EXTENSION DE FLASH CS4 PROFESSIONAL 246

Objet flash (fl)

fl.Math
Disponibilit Flash MX 2004. Utilisation
fl.Math

Description Proprit en lecture seule ; lObjet Math fournit les mthodes ncessaires pour les oprations de matrice et de point. Exemple Lexemple suivant montre la matrice de transformation de lobjet slectionn et son inverse :
// Select an element on the Stage and then run this script. var mat =fl.getDocumentDOM().selection[0].matrix; for(var prop in mat){ fl.trace("mat."+prop+" = " + mat[prop]); } var invMat = fl.Math.invertMatrix( mat ); for(var prop in invMat) { fl.trace("invMat."+prop+" = " + invMat[prop]); }

fl.mruRecentFileList
Disponibilit Flash MX 2004. Utilisation
fl.mruRecentFileList

Description Proprit en lecture seule ; tableau des noms de fichier complets de la liste des fichiers rcemment utiliss (MRU, Most Recently Used) gre par l'outil de programmation Flash. Exemple L'exemple suivant affiche dans le panneau Sortie le nombre de fichiers rcemment ouverts et le nom de chacun de ces fichiers :
fl.trace("Number of recently opened files: " + fl.mruRecentFileList.length); for (i = 0; i < fl.mruRecentFileList.length; i++) fl.trace("file: " + fl.mruRecentFileList[i]);

EXTENSION DE FLASH CS4 PROFESSIONAL 247

Objet flash (fl)

fl.mruRecentFileListType
Disponibilit Flash MX 2004. Utilisation
fl.mruRecentFileListType

Description Proprit en lecture seule ; tableau des types de fichiers de la liste des fichiers rcemment utiliss (MRU, Most Recently Used) gre par l'outil de programmation Flash. Ce tableau correspond celui de la proprit fl.mruRecentFileList. Exemple L'exemple suivant affiche dans le panneau Sortie le nombre de fichiers rcemment ouverts et le type de chacun d'eux :
fl.trace("Number of recently opened files: " + fl.mruRecentFileListType.length); for (i = 0; i < fl.mruRecentFileListType.length; i++) fl.trace("type: " + fl.mruRecentFileListType[i]);

fl.objectDrawingMode
Disponibilit Flash 8. Utilisation
fl.objectDrawingMode

Description Proprit ; valeur boolenne dterminant si le mode de dessin d'objet est activ (true) ou si le mode de dessin de fusion est activ (false). Exemple L'exemple suivant active/dsactive le mode Dessin d'objet :
var toggleMode = fl.objectDrawingMode; if (toggleMode) { fl.objectDrawingMode = false; } else { fl.objectDrawingMode = true; }

fl.openDocument()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 248

Objet flash (fl)

Utilisation
fl.openDocument(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et prcisant le nom du fichier ouvrir. Valeur renvoye En cas de succs de la mthode, Objet Document associ au nouveau document ouvert. Si le fichier est introuvable, ou si ce nest pas un fichier FLA valide, une erreur est affiche et lexcution du script est annule. Description Mthode qui ouvre dans une nouvelle fentre de document un document Flash (FLA) modifier et active cette fentre. Pour lutilisateur, leffet est identique au choix de loption de menu Fichier > Ouvrir et la slection dun fichier. Si le fichier spcifi est dj ouvert, la fentre qui contient ce document passe au premier plan. La fentre qui contient le fichier spcifi devient le document actuellement slectionn. Exemple L'exemple suivant ouvre un fichier nomm Document.fla qui est enregistr dans le rpertoire racine du lecteur C. Le code stocke un objet Document reprsentant ce document dans la variable doc et le dfinit pour qu'il soit le document actuellement slectionn. En dautres termes, tant que la fentre active reste la mme (tant que le focus nest pas modifi), fl.getDocumentDOM() renvoie ce document.
var doc = fl.openDocument("file:///c|/Document.fla");

fl.openScript()
Disponibilit Flash MX 2004. Utilisation
fl.openScript(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et prcisant le chemin daccs du fichier JSFL, AS, ASC, XML, TXT ou de tout autre fichier charger dans lditeur de texte de Flash. Valeur renvoye Aucune. Description Mthode qui ouvre un script (JSFL, AS, ASC) ou tout autre fichier (XML, TXT) dans lditeur de texte de Flash. Exemple L'exemple suivant ouvre un fichier nomm my_test.jsfl, qui est enregistr dans le rpertoire /temp du lecteur C.
fl.openScript("file:///c|/temp/my_test.jsfl");

EXTENSION DE FLASH CS4 PROFESSIONAL 249

Objet flash (fl)

fl.outputPanel
Disponibilit Flash MX 2004. Utilisation
fl.outputPanel

Description Proprit en lecture seule ; rfrence l Objet outputPanel. Exemple Voir Objet outputPanel.

fl.packagePaths
Disponibilit Flash CS3 Professional. Utilisation
fl.packagePaths

Description Proprit ; chane correspondant au paramtre de chemin de classe global dans la bote de dialogue des paramtres d'ActionScript 2.0. Les chemins d'accs de classe sont dlimits par des points-virgules (;) dans la chane. Pour afficher ou modifier des paramtres de chemin de classe d'ActionScript 3.0, utilisez fl.as3PackagePaths. Exemple Lexemple suivant montre comment modifier les paramtres de chemin de classe d'ActionScript 2.0:
fl.trace(fl.packagePaths); // Output (assuming started with default value) // .;$(LocalData)/Classes fl.packagePaths="buying;selling"; fl.trace(fl.packagePaths); // Output // buying; selling

Voir aussi
fl.resetPackagePaths()

fl.presetPanel
Disponibilit Flash CS4 Professional.

EXTENSION DE FLASH CS4 PROFESSIONAL 250

Objet flash (fl)

Utilisation
fl.presetPanel

Description Proprit en lecture seule ; Objet presetPanel.

fl.quit()
Disponibilit Flash MX 2004. Utilisation
fl.quit([bPromptIfNeeded])

Paramtres
bPromptIfNeeded Valeur boolenne devant prendre la valeur true (par dfaut) pour que lutilisateur soit invit

enregistrer les documents modifis. Si la valeur de ce paramtre est false, lutilisateur ne sera pas invit enregistrer les documents modifis. Dans ce cas, toute modification des documents ouverts sera annule, et lapplication se fermera immdiatement. Bien que cette mthode soit utile pour le traitement par lots, il est conseill de lutiliser avec prcaution. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui ferme Flash en proposant lutilisateur denregistrer les documents modifis. Exemple L'exemple suivant illustre la fermeture du programme en proposant ou non denregistrer les documents modifis :
// Quit with prompt to save any modified documents. fl.quit(); fl.quit(true); // True is optional. // Quit without saving any files. fl.quit(false);

fl.reloadEffects()
Disponibilit Flash MX 2004. Utilisation
fl.reloadEffects()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 251

Objet flash (fl)

Valeur renvoye Aucune. Description Mthode qui recharge tous les descripteurs deffets dfinis dans le dossier Configuration Effects de lutilisateur. Elle permet de modifier rapidement les scripts durant le dveloppement, donc damliorer les effets sans redmarrer lapplication. Il est conseill dappeler cette mthode partir dune commande place dans le dossier Commands. Exemple L'exemple suivant est un script dune ligne qui peut tre plac dans le dossier Commands. Sil est ncessaire de recharger des effets, il est ensuite facile douvrir le menu Commandes et dexcuter le script.
fl.reloadEffects();

fl.reloadTools()
Disponibilit Flash MX 2004. Utilisation
fl.reloadTools()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui reconstruit le panneau Outils partir du contenu du fichier toolconfig.xml. Cette mthode nest utilise que lors de la cration doutils extensibles. Employez-la quand vous devez recharger le panneau Outils, par exemple aprs avoir modifi le fichier JSFL dfinissant un outil qui se trouve dj dans le panneau. Exemple L'exemple suivant est un script dune ligne qui peut tre plac dans le dossier Commands. Lorsque vous souhaitez recharger le panneau Outils, excutez le script depuis le menu Commandes.
fl.reloadTools();

fl.removeEventListener()
Disponibilit Flash CS3 Professional. Utilisation
fl.removeEventListener(eventType)

EXTENSION DE FLASH CS4 PROFESSIONAL 252

Objet flash (fl)

Paramtres
eventType Chane spcifiant le type dvnement supprimer de cette fonction de rappel. Les valeurs possibles sont : "documentNew", "documentOpened", "documentClosed", "mouseMove", "documentChanged", "layerChanged" et "frameChanged".

Valeur renvoye Valeur boolenne, true si l'couteur d'vnement a bien t supprim, false si la fonction n'a jamais t ajoute la liste par la mthode fl.addEventListener(). Description Annule l'inscription d'une fonction enregistre l'aide de fl.addEventListener(). Exemple L'exemple suivant retire l'couteur d'vnement associ l'vnement documentClosed :
fl.removeEventListener("documentClosed");

Voir aussi
fl.addEventListener()

fl.resetAS3PackagePaths()
Disponibilit Flash CS3 Professional. Utilisation
fl.resetAS3PackagePaths()

Paramtres Aucun. Description Mthode qui rinitialise le paramtre de chemin de classe global sur la valeur par dfaut dans la bote de dialogue des paramtres d'ActionScript 3.0. Pour rinitialiser le chemin de classe globale d'ActionScript 2.0, utilisez fl.resetPackagePaths(). Exemple L'exemple suivant rinitialise le paramtre de chemin de classe d'ActionScript 3.0 sur sa valeur par dfaut.
fl.resetAS3PackagePaths();

Voir aussi
fl.as3PackagePaths

EXTENSION DE FLASH CS4 PROFESSIONAL 253

Objet flash (fl)

fl.resetPackagePaths()
Disponibilit Flash CS3 Professional. Utilisation
fl.resetPackagePaths()

Paramtres Aucun. Description Mthode qui rinitialise le paramtre de chemin de classe global sur la valeur par dfaut dans la bote de dialogue des paramtres d'ActionScript 2.0. Pour rinitialiser le chemin de classe global d'ActionScript 3.0, utilisez fl.resetAS3PackagePaths(). Exemple L'exemple suivant rinitialise le paramtre de chemin de classe d'ActionScript 2.0 sur sa valeur par dfaut.
fl.resetPackagePaths();

Voir aussi
fl.packagePaths

fl.revertDocument()
Disponibilit Flash MX 2004. Utilisation
fl.revertDocument(documentObject)

Paramtres
documentObject Objet Document. Si documentObject fait rfrence au document actif, il est possible que la fentre

Document ne soit pas rtablie avant la fin de lexcution du script qui appelle cette mthode. Valeur renvoye Valeur boolenne, true en cas de rtablissement russi, false dans le cas contraire. Description Mthode qui restaure la dernire version enregistre du document FLA spcifi. Contrairement loption de menu Fichier > Rtablir, cette mthode naffiche pas de bote de dialogue demandant lutilisateur de confirmer lopration. Voir aussi document.revert() et document.canRevert(). Pour remplacer la version du document spcifi par celle du serveur Version Cue, utilisez
fl.revertDocumentToLastVersion().

EXTENSION DE FLASH CS4 PROFESSIONAL 254

Objet flash (fl)

Exemple L'exemple suivant rtablit la dernire version enregistre du document FLA actuel ; les ventuelles modifications effectues depuis le dernier enregistrement sont perdues.
fl.revertDocument(fl.getDocumentDOM());

fl.revertDocumentToLastVersion()
Disponibilit Flash CS3 Professional. Utilisation
fl.revertDocumentToLastVersion(documentObject)

Paramtres
documentObject Objet Document.

Valeur renvoye Valeur boolenne, true si le document est bien rtabli, false dans le cas contraire. Description Mthode qui, si le rtablissement du fichier est possible, remplace la version du document spcifi par celle du serveur Version Cue et consigne les ventuelles erreurs dans le panneau Sortie. Pour rtablir la dernire version enregistre localement d'un document, utilisez fl.revertDocument(). Exemple Lexemple suivant remplace la version du document actif par celle qui est stocke sur le serveur Version Cue :
fl.revertDocumentToLastVersion(fl.getDocumentDOM());

Voir aussi
document.revertToLastVersion(), fl.downloadLatestVersion(), fl.saveAVersionOfDocument(), fl.synchronizeDocumentWithHeadVersion()

fl.runScript()
Disponibilit Flash MX 2004. Utilisation
fl.runScript(fileURI [, funcName [, arg1, arg2, ...]])

Paramtres fileURI Chane exprime sous la forme fichier:///URI et prcisant le nom du fichier de script excuter.

EXTENSION DE FLASH CS4 PROFESSIONAL 255

Objet flash (fl)

funcName Chane identifiant une fonction excuter dans le fichier JSFL spcifi dans le paramtre fileURI. Ce paramtre est facultatif. arg Paramtre facultatif spcifiant un ou plusieurs arguments transmettre funcname.

Valeur renvoye Une chane si funcName est spcifi, aucune valeur dans le cas contraire. Description Mthode qui excute un fichier JavaScript. Si une fonction est spcifie dans lun des arguments, la mthode l'excute, ainsi que tout le code du script qui n'en fait pas partie. Le reste du code du script est excut avant la fonction. Exemple Supposons qu'un fichier de script appel testScript.jsfl rside dans le rpertoire racine du lecteur C et qu'il contienne les lments suivants :
function testFunct(num, minNum) { fl.trace("in testFunct: 1st arg: " + num + " 2nd arg: " + minNum); } for (i=0; i<2; i++) { fl.trace("in for loop i=" + i); } fl.trace("end of for loop"); // End of testScript.jsfl

Si vous mettez la commande suivante,

fl.runScript("file:///C|/testScript.jsfl", "testFunct", 10, 1);

les informations suivantes apparaissent dans le panneau Sortie :

in for loop i=0 in for loop i=1 end of for loop in testFunct: 1st arg: 10 2nd arg: 1

Il est galement possible dappeler simplement testScript.jsfl sans excuter de fonction, comme suit :
fl.runScript("file:///C|/testScript.jsfl");

Le rsultat suivant s'affiche dans le panneau Sortie :

in for loop i=0 in for loop i=1 end of for loop

fl.saveAll()
Disponibilit Flash MX 2004. Utilisation
fl.saveAll()

EXTENSION DE FLASH CS4 PROFESSIONAL 256

Objet flash (fl)

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui enregistre tous les documents ouverts. Si le fichier n'a jamais t enregistr ou n'a pas t modifi depuis son dernier enregistrement, il n'est pas enregistr. Pour permettre la sauvegarde d'un fichier qui n'a pas t enregistr, ni modifi, utilisez fl.saveDocumentAs(). Exemple L'exemple suivant enregistre tous les documents ouverts qui ont t prcdemment enregistrs et modifis depuis leur dernier enregistrement :
fl.saveAll();

Voir aussi
document.save(), document.saveAndCompact(), fl.saveDocument(), fl.saveDocumentAs()

fl.saveAVersionOfDocument()
Disponibilit Flash CS3 Professional. Utilisation
fl.saveAVersionOfDocument(document)

Paramtres document Objet Document. Valeur renvoye Valeur boolenne, true si une version du document est correctement enregistre sur le serveur Version Cue, sinon false. Description Mthode qui, si le fichier peut tre enregistr sur le serveur Version Cue, affiche une bote de dialogue permettant l'utilisateur d'entrer des commentaires sur la version, puis enregistre une version du document spcifi sur le serveur et consigne les ventuelles erreurs dans le panneau Sortie. Exemple L'exemple suivant enregistre le document actif sur le serveur Version Cue :
f1.saveAVersionOfDocument(f1.getDocumentDOM());

Voir aussi
document.saveAVersion()

EXTENSION DE FLASH CS4 PROFESSIONAL 257

Objet flash (fl)

fl.saveDocument()
Disponibilit Flash MX 2004. Utilisation
fl.saveDocument(document [, fileURI])

Paramtres document Objet Document qui spcifie le document enregistrer. Si document est null, le document actif est enregistr.
fileURI Chane exprime sous la forme fichier:///URI et prcisant le nom du document enregistr. Si le paramtre

fileURI est null ou omis, le document est enregistr sous son nom actuel. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne, true en cas de russite de lenregistrement, false dans le cas contraire. Si le fichier n'a jamais t enregistr, ou s'il n'a pas t modifi depuis son dernier enregistrement, il n'est pas enregistr et la valeur false est renvoye. Pour permettre la sauvegarde d'un fichier qui n'a pas t enregistr, ni modifi, utilisez fl.saveDocumentAs(). Description Mthode qui enregistre le document spcifi sous forme de fichier FLA. Exemple L'exemple suivant enregistre le document actif et deux autres documents spcifis :
// Save the current document. alert(fl.saveDocument(fl.getDocumentDOM())); // Save the specified documents. alert(fl.saveDocument(fl.documents[0], "file:///C|/example1.fla")); alert(fl.saveDocument(fl.documents[1],"file:///C|/example2.fla"));

Voir aussi
document.save(), document.saveAndCompact(), fl.saveAll(), fl.saveDocumentAs()

fl.saveDocumentAs()
Disponibilit Flash MX 2004. Utilisation
fl.saveDocumentAs(document)

Paramtres document Objet Document qui spcifie le document enregistrer. Si document est null, le document actif est enregistr.

EXTENSION DE FLASH CS4 PROFESSIONAL 258

Objet flash (fl)

Valeur renvoye Valeur boolenne, true si l'opration Enregistrer sous est russie, false dans le cas contraire. Description Mthode qui affiche la bote de dialogue Enregistrer sous pour le document spcifi. Exemple L'exemple suivant invite l'utilisateur enregistrer le document spcifi, puis affiche un message d'alerte qui indique si le document a t enregistr :
alert(fl.saveDocumentAs(fl.documents[1]));

Voir aussi
document.save(), document.saveAndCompact(), fl.saveAll(), fl.saveDocument()

fl.scriptURI
Disponibilit Flash CS3 Professional. Utilisation
fl.scriptURI

Description Proprit en lecture seule ; chane reprsentant le chemin daccs du script JSFL actuellement en cours d'excution et exprime sous la forme fichier:///URI . Si le script a t appel partir de fl.runScript(), cette proprit reprsente le chemin d'accs du script parent immdiat. Ainsi, de multiples appels fl.runScript() sont vits pour trouver le chemin d'accs du script de l'appel original. Exemple L'exemple suivant affiche dans le panneau Sortie le chemin d'accs du script JSFL actuellement en cours d'excution :
fl.trace(fl.scriptURI);

Voir aussi
fl.runScript()

fl.selectElement()
Disponibilit Flash CS3 Professional. Utilisation
fl.selectElement(elementObject, editMode)

EXTENSION DE FLASH CS4 PROFESSIONAL 259

Objet flash (fl)

Paramtres
elementObject Objet Element slectionner. editMode Valeur boolenne indiquant si vous voulez modifier l'lment (true) ou uniquement le slectionner

(false). Valeur renvoye Valeur boolenne, true si l'lment a bien t slectionn, false dans le cas contraire. Description Mthode qui active l'option de slection ou d'dition d'un lment. En caractre rcuprer. gnrale, vous utilisez cette mthode sur des objets renvoys par fl.findObjectInDocByName() ou fl.findObjectInDocByType(). Exemple L'exemple suivant slectionne un lment nomm "second text field" s'il est trouv dans le document :
var nameToSearchFor = "second text field"; var doc = fl.getDocumentDOM(); // Start by viewing Scene 1 (index value of 0). document.editScene(0); // Search for element by name. var results = fl.findObjectInDocByName(nameToSearchFor, doc); if (results.length > 0) { // Select the first element found. // Pass false, so the symbolInstance you are searching for is selected. // If you pass true, the symbol instance will switch to edit mode. fl.selectElement(results[0], false); alert("success, found " + results.length + " objects") } else { alert("failed, no objects with name "" + nameToSearchFor + "" found"); }

Voir aussi
fl.findObjectInDocByName(), fl.findObjectInDocByType()

fl.selectTool()
Disponibilit Flash CS3 Professional. Utilisation
fl.selectTool(toolName)

Paramtres toolName Chane spcifiant le nom de loutil slectionner. Consultez la section Description ci-dessous pour connatre les valeurs acceptes par ce paramtre.

EXTENSION DE FLASH CS4 PROFESSIONAL 260

Objet flash (fl)

Description Mthode qui slectionne l'outil spcifi dans le panneau Outils. Les valeurs possibles par dfaut pour toolName sont "arrow", "bezierSelect", "freeXform", "fillXform", "lasso", "pen", "penplus", "penminus", "penmodify", "text", "line", "rect", "oval", "rectPrimitive", "ovalPrimitive", "polystar", "pencil", "brush", "inkBottle", "bucket", "eyeDropper", "eraser", "hand" et "magnifier". Si un utilisateur ou vous-mme crez des outils personnaliss, leurs noms peuvent galement tre transmis comme paramtre toolName. La liste des noms d'outil se trouve dans le fichier suivant :

Windows Vista :
lecteur d'amorage\Users\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS3\langue\Configuration\Tools\toolConfig.xml

Windows XP :
lecteur d'amorage\Documents and Settings\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS3\langue\Configuration\Tools\toolConfig.xml

Mac OS X:
DD Macintosh/Users/nom d'utilisateur/Library/Application Support/Adobe/Flash CS3/langue/Configuration/Tools/toolConfig.xml Exemple L'exemple suivant slectionne l'outil Plume .
fl.selectTool("pen");

Voir aussi Objet Tools, Objet ToolObj

fl.setActiveWindow()
Disponibilit Flash MX 2004. Utilisation
fl.setActiveWindow(document [, bActivateFrame])

Paramtres document Objet Document spcifiant le document slectionner comme fentre active.
bActivateFrame Paramtre facultatif qui est ignor par Flash et Fireworks, et uniquement destin la compatibilit

avec Dreamweaver. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 261

Objet flash (fl)

Description Mthode qui dfinit le document spcifi comme fentre active. Cette mthode est galement prise en charge par Dreamweaver et Fireworks. Sil existe plusieurs fentres ouvertes sur le mme document (cres laide de loption Fentre > Dupliquer la fentre), la fentre active la plus rcente est slectionne. Exemple L'exemple suivant montre deux faons d'activer un document spcifi :
fl.setActiveWindow(fl.documents[0]); var theIndex = fl.findDocumentIndex("myFile.fla"); fl.setActiveWindow(fl.documents[theIndex]);

fl.showIdleMessage()
Disponibilit Flash 8. Utilisation
fl.showIdleMessage(show)

Paramtres show Valeur boolenne indiquant si le message avertissant d'une excution du script trop longue doit tre activ ou dsactiv. Valeur renvoye Aucune. Description Mthode qui permet de dsactiver le message avertissant que lexcution du script est trop longue (transmettez la valeur false pour show). Il est conseill dutiliser cette mthode pour les oprations de traitement par lots qui ncessitent beaucoup de temps. Pour ractiver lalerte, appelez une nouvelle fois cette mthode en transmettant cette fois la valeur true pour show. Exemple L'exemple suivant montre comment dsactiver puis ractiver le message avertissant que lexcution du script est trop longue :
fl.showIdleMessage(false); var result = timeConsumingFunction(); fl.showIdleMessage(true); ; var result = timeConsumingFunction();

fl.sourcePath
Disponibilit Flash CS4 Professional.

EXTENSION DE FLASH CS4 PROFESSIONAL 262

Objet flash (fl)

Utilisation
fl.sourcePath

Description Proprit ; chane qui contient la liste des lments du chemin source ActionScript 3.0 global, spcifiant l'emplacement des fichiers de classes ActionScript. Les lments de la chane sont dlimits par des points-virgules. Dans l'outil de programmation, les lments sont spcifis en slectionnant Modifier > Prfrences > ActionScript > Paramtres d'ActionScript 3.0. Exemple L'exemple suivant ajoute le dossier /Classes au chemin source ActionScript 3.0 global :
fl.trace(fl.sourcePath); fl.sourcePath = "/Classes;" + fl.sourcePath; fl.trace(fl.sourcePath);

Voir aussi
fl.flexSDKPath, fl.externalLibraryPath, fl.libraryPath, document.sourcePath

fl.swfPanels
Disponibilit Flash CS4 Professional. Utilisation
fl.swfPanels

Description Proprit en lecture seule ; tableau d'objets swfPanel enregistrs (voir Objet swfPanel). Un objet swfPanel est enregistr s'il a t ouvert au moins une fois. La position du panneau dans le tableau reprsente l'ordre dans lequel il a t ouvert. Si le premier panneau ouvert se nomme TraceBitmap et le second panneau AnotherFunction, fl.swfPanels[0] est l'objet TraceBitmap swfPanel, fl.swfPanels[1] est l'objet AnotherFunction swfPanel, etc. Exemple Le code suivant affiche dans le panneau Sortie le nom et le chemin des panneaux Window SWF enregistrs :
if(fl.swfPanels.length > 0){ for(x = 0; x < fl.swfPanels.length; x++){ fl.trace("Panel: " + fl.swfPanels[x].name + " -- Path: " + fl.swfPanels[x].path); } }

EXTENSION DE FLASH CS4 PROFESSIONAL 263

Objet flash (fl)

fl.synchronizeDocumentWithHeadVersion()
Disponibilit Flash CS3 Professional. Utilisation
fl.synchronizeDocumentWithHeadVersion(documentObject)

Paramtres
documentObject Objet Document.

Valeur renvoye Valeur boolenne, true si la synchronisation du fichier spcifi s'est bien droule sur le serveur Version Cue, false dans le cas contraire. Description Mthode qui synchronise le document spcifi avec la version la plus rcente trouve sur le serveur Version Cue et consigne les ventuelles erreurs dans le panneau Sortie. Cette mthode est identique document.synchronizeWithHeadVersion(). Exemple Lexemple suivant synchronise le document actif avec la version du serveur Version Cue :
fl.synchronizeWithHeadVersion(fl.getDocumentDOM());

Voir aussi
fl.downloadLatestVersion(), fl.revertDocumentToLastVersion(), fl.saveAVersionOfDocument()

fl.tools
Disponibilit Flash MX 2004. Utilisation
fl.tools

Description Proprit en lecture seule ; tableau d'objets Tools (voir Objet Tools). Cette mthode nest utilise que lors de la cration doutils extensibles.

fl.trace()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 264

Objet flash (fl)

Utilisation
fl.trace(message)

Paramtres message Chane apparaissant dans le panneau Sortie. Valeur renvoye Aucune. Description Mthode qui envoie une chane de texte au panneau Sortie, suivie d'un code de nouvelle ligne, et affiche le panneau Sortie s'il n'est pas dj visible. Cette mthode est identique outputPanel.trace() et fonctionne comme l'instruction trace() en code ActionScript. Pour envoyer une ligne vide, utilisez fl.trace("") ou fl.trace("\n"). Vous pouvez utiliser cette dernire commande en ligne si vous intgrez \n la chane message. Exemple L'exemple suivant affiche plusieurs lignes de texte dans le panneau Sortie :
fl.outputPanel.clear(); fl.trace("Hello World!!!"); var myPet = "cat"; fl.trace("\nI have a " + myPet); fl.trace(""); fl.trace("I love my " + myPet); fl.trace("Do you have a " + myPet +"?");

fl.version
Disponibilit Flash MX 2004. Utilisation
fl.version

Description Proprit en lecture seule ; chane longue de la version de l'outil de programmation Flash, plate-forme comprise. Exemple L'exemple suivant affiche la version de l'outil de programmation Flash dans le panneau Sortie :
alert(fl.version); // For example, WIN 10,0,0,540

EXTENSION DE FLASH CS4 PROFESSIONAL 265

Objet flash (fl)

fl.xmlui
Disponibilit Flash MX 2004. Utilisation
fl.xmlui

Description Proprits en lecture seule ; Objet XMLUI. Cette proprit permet de lire et dfinir les proprits de XMLUI dans une bote de dialogue XMLUI, et daccepter ou d'annuler par programmation la bote de dialogue. Exemple Voir Objet XMLUI.

266

Chapitre 18 : Objet FLfile

Disponibilit Flash MX 2004 7.2. Description Lobjet FLfile permet de crer des extensions Flash capables daccder aux dossiers et fichiers locaux, de les modifier et de les supprimer. LAPI FLfile est propose sous forme d'extension de l'API JavaScript. Cette extension est appele bibliothque partage et se trouve dans le dossier suivant :

Windows Vista :
lecteur d'amorage \Users\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS3\langue\Configuration\External Libraries\FLfile.dll

Windows XP :
lecteur d'amorage \Documents and Settings\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS3\langue\Configuration\External Libraries\FLfile.dll

Mac OS X:
Disque dur Macintosh/Users/nom d'utilisateur/Library/Application Support/Adobe/FlashCS3/langue/Configuration/External Libraries/FLfile.dll Remarque : il ne faut pas confondre les bibliothques partages qui contiennent les symboles de vos documents Flash avec les bibliothques partages de l'API JavaScript. Il s'agit de deux types de composants diffrents. Les mthodes de FLfile sappliquent aux fichiers et aux dossiers (rpertoires) du disque. Par consquent, chaque mthode prend un ou plusieurs paramtres pour spcifier l'emplacement d'un fichier ou dossier. Cet emplacement de fichier ou de dossier est exprim sous forme dune chane trs semblable ladresse URL dun site Web. Ce type dadresse, appel URI de fichier (Uniform Resource Identifier) respecte le format reprsent ici (guillemets compris) :
"file:///drive|/folder 1/folder 2/.../filename"

Par exemple, pour crer un dossier nomm config sur le lecteur C et le placer dans le dossier Program Files/MyApp, utilisez la commande suivante :
FLfile.createFolder("file:///C|/Program Files/MyApp/config");

Si vous souhaitez ensuite placer dans ce dossier un fichier nomm config.ini, la commande sera la suivante :
FLfile.write("file:///C|/Program Files/MyApp/config/config.ini", "");

Pour crer un dossier sous Macintosh, vous pouvez utiliser une commande similaire celle-ci :
FLfile.createFolder("file:///Macintosh/MyApp/config");

Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet Flfile :

EXTENSION DE FLASH CS4 PROFESSIONAL 267

Objet FLfile

Mthode
FLfile.copy() FLfile.createFolder() FLfile.exists() FLfile.getAttributes()

Description Copie un fichier. Cre un ou plusieurs dossiers. Vrifie lexistence dun fichier ou d'un dossier. Vrifie les attributs dun fichier : accessible en criture, en lecture seule, cach, visible ou dossier systme. Dtermine combien de secondes se sont coules entre le 1er janvier 1970 et l'heure laquelle le fichier ou le dossier a t cr. Rcupre la date de cration dun fichier ou dun dossier. Dtermine combien de secondes se sont coules entre le 1er janvier 1970 et l'heure de la dernire modification du fichier ou du dossier. Rcupre la date de la dernire modification dun fichier ou dun dossier. Rcupre la taille dun fichier. Enumre le contenu d'un dossier. Convertit un nom de fichier en un format propre la plateforme : fichier:/// URI. Lit le contenu d'un fichier. Supprime un fichier ou un dossier. Donne un fichier ou un dossier lattribut lecture seule, lecture et criture, cach ou visible. Convertit un nom de fichier exprim sous la forme fichier:/// URI en un format propre la plate-forme. Cre un fichier, crit du contenu ou en ajoute la fin dun fichier.

FLfile.getCreationDate()

FLfile.getCreationDateObj() FLfile.getModificationDate()

FLfile.getModificationDateObj()

FLfile.getSize() FLfile.listFolder() FLfile.platformPathToURI()

FLfile.read() FLfile.remove() FLfile.setAttributes()

FLfile.uriToPlatformPath()

FLfile.write()

FLfile.copy()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.copy(fileURI, copyURI)

Paramtres fileURI Chane de type fichier:///URI qui indique le fichier copier.

copyURI Chane de type fichier:///URI qui spcifie lemplacement et le nom du fichier copi.

Valeur renvoye Valeur boolenne, true si lopration a russi, ou false dans le cas contraire.

EXTENSION DE FLASH CS4 PROFESSIONAL 268

Objet FLfile

Description Mthode qui copie un fichier dun emplacement un autre. Cette mthode renvoie false si copyURI existe dj. Exemple L'exemple suivant cre une copie de sauvegarde dun fichier de configuration nomm config.ini, et place cette copie dans le mme dossier que loriginal, avec un nouveau nom :
var originalFileURI="file:///C|/Program Files/MyApp/config.ini"; var newFileURI="file:///C|/Program Files/MyApp/config_backup.ini"; FLfile.copy(originalFileURI, newFileURI);

Il est possible dexcuter la mme tche avec une seule commande :

FLfile.copy("file:///C|:/Program Files/MyApp/config.ini", file:///C|/Program Files/MyApp/config_backup.ini");

FLfile.createFolder()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.createFolder(folderURI)

Paramtres
folderURI Adresse URI indiquant le chemin daccs de la structure de dossiers crer.

Valeur renvoye Valeur boolenne : true si lopration a russi, false si folderURI existe dj. Description Mthode qui cre un ou plusieurs dossiers lemplacement spcifi. Vous pouvez crer plusieurs dossiers simultanment. Par exemple, la commande suivante cre les dossiers MyData et TempData s'ils n'existent pas :
FLfile.createFolder("file:///c|/MyData/TempData")

Exemple L'exemple suivant cre un dossier et un sous-dossier sous le dossier de configuration (fl.configURI) :
fl.trace(FLfile.createFolder(fl.configURI+"folder01/subfolder01"));

L'exemple suivant tente de crer un dossier appel tempFolder la racine du lecteur C, puis affiche une alerte informant de la russite ou de l'chec de lopration.

EXTENSION DE FLASH CS4 PROFESSIONAL 269

Objet FLfile

var folderURI = "file:///c|/tempFolder"; if (FLfile.createFolder(folderURI)) { alert("Created " + folderURI); } else { alert(folderURI + " already exists"); }

Voir aussi
FLfile.remove(), FLfile.write()

FLfile.exists()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.exists(fileURI)

Paramtres fileURI Chane de type fichier:///URI qui dsigne le fichier vrifier. Valeur renvoye Valeur boolenne, true si lopration a russi, ou false dans le cas contraire. Description Mthode qui vrifie si le fichier spcifi existe. Si vous spcifiez un dossier et un nom de fichier, le dossier doit dj exister. Pour crer des dossiers, voir FLfile.createFolder(). Exemples L'exemple suivant vrifie lexistence dun fichier nomm mydata.txt dans le dossier temp, puis affiche une alerte signalant l'existence ou l'absence d'un tel fichier :
var fileURI = "file:///c|/temp/mydata.txt"; if (FLfile.exists(fileURI)) { alert( fileURI + " exists."); } else { alert( fileURI + " does not exist."); }

L'exemple suivant vrifie lexistence dun fichier de configuration requis dans le dossier MyApplication. Si le fichier nexiste pas, il est cr automatiquement.
var configFile = "file:///C|/MyApplication/config.ini"; if (!FLfile.exists(configFile)) { FLfile.write(configFile,"");

EXTENSION DE FLASH CS4 PROFESSIONAL 270

Objet FLfile

Voir aussi
FLfile.write()

FLfile.getAttributes()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.getAttributes(fileOrFolderURI)

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui dsigne le fichier ou le dossier dont les attributs doivent tre

rcuprs. Valeur renvoye Chane reprsentant les attributs du fichier ou dossier spcifi. si le fichier ou le dossier n'existe pas, les rsultats sont imprvisibles. Vous devez utiliser FLfile.exists() avant cette mthode. Description Mthode qui renvoie une chane reprsentant les attributs du fichier ou dossier indiqu, ou une chane vide si le fichier ne possde pas d'attributs spcifiques (c'est--dire s'il n'est pas en lecture seule, cach, etc.). Employez toujours FLfile.exists() pour vrifier l'existence du fichier ou du dossier avant d'utiliser cette mthode. Les caractres de cette chane reprsentent les attributs sous la forme suivante :

R fileOrFolderURI est en lecture seule. D fileOrFolderURI est un dossier (rpertoire). H fileOrFolderURI est cach (Windows uniquement). S fileOrFolderURI est un fichier ou dossier systme (Windows uniquement). A fileOrFolderURI est prt pour l'archivage (Windows uniquement).

Par exemple, si fileOrFolderURI est un dossier cach, la chane renvoye est "DH". Exemple L'exemple suivant rcupre les attributs du fichier mydata.txt et affiche un message dalerte si ce fichier est en lecture seule.
var URI = "file:///c|/temp/mydata.txt"; if (FLfile.exists(URI)){ var attr = FLfile.getAttributes(URI); if (attr && (attr.indexOf("R") != -1)) { // Returned string contains R. alert(URI + " is read only!"); } }

EXTENSION DE FLASH CS4 PROFESSIONAL 271

Objet FLfile

Voir aussi
FLfile.setAttributes()

FLfile.getCreationDate()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.getCreationDate(fileOrFolderURI)

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui indique le fichier ou le dossier dont la date et lheure de

cration doivent tre lues, sous forme hexadcimale. Valeur renvoye Chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1er janvier 1970 et l'heure laquelle le fichier ou le dossier a t cr, ou "00000000" si le fichier ou le dossier n'existe pas. Description Mthode qui dtermine combien de secondes se sont coules entre le 1er janvier 1970 et l'heure laquelle le fichier ou le dossier a t cr. Cette mthode est principalement utilise pour comparer les dates de cration ou de modification des fichiers ou des dossiers. Exemple L'exemple suivant dtermine si un fichier a t modifi depuis sa cration :
// Make sure the specified file exists var fileURI = "file:///C|/MyApplication/MyApp.fla"; var creationTime = FLfile.getCreationDate(fileURI); var modificationTime = FLfile.getModificationDate(fileURI); if ( modificationTime > creationTime ) { alert("The file has been modified since it was created."); } else { alert("The file has not been modified since it was created."); }

Voir aussi
FLfile.getCreationDateObj(), FLfile.getModificationDate()

FLfile.getCreationDateObj()
Disponibilit Flash MX 2004 7.2.

EXTENSION DE FLASH CS4 PROFESSIONAL 272

Objet FLfile

Utilisation
FLfile.getCreationDateObj(fileOrFolderURI)

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui indique le fichier ou le dossier dont la date et lheure de

cration doivent tre lues, sous forme d'un objet Date JavaScript. Valeur renvoye Objet Date JavaScript qui reprsente la date et l'heure de cration du fichier ou du dossier spcifi. Si le fichier ou le dossier n'existe pas, l'objet contient des informations indiquant qu'il a t cr minuit (GMT) le 31 dcembre 1969. Description Mthode qui renvoie un objet Date JavaScript qui reprsente la date et l'heure de cration du fichier ou du dossier spcifi. Exemple L'exemple suivant affiche dans le panneau Sortie, dans un format lisible par l'oprateur, la date laquelle un fichier a t cr :
// Make sure the specified file exists. var file1Date = FLfile.getCreationDateObj("file:///c|/temp/file1.txt"); fl.trace(file1Date);

Voir aussi
FLfile.getCreationDate(), FLfile.getModificationDateObj()

FLfile.getModificationDate()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.getModificationDate(fileOrFolderURI)

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui dsigne le fichier dont la date de modification doit tre

rcupre, sous forme de chane hexadcimale. Valeur renvoye Chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1er janvier 1970 et l'heure de la dernire modification du fichier ou du dossier, ou "00000000" si le fichier n'existe pas. Description Mthode qui dtermine combien de secondes se sont coules entre le 1er janvier 1970 et l'heure de la dernire modification du fichier ou du dossier. Cette mthode est principalement utilise pour comparer les dates de cration ou de modification des fichiers ou des dossiers.

EXTENSION DE FLASH CS4 PROFESSIONAL 273

Objet FLfile

Exemple L'exemple suivant compare les dates de modification de deux fichiers et dtermine lequel des deux a t modifi le plus rcemment :
// Make sure the specified files exist. file1 = "file:///C|/MyApplication/MyApp.fla"; file2 = "file:///C|/MyApplication/MyApp.as"; modificationTime1 = FLfile.getModificationDate(file1); modificationTime2 = FLfile.getModificationDate(file2) ; if(modificationTime1 > modificationTime2) { alert("File 2 is older than File 1") ; } else if(modificationTime1 < modificationTime2) { alert("File 1 is older than File 2") ; } else { alert("File 1 and File 2 were saved at the same time") ; }

Voir aussi
FLfile.getCreationDate(), FLfile.getModificationDateObj()

FLfile.getModificationDateObj()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.getModificationDateObj(fileOrFolderURI)

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui dsigne le fichier ou le dossier dont la date et lheure de

modification doivent tre rcupres, sous forme d'un objet Date JavaScript. Valeur renvoye Objet Date JavaScript qui reprsente la date et l'heure de la dernire modification du fichier ou du dossier spcifi. Si le fichier ou le dossier n'existe pas, l'objet contient des informations indiquant qu'il a t cr minuit (GMT) le 31 dcembre 1969. Description Mthode qui renvoie un objet Date JavaScript reprsentant la date et l'heure de la dernire modification du fichier ou du dossier spcifi. Exemple L'exemple suivant affiche dans le panneau Sortie, dans un format lisible par l'oprateur, la date de la dernire modification d'un fichier :
// Make sure the specified file exists. var file1Date = FLfile.getModificationDateObj("file:///c|/temp/file1.txt"); trace(file1Date);

EXTENSION DE FLASH CS4 PROFESSIONAL 274

Objet FLfile

Voir aussi
FLfile.getCreationDateObj(), FLfile.getModificationDate()

FLfile.getSize()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.getSize(fileURI)

Paramtres fileURI Chane de type fichier:///URI qui indique le fichier dont la taille doit tre rcupre. Valeur renvoye Un entier qui reprsente la taille en octets du fichier spcifi, ou 0 si ce fichier nexiste pas. Description Mthode qui renvoie un entier reprsentant la taille en octets du fichier spcifi, ou 0 si ce fichier nexiste pas. Si la valeur envoye est 0, utilisez FLfile.exists() pour dterminer si le fichier contient zro octet ou s'il n'existe pas. Cette mthode renvoie des valeurs de taille de fichier correctes uniquement pour les fichiers n'excdant pas 2 Go. Exemple L'exemple suivant stocke la taille du fichier mydata.txt dans la variable fileSize :
var URL = "file:///c|/temp/mydata.txt"; var fileSize = FLfile.getSize(URL);

FLfile.listFolder()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.listFolder(folderURI [, filesOrDirectories])

Paramtres
folderURI Chane de type fichier:///URI qui indique le dossier dont le contenu doit tre rcupr. Il est possible

dinsrer des caractres gnriques dans folderURI. Les caractres gnriques utilisables sont * (un ou plusieurs caractres) et ? (un seul caractre).
filesOrDirectories Chane facultative qui spcifie si seuls les noms des fichiers ou des dossiers (rpertoires)

doivent tre renvoys. Si ce paramtre est omis, les noms des dossiers et des fichiers sont renvoys. Les valeurs gres sont "files" et "directories".

EXTENSION DE FLASH CS4 PROFESSIONAL 275

Objet FLfile

Valeur renvoye Tableau de chanes reprsentant le contenu du dossier. Si le dossier n'existe pas ou si aucun fichier ou dossier ne correspond aux critres spcifis, renvoie un tableau vide. Description Mthode qui renvoie un tableau de chanes reprsentant le contenu du dossier. Exemples L'exemple suivant renvoie trois tableaux. Le premier reprsente tous les fichiers du dossier C:\temp, le second tous les dossiers du dossier C:\temp et le troisime reprsente les fichiers et les dossiers du dossier C:\temp :
var fileURI = "file:///C|/temp/" ; var folderURI = "file:///C|/temp" ; var fileList1 = FLfile.listFolder(fileURI, "files"); // files var fileList2 = FLfile.listFolder(folderURI, "directories"); //folders var fileList3 = FLfile.listFolder(folderURI); //files and folders fl.trace("Files: " + fileList1); fl.trace(""); fl.trace("Folders: " + fileList2); fl.trace(""); fl.trace("Files and folders: " + fileList3);

L'exemple suivant renvoie un tableau contenant tous les fichiers texte (.txt) du rpertoire temp et affiche cette liste dans un message dalerte :
var folderURI = "file:///c|/temp"; var fileMask = "*.txt"; var list = FLfile.listFolder(folderURI + "/" + fileMask, "files"); if (list) { alert(folderURI + " contains: " + list.join(" ")); }

L'exemple suivant utilise un masque de nom de fichier dans l'adresse folderURI spcifie afin de renvoyer les noms de tous les fichiers excutables du dossier d'applications Windows :
var executables = FLfile.listFolder("file:///C|/WINDOWS/*.exe","files"); alert(executables.join("\n"));

FLfile.platformPathToURI()
Disponibilit Flash CS4 Professional. Utilisation
FLfile.platformPathToURI(fileName)

Paramtres fileName Chane, exprime en un format propre la plate-forme, qui spcifie le nom du fichier convertir. Valeur renvoye Chane exprime sous la forme fichier:/// URI.

EXTENSION DE FLASH CS4 PROFESSIONAL 276

Objet FLfile

Description Mthode qui convertit un nom de fichier en un format propre la plate-forme : fichier:/// URI. Exemple L'exemple suivant convertit le nom de fichier au format spcifique la plate-forme en format file:/// URI, transmis ensuite outputPanel.save() :
var myFilename = "C:\\outputPanel.txt"; var myURI=FLfile.platformPathToURI(myFilename); fl.outputPanel.save(myURI);

Voir aussi
FLfile.uriToPlatformPath()

FLfile.read()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.read()

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui dsigne le fichier ou le dossier dont les attributs doivent tre

rcuprs. Valeur renvoye Le contenu du fichier spcifi sous forme de chane, ou null si la lecture choue. Description Mthode qui renvoie le contenu du fichier spcifi sous forme de chane, ou null si la lecture choue. Exemples L'exemple suivant lit le fichier mydata.txt et, si la lecture russit, affiche son contenu dans un message dalerte.
var fileURI = "file:///c|/temp/mydata.txt"; var str = FLfile.read( fileURI); if (str) { alert( fileURL + " contains: " + str); }

L'exemple suivant lit le code ActionScript dun fichier de classe et le stocke dans la variable code :
var classFileURI = "file:///C|/MyApplication/TextCarousel.as"; var code = FLfile.read(classFileURI);

EXTENSION DE FLASH CS4 PROFESSIONAL 277

Objet FLfile

FLfile.remove()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.remove(fileOrFolderURI)

Paramtres
fileOrFolderURI Chane de type fichier:///URI qui dsigne le fichier ou le dossier supprimer.

Valeur renvoye Valeur boolenne, true si lopration a russi, ou false dans le cas contraire. Description Mthode qui supprime le fichier ou le dossier spcifi. Si le dossier contient des fichiers, ceux-ci sont galement supprims. Il est impossible de supprimer les fichiers ayant lattribut R (lecture seule). Exemples L'exemple suivant prvient lutilisateur de lexistence dun fichier, et supprime celui-ci si lutilisateur le dcide :
var fileURI = prompt ("Enter file/folder to be deleted: ", "file:///c|/temp/delete.txt"); if (FLfile.exists(fileURI)) { var confirm = prompt("File exists. Delete it? (y/n)", "y"); if (confirm == "y" || confirm == "Y") { if(FLfile.remove(fileURI)) { alert(fileURI + " is deleted."); } else { alert("fail to delete " + fileURI); } } } else { alert(fileURI + " does not exist"); }

L'exemple suivant supprime un fichier de configuration cr par une application :

if(FLfile.remove("file:///C|/MyApplication/config.ini")) { alert("Configuration file deleted"); }

L'exemple suivant supprime le dossier Configuration et tout son contenu :

FLfile.remove("file:///C|/MyApplication/Configuration/");

Voir aussi
FLfile.createFolder(), FLfile.getAttributes()

EXTENSION DE FLASH CS4 PROFESSIONAL 278

Objet FLfile

FLfile.setAttributes()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.setAttributes(fileURI, strAttrs)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et dsignant le fichier dont les attributs doivent tre dfinis.
strAttrs Chane indiquant les valeurs des attributs dfinir. La liste des valeurs gres par strAttrs figure la section Description ci-dessous.

Valeur renvoye Valeur boolenne, true si lopration a russi. Remarque : si le fichier ou le dossier n'existe pas, les rsultats sont imprvisibles. Vous devez utiliser FLfile.exists() avant cette mthode. Description Mthode qui dsigne les attributs systme du fichier spcifi. Les valeurs suivantes sont possibles pour strAttrs :

N Aucun attribut spcifique (ni lecture seule, ni cach, etc.) A Prt pour l'archivage (Windows uniquement) R Lecture seule (sur Macintosh, Lecture seule signifie verrouill) W Accessible en criture (annule R) H Cach (Windows uniquement) V Visible (annule H, Windows uniquement)

Si vous insrez la fois R et W dans strAttrs, le R est ignor et le fichier est paramtr comme tant accessible en criture. De mme, si vous insrez H et V, le H est ignor et le fichier est paramtr comme tant visible. Pour vous assurer que l'attribut d'archivage n'est pas dfini, utilisez cette commande avec le paramtre N avant de dfinir les attributs. En d'autres termes, le paramtre A ne possde pas de pendant qui annule l'attribut Archive. Exemples L'exemple suivant met le fichier mydata.txt en lecture seule et cach. Il n'a aucun effet sur l'attribut d'archivage.
var URI = "file:///c|/temp/mydata.txt"; if (FLfile.exists(URI)) { FLfile.setAttributes(URI, "RH"); }

L'exemple suivant met le fichier mydata.txt en lecture seule et cach. Il fait aussi en sorte que l'attribut d'archivage ne soit pas dfini.

EXTENSION DE FLASH CS4 PROFESSIONAL 279

Objet FLfile

var URI = "file:///c|/temp/mydata.txt"; if (FLfile.exists(URI)) { FLfile.setAttributes(URI, "N"); FLfile.setAttributes(URI, "RH"); }

Voir aussi
FLfile.getAttributes()

FLfile.uriToPlatformPath()
Disponibilit Flash CS4 Professional. Utilisation
FLfile.uriToPlatformPath(fileURI)

Paramtres fileURI Chane, exprime sous la forme fichier:/// URI, spcifiant le nom du fichier convertir. Valeur renvoye Chane reprsentant un chemin propre la plate-forme. Description Mthode qui convertit un nom de fichier exprim sous la forme fichier:/// URI en un format propre la plate-forme. Exemple L'exemple suivant convertit le format file:/// URI en un format spcifique la plate-forme :
var dir =(fl.configDirectory); var URI = FLfile.platformPathToURI(dir); fl.trace(URI == fl.configURI); // displays "true"

Voir aussi
FLfile.platformPathToURI()

FLfile.write()
Disponibilit Flash MX 2004 7.2. Utilisation
FLfile.write(fileURI, textToWrite, [ , strAppendMode])

EXTENSION DE FLASH CS4 PROFESSIONAL 280

Objet FLfile

Paramtres fileURI Chane de type fichier:///URI qui dsigne le fichier dans lequel une chane doit tre crite.
textToWrite Chane reprsentant le texte placer dans le fichier. strAppendMode Chane facultative ayant la valeur append. Elle indique que la chane textToWrite doit tre crite la

fin du fichier existant. Si ce paramtre est omis, le contenu actuel de fileURI est remplac par le contenu de textToWrite. Valeur renvoye Valeur boolenne, true si lopration a russi, ou false dans le cas contraire. Description Mthode qui crit la chane spcifie dans le fichier spcifi (au format UTF-8). Si le fichier dsign nexiste pas, il est cr automatiquement. Toutefois, le dossier dans lequel vous placez le fichier doit exister avant l'emploi de cette mthode. Pour crer des dossiers, utilisez FLfile.createFolder(). Exemple L'exemple suivant tente dcrire la chane "xxx" dans le fichier mydata.txt, et affiche un message dalerte si lcriture a russi. Il tente ensuite dcrire la chane "aaa" dans le mme fichier et affiche un second message dalerte si lcriture a russi. Aprs lexcution de ce script, le fichier mydata.txt ne contiendra que le texte "xxxaaa".
var URI = "file:///c|/temp/mydata.txt"; if (FLfile.write(URI, "xxx")) { alert("Wrote xxx to " + URI); } if (FLfile.write(URI, "aaa", "append")) { alert("Appended aaa to " + fileURI); }

Voir aussi
FLfile.createFolder(), FLfile.exists()

281

Chapitre 19 : Objet folderItem

Hritage

Objet Item > Objet folderItem

Disponibilit Flash MX 2004. Description Lobjet folderItem est une sous-classe de lobjet Item. Il nexiste pas de mthodes ni de proprits particulires pour lobjet folderItem. Voir Objet Item.

282

Chapitre 20 : Objet fontItem

Hritage

Objet Item > Objet fontItem

Disponibilit Flash MX 2004. Description Lobjet fontItem est une sous-classe de lobjet Item (voir Objet Item). Rsum des proprits Outre celles de lobjet Item, l'objet fontItem gre les proprits suivantes :
Proprit
fontItem.bitmap fontItem.bold fontItem.embedVariantGlyphs

Description Spcifie si l'lment Font est mis en bitmap. Spcifie si l'lment Font est en gras. Spcifie si les variantes de glyphes devraient tre en sortie dans la police lors de la publication d'un fichier SWF. Nom de la police de priphrique associe l'lment Font. Spcifie le format de la police qui est en sortie lors de la publication d'un filem SWF. Spcifie si l'lment est en italique. Taille de l'lment Font, en points.

fontItem.font fontItem.isDefineFont4Symbol fontItem.italic fontItem.size

fontItem.bitmap
Disponibilit Flash CS4 Professional. Utilisation
fontItem.bitmap

Description Proprit ; valeur boolenne qui spcifie si le l'lment Font est mis en bitmap (true) ou non (false). Exemple En supposant que le premier lment de la bibliothque soit un lment Font, le code suivant affiche true dans le panneau Sortie s'il est mis en bitmap, false dans le cas contraire :
var theItem = fl.getDocumentDOM().library.items[0]; fl.trace("bitmap: "+ theItem.bitmap);

EXTENSION DE FLASH CS4 PROFESSIONAL 283

Objet fontItem

fontItem.bold
Disponibilit Flash CS4 Professional. Utilisation
fontItem.bold

Description Proprit ; valeur boolenne qui spcifie si l'lment Font est en gras (true) ou non (false). Exemple En supposant que le premier lment de la bibliothque soit un lment Font, le code suivant affiche true dans le panneau Sortie s'il est en gras, false dans le cas contraire, puis le dfinit sur gras.
var theItem = fl.getDocumentDOM().library.items[0]; fl.outputPanel.clear(); fl.trace("bold: "+ theItem.bold); theItem.bold=true; fl.trace("bold: "+ theItem.bold);

fontItem.embedVariantGlyphs
Disponibilit Flash CS4 Professional. Utilisation
fontItem.embedVariantGlyphs

Description Proprit; valeur boolenne qui spcifie si les variantes de glyphes devraient tre en sortie dans la police lors de la publication d'un fichier SWF (true) ou non (false). Si cette valeur est dfinie sur true, la taille de votre fichier SWF va augmenter. La valeur par dfaut est false. Certaines langues substituent dynamiquement les glyphes au fur et mesure que vous tapez (par exemple, le thailandais, l'arabe, l'hbreu et le grec). Si vous prparez ou que vous entrez du texte dans ces types de langue, dfinissez cette proprit sur true. Exemples Les symboles de police qui sont compatibles avec les interfaces de programmation flash.text apparaissent dans la bibliothque et l'utilisateur peut les grer directement. Cependant, les symboles de police qui sont compatibles avec les interfaces de programmation flash.text.engine (FTE) n'apparaissent pas dans la bibliothque ; il vous faut donc vous en occuper manuellement. La fonction suivante ajoute une nouvelle police la bibliothque qui peut tre utilise avec les API de FTE.

EXTENSION DE FLASH CS4 PROFESSIONAL 284

Objet fontItem

function embedFontSymbol(symbolName, fontName, includeVariants) { var doc = fl.getDocumentDOM(); if (doc) { // look up the item. if it exists, delete it. var index = doc.library.findItemIndex(symbolName); if (index > -1) doc.library.deleteItem(symbolName); // make a new font symbol in the library doc.library.addNewItem('font', symbolName); // look up the symbol by its name var index = doc.library.findItemIndex(symbolName); if (index > -1) { // get the item from the library and set the attributes of interest var fontObj = doc.library.items[index]; fontObj.isDefineFont4Symbol = true; fontObj.font = fontName; fontObj.bold = false; fontObj.italic = false; fontObj.embedVariantGlyphs = includeVariants; // this is what forces the font into the SWF stream fontObj.linkageExportForAS = true; fontObj.linkageExportInFirstFrame = true; } } }

La fonction suivante affiche tous les symboles de police dans le panneau Sortie.
function dumpFontSymbols() { var doc = fl.getDocumentDOM(); if (doc) { var items = doc.library.items; fl.trace("items length = " + items.length); var i; for(i=0; i<items.length; i++) { var item = items[i]; fl.trace("itemType = " + item.itemType); if (item.itemType == 'font') { fl.trace("name = " + item.name); fl.trace("DF4 symbol = " + item.isDefineFont4Symbol); fl.trace("font = " + item.font); } } } }

Voir aussi
fontItem.isDefineFont4Symbol, text.embedVariantGlyphs

EXTENSION DE FLASH CS4 PROFESSIONAL 285

Objet fontItem

fontItem.font
Disponibilit Flash CS4 Professional. Utilisation
fontItem.font

Description Proprit ; chane qui spcifie le nom de la police de priphrique associe l'lment Font. Si vous entrez une chane qui ne correspond pas une police de priphrique installe, un message d'erreur apparat. Pour dterminer si une police est prsente dans le systme, utilisez fl.isFontInstalled(). Remarque : lorsque vous dfinissez cette valeur, la valeur de la proprit rsultante peut diffrer de la chane saisie. Examinez l'exemple suivant : Exemple En supposant que le premier lment de la bibliothque soit un lment Font, le code suivant affiche le nom de la police de priphrique actuellement associe cet lment, puis le dfinit sur Times :
fl.outputPanel.clear(); var theItem = fl.getDocumentDOM().library.items[0]; fl.trace(theItem.font); theItem.font = "Times"; // depending on your system, the following may display something like "Times-Roman" fl.trace(theItem.font);

fontItem.isDefineFont4Symbol
Disponibilit Flash CS4 Professional. Utilisation
fontItem.isDefineFont4Symbol

Description Proprit; valeur boolenne qui spcifie le format de la police qui est en sortie lors de la publication d'un fichier SWF. Si cette valeur est true, Flash fournit une police qui peut tre utilise avec les interfaces de programmation de flash.text.engine (FTE). Si cette valeur est false, la police peut tre utilise avec les interfaces de programmation de flash.text, y compris les champs de texte. La valeur par dfaut est false. Exemple Voir fontItem.embedVariantGlyphs.

EXTENSION DE FLASH CS4 PROFESSIONAL 286

Objet fontItem

fontItem.italic
Disponibilit Flash CS4 Professional. Utilisation
fontItem.italic

Description Proprit ; valeur boolenne qui spcifie si l'lment est en italique (true) ou non (false). Exemple En supposant que le premier lment de la bibliothque soit un lment Font, le code suivant affiche true dans le panneau Sortie s'il est en italique, false dans le cas contraire, puis le dfinit sur italique.
var theItem = fl.getDocumentDOM().library.items[0]; fl.outputPanel.clear(); fl.trace("italic: "+ theItem.italic); theItem.italic=true; fl.trace("italic: "+ theItem.italic);

fontItem.size
Disponibilit Flash CS4 Professional. Utilisation
fontItem.size

Description Proprit ; nombre entier reprsentant la taille de l'lment Font, en points. Exemple En supposant que le premier lment de la bibliothque soit un lment Font, le code suivant affiche la taille en points de l'lment dans le panneau Sortie, puis la dfinit sur 24.
var theItem = fl.getDocumentDOM().library.items[0]; fl.outputPanel.clear(); fl.trace("font size: "+ theItem.size); theItem.size=24; fl.trace("font size: "+ theItem.size);

287

Chapitre 21 : Objet Frame

Disponibilit Flash MX 2004. Description Lobjet Frame reprsente les images du calque. Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet Frame :
Mthode
frame.getCustomEase() frame.setCustomEase()

Description Renvoie un tableau dobjets JavaScript possdant tous une proprit x et y. Spcifie une courbe de Bzier cubique utiliser comme courbe dacclration personnalise.

Rsum des proprits Vous pouvez utiliser les proprits suivantes avec lobjet Frame :
Proprit
frame.actionScript frame.duration

Description Chane reprsentant du code ActionScript. Lecture seule ; entier indiquant le nombre dimages prsentes dans une squence dimages. Lecture seule ; tableau d'objets Element (voir Objet Element). Valeur boolenne qui spcifie si l'image extrait ses informations d'acclration de la courbe dacclration personnalise. Chane qui spcifie le type du nom de limage. Valeur boolenne qui spcifie si llment interpol doit pivoter ou non pendant son dplacement le long dun trac afin de prserver son angle par rapport chaque point du trac. Chane qui spcifie le type de rotation de llment interpol. Entier qui spcifie le nombre de rotations de llment interpol entre limagecl de dpart et la suivante. Valeur boolenne qui spcifie si llment interpol doit subir une mise lchelle la taille de lobjet de la prochaine image-cl, en augmentant ainsi sa taille chaque image de linterpolation (true), ou sil ne doit pas subir de mise lchelle (false). Valeur boolenne qui spcifie si llment interpol doit tre automatiquement accroch au point le plus proche du calque de guide de mouvement associ au calque de cette image (true) ou non (false). Valeur boolenne qui, lorsquelle est dfinie sur true, synchronise lanimation de lobjet interpol avec le scnario principal. Chane qui spcifie le nom de limage.

frame.elements frame.hasCustomEase

frame.labelType frame.motionTweenOrientToPath

frame.motionTweenRotate frame.motionTweenRotateTimes

frame.motionTweenScale

frame.motionTweenSnap

frame.motionTweenSync

frame.name

EXTENSION DE FLASH CS4 PROFESSIONAL 288

Objet Frame

Proprit
frame.shapeTweenBlend

Description Chane qui spcifie comment linterpolation dune forme passe en fondu entre cette forme dans limage-cl de dpart de linterpolation et la mme forme dans limage-cl suivante. Chane qui spcifie les effets d'un son joint directement une image (frame.soundLibraryItem). Elment de bibliothque (voir Objet SoundItem) utilis pour cr un son. Valeur entire qui spcifie le nombre de fois o un son joint directement une image (frame.soundLibraryItem) est lu. Chane qui spcifie si un son joint directement une image (frame.soundLibraryItem) doit tre lu un certain nombre de fois ou en boucle infinie. Chane qui spcifie le nom d'un son joint directement une image (frame.soundLibraryItem), tel qu'il est stock dans la bibliothque. Chane qui spcifie le comportement de synchronisation d'un son joint directement une image (frame.soundLibraryItem). Lecture seule ; index de la premire image dune squence. Entier qui spcifie la quantit dacclration appliquer lobjet interpol. Chane qui spcifie le type d'interpolation. Valeur boolenne qui spcifie si une mme courbe dacclration personnalise est utilise pour les informations dacclration de toutes les proprits.

frame.soundEffect

frame.soundLibraryItem frame.soundLoop

frame.soundLoopMode

frame.soundName

frame.soundSync

frame.startFrame frame.tweenEasing frame.tweenType frame.useSingleEaseCurve

frame.actionScript
Disponibilit Flash MX 2004. Utilisation
frame.actionScript

Description Proprit ; chane reprsentant du code ActionScript. Pour insrer un caractre de nouvelle ligne, utilisez "\n". Exemple L'exemple suivant attribue le code stop() laction du calque suprieur de la premire image :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].actionScript = 'stop();';

frame.duration
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 289

Objet Frame

Utilisation
frame.duration

Description Proprit en lecture seule ; entier indiquant le nombre dimages prsentes dans une squence dimages. Exemple L'exemple suivant enregistre dans la variable frameSpan le nombre dimages dune squence qui dbute la premire image du calque suprieur :
var frameSpan = fl.getDocumentDOM().getTimeline().layers[0].frames[0].duration;

frame.elements
Disponibilit Flash MX 2004. Utilisation
frame.elements

Description Proprit en lecture seule ; tableau d'objets Element (voir Objet Element). Lordre des lments est celui dans lequel ils apparaissent dans le fichier FLA. Si la scne comporte plusieurs formes, et si toutes ces formes sont dissocies, Flash les traite comme un seul lment. Si chaque forme fait partie dun groupe (si bien quil existe plusieurs groupes sur la scne), Flash les traite comme des lments spars. Autrement dit, Flash traite les formes non groupes comme un mme lment, quel que soit le nombre de formes individuelles figurant sur la scne. Si une image contient trois formes brutes (non groupes), la proprit elements.length de cette image renvoie la valeur 1. Pour contourner le problme, vous pouvez slectionner individuellement toutes les formes et les grouper. Exemple L'exemple suivant enregistre dans la variable myElements un tableau des lments figurant dans le calque suprieur :
var myElements = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements;

frame.getCustomEase()
Disponibilit Flash 8. Utilisation
Frame.getCustomEase([property])

Paramtres property Chane facultative qui spcifie la proprit dont vous souhaitez lire la valeur dacclration. Les valeurs gres sont les suivantes : "all", "position", "rotation", "scale", "color" et "filters". La valeur par dfaut est "all".

EXTENSION DE FLASH CS4 PROFESSIONAL 290

Objet Frame

Valeur renvoye Renvoie un tableau dobjets JavaScript possdant tous une proprit x et y. Description Mthode qui renvoie un tableau d'objets reprsentant les points de contrle de la courbe de Bzier cubique qui dfinit la courbe dacclration. Exemple L'exemple suivant renvoie la valeur dacclration personnalise de la proprit position de la premire image du calque suprieur :
var theFrame = fl.getDocumentDOM().getTimeline().layers[0].frames[0] var easeArray = theFrame.getCustomEase("position");

Voir aussi
frame.hasCustomEase, frame.setCustomEase(), frame.useSingleEaseCurve

frame.hasCustomEase
Disponibilit Flash 8. Utilisation
frame.hasCustomEase

Description Proprit : valeur boolenne. Si elle est true, limage reoit ses informations dacclration de la courbe dacclration personnalise. Si elle est false, limage reoit ses informations dacclration de la valeur dacclration. Exemple L'exemple suivant spcifie que la premire image du calque suprieur doit recevoir ses informations dacclration de la valeur dacclration, plutt que de la courbe dacclration personnalise :
var theFrame = fl.getDocumentDOM().getTimeline().layers[0].frames[0] theFrame.hasCustomEase = false;

Voir aussi
frame.getCustomEase(), frame.setCustomEase(), frame.useSingleEaseCurve

frame.labelType
Disponibilit Flash MX 2004. Utilisation
frame.labelType

EXTENSION DE FLASH CS4 PROFESSIONAL 291

Objet Frame

Description Proprit ; chane qui spcifie le type de nom d'une image. Les valeurs gres sont "none" (aucun), "name" (nom), "comment" (commentaire) ou "anchor" (ancre). La dfinition d'une tiquette sur "none" efface la proprit frame.name. Exemple L'exemple suivant dfinit sur "First Frame" le nom de la premire image du calque suprieur, puis sur "comment" son tiquette :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].name = 'First Frame'; fl.getDocumentDOM().getTimeline().layers[0].frames[0].labelType = 'comment';

frame.motionTweenOrientToPath
Disponibilit Flash MX 2004. Utilisation
frame.motionTweenOrientToPath

Description Proprit ; valeur boolenne qui spcifie si llment interpol doit pivoter pendant son dplacement le long dun trac afin de prserver son angle par rapport chaque point du trac (true) ou sil ne doit pas pivoter (false). Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez frame.motionTweenRotate sur "none".

frame.motionTweenRotate
Disponibilit Flash MX 2004. Utilisation
frame.motionTweenRotate

Description Proprit ; chane qui spcifie le type de rotation de llment interpol. Les valeurs gres sont les suivantes : "none" (aucune), "auto", "clockwise" (sens horaire) et "counter-clockwise" (sens anti-horaire). La valeur "auto" signifie que lobjet subira une rotation dans la direction qui ncessite le moins de mouvement pour correspondre la rotation de cet objet dans la prochaine image-cl. Si vous souhaitez spcifier une valeur pour frame.motionTweenOrientToPath, dfinissez cette proprit sur "none". Exemple Voir frame.motionTweenRotateTimes.

EXTENSION DE FLASH CS4 PROFESSIONAL 292

Objet Frame

frame.motionTweenRotateTimes
Disponibilit Flash MX 2004. Utilisation
frame.motionTweenRotateTimes

Description Proprit ; entier qui spcifie le nombre de rotations de llment interpol entre limage-cl de dpart et la suivante. Exemple L'exemple suivant fait effectuer llment qui se trouve dans limage active trois rotations dans le sens anti-horaire dans le dlai ncessaire pour arriver limage-cl suivante :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].motionTweenRotate = "counterclockwise"; fl.getDocumentDOM().getTimeline().layers[0].frames[0].motionTweenRotateTimes = 3;

frame.motionTweenScale
Disponibilit Flash MX 2004. Utilisation
frame.motionTweenScale

Description Proprit ; valeur boolenne qui spcifie si llment interpol doit subir une mise lchelle la taille de lobjet de la prochaine image-cl, en augmentant ainsi sa taille chaque image de linterpolation (true), ou sil ne doit pas subir de mise lchelle (false). Exemple L'exemple suivant spcifie que l'lment interpol doit subir une mise lchelle la taille de lobjet de limage-cl suivante, en augmentant ainsi sa taille chaque image de linterpolation.
fl.getDocumentDOM().getTimeline().layers[0].frames[0].motionTweenScale = true;

frame.motionTweenSnap
Disponibilit Flash MX 2004. Utilisation
frame.motionTweenSnap

EXTENSION DE FLASH CS4 PROFESSIONAL 293

Objet Frame

Description Proprit ; valeur boolenne qui spcifie si llment interpol doit tre automatiquement accroch au point le plus proche du calque de guide de mouvement associ au calque de cette image (true) ou non (false).

frame.motionTweenSync
Disponibilit Flash MX 2004. Utilisation
frame.motionTweenSync

Description Proprit ; valeur boolenne qui, lorsquelle est dfinie sur true, synchronise lanimation de lobjet interpol avec le scnario principal. Exemple L'exemple suivant indique que lobjet interpol doit tre synchronis avec le scnario :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].motionTweenSync = true;

frame.name
Disponibilit Flash MX 2004. Utilisation
frame.name

Description Proprit ; chane qui spcifie le nom de limage. Exemple L'exemple suivant dfinit sur "First Frame" le nom de la premire image du calque suprieur, puis enregistre dans la variable frameLabel la valeur de sa proprit name :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].name = 'First Frame'; var frameLabel = fl.getDocumentDOM().getTimeline().layers[0].frames[0].name;

frame.setCustomEase()
Disponibilit Flash 8.

EXTENSION DE FLASH CS4 PROFESSIONAL 294

Objet Frame

Utilisation
frame.setCustomEase(property, easeCurve)

Paramtres property Chane qui spcifie la proprit pour laquelle la courbe dacclration doit tre utilise. Les valeurs gres sont les suivantes : "all", "position", "rotation", "scale", "color" et "filters".
easeCurve Tableau dobjets qui dfinissent la courbe dacclration. Chaque lment de ce tableau doit tre un objet

JavaScript avec des proprits x et y. Valeur renvoye Aucune. Description Mthode qui spcifie un tableau de coordonnes de points de contrle et de points de fin de tangente qui dcrivent une courbe de Bzier cubique utiliser comme courbe dacclration personnalise. Ce tableau est bas sur la position horizontale (ordinal : de gauche droite) des points de contrle et des points de fin de tangente. Exemple L'exemple suivant dfinit la courbe d'acclration de toutes les proprits de la premire image du premier calque sur la courbe de Bzier spcifie par le tableau easeCurve :
var theFrame = fl.getDocumentDOM().getTimeline().layers[0].frames[0]; var easeCurve = [ {x:0,y:0}, {x:.3,y:.3}, {x:.7,y:.7}, {x:1,y:1} ]; theFrame.setCustomEase( "all", easeCurve );

Voir aussi
frame.getCustomEase(), frame.hasCustomEase, frame.useSingleEaseCurve

frame.shapeTweenBlend
Disponibilit Flash MX 2004. Utilisation
frame.shapeTweenBlend

Description Proprit ; chane qui spcifie comment linterpolation dune forme passe en fondu entre cette forme dans limage-cl de dpart de linterpolation et la mme forme dans limage-cl suivante. Les valeurs gres sont "distributive" (distributif) ou "angular" (angulaire).

frame.soundEffect
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 295

Objet Frame

Utilisation
frame.soundEffect

Description Proprit ; chane qui spcifie les effets d'un son joint directement une image (frame.soundLibraryItem). Les valeurs gres sont les suivantes : "none", "left channel", "right channel", "fade left to right", "fade right to left", "fade in", "fade out" et "custom". Exemple L'exemple suivant spcifie que le son associ la premire image doit apparatre en fondu louverture :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].soundEffect = "fade in";

frame.soundLibraryItem
Disponibilit Flash MX 2004. Utilisation
frame.soundLibraryItem

Description Proprit ; lment de bibliothque (voir Objet SoundItem) utilis pour crer un son. Le son est associ directement limage. Exemple L'exemple suivant affecte le premier lment de la bibliothque la proprit soundLibraryItem de la premire image :
// The first item in the library must be a sound object. fl.getDocumentDOM().getTimeline().layers[0].frames[0].soundLibraryItem =fl.getDocumentDOM().library.items[0];

frame.soundLoop
Disponibilit Flash MX 2004. Utilisation
frame.soundLoop

Description Proprit ; valeur entire qui spcifie le nombre de lecture d'un son joint directement une image frame.soundLibraryItem). Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez frame.soundLoopMode sur "repeat".

EXTENSION DE FLASH CS4 PROFESSIONAL 296

Objet Frame

Exemple Voir frame.soundLoopMode.

frame.soundLoopMode
Disponibilit Flash MX 2004. Utilisation
frame.soundLoopMode

Description Proprit ; chane qui spcifie si un son joint directement une image (frame.soundLibraryItem) doit tre lu un certain nombre de fois ou en boucle infinie. Les valeurs gres sont "repeat" (rptition) ou "loop" (en boucle). Pour spcifier le nombre de lectures du son, attribuez une valeur frame.soundLoop. Exemple L'exemple suivant indique quun son doit tre lu deux fois :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].soundLoopMode = "repeat"; fl.getDocumentDOM().getTimeline().layers[0].frames[0].soundLoop = 2;

frame.soundName
Disponibilit Flash MX 2004. Utilisation
frame.soundName

Description Proprit ; chane qui spcifie le nom d'un son joint directement une image (frame.soundLibraryItem), tel que stock dans la bibliothque. Exemple L'exemple suivant donne la proprit soundName de la premire image la valeur "song1.mp3" ; le fichier song1.mp3 doit exister dans la bibliothque :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].soundName = "song1.mp3";

frame.soundSync
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 297

Objet Frame

Utilisation
frame.soundSync

Description Proprit ; chane qui spcifie le comportement de synchronisation d'un son joint directement une image (frame.soundLibraryItem). Les valeurs gres sont les suivantes : "event" (vnement), "stop", "start" et "stream" (flux). Exemple L'exemple suivant indique quun son doit tre lu en flux continu :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].soundSync = 'stream';

frame.startFrame
Disponibilit Flash MX 2004. Utilisation
frame.startFrame

Description Proprit en lecture seule ; index de la premire image dune squence. Exemple Dans lexemple suivant, stFrame est lindex de la premire image de la squence. Dans cet exemple, une squence dimages stend sur six images, de limage 5 limage 10. La valeur de stFrame pour nimporte quelle image comprise entre limage 5 et limage 10 est donc 4 (n'oubliez pas que les valeurs dindex sont diffrentes des valeurs de numro dimage).
var stFrame = fl.getDocumentDOM().getTimeline().layers[0].frames[4].startFrame; fl.trace(stFrame); // 4 var stFrame = fl.getDocumentDOM().getTimeline().layers[0].frames[9].startFrame; fl.trace(stFrame); // 4

frame.tweenEasing
Disponibilit Flash MX 2004. Utilisation
frame.tweenEasing

EXTENSION DE FLASH CS4 PROFESSIONAL 298

Objet Frame

Description Proprit ; entier qui spcifie la quantit dacclration appliquer lobjet interpol. Les valeurs gres vont de -100 100. Pour commencer l'interpolation de mouvement lentement et l'acclrer vers la fin de l'animation, utilisez une valeur ngative comprise entre -1 et -100. Pour commencer l'interpolation de mouvement rapidement et la ralentir vers la fin de l'animation, utilisez une valeur positive comprise entre 1 et 100. Exemple L'exemple suivant indique que le mouvement de lobjet en cours dinterpolation doit dbuter rapidement, puis dclrer vers la fin de lanimation :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].tweenEasing = 50;

frame.tweenType
Disponibilit Flash MX 2004. Utilisation
frame.tweenType

Description Proprit ; chane qui spcifie le type dinterpolation. Les valeurs gres sont les suivantes : "motion" (mouvement), "shape" (forme) ou "none" (aucune). La valeur "none" supprime l'interpolation de mouvement. Utilisez la mthode timeline.createMotionTween() pour crer une interpolation de mouvement. Si vous spcifiez la valeur "motion", lobjet interpoler doit tre un symbole, un champ de texte ou un groupe dobjets. Linterpolation sera effectue entre son emplacement dans limage-cl actuelle et son emplacement dans la prochaine image-cl. Si vous affectez la valeur "shape", lobjet interpoler doit tre une forme. Linterpolation sera effectue entre la forme dans limage-cl actuelle et la forme dans la prochaine image-cl. Exemple L'exemple suivant spcifie que lobjet est une interpolation de mouvement. Linterpolation doit donc tre effectue entre son emplacement dans limage-cl actuelle et son emplacement dans limage-cl suivante :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].tweenType = "motion";

frame.useSingleEaseCurve
Disponibilit Flash 8. Utilisation
frame.useSingleEaseCurve

EXTENSION DE FLASH CS4 PROFESSIONAL 299

Objet Frame

Description Proprit : valeur boolenne. Si sa valeur est true, la mme courbe dacclration personnalise est utilise pour les informations dacclration de toutes les proprits. Si elle est false, chaque proprit possde sa propre courbe dacclration. Cette proprit n'est pas prise en compte si l'acclration personnalise n'est pas applique l'image. Exemple L'exemple suivant spcifie quune mme courbe dacclration personnalise doit tre utilise pour toutes les proprits de la premire image du premier calque :
var theFrame = fl.getDocumentDOM().getTimeline().layers[0].frames[0] theFrame.useSingleEaseCurve = true;

Voir aussi
frame.getCustomEase(), frame.hasCustomEase, frame.setCustomEase()

300

Chapitre 22 : Objet halfEdge

Disponibilit Flash MX 2004. Description L'objet halfEdge est le ct dirig du contour dun Objet Shape. Un contour se compose de deux demi-contours. Il est possible de suivre les contours dune forme en parcourant ces demi-contours. Par exemple, en partant dun demicontour, vous pouvez suivre tous les demi-contours du contour dune forme, et revenir ainsi au demi-contour dorigine. Les demi-contours sont ordonns. Un demi-contour reprsente un ct du contour, et lautre demi-contour en reprsente lautre ct. Rsum des mthodes L'objet HalfEdge gre les mthodes suivantes :
Mthode
halfEdge.getEdge() halfEdge.getNext() halfEdge.getOppositeHalfEdge() halfEdge.getPrev() halfEdge.getVertex()

Description Mthode qui rcupre lObjet Edge de lobjet HalfEdge. Rcupre le prochain demi-contour du contour actif. Rcupre lobjet HalfEdge situ de lautre ct du contour. Rcupre l'objet HalfEdge prcdent du contour actif. Mthode qui rcupre lobjet Objet Vertex au dbut de lobjet HalfEdge.

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet HalfEdge :
Proprit
halfEdge.id halfEdge.index

Description Lecture seule ; entier reprsentant un identifiant unique pour l'objet HalfEdge. Entier prenant la valeur 0 ou 1 pour dterminer l'index de cet objet HalfEdge dans le contour parent.

halfEdge.getEdge()
Disponibilit Flash MX 2004. Utilisation
halfEdge.getEdge()

Paramtres Aucun.

EXTENSION DE FLASH CS4 PROFESSIONAL 301

Objet halfEdge

Valeur renvoye Un Objet Edge. Description Mthode qui rcupre lobjet Edge de lobjet HalfEdge. Voir Objet Edge. Exemple L'exemple suivant montre comment obtenir un contour et un demi-contour pour la forme spcifie :
var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge(0); var edge = hEdge.getEdge();

halfEdge.getNext()
Disponibilit Flash MX 2004. Utilisation
halfEdge.getNext()

Paramtres Aucun. Valeur renvoye Un objet HalfEdge. Description Mthode qui rcupre le demi-contour suivant du contour actif. Remarque : bien que les demi-contours possdent des proprits de direction et dordre squentiel, ce nest pas le cas des contours. Exemple L'exemple suivant enregistre dans la variable nextHalfEdge le demi-contour suivant du contour spcifi :
var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge( 0 ); var nextHalfEdge = hEdge.getNext();

halfEdge.getOppositeHalfEdge()
Disponibilit Flash MX 2004. Utilisation
halfEdge.getOppositeHalfEdge()

EXTENSION DE FLASH CS4 PROFESSIONAL 302

Objet halfEdge

Paramtres Aucun. Valeur renvoye Un objet HalfEdge. Description Mthode qui rcupre lobjet HalfEdge situ de lautre ct du contour. Exemple L'exemple suivant enregistre dans la variable otherHalfEdge lobjet hEdge du demi-bord oppos :
var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge(0); var otherHalfEdge = hEdge.getOppositeHalfEdge();

halfEdge.getPrev()
Disponibilit Flash MX 2004. Utilisation
halfEdge.getPrev()

Paramtres Aucun. Valeur renvoye Un objet HalfEdge. Description Mthode qui rcupre l'objet HalfEdge prcdent du contour actif. Remarque : bien que les demi-contours possdent des proprits de direction et dordre squentiel, ce nest pas le cas des contours. Exemple L'exemple suivant enregistre dans la variable prevHalfEdge le demi-contour prcdent du contour spcifi :
var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge( 0 ); var prevHalfEdge = hEdge.getPrev();

EXTENSION DE FLASH CS4 PROFESSIONAL 303

Objet halfEdge

halfEdge.getVertex()
Disponibilit Flash MX 2004. Utilisation
halfEdge.getVertex()

Paramtres Aucun. Valeur renvoye Un Objet Vertex Description Mthode qui rcupre lobjet Vertex au dbut de lobjet HalfEdge. Voir Objet Vertex Exemple L'exemple suivant enregistre dans la variable vertex lobjet Vertex situ en tte de lobjet hEdge :
var var var var shape = fl.getDocumentDOM().selection[0]; edge = shape.edges[0]; hEdge = edge.getHalfEdge(0); vertex = hEdge.getVertex();

halfEdge.id
Disponibilit Flash MX 2004. Utilisation
halfEdge.id

Description Proprit en lecture seule ; entier reprsentant un identifiant unique pour l'objet HalfEdge. Exemple L'exemple suivant affiche dans le panneau Sortie un identificateur unique pour le demi-bord spcifi :
var shape = fl.getDocumentDOM().selection[0]; alert(shape.contours[0].getHalfEdge().id);

EXTENSION DE FLASH CS4 PROFESSIONAL 304

Objet halfEdge

halfEdge.index
Disponibilit Flash MX 2004. Utilisation
halfEdge.index

Description Proprit en lecture seule ; entier possdant une valeur de 0 ou 1 qui dtermine l'index de cet objet HalfEdge dans le contour parent. Exemple L'exemple suivant affiche dans le panneau Sortie la valeur d'index pour le demi-bord spcifi :
var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge(0); var heIndex = hEdge.index;

305

Chapitre 23 : Objet Instance

Hritage

Objet Element > Objet Instance

Disponibilit Flash MX 2004. Description Instance est une sous-classe de l'Objet Element. Rsum des proprits Outre toutes celles de l'objet Element, l'objet Instance possde les proprits suivantes :
Proprit
instance.instanceType instance.libraryItem

Description Lecture seule ; chane reprsentant le type doccurrence. lment de bibliothque utilis pour instancier cette occurrence.

instance.instanceType
Disponibilit Flash MX 2004 ; valeur accepte "video", ajoute Flash 8. Utilisation
instance.instanceType

Description Proprit en lecture seule ; chane reprsentant le type doccurrence. Les valeurs possibles sont "symbol", "bitmap", "embedded video", "linked video", "video" et "compiled clip". Dans Flash MX 2004, la valeur de instance.instanceType pour un lment ajout la bibliothque l'aide de library.addNewItem("video") est "embedded_video". Dans Flash 8 et les versions ultrieures, la valeur est "video". Voir library.addNewItem(). Exemple L'exemple suivant montre que le type d'occurrence dun clip est symbol :
// Select a movie clip and then run this script. var type = fl.getDocumentDOM().selection[0].instanceType; fl.trace("This instance type is " + type);

EXTENSION DE FLASH CS4 PROFESSIONAL 306

Objet Instance

instance.libraryItem
Disponibilit Flash MX 2004. Utilisation
instance.libraryItem

Description Proprit ; lment de bibliothque utilis pour instancier cette occurrence. Il nest possible de changer cette proprit quen la remplaant par un autre objet de bibliothque du mme type (par exemple, vous ne pouvez pas faire rfrence un bitmap avec une occurrence de type symbol). Voir Objet library. Exemple L'exemple suivant modifie le symbole slectionn pour quil rfrence le premier lment de la bibliothque :
fl.getDocumentDOM().selection[0].libraryItem = fl.getDocumentDOM().library.items[0];

307

Chapitre 24 : Objet Item

Disponibilit Flash MX 2004. Description Lobjet Item est une classe de base abstraite. Tous les lments de la bibliothque drivent de lobjet Item. Voir galement Objet library. Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet Item :
Mthode
item.addData() item.getData() item.hasData() item.removeData()

Description Ajoute les donnes spcifies un lment de la bibliothque. Rcupre la valeur des donnes spcifies. Dtermine si llment de bibliothque comporte les donnes indiques. Supprime les donnes persistantes de llment de bibliothque.

Rsum des proprits Les proprits suivantes sont disponibles avec lobjet Item :
Proprit
item.itemType item.linkageBaseClass item.linkageClassName item.linkageExportForAS

Description Lecture seule ; chane indiquant le type dlment. Chane spcifiant la classe ActionScript 3.0 qui sera associe au symbole. Chane spcifiant la classe ActionScript 2.0 qui sera associe au symbole. Valeur boolenne. Si sa valeur est true, llment est export pour le code ActionScript. Valeur boolenne. Si sa valeur est true, llment est export pour le partage l'excution. Valeur boolenne. Si sa valeur est true, llment est export dans la premire image. Chane spcifiant le nom qui permettra Flash d'identifier l'lment au moment de crer une liaison vers le fichier SWF de destination. Valeur boolenne. Si sa valeur est true, llment est import pour le partage l'excution. Chane qui spcifie l'URL laquelle se trouve le fichier SWF contenant l'lment partag. Chane qui spcifie le nom de llment de bibliothque, structure de larborescence comprise.

item.linkageExportForRS

item.linkageExportInFirstFrame

item.linkageIdentifier

item.linkageImportForRS

item.linkageURL

item.name

EXTENSION DE FLASH CS4 PROFESSIONAL 308

Objet Item

item.addData()
Disponibilit Flash MX 2004. Utilisation
item.addData(name, type, data)

Paramtres name Chane qui spcifie le nom des donnes.

type Chane spcifiant le type des donnes. Les types valides sont "integer", "integerArray", "double", "doubleArray", "string" et "byteArray". data Donnes ajouter llment de bibliothque spcifi. Le type de donnes dpend de la valeur du paramtre

type. Par exemple, si type est "integer", la valeur des donnes doit tre un entier, etc. Valeur renvoye Aucune. Description Mthode qui ajoute les donnes spcifies un lment de la bibliothque. Exemple L'exemple suivant ajoute des donnes nommes myData, avec une valeur entire de 12, au premier lment de la bibliothque :
fl.getDocumentDOM().library.items[0].addData("myData", "integer", 12);

item.getData()
Disponibilit Flash MX 2004. Utilisation
item.getData(name)

Paramtres name Chane spcifiant le nom des donnes rcuprer. Valeur renvoye Les donnes spcifies par le paramtre name. Le type renvoy dpend du type des donnes enregistres. Description Mthode qui rcupre la valeur des donnes spcifies.

EXTENSION DE FLASH CS4 PROFESSIONAL 309

Objet Item

Exemple L'exemple suivant rcupre les valeurs des donnes nommes myData dans le premier lment de la bibliothque et les enregistre dans la variable libData :
var libData = fl.getDocumentDOM().library.items[0].getData("myData");

item.hasData()
Disponibilit Flash MX 2004. Utilisation
item.hasData(name)

Paramtres name Chane spcifiant le nom des donnes vrifier dans llment de bibliothque. Valeur renvoye Valeur boolenne : true si les donnes spcifies existent, false dans le cas contraire. Description Mthode qui dtermine si llment de bibliothque comporte les donnes indiques. Exemple L'exemple suivant affiche un message dans le panneau Sortie si le premier lment de la bibliothque contient des donnes nommes myData :
if (fl.getDocumentDOM().library.items[0].hasData("myData")){ fl.trace("Yep, it's there!"); }

item.itemType
Disponibilit Flash MX 2004. Utilisation
item.itemType

Description Proprit en lecture seule ; chane indiquant le type dlment. Valeurs possibles : "undefined", "component", "movie clip", "graphic", "button", "folder", "font", "sound", "bitmap", "compiled clip", "screen" ou "video". Si cette proprit est "video", vous pouvez dterminer le type vido ; voir videoItem.videoType. Exemple L'exemple suivant affiche le type de l'lment de bibliothque spcifi dans le panneau Sortie :

EXTENSION DE FLASH CS4 PROFESSIONAL 310

Objet Item

fl.trace(fl.getDocumentDOM().library.items[0].itemType);

item.linkageBaseClass
Disponibilit Flash CS3 Professional. Utilisation
item.linkageBaseClass

Description Proprit ; chane spcifiant la classe ActionScript 3.0 qui sera associe au symbole. La valeur spcifie ici apparat dans la bote de dialogue Liaison de l'environnement de programmation, ainsi que dans toutes les autres botes de dialogue affichant les contrles de cette option, par exemple la bote de dialogue Proprits du symbole. (Si vous voulez spcifier cette valeur pour une classe ActionScript 2.0, utilisez item.linkageClassName.) Si la classe de base est la classe par dfaut pour le type de symbole (par exemple "flash.display.MovieClip" pour les clips, "flash.display.SimpleButton" pour les boutons, etc.), la valeur de cette proprit est une chane vide (""). De mme, vous dfinirez cette valeur sur une chane vide pour qu'un lment devienne la classe de base par dfaut. Lorsque vous dfinissez cette valeur, aucune des vrifications prvues par la bote de dialogue Liaison n'est effectue, et aucune erreur n'est renvoye si Flash est dans l'incapacit de dfinir la valeur de la classe de base sur celle qui est spcifie. Par exemple, le fait de dfinir cette valeur dans la bote de dialogue Liaison oblige le processus de vrification contrler la prsence de la classe de base dans le chemin d'accs de classe du fichier FLA. Il s'assure qu'ActionScript 3.0 est choisi dans l'onglet Flash de la bote de dialogue Paramtres de publication, etc. Ces vrifications ne sont pas effectues lorsque vous dfinissez cette proprit dans un script. Exemple Les lignes de code suivantes illustrent plusieurs faons d'utiliser cette proprit :
// sets the library item base class to "Sprite" fl.getDocumentDOM().library.items[0].linkageBaseClass = "flash.display.Sprite"; // sets the library item base class to the default for that item type fl.getDocumentDOM().library.items[0].linkageBaseClass = ""; // finds and displays the library item's base class fl.trace(fl.getDocumentDOM().library.items[0].linkageBaseClass);

Voir aussi
document.docClass

item.linkageClassName
Disponibilit Flash MX 2004. Utilisation
item.linkageClassName

EXTENSION DE FLASH CS4 PROFESSIONAL 311

Objet Item

Description Proprit ; chane spcifiant la classe ActionScript 2.0 qui sera associe au symbole. (Si vous voulez spcifier cette valeur pour une classe ActionScript 3.0, utilisez item.linkageBaseClass.) Pour dfinir cette proprit, les proprits item.linkageExportForAS et/ou item.linkageExportForRS doivent tre dfinies sur true et la proprit item.linkageImportForRS doit tre dfinie sur false. Exemple L'exemple suivant spcifie que le nom de classe ActionScript 2.0 associ au premier lment de la bibliothque est myClass :
fl.getDocumentDOM().library.items[0].linkageClassName = "myClass";

item.linkageExportForAS
Disponibilit Flash MX 2004. Utilisation
item.linkageExportForAS

Description Proprit : valeur boolenne. Si cette proprit a la valeur true, llment est export pour le code ActionScript. Vous pouvez galement dfinir les proprits item.linkageExportForRS et item.linkageExportInFirstFrame sur true. Si vous dfinissez cette proprit sur true, la proprit item.linkageImportForRS doit tre dfinie sur false. Par ailleurs, vous devez spcifier un identificateur (item.linkageIdentifier) et une URL (item.linkageURL). Exemple L'exemple suivant dfinit cette proprit pour llment de bibliothque spcifi :
fl.getDocumentDOM().library.items[0].linkageExportForAS = true;

item.linkageExportForRS
Disponibilit Flash MX 2004. Utilisation
item.linkageExportForRS

Description Proprit : valeur boolenne. Si cette proprit a la valeur true, llment est export pour le partage l'excution. Vous pouvez galement dfinir les proprits item.linkageExportForAS et item.linkageExportInFirstFrame sur true.

EXTENSION DE FLASH CS4 PROFESSIONAL 312

Objet Item

Si vous dfinissez cette proprit sur true, la proprit item.linkageImportForRS doit tre dfinie sur false. Par ailleurs, vous devez spcifier un identificateur (item.linkageIdentifier) et une URL (item.linkageURL). Exemple L'exemple suivant dfinit cette proprit pour llment de bibliothque spcifi :
fl.getDocumentDOM().library.items[0].linkageExportForRS = true;

item.linkageExportInFirstFrame
Disponibilit Flash MX 2004. Utilisation
item.linkageExportInFirstFrame

Description Proprit : valeur boolenne. Si sa valeur est true, llment est export dans la premire image ; si elle est false, llment est export dans limage de la premire occurrence. Si llment n'apparat pas sur la scne, il nest pas export. Cette proprit peut tre dfinie sur true uniquement si les proprits item.linkageExportForAS et/ou item.linkageExportForRS sont dfinies sur true. Exemple L'exemple suivant spcifie que llment de bibliothque spcifi doit tre export dans la premire image :
fl.getDocumentDOM().library.items[0].linkageExportInFirstFrame = true;

item.linkageIdentifier
Disponibilit Flash MX 2004. Utilisation
item.linkageIdentifier

Description Proprit ; chane spcifiant le nom qui permettra Flash d'identifier l'lment au moment de crer une liaison vers le fichier SWF de destination. Flash ignore cette proprit si les proprits item.linkageImportForRS, item.linkageExportForAS et item.linkageExportForRS sont dfinies sur false. A l'inverse, cette proprit doit tre dfinie si l'une de ces proprits est dfinie sur true. Exemple L'exemple suivant spcifie que la chane my_mc sera utilise pour identifier llment de bibliothque au moment de le lier au fichier SWF vers lequel il sera export :

EXTENSION DE FLASH CS4 PROFESSIONAL 313

Objet Item

fl.getDocumentDOM().library.items[0].linkageIdentifier = "my_mc";

Voir aussi
item.linkageURL

item.linkageImportForRS
Disponibilit Flash MX 2004. Utilisation
item.linkageImportForRS

Description Proprit ; valeur boolenne, si true, l'lment est import pour le partage l'excution. Si cette proprit est dfinie sur true, les deux proprits item.linkageExportForAS et item.linkageExportForRS doivent tre dfinies sur false. Par ailleurs, vous devez spcifier un identificateur (item.linkageIdentifier) et une URL (item.linkageURL). Exemple L'exemple suivant dfinit cette proprit sur true pour llment de bibliothque spcifi :
fl.getDocumentDOM().library.items[0].linkageImportForRS = true;

item.linkageURL
Disponibilit Flash MX 2004. Utilisation
item.linkageURL

Description Proprit ; chane qui spcifie l'URL laquelle se trouve le fichier SWF contenant l'lment partag. Flash ignore cette proprit si les proprits item.linkageImportForRS, item.linkageExportForAS et item.linkageExportForRS sont dfinies sur false. A l'inverse, cette proprit doit tre dfinie si l'une de ces proprits est dfinie sur true. Il est possible dindiquer une adresse de type URL ou un nom de fichier au format dune plate-forme prcise (cest--dire avec une barre oblique normale (/) ou inverse (\), selon la plate-forme). Exemple L'exemple suivant spcifie une adresse URL comme lien vers llment de bibliothque spcifi :
fl.getDocumentDOM().library.items[0].linkageURL = "theShareSWF.swf";

Voir aussi
item.linkageIdentifier

EXTENSION DE FLASH CS4 PROFESSIONAL 314

Objet Item

item.name
Disponibilit Flash MX 2004. Utilisation
item.name

Description Mthode (chane) qui spcifie le nom de llment de bibliothque, structure de larborescence comprise. Par exemple, si Symbol_1 se trouve lintrieur dun dossier nomm Folder_1, la proprit name de Symbol_1 reoit la valeur "Folder_1/Symbol_1". Exemple L'exemple suivant affiche le nom de l'lment de bibliothque spcifi dans le panneau Sortie :
fl.trace(fl.getDocumentDOM().library.items[0].name);

item.removeData()
Disponibilit Flash MX 2004. Utilisation
item.removeData(name)

Paramtres name Chane spcifiant le nom des donnes supprimer de llment de bibliothque. Valeur renvoye Aucune. Description Proprit ; supprime les donnes persistantes de llment de bibliothque. Exemple L'exemple suivant supprime les donnes nommes myData du premier lment de la bibliothque :
fl.getDocumentDOM().library.items[0].removeData("myData");

315

Chapitre 25 : Objet Layer

Disponibilit Flash MX 2004. Description Lobjet Layer reprsente un calque dans le scnario. La proprit timeline.layers contient un tableau d'objets Layer, accessible par le biais de fl.getDocumentDOM().getTimeline().layers. Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Layer :
Proprit
layer.color

Description Chane, valeur hexadcimale ou entier qui spcifie la couleur utilise pour indiquer les contours du calque. Lecture seule ; entier prcisant le nombre dimages du calque. Lecture seule ; tableau d'objets Frame. Entier qui spcifie la hauteur du calque en pourcentage ; quivalent au champ Hauteur du calque de la bote de dialogue Proprits du calque. Chane qui spcifie lutilisation actuelle du calque ; quivalent du champ Type dans la bote de dialogue Proprits du calque. Valeur boolenne spcifiant ltat de verrouillage du calque. Chane qui spcifie le nom du calque. Valeur boolenne spcifiant ltat des contours de tous les objets du calque. Objet Layer qui reprsente lobjet parent du calque (dossier de calques, calque de guidage ou calque de masquage). Valeur boolenne indiquant si les objets du calque sur la scne sont affichs ou masqus.

layer.frameCount layer.frames layer.height

layer.layerType

layer.locked layer.name layer.outline layer.parentLayer

layer.visible

layer.color
Disponibilit Flash MX 2004. Utilisation
layer.color

Description Proprit ; couleur utiliser pour dlimiter le calque, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB

EXTENSION DE FLASH CS4 PROFESSIONAL 316

Objet Layer

Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal

Cette proprit est l'quivalent du champ Couleur de contour dans la bote de dialogue Proprits du calque. Exemple L'exemple suivant enregistre dans la variable colorValue la valeur du premier calque :
var colorValue = fl.getDocumentDOM().getTimeline().layers[0].color;

L'exemple suivant prsente les trois faons de dfinir sur rouge la couleur du premier calque :
fl.getDocumentDOM().getTimeline().layers[0].color=16711680; fl.getDocumentDOM().getTimeline().layers[0].color="#ff0000"; fl.getDocumentDOM().getTimeline().layers[0].color=0xFF0000;

layer.frameCount
Disponibilit Flash MX 2004. Utilisation
layer.frameCount

Description Proprit en lecture seule ; entier indiquant le nombre dimages du calque. Exemple L'exemple suivant enregistre dans la variable fcNum le nombre dimages du premier calque :
var fcNum = fl.getDocumentDOM().getTimeline().layers[0].frameCount;

layer.frames
Disponibilit Flash MX 2004. Utilisation
layer.frames

Description Proprit en lecture seule ; tableau d'objets Frame (voir Objet Frame). Exemple L'exemple suivant copie dans la variable frameArray le tableau dobjets Frame reprsentant les images du document actif :
var frameArray = fl.getDocumentDOM().getTimeline().layers[0].frames;

EXTENSION DE FLASH CS4 PROFESSIONAL 317

Objet Layer

Pour savoir si une image est une image-cl, vrifiez si la proprit frame.startFrame correspond l'index du tableau, comme l'illustre l'exemple suivant :
var frameArray = fl.getDocumentDOM().getTimeline().layers[0].frames; var n = frameArray.length; for (i=0; i<n; i++) { if (i==frameArray[i].startFrame) { alert("Keyframe at: " + i); } }

layer.height
Disponibilit Flash MX 2004. Utilisation
layer.height

Description Proprit ; entier qui spcifie la hauteur du calque en pourcentage ; quivalent au champ Hauteur du calque de la bote de dialogue Proprits du calque. Les valeurs possibles reprsentent un pourcentage de la hauteur par dfaut : 100, 200 ou 300. Exemple L'exemple suivant enregistre la valeur de pourcentage de hauteur du premier calque :
var layerHeight = fl.getDocumentDOM().getTimeline().layers[0].height;

Lexemple suivant dfinit la hauteur du premier calque sur 300% :

fl.getDocumentDOM().getTimeline().layers[0].height = 300;

layer.layerType
Disponibilit Flash MX 2004. Utilisation
layer.layerType

Description Proprit ; chane qui spcifie lutilisation actuelle du calque ; quivalent au champ Type dans la bote de dialogue Proprits du calque. Les valeurs gres sont : "normal", "guide", "guided", "mask", "masked" et "folder". Exemple L'exemple suivant dfinit le premier calque du scnario sur le type folder :
fl.getDocumentDOM().getTimeline().layers[0].layerType = "folder";

EXTENSION DE FLASH CS4 PROFESSIONAL 318

Objet Layer

layer.locked
Disponibilit Flash MX 2004. Utilisation
layer.locked

Description Proprit ; valeur boolenne spcifiant ltat de verrouillage du calque. Si cette proprit est true, le calque est verrouill. La valeur par dfaut est false. Exemple L'exemple suivant enregistre dans la variable lockStatus la valeur boolenne dtat de verrouillage du premier calque :
var lockStatus = fl.getDocumentDOM().getTimeline().layers[0].locked;

Lexemple suivant dfinit ltat du premier calque sur dverrouill :

fl.getDocumentDOM().getTimeline().layers[0].locked = false;

layer.name
Disponibilit Flash MX 2004. Utilisation
layer.name

Description Proprit ; chane qui spcifie le nom du calque. Exemple L'exemple suivant dfinit sur foreground le nom du premier calque du document actuel :
fl.getDocumentDOM().getTimeline().layers[0].name = "foreground";

layer.outline
Disponibilit Flash MX 2004. Utilisation
layer.outline

EXTENSION DE FLASH CS4 PROFESSIONAL 319

Objet Layer

Description Proprit ; valeur boolenne spcifiant ltat des contours de tous les objets du calque. Si cette proprit est dfinie sur true, seuls les contours des objets du calque sont affichs. Si elle est dfinie sur false, les objets apparaissent tels quils ont t crs. Exemple Lexemple suivant fait afficher uniquement les contours des objets du premier calque :
fl.getDocumentDOM().getTimeline().layers[0].outline = true;

layer.parentLayer
Disponibilit Flash MX 2004. Utilisation
layer.parentLayer

Description Proprit ; objet Layer qui reprsente lobjet parent du calque (dossier de calques, calque de guidage ou calque de masquage). Le calque parent doit tre un dossier conteneur du calque, un calque de guide ou de masque prcdant le calque dans la hirarchie, ou le calque parent (parentLayer) du calque prcdent ou suivant. Le paramtrage de lobjet parentLayer du calque ne modifie pas la position du calque dans la liste. De ce fait, tenter de dfinir le parentLayer dun calque sur un calque qui ncessiterait son dplacement est sans effet. Cette proprit utilise la valeur null pour un calque de niveau suprieur. Exemple L'exemple suivant utilise deux calques de mme niveau dans le mme scnario. Le premier calque (layers[0]) est converti en dossier, puis dfini comme dossier parent du second calque (layers[1]). Cette action place le second calque l'intrieur du premier.
var parLayer = fl.getDocumentDOM().getTimeline().layers[0]; parLayer.layerType = "folder"; fl.getDocumentDOM().getTimeline().layers[1].parentLayer = parLayer;

layer.visible
Disponibilit Flash MX 2004. Utilisation
layer.visible

EXTENSION DE FLASH CS4 PROFESSIONAL 320

Objet Layer

Description Proprit ; valeur boolenne indiquant si les objets du calque sur la scne sont affichs ou masqus. Si la valeur de cette proprit est true, tous les objets du calque sont visibles ; si elle est false, ils sont masqus. La valeur par dfaut est true. Exemple Lexemple suivant rend les objets du premier calque invisibles :
fl.getDocumentDOM().getTimeline().layers[0].visible = false;

321

Chapitre 26 : Objet library

Disponibilit Flash MX 2004. Description Lobjet library reprsente le panneau Bibliothque. Il s'agit d'une proprit de l'objet Document (voir document.library) laquelle vous pouvez accder par fl.getDocumentDOM().library. Lobjet library contient un tableau dlments de diffrents types (symboles, bitmaps, sons et vido). Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet library :
Mthode
library.addItemToDocument() library.addNewItem()

Description Ajoute llment actif ou un lment spcifi la scne, l'emplacement spcifi. Cre dans le panneau Bibliothque un nouvel lment du type spcifi, et dfinit ce nouvel lment sur l'lment slectionn. Supprime du panneau Bibliothque les lments actifs ou un lment spcifi. Copie llment slectionn ou un lment spcifi. Ouvre llment slectionn ou un lment spcifi en mode de modification. Dveloppe ou rduit le dossier slectionn ou un dossier spcifi dans la bibliothque. Renvoie lindex (en base zro) de llment dans la bibliothque. Rcupre la proprit de lobjet slectionn. Rcupre le type de lobjet slectionn ou dun objet spcifi par son chemin daccs dans la bibliothque. Rcupre le tableau de tous les lments slectionns dans la bibliothque. Importe un fichier SWF dans la bibliothque, sous forme de clip compil. Vrifie lexistence de llment spcifi dans la bibliothque. Dplace llment slectionn ou un lment de bibliothque spcifi dans un dossier spcifi. Cre un nouveau dossier portant le nom spcifi (ou le nom par dfaut "untitled folder #") si le paramtre folderName nest pas fourni) dans le dossier slectionn. Renomme llment de bibliothque slectionn dans le panneau Bibliothque. Slectionne ou dslectionne tous les lments de la bibliothque. Slectionne llment de bibliothque spcifi.

library.deleteItem() library.duplicateItem() library.editItem() library.expandFolder()

library.findItemIndex() library.getItemProperty() library.getItemType()

library.getSelectedItems() library.importEmbeddedSWF() library.itemExists() library.moveToFolder()

library.newFolder()

library.renameItem() library.selectAll() library.selectItem()

EXTENSION DE FLASH CS4 PROFESSIONAL 322

Objet library

Mthode
library.selectNone() library.setItemProperty()

Description Retire tous les lments de bibliothque de la slection. Dfinit la proprit de tous les objets de bibliothque slectionns (en ignorant les dossiers). Actualise llment de bibliothque spcifi.

library.updateItem()

Rsum des proprits de lobjet library La proprit suivante est disponible avec lobjet Library :
Proprit
library.items

Description Tableau d'objets Item de la bibliothque

library.addItemToDocument()
Disponibilit Flash MX 2004. Utilisation
library.addItemToDocument(position [, namePath])

Paramtres position Point qui indique la position x,y du centre de llment sur la scne.
namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Si namePath nest pas spcifi, la slection actuelle dans la bibliothque est utilise. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne : true si l'lment est bien ajout au document, false en cas d'chec. Description Mthode qui ajoute llment actif ou un lment spcifi la scne, l'emplacement spcifi. Exemple Lexemple suivant ajoute llment slectionn ou un lment spcifi sur la scne, la position (3,60).
fl.getDocumentDOM().library.addItemToDocument({x:3, y:60});

Lexemple suivant ajoute sur la scne llment Symbol1 (qui se trouve dans le dossier folder1 de la bibliothque) la position (550, 485) :
fl.getDocumentDOM().library.addItemToDocument({x:550.0, y:485.0}, "folder1/Symbol1");

EXTENSION DE FLASH CS4 PROFESSIONAL 323

Objet library

library.addNewItem()
Disponibilit Flash MX 2004. Utilisation
library.addNewItem(type [, namePath])

Paramtres type Chane spcifiant le type dlment crer. Les seules valeurs gres pour type sont "video", "movie clip", "button", "graphic", "bitmap", "screen" et "folder" (cette mthode ne permet donc pas dajouter un son la bibliothque). Spcifier un chemin de dossier revient utiliser library.newFolder()library.newFolder() avant d'appeler cette mthode.
namePath Chane spcifiant le nom de llment ajouter. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne : true si l'lment est bien cr, false dans le cas contraire. Description Mthode qui cre dans le panneau Bibliothque un nouvel lment du type spcifi et active ce nouvel lment. Pour plus d'informations sur l'importation d'lments dans la bibliothque, y compris des sons, consultez document.importFile(). Exemple L'exemple suivant cre un nouvel lment de bouton nomm start dans un nouveau dossier nomm folderTwo :
fl.getDocumentDOM().library.addNewItem("button", "folderTwo/start");

library.deleteItem()
Disponibilit Flash MX 2004. Utilisation
library.deleteItem([namePath])

Paramtres namePath Chane spcifiant le nom de llment supprimer. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Si vous transmettez le nom dun dossier, ce dernier et tout son contenu sont supprims. Si aucun nom nest spcifi, Flash supprime le ou les lments actuellement slectionns. Pour supprimer tous les lments du panneau Bibliothque, slectionnez tous les lments avant dutiliser cette mthode. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne : true si les lments sont bien supprims, false dans le cas contraire.

EXTENSION DE FLASH CS4 PROFESSIONAL 324

Objet library

Description Mthode qui supprime du panneau Bibliothque les lments actifs ou un lment spcifi. Si plusieurs lments sont slectionns, cette mthode les supprime tous. Exemple L'exemple suivant supprime llment slectionn :
fl.getDocumentDOM().library.deleteItem();

L'exemple suivant supprime llment Symbol_1 du dossier Folder_1 de la bibliothque :

fl.getDocumentDOM().library.deleteItem("Folder_1/Symbol_1");

library.duplicateItem()
Disponibilit Flash MX 2004. Utilisation
library.duplicateItem( [ namePath ] )

Paramtres namePath Chane spcifiant le nom de llment dupliquer. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne, true si l'lment est bien dupliqu, false en cas d'chec. Si vous avez slectionn plusieurs objets, Flash renvoie false. Description Mthode qui copie llment slectionn ou un lment spcifi. Le nouvel lment reoit un nom par dfaut (par exemple item copy) et devient llment slectionn. Si vous avez slectionn plusieurs lments, la commande choue. Exemple L'exemple suivant cre une copie de llment square dans le dossier test de la bibliothque:
fl.getDocumentDOM().library.duplicateItem("test/square");

library.editItem()
Disponibilit Flash MX 2004. Utilisation
library.editItem([namePath])

EXTENSION DE FLASH CS4 PROFESSIONAL 325

Objet library

Paramtres namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Si namePath nest pas spcifi, llment de bibliothque slectionn souvre en mode de modification. Si aucun lment nest slectionn, ou si au contraire plusieurs lments sont slectionns, la premire squence du scnario principal est ouverte en mode de modification. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne : true si l'lment spcifi existe et peut tre modifi, false dans le cas contraire. Description Mthode qui ouvre llment slectionn ou un lment spcifi en mode de modification. Exemple L'exemple suivant ouvre pour modification llment circle, qui se trouve dans le dossier test de la bibliothque :
fl.getDocumentDOM().library.editItem("test/circle");

library.expandFolder()
Disponibilit Flash MX 2004. Utilisation
library.expandFolder(bExpand [, bRecurseNestedParents [, namePath]])

Paramtres bExpand Valeur boolenne : si true, le dossier est dvelopp ; si false (par dfaut), le dossier est rduit.
bRecurseNestedParents Valeur boolenne : si true, tous les dossiers prsents dans le dossier spcifi sont dvelopps ou rduits, selon la valeur de bExpand. La valeur par dfaut est false. Ce paramtre est facultatif. namePath Chane spcifiant le nom et, ventuellement, le chemin daccs du dossier dvelopper ou rduire. Si ce paramtre nest pas spcifi, la mthode sapplique au dossier actuellement slectionn. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne : true si l'lment est bien dvelopp ou rduit ; false en cas d'chec ou si l'lment spcifi n'est pas un dossier. Description Mthode qui dveloppe ou rduit le dossier actif ou un dossier spcifi dans la bibliothque. Exemple L'exemple suivant rduit le dossier test , ainsi que tous ses sous-dossiers, le cas chant :
fl.getDocumentDOM().library.expandFolder(false, true, "test");

EXTENSION DE FLASH CS4 PROFESSIONAL 326

Objet library

library.findItemIndex()
Disponibilit Flash MX 2004. Utilisation
library.findItemIndex(namePath)

Paramtres namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Valeur renvoye Nombre entier reprsentant lindex (en base zro) de llment dans la bibliothque. Description Mthode qui renvoie lindex (en base zro) de llment dans la bibliothque. Lindex de la bibliothque possde une seule dimension, si bien que les dossiers font partie de lindexation. Il est possible dutiliser les chemins daccs des dossiers pour spcifier un lment imbriqu. Exemple L'exemple suivant enregistre dans la variable sqIndex la valeur dindex (en base zro) de llment de bibliothque "square" qui se trouve dans le dossier "test", puis affiche cette valeur dans une bote de dialogue :
var sqIndex = fl.getDocumentDOM().library.findItemIndex("test/square"); alert(sqIndex);

library.getItemProperty()
Disponibilit Flash MX 2004. Utilisation
library.getItemProperty(property)

Paramtres property Chane. Pour obtenir la liste des valeurs utilisables comme paramtre property, consultez le Rsum des proprits de l'objet Objet Item, ainsi que les proprits disponibles pour ses sous-classes. Valeur renvoye La valeur de chane de la proprit. Description Mthode qui rcupre la proprit de llment slectionn.

EXTENSION DE FLASH CS4 PROFESSIONAL 327

Objet library

Exemple L'exemple suivant affiche dans une bote de dialogue la valeur de l'identifiant de liaison du symbole tel quil est rfrenc en code ActionScript ou pour le partage l'excution :
alert(fl.getDocumentDOM().library.getItemProperty("linkageIdentifier"));

library.getItemType()
Disponibilit Flash MX 2004. Utilisation
library.getItemType([namePath])

Paramtres namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Si namePath nest pas spcifi, Flash renvoie le type de la slection actuelle. Si plusieurs lments sont slectionns et si le paramtre namePath nest pas spcifi, Flash ignore la commande. Ce paramtre est facultatif. Valeur renvoye Une valeur de chane qui spcifie le type de lobjet. Pour obtenir la liste des valeurs pouvant tre renvoyes, consultez item.itemType. Description Mthode qui rcupre le type de lobjet slectionn ou spcifi par son chemin daccs la bibliothque. Exemple L'exemple suivant affiche dans une bote de dialogue le type de llment Symbol_1, qui se trouve dans le dossier Folder_1/Folder_2 :
alert(fl.getDocumentDOM().library.getItemType("Folder_1/Folder_2/Symbol_1"));

library.getSelectedItems()
Disponibilit Flash MX 2004. Paramtres Aucun. Valeur renvoye Le tableau des valeurs de tous les lments slectionns dans la bibliothque. Description Mthode qui rcupre le tableau de tous les lments slectionns dans la bibliothque.

EXTENSION DE FLASH CS4 PROFESSIONAL 328

Objet library

Exemple L'exemple suivant stocke dans la variable selItems le tableau des lments de la bibliothque actuellement slectionns (ici, plusieurs fichiers audio), puis donne la proprit sampleRate du premier fichier audio du tableau la valeur 11 kHz :
var selItems = fl.getDocumentDOM().library.getSelectedItems(); selItems[0].sampleRate = "11 kHz";

library.importEmbeddedSWF()
Disponibilit Flash MX 2004. Utilisation
library.importEmbeddedSWF(linkageName, swfData [, libName])

Paramtres
linkageName Chane indiquant le nom de la liaison SWF du clip racine. swfData Tableau de donnes SWF binaires, qui provient dune bibliothque externe ou dune DLL. libName Chane spcifiant le nom, dans la bibliothque, de llment cr. Si ce nom est dj utilis, la mthode en

cre un autre. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui importe un fichier SWF dans la bibliothque sous forme de clip compil. la diffrence de loption de menu Fichier > Importer > SWF, cette mthode permet dincorporer dans la bibliothque un fichier SWF compil. Il nexiste dans linterface utilisateur aucune fonctionnalit correspondante, et cette mthode doit tre utilise avec une bibliothque externe ou une DLL (voir Extensibilit de niveau C la page 534). Le fichier SWF que vous importez doit possder un clip de niveau suprieur dtenant la totalit du contenu. L'identificateur de liaison de ce clip doit tre dfini sur la mme valeur que le paramtre linkageName transmis cette mthode. Exemple L'exemple suivant ajoute la bibliothque le fichier SWF ayant la valeur MyMovie pour la proprit linkageName, sous forme dun clip compil nomm Intro :
fl.getDocumentDOM().library.importEmbeddedSWF("MyMovie", swfData, "Intro");

library.itemExists()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 329

Objet library

Utilisation
library.itemExists(namePath)

Paramtres namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Valeur renvoye Valeur boolenne : true si l'lment spcifi est prsent dans la bibliothque ; false dans le cas contraire. Description Mthode qui vrifie lexistence de llment spcifi dans la bibliothque. Exemple L'exemple suivant affiche true ou false dans une bote de dialogue, selon que llment Symbol_1 existe ou non dans le dossier Folder_1 de la bibliothque :
alert(fl.getDocumentDOM().library.itemExists('Folder_1/Symbol_1'));

library.items
Disponibilit Flash MX 2004. Utilisation
library.items

Description Proprit ; tableau des lments slectionns dans la bibliothque. Exemple L'exemple suivant enregistre dans la variable itemArray le tableau de tous les lments contenus dans la bibliothque :
var itemArray = fl.getDocumentDOM().library.items;

library.moveToFolder()
Disponibilit Flash MX 2004. Utilisation
library.moveToFolder(folderPath [, itemToMove [, bReplace]])

EXTENSION DE FLASH CS4 PROFESSIONAL 330

Objet library

Paramtres
folderPath Chane indiquant le chemin daccs du dossier sous la forme "nom_de_dossier" ou "nom_de_dossier1/nom_de_dossier2". Pour dplacer un lment vers le niveau suprieur, transmettez une chane

vide ("") pour le paramtre folderPath.

itemToMove Chane spcifiant le nom de llment dplacer. Si itemToMove nest pas spcifi, les lments

actuellement slectionns sont dplacs. Ce paramtre est facultatif.

bReplace Valeur boolenne. Sil existe dj un lment du mme nom, le fait de spcifier true pour le paramtre

bReplace remplace llment existant par llment dplac. Si la valeur de ce paramtre est false, le nom de llment dplac est modifi pour tre unique. La valeur par dfaut est false. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne : true si l'lment est bien dplac, false en cas d'chec. Description Mthode qui dplace llment slectionn ou un lment de bibliothque spcifi dans un dossier spcifi. Si le paramtre folderPath est vide, les lments sont dplacs vers le niveau suprieur. Exemple L'exemple suivant dplace llment Symbol_1 dans le dossier new en remplacement de llment qui porte dj ce nom dans ce dossier :
fl.getDocumentDOM().library.moveToFolder("new", "Symbol_1", true);

library.newFolder()
Disponibilit Flash MX 2004. Utilisation
library.newFolder([folderPath])

Paramtres
folderPath Chane spcifiant le nom du dossier crer. Si cette chane contient un chemin et que ce chemin nexiste

pas, il est alors cr. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne : true si le dossier est bien cr, false en cas d'chec. Description Mthode qui cre un nouveau dossier ayant le nom spcifi (ou le nom par dfaut "untitled folder #") si le paramtre folderName nest pas transmis) dans le dossier slectionn. Exemple L'exemple suivant cre deux nouveaux dossiers de bibliothque. Le deuxime est un sous-dossier du premier :
fl.getDocumentDOM().library.newFolder("first/second");

EXTENSION DE FLASH CS4 PROFESSIONAL 331

Objet library

library.renameItem()
Disponibilit Flash MX 2004. Utilisation
library.renameItem(name)

Paramtres name Chane spcifiant le nouveau nom de llment de bibliothque. Valeur renvoye Valeur boolenne : true si le nom de l'lment est bien modifi, false dans le cas contraire. Si plusieurs lments sont slectionns, aucun nom nest modifi et la valeur renvoye correspond false (comme dans linterface utilisateur). Description Mthode qui renomme llment de bibliothque slectionn dans le panneau Bibliothque. Exemple L'exemple suivant renomme avec le nom "new name" llment de bibliothque actuellement slectionn :
fl.getDocumentDOM().library.renameItem("new name");

library.selectAll()
Disponibilit Flash MX 2004. Utilisation
library.selectAll([bSelectAll])

Paramtres
bSelectAll Valeur boolenne qui indique si tous les lments de la bibliothque doivent tre slectionns ou

dslectionns. Pour slectionner tous les lments de la bibliothque, omettez ce paramtre ou utilisez la valeur par dfaut (true) ; la valeur false dslectionne tous les lments. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui slectionne ou dslectionne tous les lments de la bibliothque. Exemple Les exemples suivants slectionnent tous les lments de la bibliothque :
fl.getDocumentDOM().library.selectAll(); fl.getDocumentDOM().library.selectAll(true);

EXTENSION DE FLASH CS4 PROFESSIONAL 332

Objet library

Les exemples suivants dslectionnent tous les lments de la bibliothque :

fl.getDocumentDOM().library.selectAll(false); fl.getDocumentDOM().library.selectNone();

library.selectItem()
Disponibilit Flash MX 2004. Utilisation
library.selectItem(namePath [, bReplaceCurrentSelection [, bSelect]])

Paramtres namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique.
bReplaceCurrentSelection Valeur boolenne qui indique si le programme doit remplacer la slection actuelle ou ajouter llment cette slection. La valeur par dfaut est true (remplacer la slection actuelle). Ce paramtre est facultatif. bSelect Valeur boolenne qui indique si llment doit tre slectionn ou dslectionn. La valeur par dfaut est true (slectionner). Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne : true si l'lment spcifi existe, false dans le cas contraire. Description Mthode qui slectionne llment de bibliothque spcifi. Exemple L'exemple suivant modifie la slection actuelle dans la bibliothque en Symbol_1 au sein du dossier sans titre Folder_1 :
fl.getDocumentDOM().library.selectItem("untitled Folder_1/Symbol_1");

L'exemple suivant tend la slection actuelle dans la bibliothque pour inclure Symbol_1 au sein du dossier sans titre Folder_1 :
fl.getDocumentDOM().library.selectItem("untitled Folder_1/Symbol_1", false);

L'exemple suivant dslectionne Symbol_1 au sein du dossier sans titre Folder_1, sans changer les autres lments slectionns :
fl.getDocumentDOM().library.selectItem("untitled Folder_1/Symbol_1", true, false);

library.selectNone()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 333

Objet library

Utilisation
library.selectNone()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui dslectionne tous les lments de la bibliothque. Exemple Les exemples suivants dslectionnent tous les lments de la bibliothque :
fl.getDocumentDOM().library.selectNone(); fl.getDocumentDOM().library.selectAll(false);

library.setItemProperty()
Disponibilit Flash MX 2004. Utilisation
library.setItemProperty(property, value)

Paramtres property Chane indiquant le nom de la proprit dfinir. Pour obtenir la liste des proprits, consultez le Rsum des proprits de l'objet Objet Item et le rsum des proprits pour ses sous-classes. Pour savoir quels objets sont des sous-classes de l'objet Item, consultez Rsum de la structure du DOM la page 12.
value Valeur affecter la proprit spcifie.

Valeur renvoye Aucune. Description Mthode qui dfinit la proprit de tous les objets de bibliothque slectionns (en ignorant les dossiers). Exemple L'exemple suivant affecte la valeur "button" la proprit symbolType des lments de bibliothque slectionns. Dans ce cas, l'lment doit tre un objet Objet SymbolItem ; symbolType tant une proprit valide pour les objets SymbolItem.
fl.getDocumentDOM().library.setItemProperty("symbolType", "button");

EXTENSION DE FLASH CS4 PROFESSIONAL 334

Objet library

library.updateItem()
Disponibilit Flash MX 2004. Utilisation
library.updateItem([namePath])

Paramtres namePath Chane spcifiant le nom de llment. Si llment se trouve dans un dossier, il est possible dindiquer son nom et son chemin daccs en utilisant la notation avec barre oblique. Cette opration est identique un clic droit sur un lment, puis la slection de Mettre jour dans le menu de l'interface utilisateur. Si aucun nom nest indiqu, cest la slection actuelle qui est actualise. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne : true si Flash a bien mis l'lment jour, false dans le cas contraire. Description Mthode qui actualise llment de bibliothque spcifi. Exemple L'exemple suivant affiche une bote de dialogue qui montre si llment actuellement slectionn a t actualis (true) ou non (false) :
alert(fl.getDocumentDOM().library.updateItem());

335

Chapitre 27 : Objet Math

Disponibilit Flash MX 2004. Description L'objet Math est disponible sous forme de proprit en lecture seule de l'objet flash ; voir fl.Math. Cet objet comporte des mthodes qui prennent en charge les oprations mathmatiques courantes. Rsum des mthodes Les mthodes suivantes sont disponibles pour lobjet Math :
Mthode
Math.concatMatrix() Math.invertMatrix() Math.pointDistance()

Description Effectue une concatnation matricielle et renvoie le rsultat. Renvoie linverse de la matrice spcifie. Calcule la distance entre deux points.

Math.concatMatrix()
Disponibilit Flash MX 2004. Utilisation
Math.concatMatrix(mat1, mat2)

Paramtres
mat1, mat2 Spcifient les objets Matrix concatner (voir Objet Matrix). Chaque paramtre doit tre un objet avec les

champs a, b, c, d, tx et ty. Valeur renvoye Une matrice dobjets concatns. Description Mthode qui effectue une concatnation de matrices et renvoie le rsultat. Exemple L'exemple suivant enregistre dans la variable elt lobjet slectionn, multiplie le tableau des objets par le tableau daffichage et enregistre cette valeur dans la variable mat :
var elt = fl.getDocumentDOM().selection[0]; var mat = fl.Math.concatMatrix( elt.matrix , fl.getDocumentDOM().viewMatrix );

EXTENSION DE FLASH CS4 PROFESSIONAL 336

Objet Math

Math.invertMatrix()
Disponibilit Flash MX 2004. Utilisation
Math.invertMatrix(mat)

Paramtres mat Indique l'objet Matrix inverser (voir Objet Matrix). Les champs suivants doivent tre prsents : a, b, c, d, tx et ty. Valeur renvoye Un objet Matrix qui est linverse de la matrice originale. Description Mthode qui renvoie linverse de la matrice spcifie. Exemple L'exemple suivant enregistre dans la variable elt lobjet slectionn, assigne cette matrice la variable mat, puis enregistre son inverse dans la variable inv :
var elt = fl.getDocumentDOM().selection[0]; var mat = elt.matrix; var inv = fl.Math.invertMatrix( mat );

Math.pointDistance()
Disponibilit Flash MX 2004. Utilisation
Math.pointDistance(pt1, pt2)

Paramtres pt1, pt2 Spcifient les points entre lesquels la distance doit tre mesure. Valeur renvoye Une valeur en virgule flottante qui reprsente la distance entre les points. Description Mthode qui calcule la distance entre deux points.

EXTENSION DE FLASH CS4 PROFESSIONAL 337

Objet Math

Exemple L'exemple suivant stocke la distance entre pt1 et pt2 dans la variable dist :
var pt1 = {x:10, y:20} var pt2 = {x:100, y:200} var dist = fl.Math.pointDistance(pt1, pt2);

338

Chapitre 28 : Objet Matrix

Disponibilit Flash MX 2004. Description Lobjet Matrix reprsente une matrice de transformation. Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Matrix :
Proprit
matrix.a matrix.b matrix.c matrix.d matrix.tx

Description Nombre en virgule flottante spcifiant llment (0,0) de la matrice de transformation. Nombre en virgule flottante spcifiant llment (0,1) de la matrice. Nombre en virgule flottante spcifiant llment (1,0) de la matrice. Nombre en virgule flottante spcifiant llment (1,1) de la matrice. Nombre en virgule flottante spcifiant lemplacement de laxe x du point d'alignement dun symbole ou du centre dune forme. Nombre en virgule flottante spcifiant lemplacement de laxe y du point d'alignement dun symbole ou du centre dune forme.

matrix.ty

matrix.a
Disponibilit Flash MX 2004. Utilisation
matrix.a

Description Proprit ; nombre en virgule flottante spcifiant llment (0,0) de la matrice de transformation. Cette valeur reprsente le facteur de redimensionnement de laxe x de lobjet. Exemple Les proprits a et d dune matrice reprsentent son redimensionnement. Dans lexemple suivant, les valeurs sont respectivement dfinies sur 2 et 3, afin de doubler la largeur de lobjet slectionn et de tripler sa hauteur :
var mat = fl.getDocumentDOM().selection[0].matrix; mat.a = 2; mat.d = 3; fl.getDocumentDOM().selection[0].matrix = mat;

Il est possible de faire pivoter un objet en dfinissant les proprits de matrice a, b, c et d l'une par rapport l'autre, aveca = d et b = -c. Par exemple, des valeurs de 0,5, 0,8, -0,8 et 0,5 feront pivoter lobjet de 60 :

EXTENSION DE FLASH CS4 PROFESSIONAL 339

Objet Matrix

var mat = fl.getDocumentDOM().selection[0].matrix; mat.a = 0.5; mat.b = 0.8; mat.c = 0.8*(-1); mat.d = 0.5; fl.getDocumentDOM().selection[0].matrix = mat;

Les valeurs a = d = 1 et c = b = 0 restaureront la forme originale de lobjet.

matrix.b
Disponibilit Flash MX 2004. Utilisation
matrix.b

Description Proprit ; nombre en virgule flottante spcifiant llment (0,1) de la matrice. Cette valeur reprsente linclinaison verticale dune forme ; elle provoque le dplacement du ct droit de la forme le long de laxe vertical. Les proprits matrix.b et matrix.c dune matrice reprsentent son inclinaison (voir matrix.c). Exemple Dans l'exemple suivant, vous pouvez donner b et c les valeurs -1 et 0, respectivement. Ces valeurs inclinent lobjet d'un angle vertical de 45 :
var mat = fl.getDocumentDOM().selection[0].matrix; mat.b = -1; mat.c = 0; fl.getDocumentDOM().selection[0].matrix = mat;

Pour restaurer la forme originale de lobjet, donnez b et c la valeur 0. Voir aussi lexemple matrix.a.

matrix.c
Disponibilit Flash MX 2004. Utilisation
matrix.c

Description Proprit ; nombre en virgule flottante spcifiant llment (1,0) de la matrice. Cette valeur provoque une inclinaison de lobjet en dplaant son bord infrieur le long dun axe horizontal. Les proprits matrix.b et matrix.c dune matrice reprsentent son inclinaison.

EXTENSION DE FLASH CS4 PROFESSIONAL 340

Objet Matrix

Exemple Voir l'exemple de matrix.b.

matrix.d
Disponibilit Flash MX 2004. Utilisation
matrix.d

Description Proprit ; nombre en virgule flottante spcifiant llment (1,1) de la matrice. Cette valeur reprsente le facteur de redimensionnement de laxe y de lobjet. Exemple Voir aussi lexemple de matrix.a.

matrix.tx
Disponibilit Flash MX 2004. Utilisation
matrix.tx

Description Proprit ; nombre en virgule flottante spcifiant lemplacement de laxe x du point d'alignement (galement point d'origine ou point zro) dun symbole ou du centre dune forme. Elle dfinit la translation de la transformation sur laxe x. Vous pouvez dplacer un objet en dfinissant les proprits matrix.tx et matrix.ty (voir matrix.ty). Exemple Dans l'exemple suivant, les paramtres tx et ty reoivent la valeur 0 pour amener le point d'alignement de lobjet au point 0,0 du document :
var mat = fl.getDocumentDOM().selection[0].matrix; mat.tx = 0; mat.ty = 0; fl.getDocumentDOM().selection[0].matrix = mat;

EXTENSION DE FLASH CS4 PROFESSIONAL 341

Objet Matrix

matrix.ty
Disponibilit Flash MX 2004. Utilisation
matrix.ty

Description Proprit ; nombre en virgule flottante spcifiant lemplacement de laxe y du point d'alignement dun symbole ou du centre dune forme. Elle dfinit la translation de la transformation sur laxe y. Vous pouvez dplacer un objet en dfinissant ses proprits matrix.tx et matrix.ty. Exemple Voir lexemple de matrix.tx.

342

Chapitre 29 : Objet outputPanel

Disponibilit Flash MX 2004. Description Lobjet outputPanel reprsente le panneau Sortie, qui affiche des informations facilitant le dbogage, par exemple les erreurs de syntaxe. Vous accdez cet objet via fl.outputPanel (ou flash.outputPanel). Voir fl.outputPanel. Rsum des mthodes Lobjet outputPanel utilise les mthodes suivantes :
Mthode
outputPanel.clear() outputPanel.save() outputPanel.trace()

Description Efface le contenu du panneau Sortie. Enregistre le contenu du panneau Sortie dans un fichier texte local. Ajoute une ligne au contenu du panneau Sortie, termin par un code de nouvelle ligne.

outputPanel.clear()
Disponibilit Flash MX 2004. Utilisation
outputPanel.clear()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui efface le contenu du panneau Sortie. Vous pouvez utiliser cette mthode dans une application de traitement par lots pour effacer une liste derreurs, ou pour les enregistrer de faon incrmentielle en utilisant cette mthode avec outputPanel.save(). Exemple L'exemple suivant efface le contenu actuel du panneau Sortie :
fl.outputPanel.clear();

EXTENSION DE FLASH CS4 PROFESSIONAL 343

Objet outputPanel

outputPanel.save()
Disponibilit Flash MX 2004 ; paramtre bUseSystemEncoding ajout Flash 8. Utilisation
outputPanel.save(fileURI [, bAppendToFile [ , bUseSystemEncoding]])

Paramtres fileURI Chane de type fichier:///URI qui spcifie le nom du fichier local qui doit recevoir le contenu du panneau Sortie.
bAppendToFile Valeur boolenne facultative. Si elle est dfinie sur true, le contenu du panneau Sortie est ajout la fin du fichier de sortie. Si elle est dfinie sur false, la mthode crase le fichier de sortie, s'il existe dj. La valeur par dfaut est false. bUseSystemEncoding Valeur boolenne facultative. Si elle est dfinie sur true, la mthode enregistre le texte du panneau Sortie en utilisant le codage systme. Si la valeur est false, le texte du panneau Sortie est enregistr en codage UTF-8, avec des caractres d'ordre d'octet au dbut du texte. La valeur par dfaut est false.

Valeur renvoye Aucune. Description Mthode qui enregistre le contenu du panneau Sortie dans un fichier texte local, soit en remplaant le fichier, soit en ajoutant les informations la fin du fichier existant. Si fileURI nest pas spcifi ou nest pas valide, une erreur est renvoye. Cette mthode s'avre pratique pour le traitement par lots. Vous pouvez par exemple crer un fichier JSFL regroupant plusieurs composants compils. Comme toute ventuelle erreur de compilation sera affiche dans le panneau Sortie, vous pouvez utiliser cette mthode pour enregistrer les erreurs dans un fichier texte, qui sera automatiquement analys par le systme de compilation utilis. Exemple L'exemple suivant enregistre le contenu du panneau Sortie dans le fichier batch.log, qui rside dans le dossier /tests, et crase son contenu le cas chant :
fl.outputPanel.save("file:///c|/tests/batch.log");

outputPanel.trace()
Disponibilit Flash MX 2004. Utilisation
outputPanel.trace(message)

EXTENSION DE FLASH CS4 PROFESSIONAL 344

Objet outputPanel

Paramtres message Chane qui contient le texte ajouter au panneau Sortie. Valeur renvoye Aucune. Description Mthode qui envoie une chane de texte au panneau Sortie, suivie d'un code de nouvelle ligne, et affiche le panneau Sortie s'il n'est pas dj visible. Cette mthode est identique fl.trace() et fonctionne de la mme manire que l'instruction trace() dans ActionScript. Pour envoyer une ligne vide, utilisez outputPanel.trace("") ou outputPanel.trace("\n"). Vous pouvez utiliser cette dernire commande en ligne si vous intgrez \n la chane message. Exemple L'exemple suivant affiche plusieurs lignes de texte dans le panneau Sortie :
fl.outputPanel.clear(); fl.outputPanel.trace("Hello World!!!"); var myPet = "cat"; fl.outputPanel.trace("\nI have a " + myPet); fl.outputPanel.trace(""); fl.outputPanel.trace("I love my " + myPet); fl.outputPanel.trace("Do you have a " + myPet +"?");

345

Chapitre 30 : Objet Oval

Hritage

Objet Element > Objet Shape > Objet Oval

Disponibilit Flash CS3 Professional. Description L'objet Oval est une forme trace l'aide de l'outil Ovale primitif. Pour savoir si un lment est un objet Oval, utilisez shape.isOvalObject. Rsum des proprits Outre les proprits de lobjet Objet Shape, l'objet Oval gre les proprits suivantes. Pour dfinir les proprits d'un objet Oval, utilisez document.setOvalObjectProperty() :
Proprit
OvalObject.closePath

Description Lecture seule ; valeur boolenne spcifiant si la case cocher Fermer le trac, qui se trouve dans l'inspecteur Proprits, est slectionne ou non. Lecture seule ; valeur en virgule flottante qui indique l'angle de fin de l'objet Oval. Lecture seule ; valeur en virgule flottante qui prcise, en pourcentage, le rayon interne de l'objet Oval. Lecture seule ; valeur en virgule flottante qui indique l'angle de dbut de l'objet Oval.

OvalObject.endAngle OvalObject.innerRadius

OvalObject.startAngle

OvalObject.closePath
Disponibilit Flash CS3 Professional. Utilisation
OvalObject.closePath

Description Proprit en lecture seule ; valeur boolenne spcifiant si la case cocher Fermer le trac, qui se trouve dans l'inspecteur Proprits, est slectionne ou non. Si les valeurs de l'angle de dbut et de fin sont identiques pour l'objet, la dfinition de cette proprit n'a aucune incidence tant que ces valeurs demeurent inchanges. Pour dfinir cette valeur, utilisez document.setOvalObjectProperty(). Exemple L'exemple suivant dslectionne la proprit OvalObject.closePath :
fl.getDocumentDOM().setOvalObjectProperty("closePath",false);

EXTENSION DE FLASH CS4 PROFESSIONAL 346

Objet Oval

Voir aussi
document.setOvalObjectProperty(), shape.isOvalObject

OvalObject.endAngle
Disponibilit Flash CS3 Professional. Utilisation
OvalObject.endAngle

Description Proprit en lecture seule ; valeur en virgule flottante qui indique l'angle de fin de l'objet Oval. Les valeurs acceptes sont comprises entre 0 et 360. Pour dfinir cette valeur, utilisez document.setOvalObjectProperty(). Exemple L'exemple suivant dfinit sur 270 l'angle de fin des objets Oval slectionns :
fl.getDocumentDOM().setOvalObjectProperty("endAngle",270);

Voir aussi
document.setOvalObjectProperty(), OvalObject.startAngle, shape.isOvalObject

OvalObject.innerRadius
Disponibilit Flash CS3 Professional. Utilisation
OvalObject.innerRadius

Description Proprits en lecture seule ; valeur en virgule flottante qui prcise, en pourcentage, le rayon interne de l'objet Oval. Les valeurs acceptes sont comprises entre 0 et 99. Pour dfinir cette valeur, utilisez document.setOvalObjectProperty(). Exemple L'exemple suivant dfinit sur 50% le rayon interne des objets Oval slectionns :
fl.getDocumentDOM().setOvalObjectProperty("innerRadius",50);

Voir aussi
document.setOvalObjectProperty(), shape.isOvalObject

EXTENSION DE FLASH CS4 PROFESSIONAL 347

Objet Oval

OvalObject.startAngle
Disponibilit Flash CS3 Professional. Utilisation
OvalObject.startAngle

Description Proprit en lecture seule ; valeur en virgule flottante qui indique l'angle de dbut de l'objet Oval. Les valeurs acceptes sont comprises entre 0 et 360. Pour dfinir cette valeur, utilisez document.setOvalObjectProperty(). Exemple L'exemple suivant dfinit sur 270 l'angle de dbut des objets Oval slectionns :
fl.getDocumentDOM().setOvalObjectProperty("startAngle",270);

Voir aussi
document.setOvalObjectProperty(), OvalObject.endAngle, shape.isOvalObject

348

Chapitre 31 : Objet Parameter

Disponibilit Flash MX 2004. Description Le type dobjet Parameter figure dans le tableau screen.parameters (qui correspond la fentre de linspecteur Proprits dans lenvironnement de programmation Flash) ou le tableau componentInstance.parameters (qui correspond au composant inspecteur Proprits dans lenvironnement de programmation). Rsum des mthodes Les mthodes suivantes sont disponibles pour lobjet Parameter :
Mthode
parameter.insertItem() parameter.removeItem()

Description Insre un lment dans une liste, un objet ou un tableau. Supprime un lment de type liste, objet ou tableau du paramtre dun cran ou dun composant.

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Parameter :
Proprit
parameter.category parameter.listIndex parameter.name parameter.value

Description Chane indiquant la proprit category du paramtre screen ou componentInstance. Entier spcifiant la valeur de llment de liste slectionn. Lecture seule ; chane indiquant le nom du paramtre. Correspond au champ Valeur de longlet Paramtres du panneau Inspecteur des composants, de l'onglet Paramtres de l'inspecteur Proprits ou de la fentre inspecteur Proprits. Lecture seule ; chane indiquant le type de paramtre dcran ou de composant. Dtermine o le paramtre est affich.

parameter.valueType parameter.verbose

parameter.category
Disponibilit Flash MX 2004. Utilisation
parameter.category

Description Proprit ; chane indiquant la proprit category du paramtre screen ou componentInstance. Cette proprit reprsente une autre manire de prsenter une liste de paramtres. Cette fonctionnalit nest pas disponible dans linterface utilisateur de Flash.

EXTENSION DE FLASH CS4 PROFESSIONAL 349

Objet Parameter

parameter.insertItem()
Disponibilit Flash MX 2004. Utilisation
parameter.insertItem(index, name, value, type)

Paramtres index Index (en base zro) sur un entier, qui indique si llment sera insr dans la liste, lobjet ou le tableau. Si lindex est 0, llment est insr au dbut de la liste. Si lindex est suprieur la taille de la liste, llment est insr la fin du tableau.
name value type

Chane spcifiant le nom de llment insrer. Ce paramtre est obligatoire pour les paramtres dobjet. Chane spcifiant la valeur de llment insrer. Chane spcifiant le type de llment insrer.

Valeur renvoye Aucune. Description Mthode qui insre un lment dans une liste, un objet ou un tableau. Si lun des paramtres est une liste, un objet ou un tableau, la proprit value est un tableau. Exemple L'exemple suivant insre la valeur de New Value dans le paramtre labelPlacement :
// Select an instance of a Button component on the Stage. var parms = fl.getDocumentDOM().selection[0].parameters; parms[2].insertItem(0, "name", "New Value", "String"); var values = parms[2].value; for(var prop in values){ fl.trace("labelPlacement parameter value = " + values[prop].value); }

parameter.listIndex
Disponibilit Flash MX 2004. Utilisation
parameter.listIndex

Description Proprit ; valeur de llment de liste slectionn. Cette proprit nest valide que si parameter.valueType est "List".

EXTENSION DE FLASH CS4 PROFESSIONAL 350

Objet Parameter

Exemple L'exemple suivant dfinit le premier paramtre dun objet diapositive, cest--dire le paramtre autoKeyNav. Pour dfinir le paramtre sur lune de ses valeurs gres (true, false ou inherit) parameter.listIndex reoit la valeur de lindex de llment dans la liste (0 pour true, 1 pour false, 2 pour inherit).
var parms = fl.getDocumentDOM().screenOutline.screens[1].parameters; parms[0].listIndex = 1;

parameter.name
Disponibilit Flash MX 2004. Utilisation
parameter.name

Description Proprit en lecture seule ; chane indiquant le nom du paramtre. Exemple L'exemple suivant affiche le nom du cinquime paramtre du composant slectionn :
var parms = fl.getDocumentDOM().selection[0].parameters; fl.trace("name: " + parms[4].name);

L'exemple suivant affiche le nom du cinquime paramtre de lcran spcifi :

var parms = fl.getDocumentDOM().screenOutline.screens[1].parameters; fl.trace("name: " + parms[4].name);

parameter.removeItem()
Disponibilit Flash MX 2004. Utilisation
parameter.removeItem(index)

Paramtres index Index sous forme de nombre entier (en base zro) de llment supprimer de la proprit dcran ou de composant. Valeur renvoye Aucune. Description Mthode qui supprime un lment du type liste, objet ou tableau du paramtre dun cran ou dun composant.

EXTENSION DE FLASH CS4 PROFESSIONAL 351

Objet Parameter

Exemple L'exemple suivant supprime llment lindex1 depuis le paramtre labelPlacement dun composant :
// Select an instance of a Button component on the Stage. var parms = fl.getDocumentDOM().selection[0].parameters; var values = parms[2].value; fl.trace("--Original--"); for(var prop in values){ fl.trace("labelPlacement value = " + values[prop].value); } parms[2].removeItem(1); var newValues = parms[2].value; fl.trace("--After Removing Item--"); for(var prop in newValues){ fl.trace("labelPlacement value = " + newValues[prop].value); }

L'exemple suivant supprime llment lindex1 du paramtre autoKeyNav dun cran :

// Open a presentation document. var parms = fl.getDocumentDOM().screenOutline.screens[1].parameters; var values = parms[0].value; fl.trace("--Original--"); for(var prop in values){ fl.trace("autoKeyNav value = " + values[prop].value); } parms[0].removeItem(1); var newValues = parms[0].value; fl.trace("--After Removing Item--"); for(var prop in newValues){ fl.trace("autoKeyNav value = " + newValues[prop].value); }

parameter.value
Disponibilit Flash MX 2004. Utilisation
parameter.value

Description Proprit qui correspond au champ Valeur de longlet Paramtres du panneau Inspecteur des composants, de l'onglet Paramtres de l'inspecteur Proprits ou de la fentre inspecteur Proprits. Le type de la proprit value est dtermin par la proprit valueType du paramtre (voir parameter.valueType).

EXTENSION DE FLASH CS4 PROFESSIONAL 352

Objet Parameter

parameter.valueType
Disponibilit Flash MX 2004. Utilisation
parameter.valueType

Description Proprit en lecture seule ; chane indiquant le type de paramtre dcran ou de composant. Le type peut prendre l'une des valeurs suivantes : "Default", "Array", "Object", "List", "String", "Number", "Boolean", "Font Name", "Color", "Collection", "Web Service URL" ou "Web Service Operation". Voir aussi
parameter.value

parameter.verbose
Disponibilit Flash MX 2004. Utilisation
parameter.verbose

Description Proprit ; dtermine o le paramtre est affich. Si la valeur de cette proprit est 0 (non dtaille), le paramtre est uniquement affich dans l'inspecteur des composants. Si elle est dfinie sur 1 (dtaille), le paramtre est affich dans l'inspecteur des composants et dans l'onglet Paramtres de l'inspecteur Proprits.

353

Chapitre 32 : Objet Path

Disponibilit Flash MX 2004. Description Lobjet Path dfinit une squence de segments de ligne (droite, courbe ou les deux), qui est particulirement destine la cration doutils extensibles. L'exemple suivant montre le renvoi dune occurrence dun objet Path par lobjet flash :
path = fl.drawingLayer.newPath();

Voir aussi l'Objet drawingLayer. Rsum des mthodes Les mthodes suivantes sont disponibles pour lobjet Path :
Mthode
path.addCubicCurve() path.addCurve() path.addPoint() path.clear() path.close()

Description Ajoute un segment de courbe de Bzier cubique au trac. Ajoute un segment de courbe de Bzier quadratique au trac. Ajoute un point au trac. Supprime tous les points du trac. Ajoute un point lemplacement du premier point du trac, puis tend le trac jusqu ce point, ce qui ferme le trac. Cre une forme sur la scne en utilisant les paramtres de trait et de remplissage actuels. Ajoute un nouveau contour au trac.

path.makeShape() path.newContour()

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Path :
Proprit
path.nPts

Description Lecture seule ; entier reprsentant le nombre de points du trac.

path.addCubicCurve()
Disponibilit Flash MX 2004. Utilisation
path.addCubicCurve(xAnchor, yAnchor, x2, y2, x3, y3, x4, y4)

Paramtres xAnchor Valeur en virgule flottante indiquant la coordonne x du premier point de contrle.

EXTENSION DE FLASH CS4 PROFESSIONAL 354

Objet Path

yAnchor Valeur en virgule flottante indiquant la coordonne y du premier point de contrle. x2 Valeur en virgule flottante indiquant la coordonne x du second point de contrle. y2 Valeur en virgule flottante indiquant la coordonne y du second point de contrle. x3 Valeur en virgule flottante indiquant la coordonne x du troisime point de contrle. y3 Valeur en virgule flottante indiquant la coordonne y du troisime point de contrle. x4 Valeur en virgule flottante indiquant la coordonne x du quatrime point de contrle. y4 Valeur en virgule flottante indiquant la coordonne y du quatrime point de contrle.

Valeur renvoye Aucune. Description Mthode qui ajoute un segment de courbe de Bzier cubique au trac. Exemple L'exemple suivant cre un nouveau trac, el stocke dans la variable myPath, puis lui affecte la courbe :
var myPath = fl.drawingLayer.newPath(); myPath.addCubicCurve(0, 0, 10, 20, 20, 20, 30, 0);

path.addCurve()
Disponibilit Flash MX 2004. Utilisation
path.addCurve(xAnchor, yAnchor, x2, y2, x3, y3)

Paramtres xAnchor Valeur en virgule flottante indiquant la coordonne x du premier point de contrle.
yAnchor Valeur en virgule flottante indiquant la coordonne y du premier point de contrle. x2 Valeur en virgule flottante indiquant la coordonne x du second point de contrle. y2 Valeur en virgule flottante indiquant la coordonne y du second point de contrle. x3 Valeur en virgule flottante indiquant la coordonne x du troisime point de contrle. y3 Valeur en virgule flottante indiquant la coordonne y du troisime point de contrle.

Valeur renvoye Aucune. Description Mthode qui ajoute un segment de courbe de Bzier quadratique au trac.

EXTENSION DE FLASH CS4 PROFESSIONAL 355

Objet Path

Exemple L'exemple suivant cre un nouveau trac, lenregistre dans la variable myPath, puis affecte la courbe au trac :
var myPath = fl.drawingLayer.newPath(); myPath.addCurve(0, 0, 10, 20, 20, 0);

path.addPoint()
Disponibilit Flash MX 2004. Utilisation
path.addPoint(x, y)

Paramtres x Nombre en virgule flottante indiquant la coordonne x du point.

y Nombre en virgule flottante indiquant la coordonne y du point.

Valeur renvoye Aucune. Description Mthode qui ajoute un point au trac. Exemple L'exemple suivant cre un nouveau trac, le stocke dans la variable myPath, puis lui affecte le nouveau point :
var myPath = fl.drawingLayer.newPath(); myPath.addPoint(10, 100);

path.clear()
Disponibilit Flash MX 2004. Utilisation
path.clear()

Paramtres Aucun. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 356

Objet Path

Description Mthode qui supprime tous les points du trac. Exemple L'exemple suivant supprime tous les points dun trac stock dans la variable myPath :
var myPath = fl.drawingLayer.newPath(); myPath.clear();

path.close()
Disponibilit Flash MX 2004. Utilisation
path.close()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui ajoute un point au niveau du premier point du trac, puis tend le trac jusqu ce point, ce qui ferme le trac. Si le trac ne comporte pas de points, aucun point nest ajout. Exemple L'exemple suivant cre un trac ferm :
var myPath = fl.drawingLayer.newPath(); myPath.close();

path.makeShape()
Disponibilit Flash MX 2004. Utilisation
path.makeShape([bSupressFill [, bSupressStroke]])

Paramtres
bSuppressFill Valeur boolenne. Si elle est true, la mthode supprime le remplissage qui devrait tre appliqu la

forme. La valeur par dfaut est false. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 357

Objet Path

bSupressStroke Valeur boolenne. Si elle est true, la mthode supprime le trait qui devrait tre appliqu la forme. La valeur par dfaut est false. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui cre une forme sur la scne en utilisant les paramtres de trait et de remplissage actuels. Le trac est effac aprs la cration de la forme. Cette mthode comporte deux paramtres facultatifs permettant de supprimer le remplissage et le trait de lobjet forme ainsi obtenu. Si ces paramtres sont omis ou reoivent la valeur false, les valeurs actuelles de remplissage et de trait sont utilises. Exemple L'exemple suivant cre une forme dote du remplissage actuel, mais sans trait :
var myPath = fl.drawingLayer.newPath(); myPath.makeShape(false, true);

path.newContour()
Disponibilit Flash MX 2004. Utilisation
path.newContour()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui ajoute un nouveau contour au trac. Exemple L'exemple suivant cre un carr vide :

EXTENSION DE FLASH CS4 PROFESSIONAL 358

Objet Path

var myPath = fl.drawingLayer.newPath(); myPath.addPoint(0, 0); myPath.addPoint(0, 30); myPath.addPoint(30, 30); myPath.addPoint(30, 0); myPath.addPoint(0, 0); myPath.newContour(); myPath.addPoint(10, 10); myPath.addPoint(10, 20); myPath.addPoint(20, 20); myPath.addPoint(20, 10); myPath.addPoint(10, 10); myPath.makeShape();

path.nPts
Disponibilit Flash MX 2004. Utilisation
path.nPts

Description Proprit en lecture seule ; entier reprsentant le nombre de points du trac. Un nouveau trac possde 0 point. Exemple L'exemple suivant affiche dans le panneau Sortie le nombre de points du trac rfrenc par la variable myPath :
var myPath = fl.drawingLayer.newPath(); var numOfPoints = myPath.nPts; fl.trace("Number of points in the path: " + numOfPoints); // Displays: Number of points in the path: 0

359

Chapitre 33 : Objet presetItem

Disponibilit Flash CS4 Professional. Description L'objet presetItem reprsente un lment (prslection ou dossier) du panneau Prslections de mouvement (Fentre > Prslections de mouvement). Le tableau d'objets presetItem est une proprit de l'objet presetPanel (presetPanel.items). Toutes les proprits de l'objet presetItem sont en lecture seule. Pour excuter des tches telles que supprimer, renommer ou dplacer des lments, utilisez les mthodes de l'Objet presetPanel. Rsum des proprits L'objet presetItem gre les proprits suivantes :
Proprit presetItem.isDefault Description Spcifie si l'lment est install avec Flash ou s'il s'agit d'un lment personnalis que vous (ou quelqu'un d'autre) avez cr. Spcifie si l'lment du panneau Prslections de mouvement est un dossier ou une prslection. Niveau de l'lment dans la structure de dossiers du panneau Prslections de mouvement. Nom de la prslection ou du dossier, sans information sur le chemin d'accs. Spcifie si un dossier du panneau Prslections de mouvement est actuellement dvelopp. Chemin de l'lment dans l'arborescence de dossiers du panneau Prslections de mouvement et nom de l'lment.

presetItem.isFolder

presetItem.level

presetItem.name presetItem.open

presetItem.path

presetItem.isDefault
Disponibilit Flash CS4 Professional. Utilisation
presetItem.isDefault

Description Proprit en lecture seule ; valeur boolenne spcifiant si l'lment est install avec Flash (true) ou s'il s'agit d'un lment personnalis que vous (ou quelqu'un d'autre) avez cr (false). Si cette valeur est true, vous pouvez le considrer comme un lment en lecture seule ; il ne peut pas tre dplac, supprim ni faire l'objet d'une opration similaire.

EXTENSION DE FLASH CS4 PROFESSIONAL 360

Objet presetItem

Exemple L'exemple suivant affiche le contenu du panneau Prslections de mouvement et indique si un lment est install avec Flash :
fl.outputPanel.clear(); var presetItemArray=fl.presetPanel.items; for (i=0;i<presetItemArray.length; i++){ var presetItem = presetItemArray[i]; fl.trace(presetItem.name +", default =" + presetItem.isDefault); }

presetItem.isFolder
Disponibilit Flash CS4 Professional. Utilisation
presetItem.isFolder

Description Proprit en lecture seule ; valeur boolenne spcifiant si l'lment du panneau Prslections de mouvement est un dossier (true) ou une prslection (false). Exemple L'exemple suivant indique que le premier lment du panneau Prslections de mouvement est un dossier et le second une prslection :
var presetItemArray=fl.presetPanel.items; fl.trace(presetItemArray[0].isFolder); fl.trace(presetItemArray[1].isFolder);

presetItem.level
Disponibilit Flash CS4 Professional. Utilisation
presetItem.level

Description Proprit en lecture seule ; nombre entier spcifiant le niveau de l'lment dans la structure de dossiers du panneau Prslections de mouvement. Les dossiers Prslections par dfaut et Prslections personnalises sont de niveau 0. Exemple L'exemple suivant indique que le premier lment du panneau Prslections de mouvement est de niveau 0 et le second de niveau 1 :

EXTENSION DE FLASH CS4 PROFESSIONAL 361

Objet presetItem

var presetItemArray=fl.presetPanel.items; fl.trace(presetItemArray[0].level); fl.trace(presetItemArray[1].level);

presetItem.name
Disponibilit Flash CS4 Professional. Utilisation
presetItem.name

Description Proprit en lecture seule ; chane reprsentant le nom de la prslection ou du dossier, sans information sur le chemin. Exemple Voir presetItem.path.

presetItem.open
Disponibilit Flash CS4 Professional. Utilisation
presetItem.open

Description Proprit en lecture seule ; prcise si un dossier du panneau Prslections de mouvement est dvelopp (true) ou non (false). Cette proprit est true si l'lment n'est pas un dossier. Pour dterminer si un lment est un dossier ou une prslection, utilisez presetItem.isFolder. Exemple L'exemple suivant indique si les dossiers du panneau Prslections de mouvement sont dvelopps ou rduits :
fl.outputPanel.clear(); var presetItemArray=fl.presetPanel.items; for (i=0;i<presetItemArray.length; i++){ var presetItem = presetItemArray[i]; if (presetItem.isFolder) { var status = presetItem.open ? "Open" : "Closed" fl.trace(presetItem.level + "-" + presetItem.name +" folder is " + status); } }

EXTENSION DE FLASH CS4 PROFESSIONAL 362

Objet presetItem

presetItem.path
Disponibilit Flash CS4 Professional. Utilisation
presetItem.path

Description Proprit en lecture seule ; chane reprsentant le chemin de l'lment dans l'arborescence de dossiers du panneau Prslections de mouvement et le nom de l'lment. Exemple L'exemple suivant illustre la diffrence entre les valeurs de presetItem.name et de presetItem.path.
fl.outputPanel.clear(); var presetItemArray=fl.presetPanel.items; for (i=0;i<presetItemArray.length; i++){ var presetItem = presetItemArray[i]; fl.trace("Name: " + presetItem.name + "\n" + "Path: " + presetItem.path); fl.trace(""); }

363

Chapitre 34 : Objet presetPanel

Disponibilit Flash CS4 Professional. Description L'objet presetPanel reprsente le panneau Prslections de mouvement (Fentre > Prslections de mouvement). Il s'agit d'une proprit de l'objet flash (fl.presetPanel). Rsum des mthodes L'objet presetPanel gre les mthodes suivantes :
Mthode
presetPanel.addNewItem()

Description Si une seule interpolation de mouvement est actuellement slectionne sur la scne, ajoute ce mouvement dans le panneau Prslections de mouvement. Applique la prslection spcifie ou slectionne l'lment actuellement slectionn sur la scne. Supprime le dossier spcifi et tous ses sous-dossiers de l'arborescence de dossiers du panneau Prslections de mouvement. Supprime la prslection spcifie du panneau Prslections de mouvement. Dveloppe ou rduit le ou les dossiers actuellement slectionns dans le panneau Prslections de mouvement. Exporte la prslection spcifie ou actuellement slectionne dans un fichier XML. Renvoie un nombre entier reprsentant l'emplacement d'index d'un lment dans le panneau Prslections de mouvement. Renvoie un tableau d'objets presetItem correspondant aux lments actuellement slectionns dans le panneau Prslections de mouvement. Ajoute une prslection dans le panneau Prslections de mouvement partir d'un fichier XML spcifi. Dplace l'lment spcifi vers le dossier spcifi. Cre un dossier dans l'arborescence de dossiers du panneau Prslections de mouvement. Remplace le nom de la prslection ou du dossier slectionn(e) par un nom spcifi. Slectionne ou dslectionne un lment dans le panneau Prslections de mouvement.

presetPanel.applyPreset()

presetPanel.deleteFolder()

presetPanel.deleteItem() presetPanel.expandFolder()

presetPanel.exportItem()

presetPanel.findItemIndex()

presetPanel.getSelectedItems()

presetPanel.importItem()

presetPanel.moveToFolder() presetPanel.newFolder()

presetPanel.renameItem()

presetPanel.selectItem()

Rsum des proprits L'objet presetPanel gre la proprit suivante :

Proprit
presetPanel.items

Description Tableau des objets presetItem prsents dans le panneau Prslections de mouvement.

EXTENSION DE FLASH CS4 PROFESSIONAL 364

Objet presetPanel

presetPanel.addNewItem()
Disponibilit Flash CS4 Professional. Utilisation
fl. presetPanel.addNewItem( [namePath] );

Paramtres namePath Chane qui spcifie le nom et le chemin de l'lment ajouter au panneau Prslections de mouvement. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne, true si l'lment a bien t ajout, false dans le cas contraire. Description Mthode qui, si une seule interpolation de mouvement est actuellement slectionne sur la scne, ajoute ce mouvement dans le panneau Prslections de mouvement, dans le dossier spcifi avec le nom spcifi. Le chemin spcifi dans namePath doit exister dans le panneau. S'il existe une prslection correspondant namePath, cette mthode n'a aucun effet et renvoie false. Si vous ne transmettez pas de valeur pour namePath, l'lment est ajout au dossier Prslections personnalises avec le nom Prslection personnalise n , o n est incrment chaque ajout d'un lment de cette manire. Exemple En supposant qu'une seule interpolation de mouvement soit slectionne sur la scne, le code suivant ajoute une prslection nomme Bouncing Ball dans le dossier Prslections personnalises :
fl.presetPanel.addNewItem("Custom Presets/Bouncing Ball");

Voir aussi presetPanel.newFolder()

presetPanel.applyPreset()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.applyPreset( [presetPath] )

Paramtres
presetPath Chane qui spcifie le chemin complet et le nom de la prslection appliquer, telle qu'il apparat dans

le panneau Prslections de mouvement. Ce paramtre est facultatif ; si vous ne transmettez pas de valeur, la prslection actuellement slectionne est applique.

EXTENSION DE FLASH CS4 PROFESSIONAL 365

Objet presetPanel

Valeur renvoye Valeur boolenne, true si la prslection a bien t applique, false dans le cas contraire. Description Mthode qui applique la prslection spcifie ou actuellement slectionne l'lment slectionn sur la scne. L'lment doit tre une interpolation de mouvement, un symbole ou un lment pouvant tre converti en symbole. Si l'lment est une interpolation de mouvement, son mouvement actuel est remplac par la prslection slectionne sans demander la confirmation de l'utilisateur. Cette mthode choue dans les cas suivants :

Le chemin spcifi en tant que presetPath n'existe pas. Vous ne transmettez pas de valeur pour presetPath et aucune prslection n'est slectionne. Vous ne transmettez pas de valeur pour presetPath et plusieurs prslections sont slectionnes. L'lment slectionn sur la scne n'est pas un symbole et ne peut pas tre converti en symbole.
Exemple L'exemple suivant applique la prslection aDribble l'lment actuellement slectionn sur la scne :
var result = fl.presetPanel.applyPreset("Custom Presets/Bounces/aDribble"); fl.trace(result);

presetPanel.deleteFolder()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.deleteFolder( [folderPath])

Paramtres
folderPath Chane qui spcifie le dossier supprimer dans le panneau Prslections de mouvement. Ce paramtre

est facultatif. Valeur renvoye Valeur boolenne, true si le ou les dossiers ont bien t supprims, false dans le cas contraire. Description Mthode qui supprime le dossier spcifi et tous ses sous-dossiers de l'arborescence de dossiers du panneau Prslections de mouvement. Toutes les prslections situes dans ces dossiers sont galement supprimes. Les dossiers situs dans le dossier Prslections par dfaut ne peuvent pas tre supprims. Si vous ne transmettez pas de valeur pour folderPath, tous les dossiers actuellement slectionns sont supprims. Remarque : les dossiers sont supprims sans demander la confirmation de l'utilisateur et l'action ne peut pas tre annule.

EXTENSION DE FLASH CS4 PROFESSIONAL 366

Objet presetPanel

Exemple Le code suivant supprime un dossier nomm Bouncing du dossier Prslections personnalises ; tous les sous-dossiers de Bouncing sont galement supprims.
fl.presetPanel.deleteFolder("Custom Presets/Bouncing");

Voir aussi presetPanel.deleteItem()

presetPanel.deleteItem()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.deleteItem( [namePath] )

Paramtres namePath Chane qui spcifie le chemin et le nom de l'lment supprimer du panneau Prslections de mouvement. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne, true si le ou les lments ont bien t supprims, false dans le cas contraire. Description Mthode qui supprime la prslection spcifie du panneau Prslections de mouvement. Si vous ne transmettez pas de valeur pour namePath, toutes les prslections actuellement slectionnes sont supprimes. Les lments du dossier Prslections par dfaut ne peuvent pas tre supprims. Remarque : les lments sont supprims sans demander la confirmation de l'utilisateur et l'action ne peut pas tre annule. Exemple Le code suivant supprime une prslection nomme aDribble du dossier Prslections personnalises :
fl.presetPanel.deleteItem("Custom Presets/aDribble");

Voir aussi presetPanel.deleteFolder()

presetPanel.expandFolder()
Disponibilit Flash CS4 Professional.

EXTENSION DE FLASH CS4 PROFESSIONAL 367

Objet presetPanel

Utilisation
presetPanel.expandFolder( [bExpand [, bRecurse [, folderPath] ] ] )

Paramtres bExpand Valeur boolenne qui spcifie si le dossier doit tre dvelopp (true) ou rduit (false). Ce paramtre est facultatif ; la valeur par dfaut est true.
bRecurse Valeur boolenne qui spcifie si les sous-dossiers du dossier doivent tre dvelopps (true) ou rduits

(false). Ce paramtre est facultatif ; la valeur par dfaut est false.

folderPath Chane qui spcifie le chemin du dossier dvelopper ou rduire. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne, true si le ou les dossiers ont bien t dvelopps ou rduits, false dans le cas contraire. Description Mthode qui dveloppe ou rduit le ou les dossiers actuellement slectionns dans le panneau Prslections de mouvement. Pour dvelopper ou rduire d'autres dossiers que ceux actuellement slectionns, transmettez une valeur pour folderPath. Exemple L'exemple suivant dveloppe le dossier Prslections personnalises sans dvelopper ses sous-dossiers :
fl.presetPanel.expandFolder(true, false, "Custom Presets");

L'exemple suivant dveloppe le dossier Prslections personnalises et ses sous-dossiers :

fl.presetPanel.expandFolder(true, true, "Custom Presets");

presetPanel.exportItem()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.exportItem(fileURI [, namePath] )

Paramtres fileURI Chane exprime sous la forme fichier:///URI et spcifiant le chemin et ventuellement le nom du fichier export. Pour plus d'informations, consultez la section Description ci-dessous.
namePath Chane qui spcifie le nom et le chemin de l'lment slectionner dans le panneau Prslections de mouvement. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne, true si la prslection a bien t exporte, false dans le cas contraire.

EXTENSION DE FLASH CS4 PROFESSIONAL 368

Objet presetPanel

Description Mthode qui exporte la prslection spcifie ou actuellement slectionne dans un fichier XML. Seules des prslections peuvent tre exportes ; si vous tentez d'exporter un dossier, la mthode choue. Elle choue galement si vous tentez de remplacer un fichier du disque. Si vous ne spcifiez pas de nom de fichier dans fileURI (c'est--dire, si le dernier caractre de fileURI est une barre oblique (/)), le fichier export est enregistr sous le nom de la prslection exporte. Si vous ne spcifiez pas de valeur pour namePath, la prslection actuellement slectionne est exporte. Voir lexemple ci-dessous. Exemple L'exemple suivant montre quels fichiers sont crs lorsque des paramtres diffrents sont transmis cette mthode, et indique si le fichier spcifi a bien t cr. Avant d'excuter cet exemple, slectionnez la prslection fly-in-left (entre rapide-gauche) dans le dossier Prslections par dfaut et crez le dossier My Presets (Mes prslections) sur le disque.
//Exports fly-in-left to C:\My Presets\fly-in-left.xml fl.presetPanel.exportItem("file:///C|/My Presets/"); //Exports fly-in-left to C:\My Presets\myFavoritePreset.xml fl.presetPanel.exportItem("file:///C|/My Presets/myFavoritePreset.xml"); // Exports the "pulse" preset to C:\My Presets\pulse.xml fl.presetPanel.exportItem("file:///C|/My Presets/", "Default Presets/pulse"); // Exports the "pulse" preset to C:\My Presets\thePulsePreset.xml fl.presetPanel.exportItem("file:///C|/My Presets/thePulsePreset.xml", "Default Presets/pulse");

Voir aussi
presetPanel.importItem()

presetPanel.findItemIndex()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.findItemIndex([presetName])

Paramtres
presetName Chane qui spcifie le nom de la prslection dont la valeur d'index est renvoye. Ce paramtre est

facultatif. Valeur renvoye Nombre entier reprsentant l'index de la prslection spcifie dans le tableau presetPanel.items. Si vous ne transmettez pas de valeur pour presetName, l'index de la prslection actuellement spcifie est renvoy. Cette mthode renvoie -1 dans les cas suivants :

Vous n'avez pas transmis de valeur pour presetName et aucune prslection n'est slectionne. Vous n'avez pas transmis de valeur pour presetName et plusieurs prslections sont slectionnes. La valeur que vous avez transmis pour presetName ne correspond pas aucun lment du panneau.

EXTENSION DE FLASH CS4 PROFESSIONAL 369

Objet presetPanel

Description Mthode qui renvoie un nombre entier reprsentant l'emplacement d'index d'un lment dans le panneau Prslections de mouvement. Exemple Le code suivant affiche la valeur d'index et le nom de chemin complet de la prslection actuellement slectionne :
// Select one preset in the Motions Preset panel before running this code var selectedPreset = fl.presetPanel.findItemIndex(); fl.trace(selectedPreset); fl.trace(fl.presetPanel.items[selectedPreset].path);

presetPanel.getSelectedItems()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.getSelectedItems()

Paramtres Aucun. Valeur renvoye Tableau d'objets presetItem. Description Mthode qui renvoie un tableau d'objets presetItem correspondant aux lments actuellement slectionns dans le panneau Prslections de mouvement (voir Objet presetItem). Chaque lment du tableau reprsente un dossier ou une prslection. Exemple Le code suivant affiche les noms de chemin complets des lments actuellement slectionns dans le panneau Prslections de mouvement :
var itemArray = fl.presetPanel.getSelectedItems(); var length = itemArray.length for (x=0; x<length; x++) { fl.trace(itemArray[x].path); }

Voir aussi
presetPanel.items

EXTENSION DE FLASH CS4 PROFESSIONAL 370

Objet presetPanel

presetPanel.importItem()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.importItem(fileURI [,namePath ])

Paramtres fileURI Chane exprime sous la forme fichier:/// URI et spcifiant le fichier XML importer en tant que prslection dans le panneau Prslections de mouvement.
namePath Chane spcifiant dans quel dossier le fichier import doit tre plac et le nom lui donner. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne, true si le fichier a bien t import, false dans le cas contraire. Description Mthode qui ajoute une prslection dans le panneau Prslections de mouvement partir d'un fichier XML spcifi. Le chemin spcifi dans namePath doit exister dans le panneau. Pour crer des fichiers XML pouvant tre imports, utilisez presetPanel.exportItem(). Si vous ne transmettez pas de valeur pour namePath, la prslection importe est place dans le dossier Prslections personnalises et nomme comme le fichier import (sans l'extension XML). Exemple L'exemple suivant importe une prslection dans le dossier Custom Presets/Pulse (Prslections personnalises/Pulsation), et la nomme fastPulse.
fl.presetPanel.importItem("file:///C|/My Presets/thePulsePreset.xml", "Custom Presets/Pulse/fastPulse");

Voir aussi
presetPanel.exportItem()

presetPanel.items
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.items

Description Proprit ; tableau des objets presetItem prsents dans le panneau Prslections de mouvement (voir Objet presetItem). Chaque lment du tableau reprsente un dossier ou une prslection.

EXTENSION DE FLASH CS4 PROFESSIONAL 371

Objet presetPanel

Exemple Le code suivant affiche les noms de chemin complets des lments dans le panneau Prslections de mouvement :
var itemArray = fl.presetPanel.items; var length = itemArray.length for (x=0; x<length; x++) { fl.trace(itemArray[x].path); }

Voir aussi presetPanel.getSelectedItems()

presetPanel.moveToFolder()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.moveToFolder(folderPath [, namePath] )

Paramtres
folderPath Chane spcifiant le chemin du dossier du panneau Prslections de mouvement vers lequel le ou les

lments sont dplacs.

namePath Chane spcifiant le chemin et le nom de l'lment dplacer. Ce paramtre est facultatif.

Valeur renvoye Valeur boolenne, true si les lments ont bien t dplacs, false dans le cas contraire. Description Mthode qui dplace l'lment spcifi vers le dossier spcifi. Si vous transmettez une chane vide ("") pour folderPath, les lments sont dplacs vers le dossier Prslections personnalises. Si vous ne transmettez pas de valeur pour namePath, les lments actuellement slectionns sont dplacs. Vous ne pouvez pas dplacer des lments vers le dossier Prslections par dfaut, ni partir de ce dernier. Exemple Dans l'exemple suivant, les lments actuellement slectionns sont dplacs vers le dossier Custom Presets/Bouncing (Prslections personnalises/Rebond). La prslection Fast Bounce (Rebond rapide) est ensuite dplace vers le mme dossier :
fl.presetPanel.moveToFolder("Custom Presets/Bouncing"); fl.presetPanel.moveToFolder("Custom Presets/Bouncing" , "Custom Presets/Fast Bounce");

EXTENSION DE FLASH CS4 PROFESSIONAL 372

Objet presetPanel

presetPanel.newFolder()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.newFolder( [folderPath] )

Paramtres
folderPath Chane spcifiant o un nouveau dossier doit tre ajout dans le panneau Prslections de mouvement

et le nom du nouveau dossier. Ce paramtre est facultatif. Valeur renvoye Valeur boolenne, true si le dossier a bien t ajout, false dans le cas contraire. Description Mthode qui cre un dossier dans l'arborescence de dossiers du panneau Prslections de mouvement. Cette mthode ne permet de crer qu'un seul nouveau niveau de dossiers. C'est--dire que si vous transmettez Prslections personnalises/Mon premier dossier/Mon second dossier pour folderPath, Prslections personnalises/Mon premier dossier doit exister dans l'arborescence. Si vous ne transmettez pas de valeur pour folderPath, un dossier nomm Dossier sans nom n est cr au premier niveau sous Prslections personnalises , o n est incrment chaque ajout d'un dossier de cette manire. Remarque : vous ne pouvez pas ajouter de dossiers dans le dossier Prslections par dfaut. Exemple L'exemple suivant ajoute un dossier nomm Bouncing (Rebond) au-dessous du dossier Custom Presets (Prslections personnalises) :
fl.presetPanel.newFolder("Custom Presets/Bouncing");

Voir aussi
presetPanel.addNewItem()

presetPanel.renameItem()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.renameItem(newName)

Paramtres newName Chane qui spcifie le nouveau nom de la prslection ou du dossier.

EXTENSION DE FLASH CS4 PROFESSIONAL 373

Objet presetPanel

Valeur renvoye Valeur boolenne, true si la prslection ou le dossier a bien t renomm(e), false dans le cas contraire. Description Mthode qui remplace le nom de la prslection ou du dossier slectionn(e) par un nom spcifi. Cette mthode fonctionne uniquement si un seul dossier ou une seule prslection est slectionn(e) dans le panneau Prslections personnalises. Cette mthode choue dans les cas suivants :

Aucun lment n'est slectionn. Plusieurs lments sont slectionns. L'lment slectionn est situ dans le dossier Prslections par dfaut. Un lment nomm newName existe dj au mme emplacement que l'lment slectionn.
Exemple L'exemple suivant renomme la prslection actuellement slectionne dans le dossier Prslections personnalises en Bounce Faster (Rebond plus rapide).
var renamed = fl.presetPanel.renameItem("Bounce Faster"); fl.trace(renamed);

presetPanel.selectItem()
Disponibilit Flash CS4 Professional. Utilisation
presetPanel.selectItem(namePath [, bReplaceCurrentSelection [, bSelect] ])

Paramtres namePath Chane qui spcifie le nom et le chemin de l'lment slectionner dans le panneau Prslections de mouvement.
bReplaceCurrentSelection Valeur boolenne indiquant si l'lment spcifi remplace la slection actuelle (true) ou lui est ajout (false). Ce paramtre est facultatif ; la valeur par dfaut est true. bSelect Valeur boolenne qui spcifie si l'lment doit tre slectionn (true) ou dslectionn (false). Ce

paramtre est facultatif ; la valeur par dfaut est true. Si vous transmettez false pour bSelect, la valeur de bReplaceCurrentSelection est ignore. Valeur renvoye Valeur boolenne, true si l'lment a bien t slectionn ou dslectionn, false dans le cas contraire. Description Mthode qui slectionne ou dslectionne un lment dans le panneau Prslections de mouvement, ventuellement en remplaant les lments actuellement slectionns.

EXTENSION DE FLASH CS4 PROFESSIONAL 374

Objet presetPanel

Exemple Le code suivant ajoute la prslection fly-in-blur-right (entre rapide-flou-droite) aux prslections actuellement slectionnes (le cas chant) dans le panneau Prslections de mouvement :
fl.presetPanel.selectItem("Default Presets/fly-in-blur-right", false);

375

Chapitre 35 : Objet Rectangle

Hritage

Objet Element > Objet Shape > Objet Rectangle

Disponibilit Flash CS3 Professional. Description L'objet Rectangle est une forme trace l'aide de l'outil Rectangle primitif. Pour savoir si un lment est un objet Rectangle, utilisez shape.isRectangleObject. Rsum des proprits Outre celles de lobjet Objet Shape, l'objet Rectangle gre les proprits suivantes : Pour dfinir les proprits d'un objet Rectangle, utilisez document.setRectangleObjectProperty().
Proprit
RectangleObject.bottomLeftRadius

Description Lecture seule ; valeur en virgule flottante qui dfinit le rayon de l'angle infrieur gauche de l'objet Rectangle. Lecture seule ; valeur en virgule flottante qui dfinit le rayon de l'angle infrieur droit de l'objet Rectangle. Lecture seule ; valeur boolenne dterminant si les valeurs des rayons des diffrents angles du rectangle peuvent tre diffrentes. Lecture seule ; valeur en virgule flottante qui dfinit le rayon de tous les angles du rectangle, ou seulement le rayon de l'angle suprieur gauche de l'objet Rectangle. Lecture seule ; valeur en virgule flottante qui dfinit le rayon de l'angle suprieur droit de l'objet Rectangle.

RectangleObject.bottomRightRadius

RectangleObject.lockFlag

RectangleObject.topLeftRadius

RectangleObject.topRightRadius

RectangleObject.bottomLeftRadius
Disponibilit Flash CS3 Professional. Utilisation
RectangleObject.bottomLeftRadius

Description Proprit en lecture seule ; valeur en virgule flottante qui dfinit le rayon de l'angle infrieur gauche de l'objet Rectangle. Si RectangleObject.lockFlag est true, tenter de dfinir cette valeur n'a aucun effet. Pour dfinir cette valeur, utilisez document.setRectangleObjectProperty().

EXTENSION DE FLASH CS4 PROFESSIONAL 376

Objet Rectangle

Voir aussi
document.setRectangleObjectProperty(), RectangleObject.bottomRightRadius, RectangleObject.lockFlag, RectangleObject.topLeftRadius, RectangleObject.topRightRadius

RectangleObject.bottomRightRadius
Disponibilit Flash CS3 Professional. Utilisation
RectangleObject.bottomRightRadius

Description Proprit en lecture seule ; valeur en virgule flottante qui dfinit le rayon de l'angle infrieur droit de l'objet Rectangle. Si RectangleObject.lockFlag est true, tenter de dfinir cette valeur n'a aucun effet. Pour dfinir cette valeur, utilisez document.setRectangleObjectProperty(). Voir aussi
document.setRectangleObjectProperty(), RectangleObject.bottomLeftRadius, RectangleObject.lockFlag, RectangleObject.topLeftRadius, RectangleObject.topRightRadius

RectangleObject.lockFlag
Disponibilit Flash CS3 Professional. Utilisation
RectangleObject.lockFlag

Description Proprit en lecture seule ; valeur boolenne dterminant si les valeurs des rayons des diffrents angles du rectangle peuvent tre diffrentes. Si cette valeur est true, les angles prennent tous la valeur RectangleObject.topLeftRadius. Si elle est false, chaque rayon d'angle peut tre dfini sparment. Pour dfinir cette valeur, utilisez document.setRectangleObjectProperty(). Voir aussi
document.setRectangleObjectProperty(), RectangleObject.bottomLeftRadius, RectangleObject.bottomRightRadius, RectangleObject.topLeftRadius, RectangleObject.topRightRadius

EXTENSION DE FLASH CS4 PROFESSIONAL 377

Objet Rectangle

RectangleObject.topLeftRadius
Disponibilit Flash CS3 Professional. Utilisation
RectangleObject.topLeftRadius

Description Proprit en lecture seule ; valeur en virgule flottante qui dfinit le rayon de tous les angles du rectangle (si la valeur de RectangleObject.lockFlag est true), ou seulement le rayon de l'angle suprieur gauche (si la valeur de RectangleObject.lockFlag est false). Pour dfinir cette valeur, utilisez document.setRectangleObjectProperty(). Voir aussi
document.setRectangleObjectProperty(), RectangleObject.bottomLeftRadius, RectangleObject.bottomRightRadius, RectangleObject.lockFlag, RectangleObject.topRightRadius

RectangleObject.topRightRadius
Disponibilit Flash CS3 Professional. Utilisation
RectangleObject.topRightRadius

Description Proprit en lecture seule ; valeur en virgule flottante qui dfinit le rayon de l'angle suprieur droit de l'objet Rectangle. Si RectangleObject.lockFlag est true, tenter de dfinir cette valeur n'a aucun effet. Pour dfinir cette valeur, utilisez document.setRectangleObjectProperty(). Voir aussi
document.setRectangleObjectProperty(), RectangleObject.bottomLeftRadius, RectangleObject.bottomRightRadius, RectangleObject.lockFlag, RectangleObject.topLeftRadius

378

Chapitre 36 : Objet Screen

Disponibilit Flash MX 2004. Description Lobjet Screen reprsente un cran spar dans une diapositive ou un formulaire. Cet objet contient les proprits propres la diapositive ou au formulaire. Pour accder au tableau de tous les objets Screen du document, utilisez le code suivant :
fl.getDocumentDOM().screenOutline.screens

Rsum des proprits Lobjet Screen possde les proprits suivantes :

Proprits
screen.accName screen.childScreens

Description Chane quivalente au champ Nom du panneau Accessibilit. Lecture seule ; tableau des crans enfant de cet cran. Ce tableau est vide sil nexiste pas dcrans enfant. Chane quivalente au champ Description du panneau Accessibilit. Valeur boolenne qui active ou dsactive laccessibilit aux enfants de lobjet. Valeur boolenne indiquant si lcran est visible. Lecture seule ; chane reprsentant le nom de l'occurrence utilise pour accder lobjet en ActionScript. Lecture seule ; chane reprsentant le nom de lcran. Lecture seule ; objet reprsentant le prochain cran de mme niveau dans le tableau childScreens de lcran parent. Lecture seule ; tableau contenant les proprits ActionScript 2.0 accessibles dans linspecteur Proprits de l'cran. Lecture seule ; chane reprsentant lcran parent. Lecture seule ; objet reprsentant lcran de mme niveau prcdent dans le tableau childScreens de lcran parent. Valeur boolenne indiquant si lobjet est accessible. Equivalent au champ Index de tabulation du panneau Accessibilit. Lecture seule ; l'objet Timeline de lcran. Voir Objet Timeline.

screen.description screen.forceSimple screen.hidden screen.instanceName

screen.name screen.nextScreen

screen.parameters

screen.parentScreen screen.prevScreen

screen.silent screen.tabIndex screen.timeline

screen.accName
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 379

Objet Screen

Utilisation
screen.accName

Description Proprit ; chane quivalente au champ Nom du panneau Accessibilit. Les logiciels de lecture vocale identifient lobjet en prononant ce nom. Exemple L'exemple suivant enregistre dans la variable theName la valeur du nom de lobjet :
var theName = fl.getDocumentDOM().screenOutline.screens[1].accName;

Lexemple suivant dfinit sur "Home Button" le nom de lobjet :

fl.getDocumentDOM().screenOutline.screens[1].accName = 'Home Button';

screen.childScreens
Disponibilit Flash MX 2004. Utilisation
screen.childScreens

Description Proprit en lecture seule ; tableau des crans enfant de cet cran. Ce tableau est vide sil nexiste pas dcrans enfant. Exemple L'exemple suivant vrifie que le document actuel est une diapositive ou un formulaire et, si cest le cas, enregistre dans la variable myChildren le tableau des crans enfant avant dafficher leurs noms dans le panneau Sortie :
var myChildren = new Array(); if(fl.getDocumentDOM().allowScreens) { var myParent = fl.getDocumentDOM().screenOutline.rootScreen.name for (i in fl.getDocumentDOM().screenOutline.rootScreen.childScreens) { myChildren.push(" "+fl.getDocumentDOM().screenOutline.rootScreen.childScreens[i].name); } fl.trace(" The child screens of "+myParent+" are "+myChildren+". "); }

screen.description
Disponibilit Flash MX 2004. Utilisation
screen.description

EXTENSION DE FLASH CS4 PROFESSIONAL 380

Objet Screen

Description Proprit ; chane quivalente au champ Description du panneau Accessibilit. Cette description est lue par les logiciels de lecture vocale. Exemple L'exemple suivant rcupre la description de l'cran et la stocke dans la variable theDescription :
var theDescription = fl.getDocumentDOM().screenOutline.screens[1].description;

L'exemple suivant dfinit la description de l'cran sur Home Screen :

fl.getDocumentDOM().screenOutline.screens[1].description = "Home Screen";

screen.forceSimple
Disponibilit Flash MX 2004. Utilisation
screen.forceSimple

Description Proprit ; valeur boolenne qui active ou dsactive laccessibilit aux enfants de lobjet. Cette proprit est quivalente linverse du paramtre Rendre les objets enfant accessibles du panneau Accessibilit. Ainsi, si forceSimple est true, son effet est similaire la dsactivation de loption Rendre les objets enfant accessibles. Si forceSimple est false, son effet est similaire lactivation de loption Rendre les objets enfant accessibles. Exemple L'exemple suivant donne la variable areChildrenAccessible la valeur de la proprit forceSimple ; une valeur false signifie que les enfants sont accessibles :
var areChildrenAccessible = fl.getDocumentDOM().screenOutline.screens[1].forceSimple

L'exemple suivant rend les enfants de lobjet accessibles :

fl.getDocumentDOM().screenOutline.screens[1].forceSimple = false;

screen.hidden
Disponibilit Flash MX 2004. Utilisation
screen.hidden

Description Proprit ; valeur boolenne indiquant si lcran est visible. Un cran dont la proprit hidden a la valeur true nest pas visible dans un autre cran.

EXTENSION DE FLASH CS4 PROFESSIONAL 381

Objet Screen

Exemple L'exemple suivant vrifie si le premier cran est cach, et change sa visibilit en consquence. Un message saffiche ensuite dans le panneau Sortie pour indiquer la visibilit de lcran avant le changement :
if (fl.getDocumentDOM().screenOutline.screens[0].hidden) { fl.getDocumentDOM().screenOutline.setScreenProperty("hidden", false); fl.trace(fl.getDocumentDOM().screenOutline.screens[0].name+" had its 'hidden' property set to 'false'"); } else { fl.getDocumentDOM().screenOutline.setScreenProperty("hidden", true); fl.trace(fl.getDocumentDOM().screenOutline.screens[0].name+" had its 'hidden' property set to 'true'"); }

screen.instanceName
Disponibilit Flash MX 2004. Utilisation
screen.instanceName

Description Proprit en lecture seule ; chane reprsentant le nom de l'occurrence utilise pour accder lobjet en ActionScript. Exemple L'exemple suivant vrifie si le document actif autorise les crans (cest--dire sil est de type diapositive ou formulaire). Il affecte ensuite la valeur instanceName du premier cran enfant du tableau la variable myInstanceName et ouvre le panneau Sortie pour afficher le nom d'occurrence de lcran :
var myChildren = new Array(); if(fl.getDocumentDOM().allowScreens) { var myInstanceName = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].instanceName; fl.trace(" The instanceName is "+myInstanceName+". "); }

screen.name
Disponibilit Flash MX 2004. Utilisation
screen.name

Description Proprit en lecture seule ; chane reprsentant le nom de lcran.

EXTENSION DE FLASH CS4 PROFESSIONAL 382

Objet Screen

Exemple L'exemple suivant vrifie si le document actif autorise les crans (cest--dire sil est de type diapositive ou formulaire). Il affecte ensuite la valeur name du premier cran enfant du tableau la variable myName, et ouvre le panneau Sortie pour afficher le nom de lcran :
var myChildren = new Array(); if(fl.getDocumentDOM().allowScreens) { var myName = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name; fl.trace("The name of the screen is "+myName+". "); }

screen.nextScreen
Disponibilit Flash MX 2004. Utilisation
screen.nextScreen

Description Proprit en lecture seule ; objet reprsentant lcran de mme niveau suivant dans le tableau childScreens de lcran parent. Autrement dit, il faut parcourir un tableau dcrans enfant jusquau prochain cran du tableau pour connatre la valeur de screen.nextScreen. Voir screen.prevScreen. S'il n'existe pas dcrans de mme niveau, la valeur est null. Exemple L'exemple suivant vrifie que le document actuel est une diapositive ou un formulaire et, si cest le cas, il affiche la squence des crans dans le panneau Sortie :
if(fl.getDocumentDOM().allowScreens) { var myCurrent = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name; var myNext = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].nextScreen.name; fl.trace(" The next screen to "+myCurrent+" is "+myNext+". "); }

screen.parameters
Disponibilit Flash MX 2004. Utilisation
screen.parameters

Description Proprit en lecture seule ; tableau contenant les proprits ActionScript 2.0 accessibles dans lInspecteur de proprits.

EXTENSION DE FLASH CS4 PROFESSIONAL 383

Objet Screen

Exemple L'exemple suivant stocke les paramtres du second cran dans la variable parms, puis affecte la valeur some value la premire proprit :
var parms = fl.getDocumentDOM().screenOutline.screens[1].parameters; parms[0].value = "some value";

Voir aussi Objet Parameter

screen.parentScreen
Disponibilit Flash MX 2004. Utilisation
screen.parentScreen

Description Proprit en lecture seule ; objet reprsentant lcran parent. Si parentScreen est null, lcran est un cran de niveau suprieur. Exemple L'exemple suivant stocke les valeurs des proprits childScreen et parentScreen dans des variables, puis affiche ces valeurs et leurs relations parent/enfant dans le panneau Sortie :
if(fl.getDocumentDOM().allowScreens) { var myCurrent = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[1].name; var myParent = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[1].parentScreen.name; fl.trace(" The parent screen to "+myCurrent+" is "+myParent+". "); }

screen.prevScreen
Disponibilit Flash MX 2004. Utilisation
screen.prevScreen

Description Proprit en lecture seule ; objet reprsentant lcran de mme niveau prcdent dans le tableau childScreens de lcran parent. S'il n'existe pas dcrans de mme niveau, la valeur est null. Voir aussi screen.nextScreen.

EXTENSION DE FLASH CS4 PROFESSIONAL 384

Objet Screen

Exemple L'exemple suivant vrifie que le document actuel est une diapositive ou un formulaire et, si cest le cas, il affiche la squence des crans dans le panneau Sortie :
if(fl.getDocumentDOM().allowScreens) { var myCurrent = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[1].name; var myNext = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[1].prevScreen.name; fl.trace(" The previous screen to "+myCurrent+" is "+myNext+". "); }

screen.silent
Disponibilit Flash MX 2004. Utilisation
screen.silent

Description Proprit ; valeur boolenne indiquant si lobjet est accessible. Cette proprit est quivalente linverse du paramtre Rendre l'objet accessible du panneau Accessibilit. Ainsi, si silent est true, son effet est similaire la dsactivation de loption Rendre lobjet accessible dans le panneau Accessibilit. Si silent est false, son effet est similaire lactivation de loption Rendre lobjet accessible dans le panneau Accessibilit. Exemple L'exemple suivant rcupre la valeur de la proprit silent de lobjet (la valeur false signifie que lobjet est accessible) :
var isSilent = fl.getDocumentDOM().screenOutline.screens[1].silent;

L'exemple suivant rend lobjet accessible :

fl.getDocumentDOM().screenOutline.screens[1].silent = false;

screen.tabIndex
Disponibilit Flash MX 2004. Utilisation
screen.tabIndex

Description Proprit ; entier quivalent au champ Index de tabulation du panneau Accessibilit. Cette valeur permet de dterminer lordre dans lequel les objets seront slectionns lorsque lutilisateur appuiera sur la touche de tabulation. Exemple L'exemple suivant rcupre lindex de tabulation de lobjet :

EXTENSION DE FLASH CS4 PROFESSIONAL 385

Objet Screen

var theTabIndex = fl.getDocumentDOM().screenOutline.screens[1].tabIndex;

L'exemple suivant dfinit lindex de tabulation de lobjet sur 1 :

fl.getDocumentDOM().screenOutline.screens[1].tabIndex = 1;

screen.timeline
Disponibilit Flash MX 2004. Utilisation
screen.timeline

Description Proprit en lecture seul ; l'Objet Timeline de l'cran. Exemple L'exemple suivant rcupre la proprit screenOutline du document actif, affecte le tableau des proprits de timeline du premier cran la variable myArray, et affiche ces proprits dans le panneau Sortie :
myArray = new Array(); if(fl.getDocumentDOM().screenOutline) { for(i in fl.getDocumentDOM().screenOutline.screens[0].timeline) { myArray.push(" "+i+" : "+fl.getDocumentDOM().screenOutline.screens[0].timeline[i]+" ") ; } fl.trace("Here are the properties of the screen named "+ fl.getDocumentDOM().screenOutline.screens[0].name+": "+myArray); }

386

Chapitre 37 : Objet ScreenOutline

Disponibilit Flash MX 2004. Description Lobjet ScreenOutline reprsente le groupe dcrans dune diapositive ou dun formulaire. Cet objet est accessible laide de fl.getDocumentDOM().screenOutline. L'objet ScreenOutline existe uniquement si le document est une diapositive ou un formulaire. Par consquent, avant d'accder la proprit, utilisez document.allowScreens() pour vrifier qu'un document Screens existe, tel que dans l'exemple suivante :
if(fl.getDocumentDOM().allowScreens) { var myName = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name; fl.trace("The name of the screen is " + myName + ". "); }

Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet ScreenOutline :
Mthode
screenOutline.copyScreenFromFile()

Description Insre sous lcran actuellement slectionn tous les crans (ou un cran spcifi et ses enfants) dun document spcifi. Supprime les crans actuellement slectionns ou un cran spcifi, ainsi que leurs enfants. Duplique les crans actuellement slectionns ou un cran spcifi. Renvoie un tableau des objets Screen actuellement slectionns dans le groupe dcrans. Insre un cran imbriqu du type spcifi un emplacement particulier du groupe dcrans. Insre un nouvel cran vierge du type spcifi un emplacement spcifique du document. Dplace lcran spcifi en fonction de la valeur du paramtre referenceScreen, soit avant, aprs, comme premier enfant ou comme dernier enfant. Donne un nouveau nom lcran portant le nom spcifi. Affecte lcran spcifi la slection actuelle dans le groupe dcrans. Dfinit la proprit spcifie avec la valeur indique pour les crans slectionns. Slectionne les crans spcifis dans le panneau Contour de l'cran.

screenOutline.deleteScreen()

screenOutline.duplicateScreen() screenOutline.getSelectedScreens()

screenOutline.insertNestedScreen()

screenOutline.insertScreen()

screenOutline.moveScreen()

screenOutline.renameScreen() screenOutline.setCurrentScreen() screenOutline.setScreenProperty()

screenOutline.setSelectedScreens()

Rsum des proprits Vous pouvez utiliser les proprits suivantes avec lobjet ScreenOutline :

EXTENSION DE FLASH CS4 PROFESSIONAL 387

Objet ScreenOutline

Proprit
screenOutline.currentScreen screenOutline.rootScreen screenOutline.screens

Description Objet Screen ; cran actuellement slectionn. Lecture seule ; premier cran du groupe dcrans. Lecture seule ; tableau des objets Screen de niveau suprieur (voir Objet Screen) contenus dans le document.

screenOutline.copyScreenFromFile()
Disponibilit Flash MX 2004. Utilisation
screenOutline.copyScreenFromFile(fileURI [, screenName])

Paramtres fileURI Chane de type fichier:///URI qui spcifie le nom du fichier FLA qui contient les crans copier dans le document.
screenName Nom de lcran copier. Si le paramtre screenName est prsent, Flash copie cet cran et ses enfants. Si

le paramtre screenName est omis, Flash copie tout le document. Ce paramtre est facultatif. Valeur renvoye Aucune. Si le fichier est introuvable, ou si ce nest pas un fichier FLA valide, ou encore si lcran spcifi est introuvable, une erreur est affiche et lexcution du script est interrompue. Description Mthode qui insre sous lcran actuellement slectionn tous les crans (ou un cran spcifi et ses enfants) dun document spcifi. Si plusieurs crans sont slectionns, les nouveaux crans sont insrs sous le dernier cran slectionn, au mme niveau. Exemple L'exemple suivant copie lcran slide1 depuis le fichier myTarget.fla (situ sur le Bureau) dans le document actif (remplacez la chane userName par votre nom dutilisateur) :
fl.getDocumentDOM().screenOutline.copyScreenFromFile("file:///C|/Documents and Settings/userName/Desktop/myTarget.fla", "slide1");

screenOutline.currentScreen
Disponibilit Flash MX 2004. Utilisation
screenOutline.currentScreen

EXTENSION DE FLASH CS4 PROFESSIONAL 388

Objet ScreenOutline

Description Proprit ; objet Screen, cran actuellement slectionn (voir Objet Screen). Exemple L'exemple suivant stocke dans la variable myScreen lobjet currentScreen, puis affiche le nom de cet cran dans le panneau Sortie :
var myScreen = fl.getDocumentDOM().screenOutline.currentScreen; fl.trace(myScreen.name);

screenOutline.deleteScreen()
Disponibilit Flash MX 2004. Utilisation
screenOutline.deleteScreen([screenName])

Paramtres
screenName Chane spcifiant le nom de lcran supprimer. Si le paramtre screenName est omis, le ou les crans actuellement slectionns, ainsi que leurs enfants, sont supprims. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui supprime le ou les crans actuellement slectionns ou un cran spcifi, ainsi que leurs enfants. Exemple L'exemple suivant supprime l'cran nomm apple et tous ses enfants :
fl.getDocumentDOM().screenOutline.deleteScreen("apple");

screenOutline.duplicateScreen()
Disponibilit Flash MX 2004. Utilisation
screenOutline.duplicateScreen([screenName])

Paramtres
screenName Chane spcifiant le nom de lcran dupliquer. Si le paramtre screenName est omis, le ou les crans

actuellement slectionns sont dupliqus. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 389

Objet ScreenOutline

Valeur renvoye Valeur boolenne, true si l'cran est bien dupliqu, false dans le cas contraire. Description Mthode qui duplique le ou les crans actuellement slectionns ou un cran spcifi. Les crans en double reoivent un nom par dfaut, qui est cr en ajoutant _copy la fin du nom de lcran original, par exemple ecran_copy, ecran_copy2, etc. Si vous dupliquez plusieurs crans, ces duplicata sont placs directement sous lcran slectionn ayant le niveau le plus bas dans la hirarchie du groupe dcrans. Exemple L'exemple suivant duplique un cran nomm apple :
fl.getDocumentDOM().screenOutline.duplicateScreen("apple");

screenOutline.getSelectedScreens()
Disponibilit Flash MX 2004. Utilisation
screenOutline.getSelectedScreens()

Paramtres Aucun. Valeur renvoye Tableau des objets Screen slectionns (voir Objet Screen). Description Mthode qui renvoie un tableau des objets Screen actuellement slectionns dans le groupe dcrans. Exemple L'exemple suivant stocke dans la variable myArray les objets Screen actuellement slectionns, puis affiche leurs noms dans le panneau Sortie :
var myArray = fl.getDocumentDOM().screenOutline.getSelectedScreens(); for (var i in myArray) { fl.trace(myArray[i].name) }

screenOutline.insertNestedScreen()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 390

Objet ScreenOutline

Utilisation
screenOutline.insertNestedScreen([name [, referenceScreen [, screenTypeName]]])

Paramtres name Chane spcifiant le nom de lcran insrer. Si cette chane est vide, le nouvel cran insr recevra un nom par dfaut, par exemple Sliden ou Formn (o n est le premier chiffre unique disponible). Ce paramtre est facultatif.
referenceScreen Une chane qui indique le nom de lcran sous lequel le nouvel cran doit tre insr en tant

quenfant. Si ce paramtre nest pas spcifi, le nouvel cran est insr en tant quenfant de lcran actuellement slectionn. Ce paramtre est facultatif.
screenTypeName Chane spcifiant le type dcran affecter au nouvel cran imbriqu. Le type dcran et son nom de

classe sont alors dfinis pour cet cran. Les valeurs gres sont "Form" et "Slide". Ce paramtre est facultatif. Si ce paramtre est omis, le type est hrit de lcran parent. Valeur renvoye Un Objet Screen. Description Mthode qui insre un cran imbriqu du type spcifi un emplacement particulier du groupe dcrans. Exemple L'exemple suivant insre lcran slide2 comme enfant de slide1 :
fl.getDocumentDOM().screenOutline.insertNestedScreen("slide2", "slide1", "Slide");

screenOutline.insertScreen()
Disponibilit Flash MX 2004. Utilisation
screenOutline.insertScreen([name [, referenceScreen [, screenTypeName]]])

Paramtres name Chane spcifiant le nom de lcran insrer. Si ce paramtre est omis, la mthode insre un nouvel cran avec un nom par dfaut, par exemple Sliden ou Formn (o n est le premier chiffre unique disponible). Ce paramtre est facultatif.
referenceScreen Chane spcifiant le nom de lcran situ avant le nouvel cran. Si ce paramtre nest pas spcifi, le nouvel cran est insr aprs lcran actuellement slectionn. Si le paramtre referenceScreen identifie un cran enfant, le nouvel cran sera de mme niveau que cet cran enfant, donc un enfant du mme cran parent. Ce paramtre est facultatif. screenTypeName Chane spcifiant le type dcran affecter au nouvel cran. Le type dcran et son nom de classe sont

alors dfinis pour cet cran. Les valeurs gres sont "Form" et "Slide". Ce paramtre est facultatif. Valeur renvoye Un Objet Screen.

EXTENSION DE FLASH CS4 PROFESSIONAL 391

Objet ScreenOutline

Description Mthode qui insre un nouvel cran vierge du type spcifi un emplacement spcifique du document. Exemple L'exemple suivant insre un formulaire nomm slide2 aprs lcran nomm slide1 :
fl.getDocumentDOM().screenOutline.insertScreen("slide2","slide1","Form");

L'exemple suivant insre une diapositive nomme slide4 aprs lcran nomm slide3 :
fl.getDocumentDOM().screenOutline.insertScreen("slide4","slide3","Slide");

screenOutline.moveScreen()
Disponibilit Flash MX 2004. Utilisation
screenOutline.moveScreen(screenToMove, referenceScreen, position)

Paramtres
screenToMove Chane indiquant le nom de lcran dplacer. referenceScreen Chane indiquant lcran ct duquel lcran indiqu par le paramtre screenToMove sera plac. position Chane indiquant lemplacement o lcran doit tre dplac, par rapport lcran indiqu par le paramtre

referenceScreen. Les valeurs possibles sont "before", "after", "firstChild" et "lastChild". Valeur renvoye Valeur boolenne, true si le dplacement est russi, false dans le cas contraire. Description Mthode qui dplace lcran spcifi en fonction de la valeur du paramtre referenceScreen, soit avant, aprs, comme premier enfant ou comme dernier enfant. Exemple L'exemple suivant dplace lcran slide1 en en faisant le premier enfant de lcran slide2 :
fl.getDocumentDOM().screenOutline.moveScreen("slide1", "slide2", "firstChild");

screenOutline.renameScreen()
Disponibilit Flash MX 2004. Utilisation
screenOutline.renameScreen(newScreenName [, oldScreenName[, bDisplayError]])

EXTENSION DE FLASH CS4 PROFESSIONAL 392

Objet ScreenOutline

Paramtres
newScreenName Chane spcifiant le nouveau nom de lcran. oldScreenName Chane spcifiant le nom de lcran modifier. Si ce paramtre est omis, le nom de lcran

actuellement slectionn est modifi. Ce paramtre est facultatif.

bDisplayError Valeur boolenne. Si sa valeur est true, un message derreur est affich en cas derreur, par exemple si

un cran porte dj le nom transmis au paramtre newScreenName. La valeur par dfaut est false. Valeur renvoye Valeur boolenne, true si le changement de nom est russi, false dans le cas contraire. Description Mthode qui donne un nouveau nom lcran ayant le nom spcifi. Exemple L'exemple suivant remplace par Intro le nom de lcran slide1 :
fl.getDocumentDOM().screenOutline.renameScreen("Intro", "slide1");

screenOutline.rootScreen
Disponibilit Flash MX 2004. Utilisation
screenOutline.rootScreen

Description Proprit en lecture seule ; premier cran du groupe dcrans. Vous pouvez utiliser screenOutline.rootScreen comme raccourci de screenOutline.screens[0]. Exemple L'exemple suivant affiche le nom du premier enfant du premier cran du groupe dcrans :
var n = fl.getDocumentDOM().screenOutline.rootScreen.childScreens[0].name; fl.trace(n);

screenOutline.screens
Disponibilit Flash MX 2004. Utilisation
screenOutline.screens

EXTENSION DE FLASH CS4 PROFESSIONAL 393

Objet ScreenOutline

Description Proprit en lecture seule ; tableau des objets Screen de niveau suprieur contenus dans le document (voir Objet Screen). Exemple L'exemple suivant stocke dans la variable myArray le tableau des objets Screen, puis affiche leurs noms dans le panneau Sortie :
var myArray = new Array(); if(fl.getDocumentDOM().allowScreens) { for(var i in fl.getDocumentDOM().screenOutline.screens) { myArray.push(" "+fl.getDocumentDOM().screenOutline.screens[i].name); } fl.trace(2"The screens array contains objects whose names are: "+myArray+". "); }

screenOutline.setCurrentScreen()
Disponibilit Flash MX 2004. Utilisation
screenOutline.setCurrentScreen(name)

Paramtres name Chane indiquant le nom de lcran devant devenir l'cran slectionn. Si cet cran est un enfant dun autre cran, il nest pas ncessaire dindiquer un chemin ni une hirarchie. Valeur renvoye Aucune. Description Mthode qui affecte lcran spcifi la slection actuelle dans le groupe dcrans. Exemple L'exemple suivant dfinit lcran nomm ChildOfSlide_1 comme cran actif :
fl.getDocumentDOM().screenOutline.setCurrentScreen("ChildOfSlide_1");

screenOutline.setScreenProperty()
Disponibilit Flash MX 2004. Utilisation
screenOutline.setScreenProperty(property, value)

EXTENSION DE FLASH CS4 PROFESSIONAL 394

Objet ScreenOutline

Paramtres property Chane spcifiant la proprit dfinir.

value Nouvelle valeur de la proprit. Le type de valeur dpend de la proprit dfinie.

Les proprits disponibles sont screenOutline.currentScreen, screenOutline.rootScreen et screenOutline.screens. Valeur renvoye Aucune. Description Mthode qui affecte la proprit spcifie, avec la valeur spcifie, aux crans slectionns. Exemple L'exemple suivant change la visibilit des crans actuellement slectionns, en la faisant passer de "hidden" "visible" :
fl.getDocumentDOM().screenOutline.setScreenProperty("hidden", false);

screenOutline.setSelectedScreens()
Disponibilit Flash MX 2004. Utilisation
screenOutline.setSelectedScreens(selection [, bReplaceCurrentSelection])

Paramtres selection Tableau des noms des crans slectionner dans le groupe dcrans.
bReplaceCurrentSelection Valeur boolenne. Si elle est true, la slection actuelle peut tre dslectionne. La valeur

par dfaut est true. Si elle est false, Flash tend la slection actuelle aux crans spcifis. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui slectionne les crans spcifis dans le groupe d'crans. Si plusieurs crans sont spcifis, celui qui a la dernire valeur dindex dans le tableau de la slection reoit le focus sur la scne. Exemple L'exemple suivant dslectionne tous les crans actuellement slectionns, puis slectionne les crans slide1, slide2, slide3 et slide4 dans le groupe dcrans :
myArray = new Array("slide1", "slide2", "slide3", "slide4"); fl.getDocumentDOM().screenOutline.setSelectedScreens(myArray, true);

395

Chapitre 38 : Objet Shape

Hritage

Objet Element > Objet Shape

Disponibilit Flash MX 2004. Description Lobjet Shape est une sous-classe de lobjet Element. Lobjet Shape offre un contrle plus prcis que les API de dessin pour la manipulation ou la cration de formes gomtriques sur la scne. Cette prcision du contrle est ncessaire pour permettre aux scripts de crer des effets utiles et autres commandes de dessin (voir Objet Element). Pour fonctionner correctement, toutes les mthodes et proprits de Shape qui modifient une forme ou lun de ses composants doivent tre places entre des appels de shape.beginEdit() et shape.endEdit(). Rsum des mthodes Outre celles de lobjet Element, l'objet Shape gre les mthodes suivantes :
Mthode shape.getCubicSegmentPoints()
shape.getCubicSegmentPoints() shape.deleteEdge() shape.endEdit()

Description Renvoie un tableau de points dfinissant une courbe cubique. Dfinit le dbut dune session de modification. Supprime le bord spcifi. Dfinit la fin dune session de modification de la forme.

Rsum des proprits Outre celles de lobjet Element, l'objet Shape gre les proprits suivantes :
Proprit
shape.contours shape.edges shape.isDrawingObject shape.isGroup shape.isOvalObject

Description Lecture seule ; tableau des objets Contour de la forme (voir Objet Contour). Lecture seule ; tableau des objets Edge (voir Objet Edge). Lecture seule ; si sa valeur est true, la forme est un objet de dessin. Lecture seule ; si sa valeur est true, la forme est un groupe. Lecture seule ; si la valeur est true, la forme est un objet Oval de type primitif (cr l'aide de l'outil Ovale). Lecture seule ; si la valeur est true, la forme est un objet Rectangle de type primitif (cr l'aide de l'outil Rectangle). Tableau des objets du groupe actuellement slectionn. Lecture seule ; nombre de segments cubiques de la forme. Lecture seule ; tableau des objets Vertex (voir Objet Vertex).

shape.isRectangleObject

shape.members shape.numCubicSegments shape.vertices

EXTENSION DE FLASH CS4 PROFESSIONAL 396

Objet Shape

shape.beginEdit()
Disponibilit Flash MX 2004. Utilisation
shape.beginEdit()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui dfinit le dbut dune session de modification. Cette mthode doit tre appele avant toute commande modifiant lobjet Shape ou lun de ses composants. Exemple L'exemple suivant supprime le premier contour du tableau des contours dans la forme actuellement slectionne :
var shape = fl.getDocumentDOM().selection[0]; shape.beginEdit(); shape.deleteEdge(0); shape.endEdit();

shape.contours
Disponibilit Flash MX 2004. Utilisation
shape.contours

Description Proprit en lecture seule ; tableau d'objets Contour de la forme (voir Objet Contour). Exemple L'exemple suivant enregistre dans la variable c le premier contour du tableau des contours, puis enregistre lObjet halfEdge de ce contour dans la variable he :
var c = fl.getDocumentDOM().selection[0].contours[0]; var he = c.getHalfEdge();

EXTENSION DE FLASH CS4 PROFESSIONAL 397

Objet Shape

shape.deleteEdge()
Disponibilit Flash MX 2004. Utilisation
shape.deleteEdge(index)

Paramtres index Index en base zro qui spcifie le bord supprimer du tableau shape.edges. Cette mthode modifie la longueur du tableau shape.edges. Valeur renvoye Aucune. Description Mthode qui supprime le contour spcifi. Il est ncessaire dappeler shape.beginEdit()avant d'utiliser cette mthode. Exemple L'exemple suivant supprime le premier contour du tableau des contours de la forme actuellement slectionne :
var shape = fl.getDocumentDOM().selection[0]; shape.beginEdit(); shape.deleteEdge(0); shape.endEdit();

shape.edges
Disponibilit Flash MX 2004. Utilisation
shape.edges

Description Proprit en lecture seule ; tableau d'objets Edge (voir Objet Edge).

shape.endEdit()
Disponibilit Flash MX 2004. Utilisation
shape.endEdit()

EXTENSION DE FLASH CS4 PROFESSIONAL 398

Objet Shape

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui dfinit la fin dune session de modification. Toutes les modifications apportes lobjet Shape ou lun de ses composants sont appliques la forme. Cette mthode doit tre appele aprs toute commande modifiant lobjet Shape ou lun de ses composants. Exemple L'exemple suivant supprime le premier contour du tableau des contours dans la forme actuellement slectionne :
var shape = fl.getDocumentDOM().selection[0]; shape.beginEdit(); shape.deleteEdge(0); shape.endEdit();

shape.getCubicSegmentPoints()
Disponibilit Flash CS4 Professional. Utilisation
shape.getCubicSegmentPoints(cubicSegmentIndex)

Paramtres
cubicSegmentIndex Nombre entier qui spcifie le segment cubique pour lequel les points sont renvoys.

Valeur renvoye Tableau de points qui dfinit une courbe cubique pour l'objet Edge correspondant au cubicSegmentIndex spcifi (voir edge.cubicSegmentIndex). Description Mthode qui renvoie un tableau de points dfinissant une courbe cubique. Exemple L'exemple suivant affiche les valeurs x et y de chaque point de la courbe cubique du premier contour de la slection :
var var var for } elem = fl.getDocumentDOM().selection[0]; index = elem.edges[0].cubicSegmentIndex; cubicPoints = elem.getCubicSegmentPoints(index); (i=0; i<cubicPoints.length; i++) { fl.trace("index " + i +" x: " + cubicPoints[i].x

+ " y: " + cubicPoints[i].y);

EXTENSION DE FLASH CS4 PROFESSIONAL 399

Objet Shape

shape.isDrawingObject
Disponibilit Flash 8. Utilisation
shape.isDrawingObject

Description Proprit en lecture seule ; si elle est true, la forme est un objet de dessin. Exemple L'exemple suivant stocke dans la variable sel le premier objet slectionn, puis utilise les proprits element.elementType et shape.isDrawingObject pour dterminer si llment slectionn est un objet de dessin :
var sel = fl.getDocumentDOM().selection[0]; var shapeDrawingObject = (sel.elementType == "shape") && sel.isDrawingObject; fl.trace(shapeDrawingObject);

Voir aussi
document.crop(), document.deleteEnvelope(), document.intersect(), document.punch(), document.union(), shape.isGroup

shape.isGroup
Disponibilit Flash MX 2004. Utilisation
shape.isGroup

Description Proprit en lecture seule ; si elle est true, la forme est un groupe. Un groupe peut contenir diffrents types d'lments, par exemple des lments de texte et des symboles. Le groupe lui-mme est cependant considr comme une forme, et vous pouvez utiliser la proprit shape.isGroup quel que soit le type des lments du groupe. Exemple L'exemple suivant stocke dans la variable sel le premier objet slectionn, puis utilise les proprits element.elementType et shape.isGroup pour dterminer si llment slectionn est un groupe :
var sel = fl.getDocumentDOM().selection[0]; var shapeGroup = (sel.elementType == "shape") && sel.isGroup; fl.trace(shapeGroup);

Voir aussi
shape.isDrawingObject

EXTENSION DE FLASH CS4 PROFESSIONAL 400

Objet Shape

shape.isOvalObject
Disponibilit Flash CS3 Professional. Utilisation
shape.isOvalObject

Description Proprit en lecture seule ; si la valeur est true, la forme est un objet Oval de type primitif (cr l'aide de l'outil Primitive ovale). Exemple L'exemple suivant affiche "true" si le premier lment slectionn est un objet Oval de type primitif, "false" dans le cas contraire :
var sel = fl.getDocumentDOM().selection[0]; fl.trace(sel.isOvalObject);

Voir aussi
shape.isRectangleObject

shape.isRectangleObject
Disponibilit Flash CS3 Professional. Utilisation
shape.isRectangleObject

Description Proprit en lecture seule ; si la valeur est true, la forme est un objet Rectangle de type primitif (cr l'aide de l'outil Primitive rectangle). Exemple L'exemple suivant affiche "true" si le premier lment slectionn est un objet Rectangle de type primitif, "false" dans le cas contraire :
var sel = fl.getDocumentDOM().selection[0]; fl.trace(sel.isRectangleObject);

Voir aussi
shape.isOvalObject

EXTENSION DE FLASH CS4 PROFESSIONAL 401

Objet Shape

shape.members
Disponibilit Flash CS4 Professional. Utilisation
shape.members

Description Proprits en lecture seule ; tableau des objets du groupe actuellement slectionn. Cette proprit n'est disponible que si la valeur de shape.isGroup est true. Les formes brutes du groupe ne sont pas incluses dans le tableau shape.members. Par exemple, si le groupe contient trois objets de dessin et trois formes brutes, le tableau shape.members contient trois entres, une pour chaque objet de dessin. Si le groupe ne contient que des formes brutes, le tableau est vide. Exemple Le code suivant affiche le nombre de segments cubiques de chaque objet de dessin du groupe actuellement slectionn :
var shapesArray = fl.getDocumentDOM().selection[0].members; for (i=0; i<shapesArray.length; i++) { fl.trace(shapesArray[i].numCubicSegments); }

Voir aussi
shape.isGroup

shape.numCubicSegments
Disponibilit Flash CS4 Professional. Utilisation
shape.numCubicSegments

Description Proprit en lecture seule ; nombre de segments cubiques de la forme. Exemple En supposant qu'une forme carre ou rectangulaire soit slectionne, le code suivant affiche 4 dans le panneau Sortie :
var theShape = fl.getDocumentDOM().selection[0]; fl.trace(theShape.numCubicSegments);

EXTENSION DE FLASH CS4 PROFESSIONAL 402

Objet Shape

shape.vertices
Disponibilit Flash MX 2004. Utilisation
shape.vertices

Description Proprit en lecture seule ; tableau d'objets Vertex (voir Objet Vertex). Exemple L'exemple suivant stocke le premier objet slectionn dans la variable someShape, puis affiche son nombre de sommets dans le panneau Sortie :
var someShape = fl.getDocumentDOM().selection[0]; fl.trace("The shape has " + someShape.vertices.length + " vertices.");

403

Chapitre 39 : Objet SoundItem

Hritage

Objet Item > Objet SoundItem

Disponibilit Flash MX 2004. Description Lobjet SoundItem est une sous-classe de lobjet Item. Il reprsente un lment de bibliothque qui est utilis pour crer un son. Voir aussi frame.soundLibraryItem et Objet Item. Rsum des mthodes Outre les mthodes de l'objet Item, l'objet SoundItem gre la mthode suivante :
Proprit
soundItem.exportToFile()

Description Exporte l'lment spcifi dans un fichier QuickTime sous Macintosh, ou dans un fichier WAV ou QT sous Windows.

Rsum des proprits Outre celles de lobjet Item, l'objet SoundItem gre les proprits suivantes :
Proprit
soundItem.bitRate

Description Chane spcifiant la vitesse de transfert dun son figurant dans la bibliothque. Uniquement disponible pour la compression MP3. Chane spcifiant la vitesse de transfert dun son enregistr avec compression en ADPCM et figurant dans la bibliothque. Chane spcifiant le type de compression dun son figurant dans la bibliothque. Valeur boolenne uniquement disponible pour les types de compression MP3 et Raw. Lecture seule ; chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1er janvier 1970 et la date de modification du fichier original (sur disque) au moment o il a t import dans la bibliothque. Lecture seule ; chane indiquant si l'lment spcifi est import sous forme de fichier mp3. Chane spcifiant la qualit de lecture dun son figurant dans la bibliothque. Uniquement disponible pour la compression MP3. Chane spcifiant la frquence d'chantillonnage du clip audio. Lecture seule ; valeur boolenne qui spcifie si le fichier import dans la bibliothque existe toujours l'emplacement d'o il provient.

soundItem.bits

soundItem.compressionType

soundItem.convertStereoToMono

soundItem.fileLastModifiedDate

soundItem.originalCompressionType

soundItem.quality

soundItem.sampleRate soundItem.sourceFileExists

EXTENSION DE FLASH CS4 PROFESSIONAL 404

Objet SoundItem

Proprit
soundItem.sourceFileIsCurrent

Description Lecture seule ; valeur boolenne qui spcifie si la date de modification du fichier de l'lment de la bibliothque correspond celle trouve sur le disque du fichier import. Lecture seule ; chane de type fichier:///URI qui reprsente le chemin et le nom du fichier import dans la bibliothque. Valeur boolenne ; si elle est true, toutes les autres proprits sont ignores, et la qualit MP3 importe est utilise.

soundItem.sourceFilePath

soundItem.useImportedMP3Quality

soundItem.bitRate
Disponibilit Flash MX 2004. Utilisation
soundItem.bitRate

Description Proprit ; chane spcifiant la vitesse de transfert dun son figurant dans la bibliothque. Cette proprit est uniquement disponible pour la compression MP3. Les valeurs gres sont "8Kbits/s", "16Kbits/s", "20Kbits/s", "24Kbits/s", "32Kbits/s", "48Kbits/s", "56Kbits/s", "64Kbits/s", "80Kbits/s", "112Kbits/s", "128Kbits/s" et "160Kbits/s". Les sons stro exports 8 ou 16 Kbits/s sont convertis en mono. Cette proprit a la valeur undefined pour les autres types de compression. Si vous voulez spcifier une valeur pour cette proprit, dfinissez soundItem.useImportedMP3Quality sur false. Exemple L'exemple suivant affiche la valeur de la proprit bitRate dans le panneau Sortie si llment spcifi possde le type de compression MP3 :
alert(fl.getDocumentDOM().library.items[0].bitRate);

Voir aussi
soundItem.compressionType, soundItem.convertStereoToMono

soundItem.bits
Disponibilit Flash MX 2004. Utilisation
soundItem.bits

EXTENSION DE FLASH CS4 PROFESSIONAL 405

Objet SoundItem

Description Proprit ; chane spcifiant la vitesse de transfert dun son enregistr avec compression ADPCM et figurant dans la bibliothque. Les valeurs gres sont les suivantes : "2bit", "3bit", "4bit" et "5bit". Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez soundItem.useImportedMP3Quality sur
false.

Exemple L'exemple suivant affiche le nombre de bits de transfert dans le panneau Sortie si llment actuellement slectionn dans la bibliothque possde le type de compression ADPCM :
alert(fl.getDocumentDOM().library.items[0].bits);

Voir aussi
soundItem.compressionType

soundItem.compressionType
Disponibilit Flash MX 2004. Utilisation
soundItem.compressionType

Description Proprit ; chane spcifiant le type de compression dun son figurant dans la bibliothque. Les valeurs possibles sont : "Default", "ADPCM", "MP3","Raw" (brut) et "Speech" (parole). Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez soundItem.useImportedMP3Quality sur
false.

Exemple L'exemple suivant modifie le type de compression dun lment de la bibliothque en lui donnant la valeur Raw :
fl.getDocumentDOM().library.items[0].compressionType = "Raw";

L'exemple suivant modifie le type de compression des lments de la bibliothque en leur donnant la valeurSpeech :
fl.getDocumentDOM().library.getSelectedItems().compressionType = "Speech";

Voir aussi
soundItem.originalCompressionType

soundItem.convertStereoToMono
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 406

Objet SoundItem

Utilisation
soundItem.convertStereoToMono

Description Proprit ; valeur boolenne uniquement disponible pour les types de compression MP3 et Raw. Si la valeur de cette proprit est true, les sons stro sont convertis en mono ; si elle est false le son stro est prserv. Pour le type de compression MP3, si soundItem.bitRate est infrieur 20 Kbps/s, cette proprit n'est pas prise en compte et prend la valeur true (voir soundItem.bitRate). Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez soundItem.useImportedMP3Quality sur
false.

Exemple L'exemple suivant convertit en mono un lment de la bibliothque si cet lment possde le type de compression MP3 ou Raw :
fl.getDocumentDOM().library.items[0].convertStereoToMono = true;

Voir aussi
soundItem.compressionType

soundItem.exportToFile()
Disponibilit Flash CS4 Professional. Utilisation
soundItem.exportToFile(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et spcifiant le chemin et le nom du fichier export. Valeur renvoye Valeur boolenne true si le fichier a bien t export, false dans le cas contraire. Description Mthode qui exporte l'lment spcifi dans un fichier QuickTime sous Macintosh, ou dans un fichier WAV ou QT sous Windows. Les fichiers QuickTime ou QT exports ne contiennent que du son ; la vido n'est pas exporte. Les paramtres d'exportation dpendent de l'lment export. Exemple En supposant que le premier lment de la bibliothque soit un lment audio, le code suivant l'exporte sous forme de fichier WAV :
var soundFileURL = "file:///C|/out.wav"; var libItem = fl.getDocumentDOM().library.items[0]; libItem.exportToFile(soundFileURL);

EXTENSION DE FLASH CS4 PROFESSIONAL 407

Objet SoundItem

soundItem.fileLastModifiedDate
Disponibilit Flash CS4 Professional. Utilisation
soundItem.fileLastModifiedDate

Description Proprit en lecture seule ; chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1er janvier 1970 et la date de modification du fichier original (sur disque) au moment o le fichier a t import dans la bibliothque. Si le fichier n'existe plus, cette valeur est 00000000 . Exemple En supposant que le premier lment de la bibliothque soit un lment audio, le code suivant affiche un nombre hexadcimal tel que dcrit ci-dessus :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("Mod date when imported = " + libItem.fileLastModifiedDate);

Voir aussi
soundItem.sourceFileExists, soundItem.sourceFileIsCurrent, soundItem.sourceFilePath, FLfile.getModificationDate()

soundItem.originalCompressionType
Disponibilit Flash CS4 Professional. Utilisation
soundItem.originalCompressionType

Description Proprit en lecture seule ; chane indiquant si l'lment spcifi est import sous forme de fichier mp3. Les valeurs possibles de cette proprit sont RAW et MP3 . Exemple En supposant que le premier lment de la bibliothque soit un lment audio, le code suivant affiche MP3 si le fichier a t import dans la bibliothque sous forme de fichier MP3, ou RAW si ce n'est pas le cas :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("Imported compression type = "+ libItem.originalCompressionType);

Voir aussi
soundItem.compressionType

EXTENSION DE FLASH CS4 PROFESSIONAL 408

Objet SoundItem

soundItem.quality
Disponibilit Flash MX 2004. Utilisation
soundItem.quality

Description Proprit ; chane spcifiant la qualit de lecture dun son figurant dans la bibliothque. Cette proprit est uniquement disponible pour la compression MP3. Les valeurs gres sont : "Fast" (rapide), "Medium" (moyenne) et "Best" (optimale). Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez soundItem.useImportedMP3Quality sur false. Exemple L'exemple suivant dfinit sur Best la qualit de lecture dun lment de la bibliothque si cet lment possde le type de compression MP3 :
fl.getDocumentDOM().library.items[0].quality = "Best";

Voir aussi
soundItem.compressionType

soundItem.sampleRate
Disponibilit Flash MX 2004. Utilisation
soundItem.sampleRate

Description Proprit ; chane spcifiant la frquence d'chantillonnage du clip audio. Cette proprit est rserve aux types de compression ADPCM, Raw et Speech. Les valeurs gres sont "5kHz", "11kHz", "22kHz" et "44kHz". Si vous souhaitez spcifier une valeur pour cette proprit, dfinissez soundItem.useImportedMP3Quality sur false. Exemple L'exemple suivant dfinit le taux dchantillonnage dun lment de la bibliothque sur 5 kHz si cet lment possde le type de compression ADPCM, Raw ou Speech :
fl.getDocumentDOM().library.items[0].sampleRate = "5 kHz";

Voir aussi
soundItem.compressionType

EXTENSION DE FLASH CS4 PROFESSIONAL 409

Objet SoundItem

soundItem.sourceFileExists
Disponibilit Flash CS4 Professional. Utilisation
soundItem.sourceFileExists

Description Proprit en lecture seule : valeur boolenne true si le fichier import dans la bibliothque existe toujours l'emplacement d'o il provient ; false dans le cas contraire. Exemple En supposant que le premier lment de la bibliothque soit un lment audio, le code suivant affiche true si le fichier import dans la bibliothque existe toujours :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("sourceFileExists = "+ libItem.sourceFileExists);

Voir aussi
soundItem.sourceFileIsCurrent, soundItem.sourceFilePath

soundItem.sourceFileIsCurrent
Disponibilit Flash CS4 Professional. Utilisation
soundItem.sourceFileIsCurrent

Description Proprit en lecture seule ; valeur boolenne, true si la date de modification du fichier de l'lment de la bibliothque correspond la date de modification sur disque du fichier import ; false dans le cas contraire. Exemple En supposant que le premier lment de la bibliothque soit un lment audio, le code suivant affiche true si le fichier import n'a pas t modifi sur le disque depuis son importation :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("fileIsCurrent = "+ libItem.sourceFileIsCurrent);

Voir aussi
soundItem.fileLastModifiedDate, soundItem.sourceFilePath

EXTENSION DE FLASH CS4 PROFESSIONAL 410

Objet SoundItem

soundItem.sourceFilePath
Disponibilit Flash CS4 Professional. Utilisation
soundItem.sourceFilePath

Description Proprit en lecture seule : chane de type fichier:///URI qui reprsente le chemin et le nom du fichier import dans la bibliothque. Exemple L'exemple suivant affiche le nom et le chemin du fichier source de tout lment de la bibliothque de type "sound" :
for (idx in fl.getDocumentDOM().library.items) { if (fl.getDocumentDOM().library.items[idx].itemType == "sound") { var myItem = fl.getDocumentDOM().library.items[idx]; fl.trace(myItem.name + " source is " + myItem.sourceFilePath); } }

Voir aussi
soundItem.sourceFileExists

soundItem.useImportedMP3Quality
Disponibilit Flash MX 2004. Utilisation
soundItem.useImportedMP3Quality

Description Proprit ; valeur boolenne. Si elle est true, toutes les autres proprits sont ignores et la qualit du fichier MP3 import est utilise. Exemple L'exemple suivant modifie la qualit dun lment de la bibliothque en utilisant la qualit du fichier MP3 import :
fl.getDocumentDOM().library.items[0].useImportedMP3Quality = true;

Voir aussi
soundItem.compressionType

411

Chapitre 40 : Objet Stroke

Disponibilit Flash MX 2004. Description Lobjet Stroke contient tous les paramtres dun trait, y compris les paramtres personnaliss. Cet objet reprsente les informations contenues dans linspecteur Proprits. En combinant l'objet Stroke et la mthode document.setCustomStroke(), vous pouvez modifier les paramtres du trait pour le panneau Outils, l'inspecteur Proprits et la slection actuelle. A l'aide de la mthode document.getCustomStroke(), vous pouvez galement rcuprer les paramtres de trait configurs dans le panneau Outils, l'inspecteur Proprits et la slection actuelle. Cet objet comporte toujours les quatre proprits suivantes : style, thickness, color et breakAtCorners. (Dans Flash CS3, la proprit breakAtCorners a t dconseille en faveur destroke.joinType.) D'autres proprits peuvent tre dfinies, selon la valeur de la proprit stroke.style. Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Stroke :
Proprit
stroke.breakAtCorners

Description Valeur boolenne, identique au paramtre Angles saillants de la bote de dialogue personnalise Style de trait. Chane qui spcifie le type dextrmit du trait. Valeur hexadcimale ou entier reprsentant la couleur du trait. Chane spcifiant le type de trame du trait. Entier spcifiant la longueur de la partie pleine d'une ligne pointille. Entier spcifiant la longueur de la partie vide d'une ligne pointille. Chane spcifiant la densit d'une ligne pointille fine. Chane spcifiant la taille des points d'une ligne pointille fine. Entier spcifiant l'espacement des points d'une ligne pointille. Chane spcifiant l'paisseur d'une ligne trame. Chane spcifiant la proprit de dplacement d'une ligne trame. Chane qui spcifie le type de jointure du trait. Chane spcifiant la longueur d'une ligne trame. Nombre en virgule flottante spcifiant langle au-dessus duquel lextrmit de la pointe sera tronque par un segment. Chane spcifiant le motif d'une ligne irrgulire. Chane spcifiant la rotation d'une ligne trame. Chane spcifiant le type de redimensionnement appliquer au trait. Objet Fill qui reprsente les paramtres de remplissage du trait.

stroke.capType stroke.color stroke.curve stroke.dash1 stroke.dash2 stroke.density stroke.dotSize stroke.dotSpace stroke.hatchThickness stroke.jiggle stroke.joinType stroke.length stroke.miterLimit

stroke.pattern stroke.rotate stroke.scaleType stroke.shapeFill

EXTENSION DE FLASH CS4 PROFESSIONAL 412

Objet Stroke

Proprit
stroke.space stroke.strokeHinting stroke.style stroke.thickness stroke.variation stroke.waveHeight stroke.waveLength

Description Chane spcifiant l'espacement d'une ligne trame. Valeur boolenne indiquant si les repres de trait doivent tre activs pour ce trait. Chane dcrivant le style du trait. Nombre entier spcifiant la taille du trait. Chane spcifiant la variation d'une ligne pointille fine. Chane spcifiant la hauteur d'onde d'une ligne irrgulire. Chane spcifiant la longueur d'onde d'une ligne irrgulire.

stroke.breakAtCorners
Disponibilit Flash MX 2004. Dlaisse dans Flash 3 au profit de stroke.joinType. Utilisation
stroke.breakAtCorners

Description Proprit : valeur boolenne. Cette proprit est identique au paramtre Angles saillants de la bote de dialogue personnalise Style de trait. Exemple L'exemple suivant dfinit la proprit breakAtCorners sur true :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.breakAtCorners = true; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.capType
Disponibilit Flash 8. Utilisation
stroke.capType

Description Proprit ; chane qui spcifie le type d'extrmit du trait. Les valeurs acceptables sont "none" (aucune), "round" (arrondie) et "square" (carre). Exemple L'exemple suivant donne la valeur round au type dextrmit du trait :

EXTENSION DE FLASH CS4 PROFESSIONAL 413

Objet Stroke

var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.capType = "round"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.color
Disponibilit Flash MX 2004. Dans Flash 8 et les versions ultrieures, cette proprit est dlaisse au profit de stroke.shapeFill.color. Utilisation
stroke.color

Description Proprit ; couleur du trait, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Exemple L'exemple suivant dfinit la couleur du trait :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.color = "#000000"; fl.getDocumentDOM().setCustomStroke(myStroke);

Voir aussi
stroke.shapeFill

stroke.curve
Disponibilit Flash MX 2004. Utilisation
stroke.curve

Description Proprit ; chane spcifiant le type de trame du trait. Cette proprit ne peut tre dfinie que si la proprit stroke.style a la valeur "hatched" (voir stroke.style). Les valeurs possibles sont "straight", "slight curve", "medium curve" et "very curved". Exemple L'exemple suivant dfinit la proprit de courbe, entre autres, d'un trait ayant le style hatched :

EXTENSION DE FLASH CS4 PROFESSIONAL 414

Objet Stroke

var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "hatched"; myStroke.curve = "straight"; myStroke.space = "close"; myStroke.jiggle = "wild"; myStroke.rotate = "free"; myStroke.length = "slight"; myStroke.hatchThickness = "thin"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.dash1
Disponibilit Flash MX 2004. Utilisation
stroke.dash1

Description Proprit ; entier spcifiant la longueur de la partie pleine d'une ligne pointille. Cette proprit n'est disponible que si la proprit stroke.style a la valeur dashed (voir stroke.style). Exemple L'exemple suivant dfinit les proprits dash1 et dash2 pour le style de trait dashed :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "dashed"; myStroke.dash1 = 1; myStroke.dash2 = 2; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.dash2
Disponibilit Flash MX 2004. Utilisation
stroke.dash2

Description Proprit ; entier spcifiant la longueur de la partie vide d'une ligne pointille. Cette proprit n'est disponible que si la proprit stroke.style a la valeur dashed (voir stroke.style). Exemple Voir stroke.dash1.

EXTENSION DE FLASH CS4 PROFESSIONAL 415

Objet Stroke

stroke.density
Disponibilit Flash MX 2004. Utilisation
stroke.density

Description Proprit ; chane spcifiant la densit d'une ligne pointille fine. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur stipple (voir stroke.style). Les valeurs possibles sont "very dense", "dense", "sparse" et "very sparse". Exemple L'exemple suivant dfinit sur sparse la proprit de densit du style de trait stipple :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "stipple"; myStroke.dotSpace= 3; myStroke.variation = "random sizes"; myStroke.density = "sparse"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.dotSize
Disponibilit Flash MX 2004. Utilisation
stroke.dotSize

Description Proprit ; chane spcifiant la taille des points d'une ligne pointille fine. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur stipple (voir stroke.style). Les valeurs possibles sont "tiny", "small", "medium" et "large". L'exemple suivant dfinit sur tiny la proprit dotSize du style de trait de stipple :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "stipple"; myStroke.dotSpace= 3; myStroke.dotsize = "tiny"; myStroke.variation = "random sizes"; myStroke.density = "sparse"; fl.getDocumentDOM().setCustomStroke(myStroke);

EXTENSION DE FLASH CS4 PROFESSIONAL 416

Objet Stroke

stroke.dotSpace
Disponibilit Flash MX 2004. Utilisation
stroke.dotSpace

Description Proprit ; entier spcifiant l'espacement des points d'une ligne pointille. Cette proprit nest disponible que si la proprit stroke.style a pour valeur dotted. Voir stroke.style. Exemple L'exemple suivant donne la valeur 3 la proprit dotSpace pour le style de trait dotted :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "dotted"; myStroke.dotSpace= 3; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.hatchThickness
Disponibilit Flash MX 2004. Utilisation
stroke.hatchThickness

Description Proprit ; chane spcifiant l'paisseur d'une ligne trame. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur hatched (voir stroke.style). Les valeurs possibles sont "hairline", "thin", "medium" et "thick". Exemple L'exemple suivant donne la valeur thin la proprit hatchThickness du style de trait hatched :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "hatched"; myStroke.curve = "straight"; myStroke.space = "close"; myStroke.jiggle = "wild"; myStroke.rotate = "free"; myStroke.length = "slight"; myStroke.hatchThickness = "thin"; fl.getDocumentDOM().setCustomStroke(myStroke);

EXTENSION DE FLASH CS4 PROFESSIONAL 417

Objet Stroke

stroke.jiggle
Disponibilit Flash MX 2004. Utilisation
stroke.jiggle

Description Proprit ; chane spcifiant la proprit de dplacement d'une ligne trame. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur hatched (voir stroke.style). Les valeurs possibles sont "none", "bounce", "loose" et "wild". Exemple L'exemple suivant donne la valeur wild la proprit jiggle du style de trait hatched :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "hatched"; myStroke.curve = "straight"; myStroke.space = "close"; myStroke.jiggle = "wild"; myStroke.rotate = "free"; myStroke.length = "slight"; myStroke.hatchThickness = "thin"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.joinType
Disponibilit Flash 8. Utilisation
stroke.joinType

Description Proprit ; chane qui spcifie le type de jointure du trait. Les valeurs gres sont "miter" (pointe), "round" (arrondie) et "bevel" (biseau). Voir aussi
stroke.capType

stroke.length
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 418

Objet Stroke

Utilisation
stroke.length

Description Proprit ; chane spcifiant la longueur d'une ligne trame. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur hatched (voir stroke.style). Les valeurs possibles sont "equal", "slight", "variation", "medium variation" et "random". Exemple L'exemple suivant donne la valeur slight la proprit length du style de trait hatched :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "hatched"; myStroke.curve = "straight"; myStroke.space = "close"; myStroke.jiggle = "wild"; myStroke.rotate = "free"; myStroke.length = "slight"; myStroke.hatchThickness = "thin"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.miterLimit
Disponibilit Flash 8. Utilisation
stroke.miterLimit

Description Proprit ; nombre en virgule flottante spcifiant l'angle au-dessus duquel l'extrmit de la pointe sera tronque par un segment. Cela signifie que la pointe ne sera tronque que si son angle est suprieur la valeur transmise dans miterLimit. Exemple L'exemple suivant donne la valeur 3 la limite de pointe du trait. Si langle de la pointe est suprieur 3, la pointe est tronque.
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.miterLimit = 3; var myStroke = fl.getDocumentDOM().setCustomStroke();

stroke.pattern
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 419

Objet Stroke

Utilisation
stroke.pattern

Description Proprit ; chane spcifiant le motif d'une ligne irrgulire. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur ragged (voir stroke.style). Les valeurs possibles sont "solid", "simple", "random", "dotted", "random dotted", "triple dotted" et "random triple dotted". Exemple L'exemple suivant donne la valeur random la proprit pattern du style de trait ragged :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "ragged"; myStroke.pattern = "random"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.rotate
Disponibilit Flash MX 2004. Utilisation
stroke.rotate

Description Proprit ; chane spcifiant la rotation d'une ligne trame. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur hatched (voir stroke.style). Les valeurs possibles sont "none", "slight", "medium" et "free". Exemple L'exemple suivant donne la valeur free la proprit rotate du style de trait hatched :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "hatched"; myStroke.curve = "straight"; myStroke.space = "close"; myStroke.jiggle = "wild"; myStroke.rotate = "free"; myStroke.length = "slight"; myStroke.hatchThickness = "thin";

stroke.scaleType
Disponibilit Flash 8.

EXTENSION DE FLASH CS4 PROFESSIONAL 420

Objet Stroke

Utilisation
stroke.scaleType

Description Proprit ; chane qui spcifie le type de redimensionnement appliquer au trait. Les valeurs gres sont "normal", "horizontal", "vertical" et "none". Exemple L'exemple suivant dfinit le type de dimensionnement du trait sur horizontal :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.scaleType = "horizontal"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.shapeFill
Disponibilit Flash 8. Utilisation
stroke.shapeFill

Description Proprit ; objet Objet Fill qui reprsente le remplissage du trait. Exemple L'exemple suivant spcifie les paramtres du remplissage et les applique au trait :
var fill = fl.getDocumentDOM().getCustomFill(); fill.linearGradient = true; fill.colorArray = [ 00ff00, ff0000, fffff ]; var stroke = fl.getDocumentDOM().getCustomStroke(); stroke.shapeFill = fill; fl.getDocumentDOM().setCustomStroke(stroke);

stroke.space
Disponibilit Flash MX 2004. Utilisation
stroke.space

Description Proprit ; chane spcifiant l'espacement d'une ligne trame. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur hatched (voir stroke.style). Les valeurs possibles sont "very close", "close", "distant" et "very distant".

EXTENSION DE FLASH CS4 PROFESSIONAL 421

Objet Stroke

Exemple L'exemple suivant donne la valeur close la proprit space du style de trait hatched :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "hatched"; myStroke.curve = "straight"; myStroke.space = "close"; myStroke.jiggle = "wild"; myStroke.rotate = "free"; myStroke.length = "slight"; myStroke.hatchThickness = "thin"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.strokeHinting
Disponibilit Flash 8. Utilisation
stroke.strokeHinting

Description Proprit ; valeur boolenne indiquant si les repres de trait doivent tre activs pour ce trait. Exemple L'exemple suivant active les repres de trait pour ce trait :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.strokeHinting = true; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.style
Disponibilit Flash MX 2004. Utilisation
stroke.style

Description Proprit ; chane dcrivant le style de trait. Les valeurs possibles sont "noStroke","solid", "dashed", "dotted", "ragged", "stipple" et "hatched". Certaines de ces valeurs ncessitent que des proprits complmentaires de l'objet Stroke soient dfinies, comme dcrit dans la liste suivante :

Si cette proprit a la valeur "solid" ou "noStroke", il n'existe pas d'autre proprit. Si la valeur est dashed, deux proprits supplmentaires sont prsentes : dash1 et dash2. Si cette proprit a la valeur dotted, la proprit supplmentaire dotSpace est prsente.

EXTENSION DE FLASH CS4 PROFESSIONAL 422

Objet Stroke

Si la valeur est "ragged", trois proprits supplmentaires, pattern, waveHeight et waveLength, sont prsentes. Si la valeur est "stipple", trois proprits supplmentaires, dotSize, variation et density, sont prsentes. Si la valeur est "hatched", six proprits supplmentaires sont prsentes : hatchThickness, space, jiggle,
rotate, curve et length.

Exemple L'exemple suivant donne la valeur ragged au style de trait :

var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "ragged"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.thickness
Disponibilit Flash MX 2004. Utilisation
stroke.thickness

Description Proprit ; nombre entier spcifiant la taille du trait. Exemple L'exemple suivant donne la valeur 2 la proprit thickness du trait :
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.thickness = 2; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.variation
Disponibilit Flash MX 2004. Utilisation
stroke.variation

Description Proprit ; chane spcifiant la variation d'une ligne pointille fine. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur stipple (voir stroke.style). Les valeurs possibles sont "one size", "small variation", "varied sizes" et "random sizes". Exemple L'exemple suivant donne la valeur random sizes la proprit de variation du style de trait stipple :

EXTENSION DE FLASH CS4 PROFESSIONAL 423

Objet Stroke

var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "stipple"; myStroke.dotSpace= 3; myStroke.variation = "random sizes"; myStroke.density = "sparse"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.waveHeight
Disponibilit Flash MX 2004. Utilisation
stroke.waveHeight

Description Proprit ; chane spcifiant la hauteur d'onde d'une ligne irrgulire. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur ragged (voir stroke.style). Les valeurs possibles sont "flat", "wavy", "very wavy" et "wild". Exemple L'exemple suivant donne la valeur flat la proprit waveHeight du style de trait ragged:
var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "ragged"; myStroke.pattern = "random"; myStroke.waveHeight = "flat"; myStroke.waveLength = "short"; fl.getDocumentDOM().setCustomStroke(myStroke);

stroke.waveLength
Disponibilit Flash MX 2004. Utilisation
stroke.waveLength

Description Proprit ; chane spcifiant la longueur d'onde d'une ligne irrgulire. Cette proprit est disponible uniquement si la proprit stroke.style a la valeur ragged (voir stroke.style). Les valeurs possibles sont "very short", "short", "medium" et "long". Exemple L'exemple suivant donne la valeur short la proprit waveLength du style de trait ragged :

EXTENSION DE FLASH CS4 PROFESSIONAL 424

Objet Stroke

var myStroke = fl.getDocumentDOM().getCustomStroke(); myStroke.style = "ragged"; myStroke.pattern = "random"; myStroke.waveHeight = 'flat"; myStroke.waveLength = "short"; fl.getDocumentDOM().setCustomStroke(myStroke);

425

Chapitre 41 : Objet swfPanel

Disponibilit Flash CS4 Professional. Description Lobjet swfPanel reprsente un panneau Window SWF. Les panneaux Window SWF sont des fichiers SWF qui implmentent les applications que vous pouvez excuter depuis l'environnement de programmation Flash. Ils sont disponibles depuis le menu Fentre > Autres panneaux. Par dfaut, les panneaux Window SWF sont stocks dans un sous-dossier du dossier Configuration (voir Enregistrement des fichiers JSFL la page 2). Par exemple, sous Windows XP, le chemin du dossier est lecteur d'amorage\Documents and Settings\utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\WindowSWF. Un exemple de panneau Window SWF est disponible ; voir Exemple du panneau de trac de bitmap la page 14. Le tableau des panneaux Window SWF enregistrs est stock dans la proprit fl.swfPanels. Rsum des mthodes L'objet swfPanel gre la mthode suivante :
Mthode
swfPanel.call()

Description Fonctionne en combinaison avec les mthodes ActionScript ExternalInterface.addCallback() et MMExecute() pour communiquer avec le panneau SWF depuis l'environnement de programmation.

Rsum des proprits L'objet swfPanel gre les proprits suivantes :

Proprit swfPanel.name swfPanel.path Description Lecture seule ; chane reprsentant le nom du panneau Window SWF spcifi. Lecture seule ; chane reprsentant le chemin du fichier SWF utilis dans le panneau Window SWF spcifi.

swfPanel.call()
Disponibilit Flash CS4 Professional. Utilisation
swfPanel.call(request)

Paramtres request Paramtres transmettre la fonction (voir la description et l'exemple ci-dessous). Valeur renvoye null ou une chane renvoye par l'appel de la fonction. Le rsultat de la fonction peut tre une chane vide.

EXTENSION DE FLASH CS4 PROFESSIONAL 426

Objet swfPanel

Description Mthode qui fonctionne en combinaison avec les mthodes ActionScript ExternalInterface.addCallback() et MMExecute() pour communiquer avec le panneau SWF depuis l'environnement de programmation. Exemple L'exemple suivant dcrit l'utilisation de code ActionScript et JavaScript pour la cration d'un panneau Window SWF et la communication avec ce dernier depuis l'environnement de programmation.
1 Crez un fichier FLA ActionScript 3.0 et dfinissez sa couleur sur gris clair et sa taille sur 400 pixels de large et 250

pixels de haut.
2 Placez un champ de texte dynamique au centre de la scne, dfinissez son nom d'occurrence sur myTextField et

entrez Status dans le champ de texte.

3 Dfinissez les autres proprits de champs de texte de la faon suivante :

Centr 355 pixels de large et 46 pixels de haut Police Times New Roman, 28 points, rouge
4 Ajoutez le code ActionScript suivant :
// Here's the callback function to be called from JSAPI function callMeFromJavascript(arg:String):void { try { var name:String = String(arg); myTextField.text = name; } catch (e:Error) { } } // Expose the callback function as "callMySWF" ExternalInterface.addCallback("callMySWF", callMeFromJavascript); // run the JSAPI to wire up the callback MMExecute("fl.runScript( fl.configURI + \"WindowSWF/fileOp.jsfl\" );"); MMExecute("fl.trace(\"AS3 File Status Panel Initialized\");");

5 Enregistrez le fichier sous le nom fileStatus.fla, et publiez le fichier SWF avec les paramtres de publication par

dfaut.
6 Fermez Flash. 7 Copiez le fichier fileStatus.swf dans le dossier WindowSWF, un sous-dossier du dossier Configuration (voir

Enregistrement des fichiers JSFL la page 2). Par exemple, sous Windows XP, le chemin du dossier est lecteur d'amorage\Documents and Settings\utilisateur\Local Settings\Application Data\Adobe\Flash CS4\langue\Configuration\WindowSWF.
8 Dmarrez Flash. 9 Crez un fichier JSFL avec le code suivant :

EXTENSION DE FLASH CS4 PROFESSIONAL 427

Objet swfPanel

function callMyPanel(panelName, arg) { if(fl.swfPanels.length > 0){ for(x = 0; x < fl.swfPanels.length; x++){ // look for a SWF panel of the specified name, then call the specified AS3 function // in this example, the panel is named "test" and the AS3 callback is "callMySWF" if(fl.swfPanels[x].name == panelName) // name busted? { fl.swfPanels[x].call("callMySWF",arg); break; } } } else fl.trace("no panels"); }

// define the various handlers for events documentClosedHandler = function () { callMyPanel("fileStatus", "Document Closed");}; fl.addEventListener("documentClosed", documentClosedHandler ); var dater = "New Document"; documentNewHandler = function () { callMyPanel("fileStatus", dater );}; fl.addEventListener("documentNew", documentNewHandler ); documentOpenedHandler = function () { callMyPanel("fileStatus", "Document Opened");}; fl.addEventListener("documentOpened", documentOpenedHandler );

10 Enregistrez le fichier JSFL dans le mme rpertoire que le fichier SWF, sous le nom fileOp.jsfl. 11 Slectionnez Fentre > Autres panneaux > fileStatus.

A prsent, lorsque vous crez, ouvrez et fermez des fichiers FLA, le panneau fileStatus affiche un message indiquant l'action effectue.

swfPanel.name
Disponibilit Flash CS4 Professional. Utilisation
swfPanel.name

Description Proprit en lecture seule ; chane reprsentant le nom du panneau Window SWF spcifi. Exemple Le code suivant affiche le nom du premier panneau Window SWF enregistr dans le panneau Sortie :
fl.trace(fl.swfPanels[0].name);

EXTENSION DE FLASH CS4 PROFESSIONAL 428

Objet swfPanel

Voir aussi
swfPanel.path, fl.swfPanels

swfPanel.path
Disponibilit Flash CS4 Professional. Utilisation
swfPanel.path

Description Proprit en lecture seule ; chane reprsentant le chemin du fichier SWF utilis dans le panneau Window SWF spcifi. Exemple Le code suivant affiche dans le panneau Sortie le chemin du fichier SWF utilis dans le premier panneau Window SWF enregistr :
fl.trace(fl.swfPanels[0].path);

Voir aussi
swfPanel.name, fl.swfPanels

429

Chapitre 42 : Objet SymbolInstance

Hritage

Objet Element > Objet Instance > Objet SymbolInstance

Disponibilit Flash MX 2004. Description SymbolInstance est une sous-classe de l'objet Instance et reprsente un symbole dans une image (voir Objet Instance). Rsum des proprits Outre celles de l'objet Instance, l'objet SymbolInstance possde les proprits suivantes :
Proprit
symbolInstance.accName symbolInstance.actionScript symbolInstance.blendMode symbolInstance.buttonTracking

Description Chane quivalente au champ Nom du panneau Accessibilit. Chane qui spcifie les actions affectes au symbole. Chane qui spcifie le mode de fondu appliquer un symbole de clip. Chane qui dfinit, pour les symboles de bouton uniquement, la mme proprit que le menu contextuel 'Traiter comme bouton' ou 'Traiter comme lment de menu' dans linspecteur Proprits. Valeur boolenne spcifiant si la mise en cache des bitmaps l'excution est active ou non. Entier spcifiant une partie de la transformation de couleur de loccurrence, en indiquant la valeur des paramtres avancs de leffet Alpha; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles qui apparaissent droite dans la bote de dialogue. Entier spcifiant certaines parties de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue. Entier spcifiant une partie de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits. Entier spcifiant une partie de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits de l'occurrence, suivie du rglage des contrles qui apparaissent gauche dans la bote de dialogue Entier spcifiant une partie de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits. Les valeurs autorises sont comprises entre -255 et 255. Partie de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue.

symbolInstance.cacheAsBitmap

symbolInstance.colorAlphaAmount

symbolInstance.colorAlphaPercent

symbolInstance.colorBlueAmount

symbolInstance.colorBluePercent

symbolInstance.colorGreenAmount

symbolInstance.colorGreenPercent

EXTENSION DE FLASH CS4 PROFESSIONAL 430

Objet SymbolInstance

Proprit
symbolInstance.colorMode

Description Chane spcifiant le mode colorimtrique tel quil est identifi dans le menu contextuel Couleurs de linspecteur Proprits du symbole. Entier spcifiant une partie de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits de l'occurrence. Partie de la transformation de couleur de loccurrence ; quivalent lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue. Chane quivalente au champ Description du panneau Accessibilit. Tableau d'objets Filter (voir Objet Filter). Entier en base zro indiquant la premire image qui doit apparatre dans le scnario du graphique. Valeur boolenne qui active ou dsactive laccessibilit aux enfants de lobjet ; quivalente linverse de la fonction Rendre les objets enfant accessibles dans le panneau Accessibilit. Chane qui dfinit, pour les symboles graphiques, la mme proprit que le menu contextuel Boucle de linspecteur Proprits. Chane quivalente la touche de raccourci associe au symbole, ainsi quau champ Raccourci dans le panneau Accessibilit. Valeur boolenne qui active et dsactive laccessibilit lobjet ; quivalente linverse de la fonction Rendre l'objet accessible dans le panneau Accessibilit. Chane spcifiant le type du symbole, quivalente la valeur du champ Comportement dans les botes de dialogue Crer un nouveau symbole et Convertir en symbole. Entier quivalent au champ Index de tabulation du panneau Accessibilit.

symbolInstance.colorRedAmount

symbolInstance.colorRedPercent

symbolInstance.description symbolInstance.filters symbolInstance.firstFrame

symbolInstance.forceSimple

symbolInstance.loop

symbolInstance.shortcut

symbolInstance.silent

symbolInstance.symbolType

symbolInstance.tabIndex

symbolInstance.accName
Disponibilit Flash MX 2004. Utilisation
symbolInstance.accName

Description Proprit ; chane quivalente au champ Nom du panneau Accessibilit. Les logiciels de lecture vocale identifient lobjet en prononant ce nom. Cette proprit n'est pas disponible pour les symboles graphiques. Exemple L'exemple suivant enregistre dans la variable theName la valeur du nom de lobjet dans le panneau Accessibilit :
var theName = fl.getDocumentDOM().selection[0].accName;

L'exemple suivant donne la valeur Home Button au nom de lobjet dans le panneau Accessibilit :

EXTENSION DE FLASH CS4 PROFESSIONAL 431

Objet SymbolInstance

fl.getDocumentDOM().selection[0].accName = "Home Button";

symbolInstance.actionScript
Disponibilit Flash MX 2004. Utilisation
symbolInstance.actionScript

Description Proprit ; chane qui spcifie les actions affectes au symbole. Elle ne sapplique quaux occurrences de clip et de bouton. Pour une occurrence de symbole graphique, la valeur renvoye est undefined. Exemple L'exemple suivant affecte une action onClipEvent au premier lment de la premire image du premier calque du scnario :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].actionScript = "onClipEvent(enterFrame) {trace('movie clip enterFrame');}";

symbolInstance.blendMode
Disponibilit Flash 8. Utilisation
symbolInstance.blendMode

Description Proprit ; chane qui spcifie le mode de fondu appliquer un symbole de clip. Les valeurs gres sont "normal", "layer", "multiply", "screen", "overlay", "hardlight", "lighten", "darken", "difference", "add", "subtract", "invert", "alpha" et "erase". Exemple L'exemple suivant dfinit le mode de fondu du premier symbole de clip dans la premire image du premier niveau sur add :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].blendMode = "add";

Voir aussi
document.setBlendMode()

EXTENSION DE FLASH CS4 PROFESSIONAL 432

Objet SymbolInstance

symbolInstance.buttonTracking
Disponibilit Flash MX 2004. Utilisation
symbolInstance.buttonTracking

Description Proprit ; chane qui dfinit, pour les symboles de bouton uniquement, la mme proprit que le menu contextuel 'Traiter comme bouton' ou 'Traiter comme lment de menu' dans linspecteur Proprits. Pour les autres types de symboles, cette proprit est ignore. Les valeurs gres sont "button" ou "menu". Exemple L'exemple suivant donne au premier symbole de la premire image du premier calque du scnario la valeur 'Traiter comme lment de menu', dans la mesure o ce symbole est un bouton :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].buttonTracking = "menu";

symbolInstance.cacheAsBitmap
Disponibilit Flash 8. Utilisation
symbolInstance.cacheAsBitmap

Description Proprit ; valeur boolenne spcifiant si la mise en cache des bitmaps l'excution est active ou non. Exemple L'exemple suivant active la mise en cache des bitmaps l'excution pour le premier lment de la premire image du premier calque :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].cacheAsBitmap = true;

symbolInstance.colorAlphaAmount
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorAlphaAmount

EXTENSION DE FLASH CS4 PROFESSIONAL 433

Objet SymbolInstance

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence, en indiquant la valeur des paramtres avancs de leffet Alpha. Cette proprit quivaut lutilisation de lentre de menu Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles qui apparaissent droite dans la bote de dialogue. Cette valeur diminue ou augmente dun niveau constant les valeurs dalpha et de teinte. Cette valeur est ajoute la valeur actuelle. Cette proprit est plus utile si elle employe avec symbolInstance.colorAlphaPercent. Les valeurs autorises sont comprises entre -255 et 255. Exemple L'exemple suivant soustrait la valeur 100 du paramtre alpha de loccurrence de symbole slectionne :
fl.getDocumentDOM().selection[0].colorAlphaAmount = -100;

symbolInstance.colorAlphaPercent
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorAlphaPercent

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit quivaut lutilisation de la commande Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue. Cette valeur spcifie le nouveau pourcentage de teinte et dalpha. Les valeurs autorises sont comprises entre -100 et 100. Voir aussi symbolInstance.colorAlphaAmount. Exemple Lexemple suivant dfinit sur 80 la valeur de la proprit colorAlphaPercent de loccurrence de symbole slectionne :
fl.getDocumentDOM().selection[0].colorAlphaPercent = 80;

symbolInstance.colorBlueAmount
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorBlueAmount

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit est quivalente au paramtre Couleur > Avanc dans l'inspecteur Proprits de l'occurrence. Les valeurs autorises sont comprises entre -255 et 255.

EXTENSION DE FLASH CS4 PROFESSIONAL 434

Objet SymbolInstance

symbolInstance.colorBluePercent
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorBluePercent

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit quivaut lutilisation de la commande Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue. Cette valeur spcifie le nouveau pourcentage de bleu. Les valeurs autorises sont comprises entre -100 et 100. Exemple Lexemple suivant dfinit sur 80 la valeur de la proprit colorBluePercent de loccurrence de symbole slectionne :
fl.getDocumentDOM().selection[0].colorBluePercent = 80;

symbolInstance.colorGreenAmount
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorGreenAmount

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit est quivalente au paramtre Couleur > Avanc dans l'inspecteur Proprits de l'occurrence. Les valeurs autorises sont comprises entre -255 et 255.

symbolInstance.colorGreenPercent
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorGreenPercent

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit quivaut lutilisation de la commande Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue. Cette valeur spcifie le nouveau pourcentage de vert. Les valeurs autorises sont comprises entre -100 et 100.

EXTENSION DE FLASH CS4 PROFESSIONAL 435

Objet SymbolInstance

Exemple Lexemple suivant dfinit sur 70 la valeur de la proprit colorGreenPercent de loccurrence de symbole slectionne :
fl.getDocumentDOM().selection[0].colorGreenPercent = 70;

symbolInstance.colorMode
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorMode

Description Proprit ; chane spcifiant le mode colorimtrique tel quil est identifi dans le menu contextuel Couleurs de linspecteur Proprits du symbole. Les valeurs gres sont "none" (aucun), "brightness" (luminosit), "tint" (teinte), "alpha" et "advanced" (avanc). Exemple L'exemple suivant donne la valeur alpha la proprit colorMode du premier lment de la premire image du premier calque du scnario :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].colorMode = "alpha";

symbolInstance.colorRedAmount
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorRedAmount

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit est quivalente au paramtre Couleur > Avanc dans l'inspecteur Proprits de l'occurrence. Les valeurs autorises sont comprises entre -255 et 255. Exemple Lexemple suivant dfinit sur 255 la valeur de la proprit colorRedAmount de loccurrence de symbole slectionne :
fl.getDocumentDOM().selection[0].colorRedAmount = 255;

EXTENSION DE FLASH CS4 PROFESSIONAL 436

Objet SymbolInstance

symbolInstance.colorRedPercent
Disponibilit Flash MX 2004. Utilisation
symbolInstance.colorRedPercent

Description Proprit ; entier spcifiant une partie de la transformation de couleur de loccurrence. Cette proprit quivaut lutilisation de la commande Couleur > Paramtres avancs de linspecteur Proprits, suivie du rglage des contrles de pourcentage qui apparaissent gauche dans la bote de dialogue. Cette valeur spcifie le nouveau pourcentage de rouge. Les valeurs autorises sont comprises entre -100 et 100. Exemple Lexemple suivant dfinit sur 10 la valeur de la proprit colorRedPercent de loccurrence de symbole slectionne :
fl.getDocumentDOM().selection[0].colorRedPercent = 10;

symbolInstance.description
Disponibilit Flash MX 2004. Utilisation
symbolInstance.description

Description Proprit ; chane quivalente au champ Description du panneau Accessibilit. Cette description est lue par les logiciels de lecture vocale. Cette proprit n'est pas disponible pour les symboles graphiques. Exemple L'exemple suivant enregistre dans la variable theDescription la valeur de la description de lobjet dans le panneau Accessibilit :
var theDescription = fl.getDocumentDOM().selection[0].description;

L'exemple suivant affecte la chane Click the home button to go to home la description de l'objet dans le panneau Accessibilit :
fl.getDocumentDOM().selection[0].description= "Click the home button to go to home";

symbolInstance.filters
Disponibilit Flash 8.

EXTENSION DE FLASH CS4 PROFESSIONAL 437

Objet SymbolInstance

Utilisation
symbolInstance.filters

Description Proprit ; tableau d'objets Filter (voir Objet Filter). Pour modifier les proprits relatives aux filtres, n'crivez pas directement de donnes dans ce tableau. Vous devez en effet rcuprer le tableau, dfinir chaque proprit, puis redfinir le tableau de sorte reflter les nouvelles proprits. Exemple L'exemple suivant recherche le nom du filtre l'index 0. S'il s'agit d'un filtre de type Glow, la proprit blurX correspondante est dfinie sur 100 et la nouvelle valeur est crite dans le tableau des filtres.
var filterName = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].filters[0].name; fl.trace(filterName); var filterArray = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].filters; if (filterName == 'glowFilter'){ filterArray[0].blurX = 100; } fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].filters = filterArray;

symbolInstance.firstFrame
Disponibilit Flash MX 2004. Utilisation
symbolInstance.firstFrame

Description Proprit ; entier en base zro indiquant la premire image qui doit apparatre dans le scnario du graphisme. Cette proprit ne sapplique quaux symboles graphiques et dfinit le mme paramtre que le champ Premire image de linspecteur Proprits. Pour les autres types de symboles, cette proprit a la valeur undefined. Exemple L'exemple suivant spcifie que limage 10 doit tre la premire apparatre dans le scnario de llment spcifi :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].firstFrame = 10;

symbolInstance.forceSimple
Disponibilit Flash MX 2004. Utilisation
symbolInstance.forceSimple

EXTENSION DE FLASH CS4 PROFESSIONAL 438

Objet SymbolInstance

Description Proprit ; valeur boolenne qui active ou dsactive laccessibilit aux enfants de lobjet. Cette proprit est quivalente linverse du paramtre Rendre les objets enfant accessibles du panneau Accessibilit. Par exemple, si forceSimple est true, son effet est similaire la dsactivation de loption Rendre les objets enfant accessibles. Si forceSimple est false, son effet est similaire lactivation de loption Rendre les objets enfant accessibles. Cette proprit est uniquement disponible pour les objets MovieClip. Exemple L'exemple suivant vrifie que les enfants de lobjet sont accessibles ; si la valeur renvoye est false, les enfants de lobjet sont accessibles :
var areChildrenAccessible = fl.getDocumentDOM().selection[0].forceSimple;

L'exemple suivant rend les enfants de lobjet accessibles :

fl.getDocumentDOM().selection[0].forceSimple = false;

symbolInstance.loop
Disponibilit Flash MX 2004. Utilisation
symbolInstance.loop

Description Proprit ; chane qui dfinit, pour les symboles graphiques, la mme proprit que le menu contextuel Boucle de linspecteur Proprits. Pour les autres types de symboles, cette proprit a la valeur undefined. Les valeurs gres sont "loop", "play once" et "single frame" pour dfinir l'animation du graphique en consquence. Exemple L'exemple suivant dfinit le premier symbole de la premire image du premier calque du scnario sur single frame (affichage d'une seule image spcifie dans le scnario graphique), dans la mesure o ce symbole est un graphique :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].loop = 'single frame';

symbolInstance.shortcut
Disponibilit Flash MX 2004. Utilisation
symbolInstance.shortcut

EXTENSION DE FLASH CS4 PROFESSIONAL 439

Objet SymbolInstance

Description Proprit ; chane quivalente la touche de raccourci associe au symbole. Cette proprit est quivalente au champ Raccourci du panneau Accessibilit. Cette touche est lue par les logiciels de lecture vocale. Cette proprit n'est pas disponible pour les symboles graphiques. Exemple L'exemple suivant enregistre dans la variable theShortcut la valeur de la touche de raccourci de lobjet dans le panneau Accessibilit :
var theShortcut = fl.getDocumentDOM().selection[0].shortcut;

Lexemple suivant dfinit sur Ctrl+i la touche de raccourci de lobjet :

fl.getDocumentDOM().selection[0].shortcut = "Ctrl+i";

symbolInstance.silent
Disponibilit Flash MX 2004. Utilisation
symbolInstance.silent

Description Proprit ; valeur boolenne qui active ou dsactive laccessibilit de lobjet. Cette proprit est quivalente linverse du paramtre Rendre l'objet accessible du panneau Accessibilit. Par exemple, si silent est true, son effet est similaire la dsactivation de loption Rendre lobjet accessible. Si silent est false, son effet est similaire lactivation de loption Rendre lobjet accessible. Cette proprit n'est pas disponible pour les objets graphiques. Exemple L'exemple suivant vrifie que lobjet est accessible ; si la valeur renvoye est false, lobjet est accessible :
var isSilent = fl.getDocumentDOM().selection[0].silent;

L'exemple suivant rend lobjet accessible :

fl.getDocumentDOM().selection[0].silent = false;

symbolInstance.symbolType
Disponibilit Flash MX 2004. Utilisation
symbolInstance.symbolType

EXTENSION DE FLASH CS4 PROFESSIONAL 440

Objet SymbolInstance

Description Proprit ; chane qui spcifie le type du symbole. Cette proprit est lquivalent de la valeur du champ Comportement dans les botes de dialogue Crer un nouveau symbole et Convertir en symbole. Les valeurs possibles sont "button" (bouton), "movie clip" (clip) et "graphic". Exemple L'exemple suivant donne le comportement de symbole graphique au premier symbole de la premire image du premier calque du scnario du document actif :
fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].symbolType = "graphic";

symbolInstance.tabIndex
Disponibilit Flash MX 2004. Utilisation
symbolInstance.tabIndex

Description Proprit ; entier quivalent au champ Index de tabulation du panneau Accessibilit. Cette proprit cre lordre de tabulation dans lequel les objets seront slectionns lorsque lutilisateur appuiera sur la touche de tabulation. Cette proprit n'est pas disponible pour les symboles graphiques. Exemple L'exemple suivant donne la valeur 3 la proprit tabIndex de lobjet mySymbol, puis affiche cette valeur dans le panneau Sortie :
var mySymbol = fl.getDocumentDOM().selection[0]; mySymbol.tabIndex = 3; fl.trace(mySymbol.tabIndex);

441

Chapitre 43 : Objet SymbolItem

Hritage

Objet Item > Objet SymbolItem

Disponibilit Flash MX 2004. Description Lobjet SymbolItem est une sous-classe de lobjet Objet Item. Rsum des mthodes Outre celles de lobjet Item, l'objet SymbolItem gre les mthodes suivantes :
Mthode
symbolItem.convertToCompiledClip()

Description Convertit en clip compil un lment de symbole dans la bibliothque. Exporte le symbole dans un fichier SWC. Exporte le symbole dans un fichier SWF.

symbolItem.exportSWC() symbolItem.exportSWF()

Rsum des proprits Outre celles de l'objet Item, l'objet SymbolItem possde les proprits suivantes :
Proprit
symbolItem.scalingGrid

Description Valeur boolenne qui spcifie si l'chelle 9 dcoupes est active pour l'lment. Objet Rectangle spcifiant les emplacements des quatre repres pour les 9 dcoupes. Valeur boolenne qui spcifie si l'lment est actualis lors de la publication du fichier FLA. Chane indiquant le chemin daccs du fichier source FLA, sous la forme fichier:///URI. Chane qui spcifie le nom de llment dans la bibliothque du fichier source. Chane qui spcifie le type de symbole. Lecture seule ; Objet Timeline.

symbolItem.scalingGridRect

symbolItem.sourceAutoUpdate

symbolItem.sourceFilePath

symbolItem.sourceLibraryName symbolItem.symbolType symbolItem.timeline

symbolItem.convertToCompiledClip()
Disponibilit Flash MX 2004. Utilisation
symbolItem.convertToCompiledClip()

EXTENSION DE FLASH CS4 PROFESSIONAL 442

Objet SymbolItem

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui convertit en clip compil un lment de symbole dans la bibliothque. Exemple Lexemple suivant convertit en clip compil un lment dans la bibliothque :
fl.getDocumentDOM().library.items[3].convertToCompiledClip();

symbolItem.exportSWC()
Disponibilit Flash MX 2004. Utilisation
symbolItem.exportSWC(outputURI)

Paramtres
outputURI Chane de type fichier:///URI qui dsigne le fichier SWC dans lequel la mthode doit exporter le symbole. Ladresse outputURI doit faire rfrence un fichier local. Flash ne cre pas de dossier si l'adresse outputURI nexiste pas.

Valeur renvoye Aucune. Description Mthode qui exporte le symbole dans un fichier SWC. Exemple L'exemple suivant exporte un lment de la bibliothque dans un fichier SWC nomm mySymbol.swc et situ dans le dossier tests :
fl.getDocumentDOM.library.selectItem("mySymbol"); var currentSelection = fl.getDocumentDOM().library.getSelectedItems(); currentSelection[0].exportSWC("file:///Macintosh HD/SWCDirectory/mySymbol.swc");

symbolItem.exportSWF()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 443

Objet SymbolItem

Utilisation
symbolItem.exportSWF(outputURI)

Paramtres
outputURI Chane de type fichier:///URI qui dsigne le fichier SWF dans lequel la mthode doit exporter le symbole. Ladresse outputURI doit faire rfrence un fichier local. Flash ne cre pas de dossier si l'adresse outputURI nexiste pas.

Valeur renvoye Aucune. Description Mthode qui exporte le symbole dans un fichier SWF. Exemple L'exemple suivant exporte un lment de la bibliothque dans le fichier my.swf du dossier tests :
fl.getDocumentDOM().library.items[0].exportSWF("file:///c|/tests/my.swf");

symbolItem.scalingGrid
Disponibilit Flash 8. Utilisation
symbolItem.scalingGrid

Description Proprit ; valeur boolenne spcifiant si l'chelle 9 dcoupes est active pour l'lment. Exemple L'exemple suivant active l'chelle 9 dcoupes pour un lment de la bibliothque :
fl.getDocumentDOM().library.items[0].scalingGrid = true;

Voir aussi
symbolItem.scalingGridRect

symbolItem.scalingGridRect
Disponibilit Flash 8. Utilisation
symbolItem.scalingGridRect

EXTENSION DE FLASH CS4 PROFESSIONAL 444

Objet SymbolItem

Description Proprit ; objet Rectangle spcifiant les emplacements des quatre repres pour les 9 dcoupes. Pour plus d'informations sur le format du rectangle, consultez document.addNewRectangle(). Exemple L'exemple suivant spcifie les emplacements des repres pour les 9 dcoupes :
fl.getDocumentDOM().library.items[0].scalingGridRect = {left:338, top:237, right:3859, bottom:713};

Voir aussi
symbolItem.scalingGrid

symbolItem.sourceAutoUpdate
Disponibilit Flash MX 2004. Utilisation
symbolItem.sourceAutoUpdate

Description Proprit ; valeur boolenne qui spcifie si l'lment est actualis lors de la publication du fichier FLA. La valeur par dfaut est false. Cette proprit est utilise pour les symboles de la bibliothque partage. Exemple L'exemple suivant dfinit la proprit sourceAutoUpdate pour un lment de la bibliothque :
fl.getDocumentDOM().library.items[0].sourceAutoUpdate = true;

symbolItem.sourceFilePath
Disponibilit Flash MX 2004. Utilisation
symbolItem.sourceFilePath

Description Proprit ; chane indiquant le chemin daccs du fichier source FLA, sous la forme fichier:///URI. Cette adresse doit tre un chemin absolu, et non pas un chemin relatif. Cette proprit est utilise pour les symboles de la bibliothque partage. Exemple Lexemple suivant affiche la valeur de la proprit sourceFilePath dans le panneau Sortie :

EXTENSION DE FLASH CS4 PROFESSIONAL 445

Objet SymbolItem

fl.trace(fl.getDocumentDOM().library.items[0].sourceFilePath);

symbolItem.sourceLibraryName
Disponibilit Flash MX 2004. Utilisation
symbolItem.sourceLibraryName

Description Proprit ; chane qui spcifie le nom de llment dans la bibliothque du fichier source. Cette proprit est utilise pour les symboles de la bibliothque partage. Exemple Lexemple suivant affiche la valeur de la proprit sourceLibraryName dans le panneau Sortie :
fl.trace(fl.getDocumentDOM().library.items[0].sourceLibraryName);

symbolItem.symbolType
Disponibilit Flash MX 2004. Utilisation
symbolItem.symbolType

Description Proprit ; chane qui spcifie le type du symbole. Les valeurs possibles sont "button" (bouton), "movie clip" (clip) et "graphic". Exemple L'exemple suivant affiche la valeur actuelle de la proprit symbolType, puis lui donne la valeur button avant de lafficher nouveau :
alert(fl.getDocumentDOM().library.items[0].symbolType); fl.getDocumentDOM().library.items[0].symbolType = "button"; alert(fl.getDocumentDOM().library.items[0].symbolType);

symbolItem.timeline
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 446

Objet SymbolItem

Utilisation
symbolItem.timeline

Description Proprit en lecture seule ; Objet Timeline. Exemple L'exemple suivant rcupre et affiche le nombre de calques du clip slectionn dans la bibliothque :
var tl = fl.getDocumentDOM().library.getSelectedItems()[0].timeline; alert(tl.layerCount);

447

Chapitre 44 : Objet Text

Hritage

Objet Element > Objet Text

Disponibilit Flash MX 2004. Description Lobjet Text reprsente un lment de texte unique dans un document. Toutes les proprits du texte concernent lensemble du bloc de texte. Pour savoir comment dfinir les proprits dun segment de texte lintrieur du champ de texte, consultez le Rsum des proprits de l'Objet TextAttrs. Pour modifier les proprits dune slection lintrieur dun champ de texte, vous pouvez utiliser document.setElementTextAttr() en spcifiant une plage de texte ou la slection actuelle. Pour dfinir les proprits gnriques du champ de texte slectionn, utilisez document.setElementProperty(). L'exemple suivant dfinit sur 50 la valeur x du point d'alignement du champ de texte slectionn :
fl.getDocumentDOM().setElementProperty("x", 50);

Rsum des mthodes Outre celles de l'objet Element, l'objet Text possde les mthodes suivantes :
Mthode
text.getTextAttr()

Description Rcupre lattribut spcifi pour le texte identifi par les paramtres facultatifs startIndex et
endIndex.

text.getTextString() text.setTextAttr() text.setTextString()

Rcupre la plage de texte spcifie. Dfinit lattribut spcifi pour le texte identifi par les paramtres startIndex et endIndex. Modifie la chane de texte dans cet objet Text.

Rsum des proprits Outre celles de l'objet Element, l'objet Text possde les proprits suivantes :
Proprit
text.accName text.antiAliasSharpness text.antiAliasThickness text.autoExpand

Description Chane quivalente au champ Nom du panneau Accessibilit. Nombre en virgule flottante spcifiant la nettet de l'anti-aliasing du texte. Nombre en virgule flottante spcifiant l'paisseur de l'anti-aliasing du texte. Valeur boolenne qui contrle lexpansion de la largeur du cadre de dlimitation des champs de texte statiques, ou la largeur et la hauteur du cadre de dlimitation des champs de texte dynamiques ou de saisie. Valeur boolenne qui dtermine si Flash affiche (true) ou masque (false) une bordure autour des champs de texte dynamiques ou de saisie. Chane quivalente au champ Description du panneau Accessibilit. Chane qui spcifie les caractres incorporer. Equivalent la saisie de texte dans la bote de dialogue Intgration de caractres.

text.border

text.description text.embeddedCharacters

EXTENSION DE FLASH CS4 PROFESSIONAL 448

Objet Text

Proprit
text.embedRanges

Description Chane compose dentiers dlimits correspondant aux lments qui peuvent tre slectionns dans la bote de dialogue Intgration de caractres. Une valeur boolenne qui spcifie s'il faut activer l'intgration de variantes de glyphes. Chane qui spcifie le mode de rendu du texte. Lecture seule ; entier reprsentant le nombre de caractres de lobjet Text. Chane dfinissant le type de ligne comme "single line" (une seule ligne), "multiline" (multiligne), "multiline no wrap" (multiligne sans retour) ou "password" (mot de passe). Entier spcifiant le nombre maximal de caractres que lutilisateur peut indiquer dans cet objet Text. Chane spcifiant lorientation du champ de texte. Valeur boolenne qui dtermine si Flash affiche le texte en HTML et interprte les balises HTML incorpores. Valeur boolenne qui indique si le texte peut dfiler (true) ou non (false). Valeur boolenne qui indique si le texte peut tre slectionn (true) ou non (false). Le texte de saisie peut toujours tre slectionn. Entier en base zro indiquant le dcalage de la fin dune sous-slection de texte. Entier en base zro indiquant le dcalage du dbut dune sous-slection de texte. Chane quivalente au champ Raccourci du panneau Accessibilit. Valeur boolenne indiquant si lobjet est accessible. Nombre entier quivalent au champ Index de tabulation du panneau Accessibilit. Lecture seule ; tableau d'objets TextRun. Chane qui spcifie le type du champ de texte. Les valeurs possibles sont "static", "dynamic" et "input". Valeur boolenne. Si sa valeur est true, Flash trace le texte laide des polices de priphrique. Chane prsentant le contenu de lobjet Text.

text.embedVariantGlyphs text.fontRenderingMode text.length text.lineType

text.maxCharacters

text.orientation text.renderAsHTML

text.scrollable text.selectable

text.selectionEnd text.selectionStart text.shortcut text.silent text.tabIndex text.textRuns text.textType

text.useDeviceFonts text.variableName

text.accName
Disponibilit Flash MX 2004. Utilisation
text.accName

Description Proprit ; chane quivalente au champ Nom du panneau Accessibilit. Les logiciels de lecture vocale identifient lobjet en prononant ce nom. Cette proprit ne peut pas tre utilise avec du texte dynamique. Exemple L'exemple suivant rcupre le nom de lobjet :

EXTENSION DE FLASH CS4 PROFESSIONAL 449

Objet Text

var doc = fl.getDocumentDOM(); var theName = doc.selection[0].accName;

L'exemple suivant dfinit le nom de lobjet actuellement slectionn :

fl.getDocumentDOM().selection[0].accName = "Home Button";

text.antiAliasSharpness
Disponibilit Flash 8. Utilisation
text.antiAliasSharpness

Description Proprit ; nombre en virgule flottante spcifiant la nettet de l'anti-aliasing du texte. Cette proprit contrle la nettet selon laquelle le texte est trac ; les valeurs plus leves correspondent du texte plus net. Une valeur de 0 reprsente une nettet normale. Cette proprit nest disponible que si text.fontRenderingMode est dfini sur customThicknessSharpness. Exemple Voir text.fontRenderingMode. Voir aussi
text.antiAliasThickness, text.fontRenderingMode

text.antiAliasThickness
Disponibilit Flash 8. Utilisation
text.antiAliasThickness

Description Proprit ; nombre en virgule flottante spcifiant l'paisseur de l'anti-aliasing du texte. Cette proprit dtermine l'paisseur selon laquelle le texte est trac, une valeur plus leve reprsentant un texte plus pais. Une valeur de 0 reprsente une paisseur normale. Cette proprit nest disponible que si text.fontRenderingMode est dfini sur customThicknessSharpness. Exemple Voir text.fontRenderingMode. Voir aussi
text.antiAliasSharpness, text.fontRenderingMode

EXTENSION DE FLASH CS4 PROFESSIONAL 450

Objet Text

text.autoExpand
Disponibilit Flash MX 2004. Utilisation
text.autoExpand

Description Proprit : valeur boolenne. Pour les champs de texte statiques, la valeur true provoque une expansion en largeur du cadre de dlimitation afin dafficher tout le texte. Pour les champs de texte dynamiques ou de saisie, la valeur true provoque une expansion en largeur et en hauteur du cadre de dlimitation afin dafficher tout le texte. Exemple Lexemple suivant donne la proprit autoExpand la valeur true :
fl.getDocumentDOM().selection[0].autoExpand = true;

text.border
Disponibilit Flash MX 2004. Utilisation
text.border

Description Proprit : valeur boolenne. Si sa valeur est true, Flash trace une bordure autour du texte. Exemple Lexemple suivant donne la proprit border la valeur true :
fl.getDocumentDOM().selection[0].border = true;

text.description
Disponibilit Flash MX 2004. Utilisation
text.description

Description Proprit ; chane quivalente au champ Description du panneau Accessibilit. Cette description est lue par les logiciels de lecture vocale.

EXTENSION DE FLASH CS4 PROFESSIONAL 451

Objet Text

Exemple L'exemple suivant rcupre la description de lobjet :

var doc = fl.getDocumentDOM(); var desc = doc.selection[0].description;

L'exemple suivant dfinit la description de lobjet :

var doc = fl.getDocumentDOM(); doc.selection[0].description= "Enter your name here";

text.embeddedCharacters
Disponibilit Flash MX 2004. Utilisation
text.embeddedCharacters

Description Proprit ; chane qui spcifie les caractres incorporer. Equivalent la saisie de texte dans la bote de dialogue Intgration de caractres. Elle est disponible uniquement avec les champs de texte dynamiques ou de saisie, et dclenche un avertissement avec un autre type de champ de texte. Exemple Lexemple suivant donne la proprit embeddedCharacters la valeur abc :
fl.getDocumentDOM().selection[0].embeddedCharacters = "abc";

text.embedRanges
Disponibilit Flash MX 2004. Utilisation
text.embedRanges

Description Proprit ; chane compose dentiers dlimits correspondant aux lments qui peuvent tre slectionns dans la bote de dialogue Intgration de caractres. Cette proprit est disponible uniquement avec les champs de texte dynamiques ou de saisie, et est ignore avec du texte statique. Remarque : cette proprit correspond au fichier XML du dossier Configuration/Font Embedding. Exemple Lexemple suivant donne la proprit embedRanges la valeur "1|3|7" :

EXTENSION DE FLASH CS4 PROFESSIONAL 452

Objet Text

var doc = fl.getDocumentDOM(); doc.selection[0].embedRanges = "1|3|7";

L'exemple suivant rinitialise la proprit :

var doc = fl.getDocumentDOM(); doc.selection[0].embedRanges = "";

text.embedVariantGlyphs
Disponibilit Flash CS4 Professional. Utilisation
text.embedVariantGlyphs

Description Proprit; une valeur boolenne qui spcifie s'il faut activer l'intgration de variantes de glyphes (true) ou pas (false). Cette proprit est disponible uniquement avec les champs de texte dynamiques ou de saisie, et est ignore avec du texte statique. La valeur par dfaut est false. Exemple L'exemple suivant active les variantes de glyphes pour qu'elles soient intgres dans l'objet Text slectionn :
fl.getDocumentDOM().selection[0].embedVariantGlyphs = true;

Voir aussi
fontItem.embedVariantGlyphs

text.fontRenderingMode
Disponibilit Flash 8. Utilisation
text.fontRenderingMode

Description Proprit ; chane qui spcifie le mode de rendu du texte. Cette proprit affecte l'affichage du texte sur la scne et dans Flash Player. Les valeurs gres sont dcrites dans le tableau suivant :

EXTENSION DE FLASH CS4 PROFESSIONAL 453

Objet Text

Valeur de la proprit
device bitmap

Rendu du texte Le texte est restitu avec les polices de priphrique. Le texte alias est restitu sous la forme d'un bitmap ou comme le ferait une police en mode pixel. Le texte est restitu par le biais de la mthode d'anti-aliasing standard utilise par Flash MX 2004. Ce paramtre est particulirement adapt au texte anim, de trs grande taille ou inclin. Le texte est restitu par le biais de la technologie de rendu des polices, l'anti-alias avanc mis en oeuvre dans Flash 8. Elle produit un meilleur anti-aliasing et amliore la lisibilit, en particulier dans le cas de texte de petite taille. Permet de dfinir des paramtres personnaliss pour la nettet et l'paisseur du texte en cas d'emploi de la technologie de rendu des polices par l'anti-alias avanc mis en oeuvre dans Flash 8.

standard

advanced

customThicknessSharpness

Exemple L'exemple suivant illustre une utilisation de la valeur customThicknessSharpness pour spcifier la nettet et l'paisseur du texte :
fl.getDocumentDOM().setElementProperty("fontRenderingMode", "customThicknessSharpness"); fl.getDocumentDOM().setElementProperty("antiAliasSharpness", 400); fl.getDocumentDOM().setElementProperty("antiAliasThickness", -200);

Voir aussi
text.antiAliasSharpness, text.antiAliasThickness

text.getTextAttr()
Disponibilit Flash MX 2004. Utilisation
text.getTextAttr(attrName [, startIndex [, endIndex]])

Paramtres attrName Chane spcifiant le nom de la proprit TextAttrs renvoyer. La liste des valeurs possibles de attrName figure dans le Rsum des proprits de l'Objet TextAttrs.
startIndex Nombre entier qui spcifie lindex du premier caractre. Ce paramtre est facultatif. endIndex Nombre entier spcifiant la fin de la plage de texte, de startIndex compris endIndex non compris. Ce paramtre est facultatif.

Valeur renvoye La valeur de lattribut spcifi par le paramtre attrName.

EXTENSION DE FLASH CS4 PROFESSIONAL 454

Objet Text

Description Mthode qui rcupre lattribut spcifi par le paramtre attrName pour le texte identifi par les paramtres facultatifs startIndex et endIndex. Si cet attribut nest pas cohrent pour la plage spcifie, Flash renvoie la valeur undefined. Si vous ne spcifiez pas les paramtres facultatifs startIndex et endIndex, la mthode utilise la plage de texte entire. Si vous ne prcisez que startIndex, la plage devient le caractre qui occupe cette position. Si startIndex et endIndex sont tous deux spcifis, la plage de caractres commence startIndex et se termine au dernier caractre avant endIndex. Exemple L'exemple suivant rcupre et affiche la taille de caractres du champ de texte slectionn :
var TheTextSize = fl.getDocumentDOM().selection[0].getTextAttr("size"); fl.trace(TheTextSize);

L'exemple suivant rcupre la couleur de remplissage du champ de texte slectionn :

var TheFill = fl.getDocumentDOM().selection[0].getTextAttr("fillColor"); fl.trace(TheFill);

L'exemple suivant rcupre la taille du troisime caractre du champ de texte slectionn :

var Char3 = fl.getDocumentDOM().selection[0].getTextAttr("size", 2); fl.trace(Char3);

L'exemple suivant rcupre la couleur du champ de texte slectionn entre les troisime et huitime caractres :
fl.getDocumentDOM().selection[0].getTextAttr("fillColor", 2, 8);

text.getTextString()
Disponibilit Flash MX 2004. Utilisation
text.getTextString([startIndex [, endIndex]])

Paramtres
startIndex Nombre entier qui spcifie lindex (en base zro) du premier caractre. Ce paramtre est facultatif. endIndex Nombre entier spcifiant la fin de la plage de texte, de startIndex compris endIndex non compris. Ce paramtre est facultatif.

Valeur renvoye Chane de texte de la plage spcifie. Description Mthode qui rcupre la plage de texte spcifie. Si vous omettez les paramtres facultatifs startIndex et endIndex, la mthode renvoie tout le texte. Si seul le paramtre startIndex est transmis, la mthode renvoie la chane qui commence cet index et se termine la fin du champ. Si vous spcifiez la fois startIndex et endIndex, la mthode renvoie la chane comprise entre startIndex et le caractre prcdant endIndex. Exemple L'exemple suivant rcupre le texte compris entre le cinquime caractre et la fin de la slection :

EXTENSION DE FLASH CS4 PROFESSIONAL 455

Objet Text

var myText = fl.getDocumentDOM().selection[0].getTextString(4); fl.trace(myText);

L'exemple suivant rcupre le texte compris entre les quatrime et neuvime caractres partir du dbut du texte slectionn :
var myText = fl.getDocumentDOM().selection[0].getTextString(3, 9); fl.trace(myText);

text.length
Disponibilit Flash MX 2004. Utilisation
text.length

Description Proprit en lecture seule ; entier indiquant le nombre de caractres prsents dans lobjet Text. Exemple L'exemple suivant renvoie le nombre de caractres du texte slectionn :
var textLength = fl.getDocumentDOM().selection[0].length;

text.lineType
Disponibilit Flash MX 2004. Utilisation
text.lineType

Description Proprit ; chane qui dfinit le type de ligne. Les valeurs possibles sont "single line", "multiline", "multiline no wrap" et "password". Cette proprit est uniquement disponible avec les champs de texte dynamiques ou de saisie, et dclenche un avertissement avec du texte statique. La valeur "password" nest valide que pour les champs de saisie. Exemple Lexemple suivant donne la proprit lineType la valeur multiline no wrap :
fl.getDocumentDOM().selection[0].lineType = "multiline no wrap";

EXTENSION DE FLASH CS4 PROFESSIONAL 456

Objet Text

text.maxCharacters
Disponibilit Flash MX 2004. Utilisation
text.maxCharacters

Description Proprit ; entier spcifiant le nombre maximal de caractres que lutilisateur peut saisir dans cet objet Text. Elle est disponible uniquement avec les champs de saisie, et dclenche un avertissement avec un autre type de champ de texte. Exemple L'exemple suivant donne la valeur 30 la proprit maxCharacters :
fl.getDocumentDOM().selection[0].maxCharacters = 30;

text.orientation
Disponibilit Flash MX 2004. Utilisation
text.orientation

Description Proprit ; chane spcifiant lorientation du champ de texte. Les valeurs possibles sont "horizontal", "vertical left to right" (vertical de gauche droite) et "vertical right to left" (vertical de droite gauche). Cette proprit est disponible uniquement avec les champs de texte statiques, et dclenche un avertissement avec un autre type de champ de texte. Exemple Lexemple suivant donne lorientation la valeur vertical right to left :
fl.getDocumentDOM().selection[0].orientation = "vertical right to left";

text.renderAsHTML
Disponibilit Flash MX 2004. Utilisation
text.renderAsHTML

EXTENSION DE FLASH CS4 PROFESSIONAL 457

Objet Text

Description Proprit : valeur boolenne. Si sa valeur est true, Flash affiche le texte en HTML et interprte les balises HTML incorpores. Elle est disponible uniquement avec les champs de texte dynamiques ou de saisie, et dclenche un avertissement avec un autre type de champ de texte. Exemple Lexemple suivant donne la proprit renderAsHTML la valeur true :
fl.getDocumentDOM().selection[0].renderAsHTML = true;

text.scrollable
Disponibilit Flash MX 2004. Utilisation
text.scrollable

Description Proprit : valeur boolenne. Si sa valeur est true, il est possible de faire dfiler le texte. Cette proprit est uniquement disponible avec les champs dynamiques ou de saisie, et dclenche un avertissement avec un champ de texte statique. Exemple Lexemple suivant donne la proprit scrollable la valeur false :
fl.getDocumentDOM().selection[0].scrollable = false;

text.selectable
Disponibilit Flash MX 2004. Utilisation
text.selectable

Description Proprit : valeur boolenne. Si sa valeur est true, il est possible de slectionner le texte. Le texte de saisie peut toujours tre slectionn. Flash gnre un avertissement lorsque cette proprit est dfinie sur false et utilise avec un texte de saisie. Exemple Lexemple suivant donne la proprit selectable la valeur true :

EXTENSION DE FLASH CS4 PROFESSIONAL 458

Objet Text

fl.getDocumentDOM().selection[0].selectable = true;

text.selectionEnd
Disponibilit Flash MX 2004. Utilisation
text.selectionEnd

Description Proprit ; entier en base zro indiquant la fin dune sous-slection de texte. Pour plus d'informations, consultez text.selectionStart.

text.selectionStart
Disponibilit Flash MX 2004. Utilisation
text.selectionStart

Description Proprit ; entier en base zro indiquant le dbut dune sous-slection de texte. Cette proprit peut tre utilise avec text.selectionEnd pour slectionner une plage de caractres. Les caractres sont slectionns jusqu text.selectionEnd non compris. Voir text.selectionEnd.

Sil ny a pas de slection, ou si le point dinsertion est actif, text.selectionEnd possde la mme valeur que
text.selectionStart.

Si text.selectionStart reoit une valeur suprieure celle de text.selectionEnd, text.selectionEnd

prendra la mme valeur que text.selectionStart, et aucun texte ne sera slectionn. Exemple L'exemple suivant dfinit le dbut de la sous-slection de texte sur le sixime caractre :
fl.getDocumentDOM().selection[0].selectionStart = 5;

L'exemple suivant slectionne les caractres Barbara dans un champ de texte contenant la phrase My name is Barbara, puis met ces caractres en vert gras :
fl.getDocumentDOM().selection[0].selectionStart = 11; fl.getDocumentDOM().selection[0].selectionEnd = 18; var s = fl.getDocumentDOM().selection[0].selectionStart; var e = fl.getDocumentDOM().selection[0].selectionEnd; fl.getDocumentDOM().setElementTextAttr('bold', true, s, e); fl.getDocumentDOM().setElementTextAttr("fillColor", "#00ff00", s, e);

EXTENSION DE FLASH CS4 PROFESSIONAL 459

Objet Text

text.setTextAttr()
Disponibilit Flash MX 2004. Utilisation
text.setTextAttr(attrName, attrValue [, startIndex [, endIndex]])

Paramtres attrName Chane spcifiant le nom de la proprit TextAttrs modifier.

attrValue Valeur de la proprit TextAttrs.

La liste des valeurs possibles de attrName et attrValue figure la section Rsum des proprits de l'Objet TextAttrs.
startIndex Nombre entier qui spcifie lindex (en base zro) du premier caractre du tableau. Ce paramtre est

facultatif.
endIndex Nombre entier spcifiant l'index du point d'extrmit de la chane de texte slectionne, de startIndex

compris endIndex non compris. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui donne la valeur spcifie par le paramtre attrValue lattribut spcifi par le paramtre attrName associ au texte identifi par les paramtres facultatifs startIndex et endIndex. Cette mthode permet de changer des attributs de texte chevauchant des lments TextRun (voir Objet TextRun), ou reprsentant des parties dlments TextRun existants. Son utilisation est susceptible de modifier la position et le nombre dlments TextRun dans le tableau text.textRuns de cet objet (voir text.textRuns). Si vous omettez les paramtres facultatifs, la mthode utilise la plage de caractres complte de l'objet Text. Si vous prcisez uniquement startIndex, la plage devient le caractre qui occupe cette position. Si startIndex et endIndex sont tous deux spcifis, la plage de caractres commence startIndex et se termine au dernier caractre avant endIndex. Exemple L'exemple suivant met en italique le champ de texte slectionn :
fl.getDocumentDOM().selection[0].setTextAttr("italic", true);

L'exemple suivant donne une taille de 10 points au troisime caractre :

fl.getDocumentDOM().selection[0].setTextAttr("size", 10, 2);

L'exemple suivant donne la couleur rouge au texte compris entre le troisime et le huitime caractre :
fl.getDocumentDOM().selection[0].setTextAttr("fillColor", 0xff0000, 2, 8);

text.setTextString()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 460

Objet Text

Utilisation
text.setTextString(text [, startIndex [, endIndex]])

Paramtres text Chane compose des caractres insrer dans lobjet Text.
startIndex Nombre entier qui spcifie lindex (en base zro) du premier caractre de la chane dans laquelle le texte

sera insr. Ce paramtre est facultatif.

endIndex Nombre entier qui spcifie lindex du dernier caractre de la chane slectionne. La nouvelle chane remplace le texte compris entre startIndex et endIndex non compris. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Proprit ; modifie la chane de texte de cet objet Text. Si vous omettez les paramtres facultatifs, l'objet Text est remplac dans son intgralit. Si vous prcisez uniquement startIndex, la chane spcifie est insre la position startIndex. Si startIndex et endIndex sont transmis, la chane spcifie remplace le segment de texte compris entre startIndex et le dernier caractre avant endIndex. Exemple L'exemple suivant affecte la chane this is a string au champ de texte slectionn :
fl.getDocumentDOM().selection[0].setTextString("this is a string");

L'exemple suivant insre la chane abc partir du cinquime caractre du champ de texte slectionn :
fl.getDocumentDOM().selection[0].setTextString("01234567890"); fl.getDocumentDOM().selection[0].setTextString("abc", 4); // text field is now "0123abc4567890"

L'exemple suivant remplace le texte compris entre le troisime et le huitime caractre du texte slectionn par la chane abcdefghij. Les caractres compris entre startIndex et endIndex sont remplacs. La chane de caractres qui dbute endIndex est dcale aprs la chane insre.
fl.getDocumentDOM().selection[0].setTextString("01234567890"); fl.getDocumentDOM().selection[0].setTextString("abcdefghij", 2, 8); // text field is now "01abcdefghij890"

text.shortcut
Disponibilit Flash MX 2004. Utilisation
text.shortcut

Description Proprit ; chane quivalente au champ Raccourci du panneau Accessibilit. Ce raccourci est lu par les logiciels de lecture vocale. Cette proprit ne peut pas tre utilise avec du texte dynamique.

EXTENSION DE FLASH CS4 PROFESSIONAL 461

Objet Text

Exemple Lexemple suivant rcupre et affiche la touche de raccourci de lobjet slectionn :

var theShortcut = fl.getDocumentDOM().selection[0].shortcut; fl.trace(theShortcut);

L'exemple suivant dfinit la touche de raccourci de lobjet slectionn :

fl.getDocumentDOM().selection[0].shortcut = "Ctrl+i";

text.silent
Disponibilit Flash MX 2004. Utilisation
text.silent

Description Proprit ; valeur boolenne indiquant si lobjet est accessible. Cette proprit est quivalente linverse du paramtre Rendre l'objet accessible du panneau Accessibilit. Ainsi, si silent est true, loption Rendre l'objet accessible est dsactive. Si cette valeur est false, loption Rendre l'objet accessible est active. Exemple L'exemple suivant vrifie que lobjet est accessible ; si la valeur renvoye est false, lobjet est accessible :
var isSilent = fl.getDocumentDOM().selection[0].silent;

L'exemple suivant rend lobjet accessible :

fl.getDocumentDOM().selection[0].silent = false;

text.tabIndex
Disponibilit Flash MX 2004. Utilisation
text.tabIndex

Description Proprit ; nombre entier quivalent au champ Index de tabulation du panneau Accessibilit. Cette valeur permet de dterminer lordre dans lequel les objets seront slectionns lorsque lutilisateur appuiera sur la touche de tabulation. Exemple L'exemple suivant rcupre la valeur de la proprit tabIndex de lobjet actuellement slectionn :
var theTabIndex = fl.getDocumentDOM().selection[0].tabIndex;

L'exemple suivant dfinit la proprit tabIndex de lobjet actuellement slectionn :

EXTENSION DE FLASH CS4 PROFESSIONAL 462

Objet Text

fl.getDocumentDOM().selection[0].tabIndex = 1;

text.textRuns
Disponibilit Flash MX 2004. Utilisation
text.textRuns

Description Proprit en lecture seule ; tableau d'objets TextRun (voir Objet TextRun). Exemple L'exemple suivant enregistre dans la variable myTextRuns la valeur de la proprit textRuns :
var myTextRuns = fl.getDocumentDOM().selection[0].textRuns;

text.textType
Disponibilit Flash MX 2004. Utilisation
text.textType

Description Proprit ; chane qui spcifie le type du champ de texte. Les valeurs possibles sont "static", "dynamic" et "input". Exemple Lexemple suivant donne la proprit textType la valeur input :
fl.getDocumentDOM().selection[0].textType = "input";

text.useDeviceFonts
Disponibilit Flash MX 2004. Utilisation
text.useDeviceFonts

Description Proprit : valeur boolenne. Si sa valeur est true, Flash trace le texte laide des polices de priphrique.

EXTENSION DE FLASH CS4 PROFESSIONAL 463

Objet Text

Exemple L'exemple suivant oblige Flash utiliser les polices de priphrique lors du trac du texte :
fl.getDocumentDOM().selection[0].useDeviceFonts = true;

text.variableName
Disponibilit Flash MX 2004. Utilisation
text.variableName

Description Proprit ; chane contenant le nom de la variable associe lobjet Text. Elle est disponible uniquement avec les champs de texte dynamiques ou de saisie, et dclenche un avertissement avec un autre type de champ de texte. Cette proprit n'est prise en charge que dans ActionScript 1.0 et ActionScript 2.0. Exemple L'exemple suivant dfinit le nom de la variable du champ de texte slectionn sur firstName :
fl.getDocumentDOM().selection[0].variableName = "firstName";

464

Chapitre 45 : Objet TextAttrs

Disponibilit Flash MX 2004. Description Lobjet TextAttrs contient toutes les proprits de texte pouvant tre appliques une sous-slection. Cet objet est une proprit de lobjet TextRun (textRun.textAttrs). Rsum des proprits Les proprits suivantes sont disponibles avec lobjet TextAttrs :
Proprit
textAttrs.aliasText

Description Valeur boolenne spcifiant que Flash doit tracer le texte laide dune mthode optimise pour amliorer la lisibilit du texte en petits caractres. Chane qui spcifie la justification des paragraphes. Les valeurs possibles sont "left", "center", "right" et "justify". Valeur boolenne qui dtermine si Flash utilise (true) ou ignore (false) les informations de crnage (distance entre deux lettres) des polices de caractres. Valeur boolenne. La valeur true provoque l'apparition de la version gras de la police. Chane qui dtermine la ligne de base du texte. Dconseill en faveur de textAttrs.letterSpacing. Nombre entier reprsentant lespacement entre les caractres. Chane qui reprsente le nom de la police, par exemple "Arial". Chane, valeur hexadcimale ou entire reprsentant la couleur de remplissage. Entier spcifiant lindentation des paragraphes. Valeur boolenne. Si sa valeur est true, Flash trace le texte laide de la version italique de la police. Entier spcifiant la marge gauche des paragraphes. Nombre entier reprsentant lespacement entre les caractres. Entier spcifiant linterlignage des paragraphes. Entier spcifiant la marge droite des paragraphes. Valeur boolenne. Si sa valeur est true, Flash fait pivoter les caractres du texte 90. La valeur par dfaut est false. Entier dfinissant la taille de la police. Chane reprsentant la proprit target du champ de texte. Chane reprsentant la proprit URL du champ de texte.

textAttrs.alignment

textAttrs.autoKern

textAttrs.bold

textAttrs.characterPosition textAttrs.characterSpacing

textAttrs.face textAttrs.fillColor textAttrs.indent textAttrs.italic

textAttrs.leftMargin textAttrs.letterSpacing textAttrs.lineSpacing textAttrs.rightMargin textAttrs.rotation

textAttrs.size textAttrs.target textAttrs.url

EXTENSION DE FLASH CS4 PROFESSIONAL 465

Objet TextAttrs

textAttrs.aliasText
Disponibilit Flash MX 2004. Utilisation
textAttrs.aliasText

Description Proprit ; valeur boolenne spcifiant que Flash doit tracer le texte laide dune mthode optimise pour amliorer la lisibilit du texte en petits caractres. Exemple L'exemple suivant donne la valeur true la proprit aliasText de tout le texte du champ de texte slectionn :
fl.getDocumentDOM().setElementTextAttr('aliasText', true);

textAttrs.alignment
Disponibilit Flash MX 2004. Utilisation
textAttrs.alignment

Description Proprit ; chane qui spcifie la justification des paragraphes. Les valeurs possibles sont "left", "center", "right" et "justify". Exemple L'exemple suivant justifie le paragraphe qui contient le texte compris entre le caractre dindex 0 et le caractre dindex 3 non compris : Cette opration peut affecter des caractres situs lextrieur de la plage spcifie sils se trouvent dans le mme paragraphe.
fl.getDocumentDOM().setTextSelection(0, 3); fl.getDocumentDOM().setElementTextAttr("alignment", "justify");

textAttrs.autoKern
Disponibilit Flash MX 2004. Utilisation
textAttrs.autoKern

EXTENSION DE FLASH CS4 PROFESSIONAL 466

Objet TextAttrs

Description Proprit ; valeur boolenne qui dtermine si Flash utilise (true) ou ignore (false) les informations de crnage (distance entre deux lettres) des polices de caractres. Exemple L'exemple suivant slectionne le texte compris entre le caractre dindex 2 et le caractre dindex 6 non compris, puis donne la valeur true la proprit autoKern :
fl.getDocumentDOM().setTextSelection(3, 6); fl.getDocumentDOM().setElementTextAttr('autoKern', true);

textAttrs.bold
Disponibilit Flash MX 2004. Utilisation
textAttrs.bold

Description Proprit : valeur boolenne. La valeur true provoque l'apparition de la version gras de la police. Exemple L'exemple suivant slectionne le premier caractre de lobjet Text slectionn, puis donne la valeur true la proprit bold :
fl.getDocumentDOM().setTextSelection(0, 1); fl.getDocumentDOM().setElementTextAttr('bold', true);

textAttrs.characterPosition
Disponibilit Flash MX 2004. Utilisation
textAttrs.characterPosition

Description Proprit ; chane qui dtermine la ligne de base du texte. Les valeurs possibles sont "normal", "subscript" et "superscript". Cette proprit ne sapplique quau texte statique. Exemple L'exemple suivant slectionne le texte compris entre le caractre dindex 2 et le caractre dindex 6 non compris, puis donne la valeur subscript la proprit characterPosition :
fl.getDocumentDOM().setTextSelection(2, 6); fl.getDocumentDOM().setElementTextAttr("characterPosition", "subscript");

EXTENSION DE FLASH CS4 PROFESSIONAL 467

Objet TextAttrs

textAttrs.characterSpacing
Disponibilit Flash MX 2004. Dlaisse dans Flash 8 au profit de textAttrs.letterSpacing. Utilisation
textAttrs.characterSpacing

Description Proprit ; nombre entier reprsentant lespacement entre les caractres. Les valeurs gres sont comprises entre -60 et 60. Cette proprit est disponible uniquement avec les champs de texte statique, elle dclenche un avertissement avec un autre type de champ de texte. Exemple L'exemple suivant donne la valeur 10 lespacement des caractres du champ de texte slectionn :
fl.getDocumentDOM().setElementTextAttr("characterSpacing", 10);

textAttrs.face
Disponibilit Flash MX 2004. Utilisation
textAttrs.face

Description Proprit ; chane qui reprsente le nom de la police, par exemple "Arial". Exemple L'exemple suivant donne la valeur Arial la police de caractres du texte slectionn, partir du caractre dindex 2 et jusquau caractre dindex 8 (non inclus) :
fl.getDocumentDOM().selection[0].setTextAttr("face", "Arial", 2, 8);

textAttrs.fillColor
Disponibilit Flash MX 2004. Utilisation
textAttrs.fillColor

EXTENSION DE FLASH CS4 PROFESSIONAL 468

Objet TextAttrs

Description Proprit ; couleur du remplissage, exprime dans l'un des formats suivants :

Chane au format "#RRVVBB" ou "#RRVVBBAA" Nombre hexadcimal au format 0xRRVVBB Entier reprsentant l'quivalent dcimal d'un nombre hexadcimal
Exemple L'exemple suivant donne la valeur rouge la couleur du texte slectionn, partir du caractre dindex 2 et jusquau caractre dindex 8 (non inclus) :
fl.getDocumentDOM().selection[0].setTextAttr("fillColor", 0xff0000, 2, 8);

textAttrs.indent
Disponibilit Flash MX 2004. Utilisation
textAttrs.indent

Description Proprit ; entier spcifiant lindentation des paragraphes. Les valeurs gres sont comprises entre -720 et 720. Exemple L'exemple suivant donne la valeur 100 lindentation du champ de texte slectionn, partir du caractre dindex 2 et jusquau caractre dindex 8 (non inclus). Cette opration peut affecter des caractres situs lextrieur de la plage spcifie sils se trouvent dans le mme paragraphe.
fl.getDocumentDOM().selection[0].setTextAttr("indent", 100, 2, 8);

textAttrs.italic
Disponibilit Flash MX 2004. Utilisation
textAttrs.italic

Description Proprit : valeur boolenne. Si sa valeur est true, Flash trace le texte laide de la version italique de la police. Exemple L'exemple suivant met en italique le champ de texte slectionn :
fl.getDocumentDOM().selection[0].setTextAttr("italic", true);

EXTENSION DE FLASH CS4 PROFESSIONAL 469

Objet TextAttrs

textAttrs.leftMargin
Disponibilit Flash MX 2004. Utilisation
textAttrs.leftMargin

Description Proprit ; entier spcifiant la marge gauche des paragraphes. Les valeurs gres sont comprises entre 0 et 720. Exemple L'exemple suivant donne la valeur 100 la proprit leftMargin du champ de texte slectionn, partir du caractre dindex 2 et jusquau caractre dindex 8 (non inclus). Cette opration peut affecter des caractres situs lextrieur de la plage spcifie sils se trouvent dans le mme paragraphe.
fl.getDocumentDOM().selection[0].setTextAttr("leftMargin", 100, 2, 8);

textAttrs.letterSpacing
Disponibilit Flash 8. Utilisation
textAttrs.letterSpacing

Description Proprit ; nombre entier reprsentant lespacement entre les caractres. Les valeurs gres sont comprises entre -60 et 60. Cette proprit est disponible uniquement avec les champs de texte statique, elle dclenche un avertissement avec un autre type de champ de texte. Exemple Le code suivant slectionne les caractres de l'index 0 jusqu' l'index 10 (sans inclure celui-ci) et fixe l'espacement des caractres 60 :
fl.getDocumentDOM().setTextSelection(0, 10); fl.getDocumentDOM().setElementTextAttr("letterSpacing", 60);

textAttrs.lineSpacing
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 470

Objet TextAttrs

Utilisation
textAttrs.lineSpacing

Description Proprit ; entier spcifiant linterlignage (leading) du paragraphe. Les valeurs gres sont comprises entre -360 et 720. Exemple L'exemple suivant donne la valeur 100 la proprit lineSpacing du champ de texte slectionn :
fl.getDocumentDOM().selection[0].setTextAttr("lineSpacing", 100);

textAttrs.rightMargin
Disponibilit Flash MX 2004. Utilisation
textAttrs.rightMargin

Description Proprit ; entier spcifiant la marge droite des paragraphes. Les valeurs gres sont comprises entre 0 et 720. Exemple L'exemple suivant donne la valeur 100 la proprit rightMargin du champ de texte slectionn, partir du caractre dindex 2 et jusquau caractre dindex 8 (non inclus). Cette opration peut affecter des caractres situs lextrieur de la plage spcifie sils se trouvent dans le mme paragraphe.
fl.getDocumentDOM().selection[0].setTextAttr("rightMargin", 100, 2, 8);

textAttrs.rotation
Disponibilit Flash MX 2004. Utilisation
textAttrs.rotation

Description Proprit : valeur boolenne. Si sa valeur est true, Flash fait pivoter les caractres du texte 90. La valeur par dfaut est false. Cette proprit est disponible uniquement avec les champs de texte statiques ayant une orientation verticale, et dclenche un avertissement avec un autre type de champ de texte. Exemple L'exemple suivant donne la valeur true la rotation du champ de texte slectionn :

EXTENSION DE FLASH CS4 PROFESSIONAL 471

Objet TextAttrs

fl.getDocumentDOM().setElementTextAttr("rotation", true);

textAttrs.size
Disponibilit Flash MX 2004. Utilisation
textAttrs.size

Description Proprit ; entier dfinissant la taille de la police. Exemple Lexemple suivant lit la taille du caractre ayant lindex 2 et affiche le rsultat dans le panneau Sortie :
fl.outputPanel.trace(fl.getDocumentDOM().selection[0].getTextAttr("size", 2));

textAttrs.target
Disponibilit Flash MX 2004. Utilisation
textAttrs.target

Description Proprit ; chane reprsentant la proprit target du champ de texte. Cette proprit ne sapplique quau texte statique. Exemple L'exemple suivant rcupre la proprit target du champ de texte de la premire image du calque suprieur de la squence active, puis laffiche dans le panneau Sortie :
fl.outputPanel.trace(fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0].getTe xtAttr("target"));

textAttrs.url
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 472

Objet TextAttrs

Utilisation
textAttrs.url

Description Proprit ; chane reprsentant la proprit URL du champ de texte. Cette proprit ne sapplique quau texte statique. Exemple L'exemple suivant dfinit l'URL du champ de texte slectionn sur http://www.adobe.com :
fl.getDocumentDOM().setElementTextAttr("url", "http://www.adobe.com");

473

Chapitre 46 : Objet TextRun

Disponibilit Flash MX 2004. Description Lobjet TextRun reprsente un flux de caractres dont les attributs correspondent toutes les proprits de lObjet TextAttrs. Cet objet est une proprit de lobjet Text (text.textRuns). Rsum des proprits Outre celles de l'objet Text, l'objet TextRun fournit les proprits suivantes :
Proprit
textRun.characters textRun.textAttrs

Description Chane reprsentant le texte contenu dans lobjet TextRun. Objet TextAttrs contenant les attributs du segment de texte.

textRun.textAttrs
Disponibilit Flash MX 2004. Utilisation
textRun.textAttrs

Description Proprit ; Objet TextAttrs contenant les attributs du segment de texte. Exemple L'exemple suivant affiche dans le panneau Sortie les proprits de la premire suite de caractres du champ de texte slectionn.
var curTextAttrs = fl.getDocumentDOM().selection[0].textRuns[0].textAttrs; for (var prop in curTextAttrs) { fl.trace(prop + " = " + curTextAttrs[prop]); }

textRun.characters
Disponibilit Flash MX 2004. Utilisation
textRun.characters

EXTENSION DE FLASH CS4 PROFESSIONAL 474

Objet TextRun

Description Proprit ; texte contenu dans lobjet TextRun. Exemple L'exemple suivant affiche dans le panneau Sortie les caractres qui forment la premire suite de caractres du champ de texte slectionn :
fl.trace(fl.getDocumentDOM().selection[0].textRuns[0].characters);

475

Chapitre 47 : Objet Timeline

Disponibilit Flash MX 2004. Description Lobjet Timeline reprsente le scnario de Flash qui est accessible, pour le document actif, par le biais de fl.getDocumentDOM().getTimeline(). Cette mthode renvoie le scnario de la squence actuelle ou du symbole en cours de modification. Lorsque lutilisateur travaille sur les squences, le scnario de chaque squence possde une valeur dindex qui permet dy accder (pour le document actif) via fl.getDocumentDOM().timelines[i]. (Dans cet exemple, i est lindex de la valeur du scnario.) Si vous travaillez sur les images en utilisant les mthodes et les proprits de lobjet Timeline, noubliez pas que lindex des images est en base zro et nest donc pas gal au numro de limage dans la squence dimages du scnario. Autrement dit, limage n1 possde lindex 0. Rsum des mthodes Les mthodes suivantes sont disponibles pour lobjet Timeline :
Mthode
timeline.addMotionGuide()

Description Ajoute un calque de guide de mouvement au-dessus du calque actif et rattache ce calque actif au nouveau calque de guide de mouvement. Ajoute un nouveau calque au document et lactive. Supprime tout le contenu dune image ou dune plage dimages dans le calque actif. Convertit une image-cl en image normale et supprime son contenu du calque actif. Convertit des images en images-cls vierges dans le calque actif. Convertit une plage dimages en images-cls (ou convertit la slection si aucune image nest spcifie) dans le calque actif. Copie une plage dimages du calque actif dans le Presse-papiers. A partir d'une interpolation de mouvement ou d'une animation image par image, copie un mouvement sur les images slectionnes pour pouvoir l'appliquer d'autres images. A partir d'une interpolation de mouvement ou d'une animation image par image, copie via le Presse-papiers un mouvement dans les images slectionnes sous forme de code ActionScript 3.0. Dfinit la proprit frame.tweenType sur motion pour toutes les images-cls slectionnes dans le calque actif, et convertit le contenu de chaque image en une occurrence de symbole unique si ncessaire. A partir du scnario, coupe une plage dimages du calque actif et la place dans le Presse-papiers. Supprime un calque

timeline.addNewLayer() timeline.clearFrames()

timeline.clearKeyframes()

timeline.convertToBlankKeyframes() timeline.convertToKeyframes()

timeline.copyFrames() timeline.copyMotion()

timeline.copyMotionAsAS3()

timeline.createMotionTween()

timeline.cutFrames()

timeline.deleteLayer()

EXTENSION DE FLASH CS4 PROFESSIONAL 476

Objet Timeline

Mthode
timeline.expandFolder() timeline.findLayerIndex() timeline.getFrameProperty()

Description Dveloppe ou rduit le ou les dossiers spcifis. Recherche le nom de calque spcifi dans un tableau dindex. Rcupre la valeur de la proprit spcifie pour les images slectionnes. Renvoie une chane XML reprsentant la position actuelle des lignes horizontale et verticale des guides pour un scnario (Affichage > Guides > Afficher les guides). Rcupre la valeur de la proprit spcifie pour les calques slectionns. Rcupre dans un tableau les images actuellement slectionnes. Rcupre les valeurs dindex en base zro des calques slectionns. Insre une image-cl vierge lindex spcifi dans le tableau des images. Si lindex nest pas spcifi, une image-cl vierge est insre au niveau de la tte de lecture ou de la slection. Insre le nombre dimages spcifi au numro dimage indiqu. Insre une image-cl au numro dimage spcifi. Colle la plage dimages du Presse-papiers dans les images spcifies. Copie la plage d'images de mouvement rcupre par timeline.copyMotion() dans le scnario. Supprime limage. Dplace le premier calque spcifi avant ou aprs le second calque spcifi. Inverse une plage dimages. Slectionne toutes les images du scnario actif. Dfinit la proprit de lobjet Frame pour les images slectionnes. Remplace les guides du scnario par les informations spcifies. Donne une valeur spcifie la proprit spcifie pour tous les calques slectionns. Slectionne une plage dimages dans le calque actif, ou applique les images slectionnes au tableau de slection transmis cette mthode. Slectionne le calque spcifi et lactive. Affiche les masques de calque pendant la programmation, en verrouillant le masque et les calques masqus.

timeline.getGuidelines()

timeline.getLayerProperty()

timeline.getSelectedFrames() timeline.getSelectedLayers() timeline.insertBlankKeyframe()

timeline.insertFrames() timeline.insertKeyframe() timeline.pasteFrames() timeline.pasteMotion()

timeline.removeFrames() timeline.reorderLayer()

timeline.reverseFrames() timeline.selectAllFrames() timeline.setFrameProperty() timeline.setGuidelines() timeline.setLayerProperty()

timeline.setSelectedFrames()

timeline.setSelectedLayers() timeline.showLayerMasking()

Rsum des proprits Les paramtres suivants sont disponibles avec l'objet Timeline :

EXTENSION DE FLASH CS4 PROFESSIONAL 477

Objet Timeline

Proprit
timeline.currentFrame timeline.currentLayer timeline.frameCount

Description Index (en base zro) de limage qui se trouve au niveau de la tte de lecture. Index (en base zro) du calque actif. Lecture seule ; nombre entier indiquant le nombre dimages du calque le plus long du scnario actif. Lecture seule ; nombre entier indiquant le nombre de calques du scnario spcifi. Lecture seule ; tableau d'objets layer. Chane indiquant le nom du scnario actif.

timeline.layerCount timeline.layers timeline.name

timeline.addMotionGuide()
Disponibilit Flash MX 2004. Utilisation
timeline.addMotionGuide()

Paramtres Aucun. Valeur renvoye Entier reprsentant lindex (en base zro) du nouveau calque de guidage. Si le calque actif nest pas de type "Normal", Flash renvoie -1. Description Mthode qui ajoute un calque de guide de mouvement au-dessus du calque actif et les relie entre eux grce la conversion du calque actif en calque de type "Guided". Cette mthode ne fonctionne quavec un calque de type "Normal". Elle n'a aucun d'effet sur un calque de type
"Folder", "Mask", "Masked", "Guide" ou "Guided".

Exemple Lexemple suivant ajoute un calque de guide de mouvement au-dessus du calque actif et convertit ce dernier en type Guided (guid) :
fl.getDocumentDOM().getTimeline().addMotionGuide();

timeline.addNewLayer()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 478

Objet Timeline

Utilisation
timeline.addNewLayer([name] [, layerType [, bAddAbove]])

Paramtres name Chane spcifiant le nom du nouveau calque. Si ce paramtre est omis, un nouveau nom par dfaut est affect au nouveau calque ("Layer n", o n correspond au nombre total de calques). Ce paramtre est facultatif.
layerType Chane qui spcifie le type du calque ajouter. Si vous omettez ce paramtre, un calque de type Normal

est cr. Ce paramtre est facultatif. Les valeurs gres sont : "normal", "guide", "guided", "mask", "masked" et
"folder". bAddAbove Valeur boolenne. Si elle est true (valeur par dfaut), Flash ajoute le nouveau calque au-dessus du calque actif ; si elle vaut false, Flash ajoute le nouveau calque sous le calque actif. Ce paramtre est facultatif.

Valeur renvoye Entier reprsentant lindex (en base zro) du nouveau calque. Description Mthode qui ajoute un nouveau calque au document et lactive. Exemple L'exemple suivant ajoute un nouveau calque au scnario, avec un nom par dfaut gnr par Flash :
fl.getDocumentDOM().getTimeline().addNewLayer();

L'exemple suivant ajoute un nouveau calque de dossier au-dessus du calque actif et le nomme Folder1 :
fl.getDocumentDOM().getTimeline().addNewLayer("Folder1", "folder", true);

timeline.clearFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.clearFrames([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui dfinit le dbut de la plage dimages effacer. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui dfinit la fin de la plage dimages effacer. Cette plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui supprime tout le contenu dune image ou dune plage dimages dans le calque actif.

EXTENSION DE FLASH CS4 PROFESSIONAL 479

Objet Timeline

Exemple L'exemple suivant efface les images partir de limage 6 et jusqu limage 11 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().clearFrames(5, 10);

L'exemple suivant efface limage 15 :

fl.getDocumentDOM().getTimeline().clearFrames(14);

timeline.clearKeyframes()
Disponibilit Flash MX 2004. Utilisation
timeline.clearKeyframes([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui dfinit le dbut de la plage dimages effacer. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui dfinit la fin de la plage dimages effacer. Cette plage stend jusqu

endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui convertit une image-cl en image standard et supprime son contenu du calque actif. Exemple L'exemple suivant efface les images-cls partir de limage 5 et jusqu limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().clearKeyframes(4, 9);

L'exemple suivant efface limage-cl 15 et la convertit en image normale :

fl.getDocumentDOM().getTimeline().clearKeyframes(14);

timeline.convertToBlankKeyframes()
Disponibilit Flash MX 2004. Utilisation
timeline.convertToBlankKeyframes([startFrameIndex [, endFrameIndex]])

EXTENSION DE FLASH CS4 PROFESSIONAL 480

Objet Timeline

Paramtres
startFrameIndex Index en base zro qui spcifie l'image de dbut convertir en image-cl. Si le paramtre

startFrameIndex est omis, la mthode convertit les images actuellement slectionnes. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image convertir en image-cl. La plage convertir stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui convertit des images en images-cls vierges dans le calque actif. Exemple L'exemple suivant convertit en images vides les images-cls partir de limage 2 et jusqu limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().convertToBlankKeyframes(1, 9);

L'exemple suivant convertit limage 5 en image-cl vide :

fl.getDocumentDOM().getTimeline().convertToBlankKeyframes(4);

timeline.convertToKeyframes()
Disponibilit Flash MX 2004. Utilisation
timeline.convertToKeyframes([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui dfinit la premire image convertir en image-cl. Si le paramtre

startFrameIndex est omis, la mthode convertit les images actuellement slectionnes. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image convertir en image-cl. La plage convertir stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui convertit une plage dimages-cls en images standard (ou convertit la slection si aucune image nest spcifie) dans le calque actif. Exemple L'exemple suivant convertit les images slectionnes en images-cls :

EXTENSION DE FLASH CS4 PROFESSIONAL 481

Objet Timeline

fl.getDocumentDOM().getTimeline().convertToKeyframes();

L'exemple suivant convertit en images-cls la plage d'images allant de limage 2 limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().convertToKeyframes(1, 9);

L'exemple suivant convertit limage 5 en image-cl :

fl.getDocumentDOM().getTimeline().convertToKeyframes(4);

timeline.copyFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.copyFrames([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui spcifie le dbut de la plage dimages copier. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image copier. La plage dimages copier stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui copie une plage dimages du calque actif vers le Presse-papiers. Exemple L'exemple suivant copie les images slectionnes dans le Presse-papiers :
fl.getDocumentDOM().getTimeline().copyFrames();

L'exemple suivant copie dans le Presse-papiers la plage d'images allant de limage 2 limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().copyFrames(1, 9);

L'exemple suivant copie limage 5 dans le Presse-papiers :

fl.getDocumentDOM().getTimeline().copyFrames(4);

timeline.copyMotion()
Disponibilit Flash CS3 Professional.

EXTENSION DE FLASH CS4 PROFESSIONAL 482

Objet Timeline

Utilisation
timeline.copyMotion()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui copie un mouvement dans les images slectionnes, soit d'une interpolation de mouvement, soit d'une animation image par image. Vous pouvez ensuite utiliser timeline.pasteMotion() pour appliquer ce mouvement d'autres images. Pour savoir comment copier un mouvement sous forme de texte (code) coller ensuite dans un script, consultez timeline.copyMotionAsAS3(). Exemple Lexemple suivant copie le mouvement partir de l'image ou des images slectionnes :
fl.getDocumentDOM().getTimeline().copyMotion();

Voir aussi
timeline.copyMotionAsAS3(), timeline.pasteMotion()

timeline.copyMotionAsAS3()
Disponibilit Flash CS3 Professional. Utilisation
timeline.copyMotionAsAS3()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui, partir d'une interpolation de mouvement ou d'une animation image par image, copie sous forme de code ActionScript 3.0. via le Presse-papiers un mouvement dans les images slectionnes. Vous pouvez ensuite coller ce code dans un script. Pour savoir comment copier un mouvement dans un format applicable d'autres images, consultez timeline.copyMotion().

EXTENSION DE FLASH CS4 PROFESSIONAL 483

Objet Timeline

Exemple Lexemple suivant copie dans le Presse-papiers, sous forme de code ActionScript 3.0, le mouvement partir de l'image ou des images slectionnes :
fl.getDocumentDOM().getTimeline().copyMotionAsAS3();

Voir aussi
timeline.copyMotion()

timeline.createMotionTween()
Disponibilit Flash MX 2004. Utilisation
timeline.createMotionTween([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui spcifie limage de dbut de linterpolation. Si le paramtre startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif. endFrameIndex Index en base zro qui spcifie la dernire image de linterpolation. La plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui dfinit la proprit frame.tweenType sur motion pour toutes les images-cls slectionnes dans le calque actif, et convertit le contenu de chaque image en une occurrence de symbole unique si ncessaire. Cette proprit est lquivalent de loption de menu Crer une interpolation de mouvement dans linterface de Flash. Exemple L'exemple suivant convertit en occurrence de symbole graphique la forme qui se trouve dans la premire image jusqu limage 10 non comprise, et donne la valeur motion la proprit frame.tweenType (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().createMotionTween(0, 9);

timeline.currentFrame
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 484

Objet Timeline

Utilisation
timeline.currentFrame

Description Proprit ; index en base zro de limage qui se trouve actuellement au niveau de la tte de lecture. Exemple L'exemple suivant place la tte de lecture face limage 10 du scnario actif (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().currentFrame = 9;

L'exemple suivant enregistre dans la variable curFrame lemplacement actuel de la tte de lecture :
var curFrame = fl.getDocumentDOM().getTimeline().currentFrame;

timeline.currentLayer
Disponibilit Flash MX 2004. Utilisation
timeline.currentLayer

Description Proprit ; index (en base zro) du calque actif. La valeur 0 spcifie le calque suprieur, la valeur 1 indique le calque plac juste en dessous, etc. Exemple L'exemple suivant active le calque suprieur :
fl.getDocumentDOM().getTimeline().currentLayer = 0;

L'exemple suivant enregistre dans la variable curLayer lindex du calque actif :

var curLayer = fl.getDocumentDOM().getTimeline().currentLayer;

timeline.cutFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.cutFrames([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui dfinit le dbut de la plage dimages couper. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 485

Objet Timeline

endFrameIndex Index en base zro qui dfinit la dernire image couper. La plage stend jusqu endFrameIndex

non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui, partir du scnario, coupe une plage dimages du calque actif et la place dans le Presse-papiers. Exemple Lexemple suivant coupe les images slectionnes dans le scnario et les place dans le Presse-papiers :
fl.getDocumentDOM().getTimeline().cutFrames();

L'exemple suivant coupe et place dans le Presse-papiers la plage d'images, de limage 2 limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage):
fl.getDocumentDOM().getTimeline().cutFrames(1, 9);

Lexemple suivant coupe limage 5 dans le scnario et la place dans le Presse-papiers :

fl.getDocumentDOM().getTimeline().cutFrames(4);

timeline.deleteLayer()
Disponibilit Flash MX 2004. Utilisation
timeline.deleteLayer([index])

Paramtres index Nombre entier en base zro indiquant le calque supprimer. Sil nexiste quun seul calque dans le scnario, cette mthode na aucun effet. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui supprime un calque. Sil sagit dun calque de type Dossier, tous les calques de ce dossier sont supprims. Si lindex du calque nest pas spcifi, Flash supprime les calques actuellement slectionns. Exemple L'exemple suivant supprime le second calque partir du haut :
fl.getDocumentDOM().getTimeline().deleteLayer(1);

L'exemple suivant supprime les calques slectionns :

fl.getDocumentDOM().getTimeline().deleteLayer();

EXTENSION DE FLASH CS4 PROFESSIONAL 486

Objet Timeline

timeline.expandFolder()
Disponibilit Flash MX 2004. Utilisation
timeline.expandFolder(bExpand [, bRecurseNestedParents [, index]])

Paramtres bExpand Valeur boolenne. Si elle est true, la mthode dveloppe le dossier ; si elle est false, la mthode rduit le dossier.
bRecurseNestedParents Valeur boolenne. Si elle est true, tous les calques du dossier spcifi sont ouverts ou ferms selon la valeur du paramtre bExpand. Ce paramtre est facultatif. index Index en base zro du dossier dvelopper ou rduire. Utilisez la valeur -1 pour lappliquer tous les calques (le paramtre bRecurseNestedParents doit galement avoir la valeur true). Cette proprit est lquivalent de loption de menu Dvelopper/rduire tous les dossiers dans l'outil de programmation Flash. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui dveloppe ou rduit le ou les dossiers spcifis. Si vous ne spcifiez pas de calque, cette mthode opre sur le calque actif. Exemple Les exemples suivants utilisent cette structure de dossiers :
Folder 1 *** --layer 7 --Folder 2 **** ----Layer 5

L'exemple suivant dveloppe le dossier Folder 1 uniquement :

fl.getDocumentDOM().getTimeline().currentLayer = 1; fl.getDocumentDOM().getTimeline().expandFolder(true);

L'exemple suivant dveloppe le dossier Folder 1 uniquement (en supposant que Folder 2 tait rduit lorsque Folder 1 a t rduit prcdemment, sinon Folder 2 est galement dvelopp) :
fl.getDocumentDOM().getTimeline().expandFolder(true, false, 0);

L'exemple suivant rduit tous les dossiers du scnario actuel :

fl.getDocumentDOM().getTimeline().expandFolder(false, true, -1);

timeline.findLayerIndex()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 487

Objet Timeline

Utilisation
timeline.findLayerIndex(name)

Paramtres name Chane spcifiant le nom du calque rechercher. Valeur renvoye Tableau de valeurs dindex pour le calque spcifi. Si le calque spcifi est introuvable, Flash renvoie undefined. Description Mthode qui recherche le nom du calque spcifi dans un tableau dindex. Le tableau des calques possde une seule dimension, si bien que les dossiers font partie de lindex principal. Exemple Lexemple suivant affiche dans le panneau Sortie la valeur dindex de tous les calques nomms Layer 7 :
var layerIndex = fl.getDocumentDOM().getTimeline().findLayerIndex("Layer 7"); fl.trace(layerIndex);

L'exemple suivant montre comment transmettre les valeurs renvoyes par cette mthode timeline.setSelectedLayers() :
var layerIndex = fl.getDocumentDOM().getTimeline().findLayerIndex("Layer 1"); fl.getDocumentDOM().getTimeline().setSelectedLayers(layerIndex[0], true);

timeline.frameCount
Disponibilit Flash MX 2004. Utilisation
timeline.frameCount

Description Proprit en lecture seule ; entier indiquant le nombre dimages du calque le plus long du scnario actif. Exemple L'exemple suivant enregistre dans la variable countNum le nombre dimages du calque le plus long du document actif :
var countNum = fl.getDocumentDOM().getTimeline().frameCount;

timeline.getFrameProperty()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 488

Objet Timeline

Utilisation
timeline.getFrameProperty(property [, startframeIndex [, endFrameIndex]])

Paramtres property Chane spcifiant le nom de la proprit dont la valeur est recherche. La liste complte des proprits est indique dans le Rsum des proprits de l'Objet Frame.
startFrameIndex Index en base zro qui spcifie limage de dbut dont la valeur est recherche. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la fin de la plage dimages slectionner. Cette plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Valeur de la proprit spcifie, ou undefined si les images slectionnes nont pas toutes la mme valeur pour cette proprit. Description Mthode qui rcupre la valeur de la proprit spcifie pour les images slectionnes. Exemple Lexemple suivant rcupre le nom de la premire image du calque suprieur du document actif, et affiche ce nom dans le panneau Sortie :
fl.getDocumentDOM().getTimeline().currentLayer = 0; fl.getDocumentDOM().getTimeline().setSelectedFrames(0, 0, true); var frameName = fl.getDocumentDOM().getTimeline().getFrameProperty("name"); fl.trace(frameName);

timeline.getGuidelines()
Disponibilit Flash CS4 Professional. Utilisation
timeline.getGuidelines()

Paramtres Aucun. Valeur renvoye Chane XML. Description Mthode qui renvoie une chane XML reprsentant la position actuelle des lignes horizontale et verticale des guides pour un scnario (Affichage > Guides > Afficher les guides). Pour appliquer ces guides un scnario, utilisez timeline.setGuidelines().

EXTENSION DE FLASH CS4 PROFESSIONAL 489

Objet Timeline

Exemple En supposant que le premier scnario contienne des guides, l'exemple suivant les affiche sous forme de chane XML dans le panneau Sortie :
var currentTimeline = fl.getDocumentDOM().timelines[0]; fl.trace(currentTimeline.getGuidelines());

timeline.getLayerProperty()
Disponibilit Flash MX 2004. Utilisation
timeline.getLayerProperty(property)

Paramtres property Chane spcifiant le nom de la proprit dont la valeur est recherche. La liste des proprits est indique dans le Rsum des proprits de l'Objet Frame. Valeur renvoye Valeur de la proprit spcifie. Flash examine les proprits du calque pour en dterminer le type. Si les calques spcifis nont pas tous la mme valeur pour cette proprit, Flash renvoie undefined. Description Mthode qui rcupre la valeur de la proprit spcifie pour les calques slectionns. Exemple Lexemple suivant rcupre le nom du calque suprieur du document actif, et l'affiche dans le panneau Sortie :
fl.getDocumentDOM().getTimeline().currentLayer = 0; var layerName = fl.getDocumentDOM().getTimeline().getLayerProperty("name"); fl.trace(layerName);

timeline.getSelectedFrames()
Disponibilit Flash MX 2004. Paramtres Aucun. Valeur renvoye Tableau contenant 3n entiers, o n est le nombre de zones slectionnes. Le premier entier de chaque groupe est lindex du calque, le second est limage de dpart de la slection, et le troisime indique limage de fin de la slection. Limage de fin nest pas incluse dans la slection.

EXTENSION DE FLASH CS4 PROFESSIONAL 490

Objet Timeline

Description Mthode qui recherche dans un tableau les images actuellement slectionnes. Exemple Si le calque suprieur est le calque actif, l'exemple suivant affiche 0,5,10,0,20,25 dans le panneau Sortie :
var timeline = fl.getDocumentDOM().getTimeline(); timeline.setSelectedFrames(5,10); timeline.setSelectedFrames(20,25,false); var theSelectedFrames = timeline.getSelectedFrames(); fl.trace(theSelectedFrames);

Voir aussi
timeline.setSelectedFrames()

timeline.getSelectedLayers()
Disponibilit Flash MX 2004. Paramtres Aucun. Valeur renvoye Tableau des valeurs dindex en base zro des calques slectionns. Description Mthode qui recherche les valeurs dindex en base zro des calques slectionns. Exemple L'exemple suivant affiche 1,0 dans le panneau Sortie.
fl.getDocumentDOM().getTimeline().setSelectedLayers(0); fl.getDocumentDOM().getTimeline().setSelectedLayers(1, false); var layerArray = fl.getDocumentDOM().getTimeline().getSelectedLayers(); fl.trace(layerArray);

Voir aussi
timeline.setSelectedLayers()

timeline.insertBlankKeyframe()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 491

Objet Timeline

Utilisation
timeline.insertBlankKeyframe([frameNumIndex])

Paramtres
frameNumIndex Index en base zro qui dfinit limage laquelle limage-cl doit tre insre. Si le paramtre frameNumIndex est omis, la mthode utilise limage qui se trouve en face de la tte de lecture. Ce paramtre est facultatif.

Si limage spcifie ou limage slectionne est une image normale, limage-cl est insre au niveau de celle-ci. Par exemple, pour une plage de 10 images numrotes de 1 10, si vous slectionnez limage 5, cette mthode transforme limage 5 en image-cl vide, et la longueur de la plage reste de 10 images. Si limage 5 est slectionne et est une imagecl suivie dune image normale, cette mthode insre une image-cl vide au niveau de limage 6. Si limage 5 est une image-cl et que la suivante est dj une image-cl, aucune image-cl nest insre, mais la tte de lecture est place en face de limage 6. Valeur renvoye Aucune. Description Mthode qui insre une image-cl vierge lindex spcifi dans le tableau des images ; si lindex nest pas spcifi, une image-cl vierge est insre au niveau de la tte de lecture ou de la slection. Voir aussi timeline.insertKeyframe(). Exemple L'exemple suivant insre une image-cl vide au niveau de limage 20 (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().insertBlankKeyframe(19);

L'exemple suivant insre une image-cl vide au niveau de limage slectionne (ou au niveau de la tte de lecture si aucune image nest slectionne) :
fl.getDocumentDOM().getTimeline().insertBlankKeyframe();

timeline.insertFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.insertFrames([numFrames [, bAllLayers [, frameNumIndex]]])

Paramtres
numFrames Nombre entier qui indique le nombre dimages insrer. Si ce paramtre est omis, la mthode insre les

images au niveau de la slection actuelle dans le calque actif. Ce paramtre est facultatif.
bAllLayers Valeur boolenne. Si elle est true (valeur par dfaut), la mthode insre dans tous les calques le nombre

dimages spcifi dans le paramtre numFrames ; si elle a la valeur false, la mthode insre ces images dans le calque actif. Ce paramtre est facultatif.

EXTENSION DE FLASH CS4 PROFESSIONAL 492

Objet Timeline

frameNumIndex Index en base zro qui spcifie limage au niveau de laquelle une nouvelle image doit tre insre. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui insre le nombre dimages spcifi au numro dindex indiqu. Si aucun paramtre nest spcifi, cette mthode fonctionne comme suit :

Si une ou plusieurs images sont slectionnes, la mthode insre le nombre dimages slectionnes lemplacement
de la premire image slectionne dans le calque actif. Autrement dit, si les images 6 10 sont slectionnes (soit un total de cinq images), la mthode ajoute cinq images limage 6 dans le calque contenant les images slectionnes.

Si aucune image nest slectionne, la mthode en insre une dans tous les calques, au niveau de limage active.
Si des paramtres sont spcifis, cette mthode fonctionne comme suit :

Si seul le paramtre numFrames est spcifi, la mthode insre le nombre dimages indiqu au niveau de limage
active dans le calque actif.

Si le paramtre numFrames est spcifi et si le paramtre bAllLayers a la valeur true, la mthode insre le nombre
dimages indiqu au niveau de limage active dans tous les calques.

Si les trois paramtres sont spcifis, la mthode insre le nombre dimages indiqu au niveau de lindex spcifi
(frameIndex) ; la valeur de bAllLayers dtermine si les images sont ajoutes au calque actif seulement ou tous les calques. Si limage spcifie ou limage slectionne est une image normale, limage est insre au niveau de celle-ci. Par exemple, pour une plage de 10 images numrotes de 1 10, si vous slectionnez limage 5 (ou si vous transmettez la valeur 4 pour le paramtre frameIndex), cette mthode ajoute une image limage 5, et la longueur de la plage devient 11 images. Si limage 5 est slectionne et sil sagit dune image-cl, cette mthode insre une image au niveau de limage 6, que limage suivante soit galement une image-cl ou non. Exemple L'exemple suivant insre une ou plusieurs images (selon ltendue de la slection) au niveau de la slection actuelle dans le calque actif :
fl.getDocumentDOM().getTimeline().insertFrames();

L'exemple suivant insre cinq images au niveau de limage active dans tous les calques :
fl.getDocumentDOM().getTimeline().insertFrames(5);

Remarque : si le document comporte plusieurs calques dots dimages, et si vous avez slectionn une image dans un calque lors de lutilisation de la commande prcdente, Flash insre les images dans le calque slectionn uniquement. Si le document comporte plusieurs calques dots dimages mais quaucune d'elles nest slectionne, Flash insre les images dans tous les calques. L'exemple suivant insre trois images dans le calque actif uniquement :
fl.getDocumentDOM().getTimeline().insertFrames(3, false);

L'exemple suivant insre quatre images dans tous les calques, en commenant la premire image :
fl.getDocumentDOM().getTimeline().insertFrames(4, true, 0);

EXTENSION DE FLASH CS4 PROFESSIONAL 493

Objet Timeline

timeline.insertKeyframe()
Disponibilit Flash MX 2004. Utilisation
timeline.insertKeyframe([frameNumIndex])

Paramtres
frameNumIndex Index en base zro qui spcifie lindex de limage au niveau de laquelle limage-cl doit tre insre dans le calque actif. Si le paramtre frameNumIndex est omis, la mthode utilise lindex de limage qui se trouve en face de la tte de lecture ou de limage slectionne. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui insre une image-cl au numro dimage indiqu. Si ce paramtre est omis, la mthode insre une imagecl au niveau de la slection actuelle ou de la tte de lecture. Cette mthode donne un rsultat identique celui de timeline.insertBlankKeyframe(), si ce nest que limage-cl insre dtient le contenu de limage convertie et nest donc pas vide. Exemple L'exemple suivant insre une image-cl au niveau de la tte de lecture ou de limage slectionne :
fl.getDocumentDOM().getTimeline().insertKeyframe();

L'exemple suivant insre une image-cl au niveau de limage 10 du second calque (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().currentLayer = 1; fl.getDocumentDOM().getTimeline().insertKeyframe(9);

timeline.layerCount
Disponibilit Flash MX 2004. Utilisation
timeline.layerCount

Description Proprit en lecture seule ; entier indiquant le nombre de calques du scnario spcifi. Exemple L'exemple suivant enregistre dans la variable NumLayer le nombre de calques de la squence active :
var NumLayer = fl.getDocumentDOM().getTimeline().layerCount;

EXTENSION DE FLASH CS4 PROFESSIONAL 494

Objet Timeline

timeline.layers
Disponibilit Flash MX 2004. Utilisation
timeline.layers

Description Proprit en lecture seule ; tableau d'objets layer. Exemple L'exemple suivant enregistre dans la variable currentLayers le tableau des objets layer du document actif :
var currentLayers = fl.getDocumentDOM().getTimeline().layers;

timeline.name
Disponibilit Flash MX 2004. Utilisation
timeline.name

Description Proprit ; chane qui spcifie le nom du scnario actif. Ce nom est celui de la squence, de lcran (diapositive ou formulaire) ou du symbole qui est en cours de modification. Exemple L'exemple suivant rcupre le nom de la squence active :
var sceneName = fl.getDocumentDOM().timelines[0].name;

L'exemple suivant donne la valeur FirstScene au nom de la premire squence :

fl.getDocumentDOM().timelines[0].name = "FirstScene";

timeline.pasteFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.pasteFrames([startFrameIndex [, endFrameIndex]])

EXTENSION DE FLASH CS4 PROFESSIONAL 495

Objet Timeline

Paramtres
startFrameIndex Index en base zro qui spcifie le dbut de la plage dimages coller. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image au niveau de laquelle les images doivent tre colles. Cette plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui colle la plage dimages du Presse-papiers dans les images spcifies. Exemple L'exemple suivant colle la plage dimages du Presse-papiers dans limage slectionne ou, dfaut, lemplacement de la tte de lecture :
fl.getDocumentDOM().getTimeline().pasteFrames();

L'exemple suivant colle les images dans le Presse-papiers partir de limage 2 et jusqu limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().pasteFrames(1, 9);

L'exemple suivant colle les images dans le Presse-papiers partir de limage 5 :

fl.getDocumentDOM().getTimeline().pasteFrames(4);

timeline.pasteMotion()
Disponibilit Flash CS3 Professional. Utilisation
timeline.pasteMotion()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui copie dans le scnario la plage d'images de mouvement rcupre par timeline.copyMotion(). Au besoin, les images existantes sont dplaces (repositionnes droite) pour faire de la place aux images qui sont colles. Exemple L'exemple suivant colle le mouvement du Presse-papiers dans limage slectionne ou lemplacement de la tte de lecture en dplaant cette image droite des images colles :

EXTENSION DE FLASH CS4 PROFESSIONAL 496

Objet Timeline

fl.getDocumentDOM().getTimeline().pasteMotion();

Voir aussi
timeline.copyMotion()

timeline.removeFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.removeFrames([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui spcifie la premire image partir de laquelle les images doivent tre

supprimes. Si le paramtre startFrameIndex est omis, la mthode utilise la slection actuelle. Sil nexiste pas de slection, toutes les images (de tous les calques) qui se trouvent au niveau de la tte de lecture sont supprimes. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image au niveau de laquelle les images doivent tre supprimes ; la plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui supprime limage. Exemple L'exemple suivant supprime les images du calque suprieur de la squence active partir de limage 5 et jusqu limage 10 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().currentLayer = 0; fl.getDocumentDOM().getTimeline().removeFrames(4, 9);

L'exemple suivant supprime limage 8 du calque suprieur de la squence active :

fl.getDocumentDOM().getTimeline().currentLayer = 0; fl.getDocumentDOM().getTimeline().removeFrames(7);

timeline.reorderLayer()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 497

Objet Timeline

Utilisation
timeline.reorderLayer(layerToMove, layerToPutItBy [, bAddBefore])

Paramtres
layerToMove Index en base zro spcifiant le calque dplacer. layerToPutItBy Index en base zro indiquant le calque ct duquel l'autre calque doit tre plac. Par exemple, si vous spcifiez 1 pour layerToMove et 0 pour layerToPutItBy, le second calque est plac ct du premier. bAddBefore Indique si le calque doit tre plac avant ou aprs layerToPutItBy. Si sa valeur est false, le calque est

plac aprs layerToPutItBy. La valeur par dfaut est true. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui dplace le premier calque spcifi avant ou aprs le second calque spcifi. Exemple L'exemple suivant place le calque ayant lindex 2 au niveau suprieur (au-dessus du calque ayant lindex 0) :
fl.getDocumentDOM().getTimeline().reorderLayer(2, 0);

L'exemple suivant place le calque ayant lindex 3 aprs le calque dot de lindex 5 :
fl.getDocumentDOM().getTimeline().reorderLayer(3, 5, false);

timeline.reverseFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.reverseFrames([startFrameIndex [, endFrameIndex]])

Paramtres
startFrameIndex Index en base zro qui spcifie la premire image partir de laquelle les images doivent tre

inverses. Si le paramtre startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image au niveau de laquelle les images doivent tre inverses ; la plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui inverse une plage dimages.

EXTENSION DE FLASH CS4 PROFESSIONAL 498

Objet Timeline

Exemple L'exemple suivant inverse les positions des calques actuellement slectionns :
fl.getDocumentDOM().getTimeline().reverseFrames();

L'exemple suivant inverse les images partir de limage 10 et jusqu limage 15 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().reverseFrames(9, 14);

timeline.selectAllFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.selectAllFrames()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui slectionne toutes les images du scnario actif. Exemple Lexemple suivant slectionne toutes les images du scnario actif.
fl.getDocumentDOM().getTimeline().selectAllFrames();

timeline.setFrameProperty()
Disponibilit Flash MX 2004. Utilisation
timeline.setFrameProperty(property, value [, startFrameIndex [, endFrameIndex]])

Paramtres property Chane spcifiant le nom de la proprit modifier. La liste complte des proprits et des valeurs est indique dans le Rsum des proprits de l'Objet Frame. Cette mthode ne permet pas de dfinir les proprits en lecture seule, telles que frame.duration et
frame.elements.

EXTENSION DE FLASH CS4 PROFESSIONAL 499

Objet Timeline

value Valeur affecter la proprit. Pour dterminer le type et les valeurs appropries, consultez le Rsum des proprits de l'Objet Frame. startFrameIndex Index en base zro qui spcifie le numro de l'image de dbut modifier. Si le paramtre

startFrameIndex est omis, la mthode utilise la slection actuelle. Ce paramtre est facultatif.
endFrameIndex Index en base zro qui spcifie la dernire image modifier. La plage stend jusqu endFrameIndex non compris. Si seul le paramtre startFrameIndex est transmis et que endFrameIndex est omis, la valeur de endFrameIndex prend par dfaut la valeur de startFrameIndex. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui dfinit la proprit de lobjet Frame pour les images slectionnes. Exemple L'exemple suivant affecte la commande ActionScript stop() la premire image du calque suprieur du document actif :
fl.getDocumentDOM().getTimeline().currentLayer = 0; fl.getDocumentDOM().getTimeline().setSelectedFrames(0,0,true); fl.getDocumentDOM().getTimeline().setFrameProperty("actionScript", "stop();");

L'exemple suivant dfinit une interpolation de mouvement des images comprises entre limage 2 et limage 5 non comprise (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
var doc = fl.getDocumentDOM(); doc.getTimeline().setFrameProperty("tweenType","motion",1,4);

timeline.setGuidelines()
Disponibilit Flash CS4 Professional. Utilisation
timeline.setGuidelines(xmlString)

Paramtres
xmlString Chane XML contenant des informations sur les guides appliquer.

Valeur renvoye Valeur boolenne, true si les guides ont bien t appliqus, false dans le cas contraire. Description Mthode qui remplace les guides du scnario (Affichage > Guides > Afficher les guides) par les informations spcifies dans xmlString. Pour rcuprer une chane XML pouvant tre transmise cette mthode, utilisez timeline.getGuidelines(). Pour afficher les guides nouvellement dfinis, vous devrez peut-tre les masquer, puis les rafficher.

EXTENSION DE FLASH CS4 PROFESSIONAL 500

Objet Timeline

Exemple L'exemple suivant applique les guides d'un fichier FLA un autre fichier FLA :
var doc0 = fl.documents[0]; var guides0 = doc0.timelines[0].getGuidelines(); var doc1 = fl.documents[1]; doc1.timelines[0].setGuidelines(guides0);

timeline.setLayerProperty()
Disponibilit Flash MX 2004. Utilisation
timeline.setLayerProperty(property, value [, layersToChange])

Paramtres property Chane spcifiant la proprit dfinir. Pour obtenir la liste des proprits, consultez l' Objet Layer la page 315.
value Valeur affecter la proprit. Faites appel au type de valeur utilis pour dfinir la proprit dans lobjet Layer. layersToChange Chane identifiant les calques modifier. Les valeurs acceptables sont "selected" (slectionn), "all" (tous) et "others" (autres). Si vous omettez ce paramtre, la valeur par dfaut est "selected". Ce paramtre

est facultatif. Valeur renvoye Aucune. Description Mthode qui donne une valeur spcifie la proprit spcifie pour tous les calques slectionns. Exemple L'exemple suivant rend invisibles le ou les calques slectionns :
fl.getDocumentDOM().getTimeline().setLayerProperty("visible", false);

Lexemple suivant dfinit sur selLayer le nom du ou des calques slectionns :

fl.getDocumentDOM().getTimeline().setLayerProperty("name", "selLayer");

timeline.setSelectedFrames()
Disponibilit Flash MX 2004. Utilisation
timeline.setSelectedFrames(startFrameIndex, endFrameIndex [, bReplaceCurrentSelection]) timeline.setSelectedFrames(selectionList [, bReplaceCurrentSelection])

EXTENSION DE FLASH CS4 PROFESSIONAL 501

Objet Timeline

Paramtres
startFrameIndex Index en base zro qui spcifie la premire image dfinir. endFrameIndex Index en base zro qui spcifie la fin de la slection ; endFrameIndex est limage qui suit la dernire

image de la plage slectionner.

bReplaceCurrentSelection Valeur boolenne ; si elle est true, les images actuellement slectionnes sont dslectionnes, puis les images spcifies sont slectionnes. La valeur par dfaut est true. selectionList Tableau de trois entiers renvoys par timeline.getSelectedFrames().

Valeur renvoye Aucune. Description Mthode qui slectionne une plage dimages dans le calque actif, ou applique les images slectionnes au tableau de slection transmis cette mthode. Exemple Les exemples suivants montrent deux manires de slectionner dans le calque suprieur la plage d'images allant de l'image 1 l'image 10 (non comprise) ; puis la plage de l'image 12 l'image 15 (non comprise) du mme calque pour l'ajouter la slection en cours (noubliez pas que les valeurs dindex diffrent des valeurs de numro dimage) :
fl.getDocumentDOM().getTimeline().setSelectedFrames(0, 9); fl.getDocumentDOM().getTimeline().setSelectedFrames(11, 14, false); fl.getDocumentDOM().getTimeline().setSelectedFrames([0, 0, 9]); fl.getDocumentDOM().getTimeline().setSelectedFrames([0, 11, 14], false);

L'exemple suivant stocke dans la variable savedSelectionList le tableau des images slectionnes, puis utilise ce tableau dans le code pour slectionner nouveau ces images aprs modification de la slection par le biais dune commande ou dune interaction de lutilisateur :
var savedSelectionList = fl.getDocumentDOM().getTimeline().getSelectedFrames(); // Do something that changes the selection. fl.getDocumentDOM().getTimeline().setSelectedFrames(savedSelectionList);

Voir aussi
timeline.getSelectedFrames()

timeline.setSelectedLayers()
Disponibilit Flash MX 2004. Utilisation
timeline.setSelectedLayers(index [, bReplaceCurrentSelection])

Paramtres index Index en base zro indiquant le calque slectionner.

EXTENSION DE FLASH CS4 PROFESSIONAL 502

Objet Timeline

bReplaceCurrentSelection Valeur boolenne. Si elle est true, la mthode remplace la slection actuelle ; si elle est false, la mthode tend la slection. La valeur par dfaut est true. Ce paramtre est facultatif.

Valeur renvoye Aucune. Description Mthode qui dfinit le calque slectionner, et fait du calque spcifi le calque actif. Lorsquun calque est slectionn, toutes ses images sont slectionnes. Exemple L'exemple suivant slectionne le calque suprieur :
fl.getDocumentDOM().getTimeline().setSelectedLayers(0);

L'exemple suivant ajoute le prochain calque la slection :

fl.getDocumentDOM().getTimeline().setSelectedLayers(1, false);

Voir aussi
timeline.getSelectedLayers()

timeline.showLayerMasking()
Disponibilit Flash MX 2004. Utilisation
timeline.showLayerMasking([layer])

Paramtres layer Index en base zro dun calque de masque ou dun calque masqu afficher durant la programmation. Ce paramtre est facultatif. Valeur renvoye Aucune. Description Mthode qui affiche les masques de calque pendant la programmation, en verrouillant le calque de masque et les calques masqus. Si aucun calque nest spcifi, la mthode sapplique au calque actif. Si cette mthode est utilise sur un calque qui nest pas de type Masque ou Masqu, Flash affiche une erreur dans le panneau Sortie. Exemple L'exemple suivant spcifie que le masquage du premier calque doit apparatre pendant la programmation.
fl.getDocumentDOM().getTimeline().showLayerMasking(0);

503

Chapitre 48 : Objet ToolObj

Disponibilit Flash MX 2004. Description Un objet toolObj reprsente un outil individuel dans le panneau Outils. Pour accder un objet ToolObj, utilisez les proprits de l'Objet Tools : le tableau tools.toolObjs ou tools.activeTool. Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet ToolObj : Remarque : ces mthodes ne sont utilises que lors de la cration doutils extensibles.
Mthode
toolObj.enablePIControl()

Description Active ou dsactive le contrle spcifi dans un inspecteur Proprits. Cette mthode nest utilise que lors de la cration doutils extensibles. Identifie un fichier PNG utiliser comme icne doutil dans le panneau Outils de Flash. Dfinit la chane qui doit apparatre dans le menu contextuel pour identifier loutil. Associe un fichier XML l'outil. Dfinit un inspecteur Proprits spcifique utiliser lorsque loutil est activ. Affecte un nom loutil pour la configuration du panneau Outils. Dfinit linfo-bulle qui doit apparatre lorsque la souris est amene sur licne de loutil. Affiche ou masque un contrle dans l'inspecteur Proprits. Appele dans la mthode configureTool() du fichier JavaScript de l'outil extensible pour indiquer que les poignes de transformation libre doivent apparatre lorsque loutil est actif.

toolObj.setIcon()

toolObj.setMenuString()

toolObj.setOptionsFile() toolObj.setPI() toolObj.setToolName() toolObj.setToolTip()

toolObj.showPIControl() toolObj.showTransformHandles()

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet ToolObj :
Proprit
toolObj.depth toolObj.iconID toolObj.position

Description Entier qui dfinit la profondeur de l'outil dans le menu contextuel du panneau Outils. Entier qui dfinit l'ID de ressource de l'outil. Lecture seule ; entier indiquant la position de loutil dans le panneau Outils.

EXTENSION DE FLASH CS4 PROFESSIONAL 504

Objet ToolObj

toolObj.depth
Disponibilit Flash MX 2004. Utilisation
toolObj.depth

Description Proprit en lecture seule ; entier qui dfinit la profondeur de l'outil dans le menu contextuel du panneau Outils. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant spcifie que l'outil possde une profondeur de 1, ce qui signifie qu'il se trouve un niveau en dessous d'un outil dans le panneau Outils :
fl.tools.activeTool.depth = 1;

toolObj.enablePIControl()
Disponibilit Flash MX 2004. Utilisation
toolObj.enablePIControl(control, bEnable)

Paramtres control Chane spcifiant le nom du contrle activer ou dsactiver. Les valeurs autorises dpendent de linspecteur Proprits appel par cet outil ; voir toolObj.setPI(). L'inspecteur Proprits dune forme possde les contrles suivants :
stroke fill

L'inspecteur Proprits dun texte possde les contrles suivants :

type color direction alignRight position rotation font bold alignLeft alignJustify autoKern format pointsize italic alignCenter spacing small lineType

EXTENSION DE FLASH CS4 PROFESSIONAL 505

Objet ToolObj

selectable deviceFonts link

html varEdit maxChars

border options target

L'inspecteur Proprits dun film possde les contrles suivants :

size framerate publish player background profile

bEnable Valeur boolenne indiquant si le contrle doit tre activ (true) ou non (false).

Valeur renvoye Aucune. Description Mthode qui active ou dsactive le contrle spcifi dans un inspecteur Proprits. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple Si la commande suivante est insre dans le fichier JavaScript dun outil extensible, Flash naffiche pas les options de trait dans linspecteur Proprits de cet outil :
theTool.enablePIControl("stroke",false);

toolObj.iconID
Disponibilit Flash MX 2004. Utilisation
toolObj.iconID

Description Proprit en lecture seule ; entier de valeur -1. Cette proprit s'utilise uniquement lors de la cration d'outils extensibles. Une valeur iconID de -1 signifie que Flash ne tentera pas de trouver une icne pour l'outil. Au contraire, le script de l'outil doit dfinir l'icne afficher dans le panneau Outils ; voir toolObj.setIcon(). Exemple L'exemple suivant attribue une valeur de -1 (l'ID d'icne de l'outil actuel) la variable toolIconID :
var toolIconID = fl.tools.activeTool.iconID

EXTENSION DE FLASH CS4 PROFESSIONAL 506

Objet ToolObj

toolObj.position
Disponibilit Flash MX 2004. Utilisation
toolObj.position

Description Proprit en lecture seule ; entier indiquant la position de loutil dans le panneau Outils. Cette proprit nest utilise que lors de la cration doutils extensibles. Exemple Si les commandes suivantes sont insres dans la mthode mouseDown() du fichier JavaScript dun outil extensible, la position de ce dernier dans le panneau Outils sera affiche sous forme d'entier dans le panneau Sortie :
myToolPos = fl.tools.activeTool.position; fl.trace(myToolPos);

toolObj.setIcon()
Disponibilit Flash MX 2004. Utilisation
toolObj.setIcon(file)

Paramtres file Chane spcifiant le nom du fichier PNG utiliser comme icne. Le fichier PNG doit tre plac dans le mme dossier que le fichier JSFL. Valeur renvoye Aucune. Description Mthode qui identifie un fichier PNG utiliser comme icne doutil dans le panneau Outils. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant indique que limage enregistre dans le fichier PolyStar.png doit tre utilise comme icne de loutil PolyStar. Ce code est extrait du fichier d'exemple PolyStar.jsfl (voir Exemple d'outil PolyStar la page 14) :
theTool = fl.tools.activeTool; theTool.setIcon("PolyStar.png");

EXTENSION DE FLASH CS4 PROFESSIONAL 507

Objet ToolObj

toolObj.setMenuString()
Disponibilit Flash MX 2004. Utilisation
toolObj.setMenuString(menuStr)

Paramtres menuStr Chane spcifiant le nom qui doit apparatre dans le menu contextuel pour identifier loutil. Valeur renvoye Aucune. Description Mthode qui dfinit la chane qui devant apparatre dans le menu contextuel pour identifier loutil. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant indique que loutil theTool doit afficher le nom PolyStarTool dans son menu contextuel. Ce code est extrait du fichier d'exemple PolyStar.jsfl (voir Exemple d'outil PolyStar la page 14) :
theTool = fl.tools.activeTool; theTool.setMenuString("PolyStar Tool");

toolObj.setOptionsFile()
Disponibilit Flash MX 2004. Utilisation
toolObj.setOptionsFile(xmlFile)

Paramtres xmlFile Chane spcifiant le nom du fichier XML qui contient la description des options de loutil. Le fichier XML doit tre plac dans le mme dossier que le fichier JSFL. Valeur renvoye Aucune. Description Mthode qui associe un fichier XML l'outil. Le fichier spcifie les options qui s'afficheront dans un panneau modal appel par un bouton Options dans linspecteur Proprits. Vous utiliserez en caractre rcuprer. gnrale cette mthode dans la fonction configureTool() intgre votre fichier JSFL. Voir configureTool(). Le fichier PolyStar.xml spcifie trois options associes l'outil Polygon :

EXTENSION DE FLASH CS4 PROFESSIONAL 508

Objet ToolObj

<properties> <property name="Style" variable="style" list="polygon,star" defaultValue="0" type="Strings"/> <property name="Number of Sides" variable="nsides" min="3" max="32" defaultValue="5" type="Number" /> <property name="Star point size" variable="pointParam" min="0" max="1" defaultValue=".5" type="Double" /> </properties>

Exemple L'exemple suivant spcifie que le fichier PolyStar.xml est associ loutil actif. Ce code est extrait du fichier d'exemple PolyStar.jsfl (voir Exemple d'outil PolyStar la page 14) :
theTool = fl.tools.activeTool; theTool.setOptionsFile("PolyStar.xml");

toolObj.setPI()
Disponibilit Flash MX 2004. Utilisation
toolObj.setPI(pi)

Paramtres pi Chane spcifiant linspecteur Proprits appeler pour cet outil. Valeur renvoye Aucune. Description Mthode qui dfinit un inspecteur Proprits spcifique utiliser lorsque loutil est activ. Cette mthode nest utilise que lors de la cration doutils extensibles. Les valeurs gres sont "shape" (forme, valeur par dfaut), "text" et "movie" (film).

EXTENSION DE FLASH CS4 PROFESSIONAL 509

Objet ToolObj

Exemple Lexemple suivant spcifie que linspecteur Proprits des formes doit tre utilis lorsque loutil est activ. Ce code est extrait du fichier d'exemple PolyStar.jsfl (voir Exemple d'outil PolyStar la page 14) :
theTool = fl.tools.activeTool; theTool.setPI("shape");

toolObj.setToolName()
Disponibilit Flash MX 2004. Utilisation
toolObj.setToolName(name)

Paramtres name Chane spcifiant le nom de loutil. Valeur renvoye Aucune. Description Mthode qui affecte un nom loutil pour la configuration du panneau Outils. Cette mthode nest utilise que lors de la cration doutils extensibles. Ce nom est uniquement utilis par le fichier XML de disposition que Flash lit pour construire le panneau Outils. Il napparat donc pas dans linterface utilisateur de Flash. Exemple L'exemple suivant affecte le nom polystar loutil nomm theTool. Ce code est extrait du fichier d'exemple PolyStar.jsfl (voir Exemple d'outil PolyStar la page 14) :
theTool = fl.tools.activeTool; theTool.setToolName("polystar");

toolObj.setToolTip()
Disponibilit Flash MX 2004. Utilisation
toolObj.setToolTip(toolTip)

Paramtres toolTip Chane spcifiant linfo-bulle utiliser pour cet outil. Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 510

Objet ToolObj

Description Mthode qui dfinit linfo-bulle qui doit apparatre lorsque la souris est amene sur licne de loutil. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple L'exemple suivant spcifie que linfo-bulle de loutil doit tre PolyStarTool. Ce code est extrait du fichier d'exemple PolyStar.jsfl (voir Exemple d'outil PolyStar la page 14) :
theTool = fl.tools.activeTool; theTool.setToolTip("PolyStar Tool");

toolObj.showPIControl()
Disponibilit Flash MX 2004. Utilisation
toolObj.showPIControl(control, bShow)

Paramtres control Chane spcifiant le nom du contrle afficher ou masquer. Cette mthode nest utilise que lors de la cration doutils extensibles. Les valeurs autorises dpendent de linspecteur Proprits appel par cet outil (voir toolObj.setPI()toolObj.setPI()). L'inspecteur Proprits dune forme possde les contrles suivants :
stroke fill

L'inspecteur Proprits dun texte possde les contrles suivants :

type color direction alignRight position rotation selectable deviceFonts link font bold alignLeft alignJustify autoKern format html varEdit maxChars pointsize italic alignCenter spacing small lineType border options target

L'inspecteur Proprits dun film possde les contrles suivants :

size framerate publish player background profile

EXTENSION DE FLASH CS4 PROFESSIONAL 511

Objet ToolObj

bShow Valeur boolenne indiquant si le contrle spcifi doit tre affich (true) ou masqu (false).

Valeur renvoye Aucune. Description Mthode qui affiche ou masque un contrle dans l'inspecteur Proprits. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple Si la commande suivante est insre dans le fichier JavaScript dun outil extensible, Flash naffiche pas les options de remplissage dans linspecteur Proprits de cet outil :
fl.tools.activeTool.showPIControl("fill", false);

toolObj.showTransformHandles()
Disponibilit Flash MX 2004. Utilisation
toolObj.showTransformHandles(bShow)

Paramtres bShow Valeur boolenne indiquant si les poignes de transformation libre de loutil actif doivent tre affiches (true) ou masques (false). Valeur renvoye Aucune. Description Mthode qui est appele par la mthode configureTool() du fichier JavaScript dun outil extensible pour indiquer que les poignes de transformation libre doivent apparatre lorsque loutil est actif. Cette mthode nest utilise que lors de la cration doutils extensibles. Exemple Voir configureTool().

512

Chapitre 49 : Objet Tools

Disponibilit Flash MX 2004. Description Lobjet Tools est accessible partir de lobjet flash (fl.tools). La proprit tools.toolObjs contient un tableau d'objets ToolObj, et la proprit tools.activeTool renvoie l'objet ToolObj pour l'outil actif. (Voir aussi Objet ToolObj et la liste d'outils extensibles dans Fonctions et mthodes de haut niveau la page 16.) Remarque : les mthodes et proprits suivantes sont uniquement utilises lors de la cration doutils extensibles. Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet Tools :
Mthode
tools.constrainPoint() tools.getKeyDown() tools.setCursor() tools.snapPoint()

Description Rcupre deux points et renvoie un nouveau point ajust ou impos. Renvoie la touche la plus rcemment appuye. Dfinit lapparence du pointeur. Reoit un point et en renvoie un nouveau qui peut tre ajust ou accroch lobjet gomtrique le plus proche.

Rsum des proprits Les proprits suivantes sont disponibles avec lobjet Tools :
Proprit
tools.activeTool tools.altIsDown tools.ctlIsDown tools.mouseIsDown tools.penDownLoc

Description Lecture seule ; renvoie l'Objet ToolObj pour l'outil actif. Lecture seule ; valeur boolenne qui indique si la touche Alt est enfonce. Lecture seule ; valeur boolenne qui indique si la touche Ctrl est enfonce. Lecture seule ; valeur boolenne qui indique si le bouton gauche de la souris est enfonc. Lecture seule ; point qui reprsente la position du dernier vnement de bouton de souris enfonc sur la scne. Lecture seule ; point reprsentant lemplacement actuel de la souris. Lecture seule ; valeur boolenne qui indique si la touche Maj est actuellement enfonce. Lecture seule ; tableau d'objets ToolObj.

tools.penLoc tools.shiftIsDown tools.toolObjs

tools.activeTool
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 513

Objet Tools

Utilisation
tools.activeTool

Description Proprit en lecture seule ; renvoie l'Objet ToolObj pour l'outil actif. Exemple L'exemple suivant enregistre un objet qui reprsente loutil actif dans la variable theTool :
var theTool = fl.tools.activeTool;

tools.altIsDown
Disponibilit Flash MX 2004. Utilisation
tools.altIsDown

Description Proprit en lecture seule ; valeur boolenne qui indique si la touche Alt est actuellement enfonce. Sa valeur est true si la touche Alt est enfonce, ou false dans le cas contraire. Exemple L'exemple suivant dtermine si la touche Alt est enfonce :
var isAltDown = fl.tools.altIsDown;

tools.constrainPoint()
Disponibilit Flash MX 2004. Utilisation
tools.constrainPoint(pt1, pt2)

Paramtres pt1, pt2 Points indiquant respectivement le point auquel le clic a eu lieu et le point jusquauquel le bouton de la souris est rest enfonc. Valeur renvoye Nouveau point ajust ou impos.

EXTENSION DE FLASH CS4 PROFESSIONAL 514

Objet Tools

Description Mthode qui reoit deux points et renvoie un nouveau point ajust ou impos. Si la touche Maj est enfonce lors de l'excution de la commande, le point renvoy est impos, soit pour contraindre un angle 45 (par exemple pour une ligne termine par une flche), soit pour obliger un objet a conserver ses proportions (par exemple pour tracer un carr parfait laide de loutil Rectangle). Exemple L'exemple suivant renvoie un point impos :
pt2 = fl.tools.constrainPoint(pt1, tempPt);

tools.ctlIsDown
Disponibilit Flash MX 2004. Utilisation
tools.ctlIsDown

Description Proprit en lecture seule ; valeur boolenne dfinie sur true si la touche Ctrl est enfonce, false dans le cas contraire. Exemple L'exemple suivant dtermine si la touche Ctrl est enfonce :
var isCtrldown = fl.tools.ctrlIsDown;

tools.getKeyDown()
Disponibilit Flash MX 2004. Utilisation
tools.getKeyDown()

Paramtres Aucun. Valeur renvoye La valeur entire de la touche. Description Mthode qui renvoie la touche la plus rcemment appuye.

EXTENSION DE FLASH CS4 PROFESSIONAL 515

Objet Tools

Exemple L'exemple suivant affiche la valeur d'entier de la touche la plus rcemment enfonce :
var theKey = fl.tools.getKeyDown(); fl.trace(theKey);

tools.mouseIsDown
Disponibilit Flash MX 2004. Utilisation
tools.mouseIsDown

Description Proprit en lecture seule ; valeur boolenne dfinie sur true si le bouton gauche de la souris est actuellement enfonc, false dans le cas contraire. Exemple L'exemple suivant dtermine si le bouton gauche de la souris est enfonc.
var isMouseDown = fl.tools.mouseIsDown;

tools.penDownLoc
Disponibilit Flash MX 2004. Utilisation
tools.penDownLoc

Description Proprit en lecture seule ; point qui reprsente la position du dernier vnement de bouton de souris enfonc sur la scne. La proprit tools.penDownLoc comprend deux proprits, x et y, qui correspondent la position x,y du pointeur de la souris. Exemple L'exemple suivant dtermine la position du dernier vnement de bouton de souris enfonc sur la scne et affiche les valeurs x et y dans le panneau Sortie :
var pt1 = fl.tools.penDownLoc; fl.trace("x,y location of last mouseDown event was " + pt1.x + ", " + pt1.y)

Voir aussi
tools.penLoc

EXTENSION DE FLASH CS4 PROFESSIONAL 516

Objet Tools

tools.penLoc
Disponibilit Flash MX 2004. Utilisation
tools.penLoc

Description Proprit en lecture seule ; point reprsentant lemplacement actuel du pointeur de la souris. La proprit tools.penLoc comprend deux proprits, x et y, qui correspondent la position x,y du pointeur de la souris. Exemple L'exemple suivant dtermine lemplacement actuel de la souris :
var tempPt = fl.tools.penLoc;

Voir aussi
tools.penDownLoc

tools.setCursor()
Disponibilit Flash MX 2004. Utilisation
tools.setCursor(cursor)

Paramtres cursor Entier dfinissant lapparence du pointeur, dcrite dans la liste suivante :

0 = curseur Plus (+) 1 = flche noire 2 = flche blanche 3 = flche quatre directions 4 = flche bidirectionnelle horizontale 5 = flche bidirectionnelle verticale 6=X 7 = curseur main
Valeur renvoye Aucune.

EXTENSION DE FLASH CS4 PROFESSIONAL 517

Objet Tools

Description Mthode qui donne lapparence spcifie au pointeur. Exemple Lexemple suivant donne laspect dune flche noire au pointeur.
fl.tools.setCursor(1);

tools.shiftIsDown
Disponibilit Flash MX 2004. Utilisation
tools.shiftIsDown

Description Proprit en lecture seule ; valeur boolenne dfinie sur true si la touche Maj est enfonce, false dans le cas contraire. Exemple L'exemple suivant dtermine si la touche Maj est enfonce.
var isShiftDown = fl.tools.shiftIsDown;

tools.snapPoint()
Disponibilit Flash MX 2004. Utilisation
tools.snapPoint(pt)

Paramtres pt Spcifie lemplacement du point pour lequel un point daccrochage doit tre renvoy. Valeur renvoye Nouveau point qui peut tre ajust ou accroch l'objet gomtrique le plus proche. Description Mthode qui reoit un point et en renvoie un nouveau qui peut tre ajust ou accroch lobjet gomtrique le plus proche. Si laccrochage a t dsactiv dans le menu Affichage de linterface utilisateur de Flash, le point renvoy est le point d'origine. Exemple L'exemple suivant renvoie un nouveau point qui peut tre accroch l'objet gomtrique le plus proche :

EXTENSION DE FLASH CS4 PROFESSIONAL 518

Objet Tools

var theSnapPoint = fl.tools.snapPoint(pt1);

tools.toolObjs
Disponibilit Flash MX 2004. Utilisation
tools.toolObjs

Description Proprit en lecture seule ; tableau d'objets ToolObj (voir Objet ToolObj).

519

Chapitre 50 : Objet Vertex

Disponibilit Flash MX 2004. Description Lobjet Vertex est la partie de la structure de donnes dune forme qui contient les coordonnes. Rsum des mthodes Vous pouvez utiliser les mthodes suivantes avec lobjet Vertex :
Mthode
vertex.getHalfEdge() vertex.setLocation()

Description Rcupre un objet Objet halfEdge qui partage ce sommet. Dfinit lemplacement du sommet.

Rsum des proprits Les proprits suivantes sont disponibles pour lobjet Vertex :
Proprit
vertex.x vertex.y

Description Lecture seule ; emplacement de la coordonne x du sommet, en pixels. Lecture seule ; emplacement de la coordonne y du sommet, en pixels.

vertex.getHalfEdge()
Disponibilit Flash MX 2004. Utilisation
vertex.getHalfEdge()

Paramtres Aucun. Valeur renvoye Objet Objet halfEdge. Description Mthode qui rcupre un objet Objet halfEdge qui partage ce sommet. Exemple L'exemple suivant montre comment obtenir les autres demi-contours qui partagent le mme sommet :

EXTENSION DE FLASH CS4 PROFESSIONAL 520

Objet Vertex

var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge(0); var theVertex = hEdge.getVertex(); var someHEdge = theVertex.getHalfEdge(); // Not necessarily the same half edge var theSameVertex = someHEdge.getVertex(); fl.trace('the same vertex: ' + theSameVertex);

vertex.setLocation()
Disponibilit Flash MX 2004. Utilisation
vertex.setLocation(x, y)

Paramtres x Valeur en virgule flottante indiquant la coordonne x de la position souhaite pour le sommet, en pixels.
y Valeur en virgule flottante indiquant la coordonne y de la position souhaite pour le sommet, en pixels.

Valeur renvoye Aucune. Description Mthode qui dfinit lemplacement du sommet. Il est ncessaire dappeler shape.beginEdit() avant d'utiliser cette mthode. Exemple Lexemple suivant dfinit le sommet sur le point dorigine :
var shape = fl.getDocumentDOM().selection[0]; shape.beginEdit(); var hEdge = shape.edges[0].getHalfEdge(0); var vertex = hEdge.getVertex(); var someHEdge = vertex.getHalfEdge(); var vertex = someHEdge.getVertex(); // Move the vertex to the origin. vertex.setLocation(0.0, 0.0); shape.endEdit();

vertex.x
Disponibilit Flash MX 2004. Utilisation
vertex.x

EXTENSION DE FLASH CS4 PROFESSIONAL 521

Objet Vertex

Description Proprit en lecture seule ; emplacement de la coordonne x du sommet, en pixels. Exemple L'exemple suivant affiche dans le panneau Sortie les coordonnes x et y du sommet :
var shape = fl.getDocumentDOM().selection[0]; var hEdge = shape.edges[0].getHalfEdge(0); var vertex = hEdge.getVertex(); fl.trace('x location of vertex is: ' + vertex.x); fl.trace('y location of vertex is: ' + vertex.y);

vertex.y
Disponibilit Flash MX 2004. Utilisation
vertex.y

Description Proprit en lecture seule ; emplacement de la coordonne y du sommet, en pixels. Exemple Voir vertex.x.

522

Chapitre 51 : Objet VideoItem

Hritage

Objet Item > Objet VideoItem

Disponibilit Flash MX 2004. Description Lobjet VideoItem est une sous-classe de lobjet Objet Item. Rsum des mthodes Outre les mthodes de l'objet Item, l'objet VideoItem gre la mthode suivante :
Proprit
videoItem.exportToFLV()

Description Exporte l'lment spcifi dans un fichier FLV.

Rsum des proprits Outre celles de lobjet Item, l'objet VideoItem gre les proprits suivantes :
Proprit
videoItem.fileLastModifiedDate

Description Lecture seule ; chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1er janvier 1970 et la date de modification du fichier original (sur disque) au moment o il a t import dans la bibliothque. Lecture seule ; valeur boolenne qui spcifie si le fichier import dans la bibliothque existe toujours l'emplacement d'o il provient. Lecture seule ; valeur boolenne qui spcifie si la date de modification du fichier de l'lment de la bibliothque correspond celle trouve sur le disque du fichier import. Lecture seule ; chane reprsentant le chemin daccs l'lment vido. Lecture seule ; chane spcifiant le type de la vido reprsente par l'lment.

videoItem.sourceFileExists

videoItem.sourceFileIsCurrent

videoItem.sourceFilePath videoItem.videoType

videoItem.exportToFLV()
Disponibilit Flash CS4 Professional. Utilisation
videoItem.exportToFLV(fileURI)

Paramtres fileURI Chane exprime sous la forme fichier:///URI et spcifiant le chemin et le nom du fichier export.

EXTENSION DE FLASH CS4 PROFESSIONAL 523

Objet VideoItem

Valeur renvoye Valeur boolenne, true si le fichier a bien t export, false dans le cas contraire. Description Mthode qui exporte l'lment spcifi dans un fichier FLV. Exemple En supposant que le premier lment de la bibliothque soit un lment vido, le code suivant l'exporte sous forme de fichier FLV :
var videoFileURL = "file:///C|/out.flv"; var libItem = fl.getDocumentDOM().library.items[0]; libItem.exportToFLV(videoFileURL);

videoItem.fileLastModifiedDate
Disponibilit Flash CS4 Professional. Utilisation
videoItem.fileLastModifiedDate

Description Proprit en lecture seule ; chane contenant un nombre hexadcimal qui reprsente le nombre de secondes coules entre le 1 janvier 1970 et la date de modification du fichier original (sur disque) au moment o le fichier a t import dans la bibliothque. Si le fichier n'existe plus, cette valeur est 00000000 . Exemple En supposant que le premier lment de la bibliothque soit un lment vido, le code suivant affiche un nombre hexadcimal tel que dcrit ci-dessus :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("Mod date when imported = " + libItem.fileLastModifiedDate);

Voir aussi
videoItem.sourceFileExists, videoItem.sourceFileIsCurrent, videoItem.sourceFilePath, FLfile.getModificationDate()

videoItem.sourceFileExists
Disponibilit Flash CS4 Professional. Utilisation
videoItem.sourceFileExists

EXTENSION DE FLASH CS4 PROFESSIONAL 524

Objet VideoItem

Description Proprit en lecture seule : valeur boolenne true si le fichier import dans la bibliothque existe toujours l'emplacement d'o il provient ; false dans le cas contraire. Exemple En supposant que le premier lment de la bibliothque soit un lment vido, le code suivant affiche true si le fichier import dans la bibliothque existe toujours :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("sourceFileExists = "+ libItem.sourceFileExists);

Voir aussi
videoItem.sourceFileIsCurrent, videoItem.sourceFilePath

videoItem.sourceFileIsCurrent
Disponibilit Flash CS4 Professional. Utilisation
videoItem.sourceFileIsCurrent

Description Proprit en lecture seule ; valeur boolenne, true si la date de modification du fichier de l'lment de la bibliothque correspond la date de modification sur disque du fichier import ; false dans le cas contraire. Exemple En supposant que le premier lment de la bibliothque soit un lment vido, le code suivant affiche true si le fichier import n'a pas t modifi sur le disque depuis son importation :
var libItem = fl.getDocumentDOM().library.items[0]; fl.trace("fileIsCurrent = "+ libItem.sourceFileIsCurrent);

Voir aussi
videoItem.fileLastModifiedDate, videoItem.sourceFilePath

videoItem.sourceFilePath
Disponibilit Flash 8. Utilisation
videoItem.sourceFilePath

Description Proprit en lecture seule ; chane de type fichier:///URI qui reprsente le chemin daccs llment vido.

EXTENSION DE FLASH CS4 PROFESSIONAL 525

Objet VideoItem

Exemple L'exemple suivant affiche le nom et le chemin d'accs source de tout lment de la bibliothque de type video :
for (idx in fl.getDocumentDOM().library.items) { if (fl.getDocumentDOM().library.items[idx].itemType == "video") { var myItem = fl.getDocumentDOM().library.items[idx]; fl.trace(myItem.name + " source is " + myItem.sourceFilePath); } }

Voir aussi
videoItem.sourceFileExists

videoItem.videoType
Disponibilit Flash 8. Utilisation
videoItem.videoType

Description Proprit en lecture seule ; chane spcifiant le type de vido reprsent par l'lment. Les valeurs gres sont "embeddedvideo", "linkedvideo" et "video". Exemple L'exemple suivant affiche le nom et le type de tout lment de la bibliothque de type video :
for (idx in fl.getDocumentDOM().library.items) { if (fl.getDocumentDOM().library.items[idx].itemType == "video") { var myItem = fl.getDocumentDOM().library.items[idx]; fl.trace(myItem.name + " is " + myItem.videoType); } }

526

Chapitre 52 : Objet XMLUI

Disponibilit Flash MX 2004. Description Flash 8 prend en charge des botes de dialogue personnalises crites laide dun sous-ensemble du langage XUL (XML User Interface Language). Une bote de dialogue XMLUI (XML User Interface) peut tre utilise par plusieurs fonctionnalits de Flash, telles que les commandes et les comportements, pour offrir une interface utilisateur de nouvelles fonctionnalits cres avec lAPI dextensibilit. Lobjet XMLUI permet de lire et dfinir les proprits dune bote de dialogue XMLUI, et den accepter ou d'en annuler une. Les mthodes XMLUI peuvent tre utilises dans des fonctions de rappel, telles que les gestionnaires oncommand des boutons. Il est possible de crer un fichier dialog.xml et de lappeler partir de lAPI JavaScript avec la mthode document.xmlPanel(). Pour rcuprer un objet reprsentant la bote de dialogue XMLUI en cours, utilisez fl.xmlui. Rsum des mthodes Les mthodes suivantes sont disponibles avec lobjet XMLUI :
Mthode
xmlui.accept() xmlui.cancel() xmlui.get()

Description Ferme la bote de dialogue XMLUI actuelle avec ltat dacceptation. Ferme la bote de dialogue XMLUI active avec ltat dannulation. Rcupre la valeur de la proprit spcifie de la bote de dialogue XMLUI actuelle. Renvoie llment de contrle actif pour le contrle spcifi. Renvoie une valeur boolenne qui spcifie si le contrle est activ ou dsactiv (affich en gris). Renvoie une valeur boolenne qui spcifie si le contrle est visible ou masqu. Modifie la valeur de la proprit spcifie de la bote de dialogue XMLUI actuelle. Dfinit le libell et la valeur de llment actif. Dfinit les paires libell et valeur de llment actif. Active ou dsactive (affiche en gris) un contrle. Affiche ou masque un contrle.

xmlui.getControlItemElement() xmlui.getEnabled()

xmlui.getVisible() xmlui.set()

xmlui.setControlItemElement() xmlui.setControlItemElements() xmlui.setEnabled() xmlui.setVisible()

xmlui.accept()
Disponibilit Flash MX 2004.

EXTENSION DE FLASH CS4 PROFESSIONAL 527

Objet XMLUI

Utilisation
xmlui.accept()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui ferme la bote de dialogue XMLUI avec un tat dacceptation, ce qui est quivalent un clic sur le bouton OK. Voir aussi fl.xmlui, document.xmlPanel(), xmlui.cancel()

xmlui.cancel()
Disponibilit Flash MX 2004. Utilisation
xmlui.cancel()

Paramtres Aucun. Valeur renvoye Aucune. Description Mthode qui ferme la bote de dialogue XMLUI avec un tat dannulation, ce qui est quivalent un clic sur le bouton Annuler. Voir aussi fl.xmlui, document.xmlPanel(), xmlui.accept()

xmlui.get()
Disponibilit Flash MX 2004. Utilisation
xmlui.get(controlPropertyName)

EXTENSION DE FLASH CS4 PROFESSIONAL 528

Objet XMLUI

Paramtres
controlPropertyName Chane spcifiant le nom de la proprit XMLUI dont vous recherchez la valeur.

Valeur renvoye Chane reprsentant la valeur de la proprit spcifie. Dans les cas o une valeur boolenne true ou false est attendue, cette mthode renvoie la chane "true" ou "false". Description Mthode qui rcupre la valeur de la proprit spcifie de la bote de dialogue XMLUI active. Exemple L'exemple suivant renvoie la valeur de la proprit nomme URL :
fl.xmlui.get("URL");

Voir aussi fl.xmlui, document.xmlPanel(), xmlui.getControlItemElement(), xmlui.set()

xmlui.getControlItemElement()
Disponibilit Flash 8. Utilisation
xmlui.getControlItemElement(controlPropertyName)

Paramtres
controlPropertyName Chane spcifiant la proprit dont vous souhaitez rcuprer llment de contrle.

Valeur renvoye Objet reprsentant llment de contrle actif pour le contrle spcifi par controlPropertyName. Description Mthode qui renvoie le libell et la valeur de la ligne slectionne dans un contrle de type zone de liste (ListBox) ou zone droulante (ComboBox) pour le contrle spcifi par le paramtre controlPropertyName. Exemple L'exemple suivant renvoie le libell et la valeur de la ligne actuellement slectionne pour le contrle myListBox :
var elem = new Object(); elem = fl.xmlui.getControlItemElement("myListBox"); fl.trace("label = " + elem.label + " value = " + elem.value);

Voir aussi fl.xmlui, document.xmlPanel(), xmlui.get(), xmlui.setControlItemElement(),

xmlui.setControlItemElements()

EXTENSION DE FLASH CS4 PROFESSIONAL 529

Objet XMLUI

xmlui.getEnabled()
Disponibilit Flash 8. Utilisation
xmlui.getEnabled(controlID)

Paramtres
controlID Chane spcifiant l'attribut ID du contrle dont vous recherchez l'tat.

Valeur renvoye Valeur boolenne, true si le contrle est activ, false dans le cas contraire. Description Mthode qui renvoie une valeur boolenne indiquant si le contrle est activ ou dsactiv (affich en gris). Exemple L'exemple suivant renvoie une valeur indiquant si le contrle dont l'attribut ID correspond myListBox est activ :
var isEnabled = fl.xmlui.getEnabled("myListBox"); fl.trace(isEnabled);

Voir aussi fl.xmlui, document.xmlPanel(), xmlui.setEnabled()

xmlui.getVisible()
Disponibilit Flash 8. Utilisation
xmlui.getVisible(controlID)

Paramtres
controlID Chane spcifiant l'attribut ID du contrle dont vous recherchez l'tat de visibilit.

Valeur renvoye Valeur boolenne, true si le contrle est visible, ou false s'il est invisible (masqu). Description Mthode qui renvoie une valeur boolenne indiquant si le contrle est visible ou masqu. Exemple L'exemple suivant renvoie une valeur indiquant si le contrle dont l'attribut ID correspond myListBox est visible :

EXTENSION DE FLASH CS4 PROFESSIONAL 530

Objet XMLUI

var isVisible = fl.xmlui.getVisible("myListBox"); fl.trace(isVisible);

Voir aussi
xmlui.setVisible()

xmlui.set()
Disponibilit Flash MX 2004. Utilisation
xmlui.set(controlPropertyName, value)

Paramtres
controlPropertyName Chane spcifiant le nom de la proprit XMLUI modifier. value Chane spcifiant la valeur donner la proprit XMLUI.

Valeur renvoye Aucune. Description Mthode qui modifie la valeur de la proprit spcifie de la bote de dialogue XMLUI active. Exemple L'exemple suivant dfinit la valeur d'une proprit nomme URL sur www.adobe.com :
fl.xmlui.set("URL", "www.adobe.com");

Voir aussi fl.xmlui, document.xmlPanel(), xmlui.get(), xmlui.setControlItemElement(),

xmlui.setControlItemElements()

xmlui.setControlItemElement()
Disponibilit Flash 8. Utilisation
xmlui.setControlItemElement(controlPropertyName, elementItem)

Paramtres
controlPropertyName Chane spcifiant llment de contrle dfinir.

EXTENSION DE FLASH CS4 PROFESSIONAL 531

Objet XMLUI

elementItem Objet JavaScript dot d'une proprit de chane nomme label et d'une proprit de chane facultative

nomme value. Si la proprit value nexiste pas, elle est cre et reoit la mme valeur que label. Valeur renvoye Aucune. Description Mthode qui dfinit le libell et la valeur de la ligne actuellement slectionne dans le contrle de type zone de liste (ListBox) ou zone droulante (ComboBox) spcifi par le paramtre controlPropertyName. Exemple L'exemple suivant dfinit le libell et la valeur de l'lment actif de la proprit de contrle PhoneNumber :
var elem = new Object(); elem.label = "Fax"; elem.value = "707-555-5555"; fl.xmlui.setControlItemElement("PhoneNumber",elem);

Voir aussi fl.xmlui, document.xmlPanel(), xmlui.getControlItemElement(), xmlui.set(),

xmlui.setControlItemElements()

xmlui.setControlItemElements()
Disponibilit Flash 8. Utilisation
xmlui.setControlItemElements(controlID, elementItemArray)

Paramtres
controlID Chane spcifiant l'attribut ID du contrle dfinir. elementItemArray Tableau constitu dobjets JavaScript dots chacun d'une proprit de chane nomme label et d'une proprit de chane facultative nomme value. Si la proprit value nexiste pas, elle est cre et reoit la mme valeur que label.

Valeur renvoye Aucune. Description Mthode qui efface les valeurs du contrle de type zone de liste ou zone droulante spcifi par controlID et remplace les lments de liste ou les commandes de menu par les paires label, value spcifies par elementItemArray. Exemple L'exemple suivant dfinit le libell et la valeur des lments associs au contrle possdant l'attribut d'ID myControlID sur les paires label,value spcifies :

EXTENSION DE FLASH CS4 PROFESSIONAL 532

Objet XMLUI

var nameArray = new Array("January", "February", "March"); var monthArray = new Array(); for (i=0;i<nameArray.length;i++){ elem = new Object(); elem.label = nameArray[i]; elem.value = i; monthArray[i] = elem; } fl.xmlui.setControlItemElements("myControlID", monthArray);

Voir aussi
xmlui.getControlItemElement(), xmlui.set(), xmlui.setControlItemElement()

xmlui.setEnabled()
Disponibilit Flash 8. Utilisation
xmlui.setEnabled(controlID, enable)

Paramtres
controlID Chane spcifiant l'attribut ID du contrle activer ou dsactiver. enable Valeur boolenne, true si vous souhaitez activer le contrle, false pour le dsactiver (l'afficher en gris).

Valeur renvoye Aucune. Description Mthode qui active ou dsactive (affiche en gris) un contrle. Exemple L'exemple suivant affiche en gris le contrle dont l'attribut ID est myControl :
fl.xmlui.setEnabled("myControl", false);

Voir aussi
xmlui.getEnabled()

xmlui.setVisible()
Disponibilit Flash 8. Utilisation
xmlui.setVisible(controlID, visible)

EXTENSION DE FLASH CS4 PROFESSIONAL 533

Objet XMLUI

Paramtres
controlID Chane spcifiant l'attribut ID du contrle afficher ou masquer. visible Valeur boolenne, true si vous voulez afficher le contrle, et false pour le masquer.

Valeur renvoye Aucune. Description Mthode qui affiche ou masque un contrle. Exemple L'exemple suivant masque le contrle dont l'attribut ID est myControl :
fl.xmlui.setVisible("myControl", false);

Voir aussi
xmlui.getVisible()

534

Chapitre 53 : Extensibilit de niveau C

Ce chapitre dcrit le mcanisme dextensibilit de niveau C qui permet dimplmenter des fichiers dextension Adobe Flash CS4 Professional laide dune combinaison de codes JavaScript et C personnalis. Ce mcanisme n'a pas t modifi dans cette version de Flash.

A propos de l'extensibilit
Pour implmenter l'extensibilit, les fonctions sont dfinies en C, puis regroupes dans une DLL ou une bibliothque partage qui est ensuite enregistre dans le rpertoire appropri. Ces fonctions peuvent alors tre appeles en JavaScript laide de lAPI JavaScript d'Adobe Flash. Par exemple, il est possible de dfinir en C une fonction effectuant des calculs complexes beaucoup plus rapidement quen JavaScript, ou de crer des outils ou des effets trs sophistiqus. Ce mcanisme dextensibilit est un sous-ensemble de lAPI d'Adobe Dreamweaver CS3. Si vous connaissez dj cette API, les fonctions de lAPI du mcanisme dextensibilit de niveau C ne vous sembleront pas vraiment trangres. Toutefois, cette API diffre de lAPI de Dreamweaver sur certains points :

Cette API ne contient pas toutes les commandes de lAPI de Dreamweaver. Toutes les dclarations qui sont de type wchar_t et char dans lAPI de Dreamweaver sont implmentes comme
dclarations unsigned short dans celle-ci, afin dassurer la prise en charge dUnicode pour le transfert de chanes.

La fonction JSVal

JS_BytesToValue() de cette API ne figure pas dans lAPI de Dreamweaver.

Lemplacement o les DLL et les fichiers de bibliothque partage doivent tre stocks est diffrent (voir
Intgration de fonctions en C la page 534).

Intgration de fonctions en C
Le mcanisme dextensibilit de niveau C permet dimplmenter des fichiers dextension Flash laide dune combinaison de codes JavaScript et C. Le processus dimplmentation de cette possibilit se rsume ainsi :
1 Dfinir des fonctions en langage C ou C++. 2 Regrouper ces fonctions dans une DLL (Windows) ou une bibliothque partage (Macintosh). 3 Enregistrer le fichier de la DLL ou de la bibliothque lemplacement appropri :

Windows Vista :
lecteur d'amorage \Users\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS3\langue\Configuration\External Libraries

Windows XP :
lecteur d'amorage \Documents and Settings\nom d'utilisateur\Local Settings\Application Data\Adobe\Flash CS3\langue\Configuration\External Libraries

Mac OS X :

EXTENSION DE FLASH CS4 PROFESSIONAL 535

Extensibilit de niveau C

Disque dur Macintosh/Users/nom d'utilisateur/Library/Application Support/Adobe/Flash CS3/langue/Configuration/External Libraries

4 Crez un fichier JSFL qui appelle ces fonctions. 5 Excuter le fichier JSFL partir du menu Commandes dans lenvironnement de programmation Flash.

Pour plus d'informations, consultez Exemple d'implmentation d'une DLL la page 538.

Extensibilit de niveau C et interprteur JavaScript

Linteraction entre l'API JavaScript de Flash et le code C contenu dans la DLL ou la bibliothque partage comporte trois tapes :

Au dmarrage, pour enregistrer les fonctions de la bibliothque Lors de lappel de la fonction en C, pour transmettre les arguments passs de JavaScript en C Avant le retour de la fonction C, pour transmettre la valeur renvoye
Pour accomplir ces tches, linterprteur dfinit plusieurs types de donnes et expose une API. Les dfinitions des types de donnes et des fonctions prsentes dans cette section apparaissent dans le fichier mm_jsapi.h. Pour permettre votre bibliothque de fonctionner correctement, vous devez indiquer en "include" le fichier mm_jsapi.h au dbut de chaque fichier de votre bibliothque, laide de la ligne suivante :
#include "mm_jsapi.h"

Cette inclusion du fichier mm_jsapi.h comprend galement le fichier mm_jsapi_environment.h qui dfinit la structure MM_Environment. Pour obtenir le fichier mm_jsapi.h, vous pouvez l'extraire du fichier dexemple ZIP ou SIT (voir Exemple d'implmentation d'une DLL la page 538) ou copier le code ci-dessous dans un fichier nomm mm_jsapi.h :
#ifndef _MM_JSAPI_H_ #define _MM_JSAPI_H_ /***************************************************************************** * Public data types ****************************************************************************/ typedef typedef typedef #ifndef typedef #endif struct JSContext JSContext; struct JSObject JSObject; long jsval; JSBool long JSBool;

typedef JSBool (*JSNative)(JSContext *cx, JSObject *obj, unsigned int argc, jsval *argv, jsval *rval); /* Possible values for JSBool */ #define JS_TRUE 1 #define JS_FALSE 0

/***************************************************************************** * Public functions ****************************************************************************/

EXTENSION DE FLASH CS4 PROFESSIONAL 536

Extensibilit de niveau C

/* JSBool JS_DefineFunction(unsigned short *name, JSNative call, unsigned int nargs) */ #define JS_DefineFunction(n, c, a) \ (mmEnv.defineFunction ? (*(mmEnv.defineFunction))(mmEnv.libObj, n, c, a) \ : JS_FALSE) /* unsigned short *JS_ValueToString(JSContext *cx, jsval v, unsigned int *pLength) */ #define JS_ValueToString(c, v, l) \ (mmEnv.valueToString? (*(mmEnv.valueToString))(c, v, l) : (char *)0) /* unsigned char *JS_ValueToBytes(JSContext *cx, jsval v, unsigned int *pLength) */ #define JS_ValueToBytes(c, v, l) \ (mmEnv.valueToBytes? (*(mmEnv.valueToBytes))(c, v, l) : (unsigned char *)0) /* JSBool JS_ValueToInteger(JSContext *cx, jsval v, long *lp); */ #define JS_ValueToInteger(c, v, l) \ (mmEnv.valueToInteger ? (*(mmEnv.valueToInteger))(c, v, l) : JS_FALSE) /* JSBool JS_ValueToDouble(JSContext *cx, jsval v, double *dp); */ #define JS_ValueToDouble(c, v, d) \ (mmEnv.valueToDouble? (*(mmEnv.valueToDouble))(c, v, d) : JS_FALSE) /* JSBool JS_ValueToBoolean(JSContext *cx, jsval v, JSBool *bp); */ #define JS_ValueToBoolean(c, v, b) \ (mmEnv.valueToBoolean ? (*(mmEnv.valueToBoolean))(c, v, b) : JS_FALSE) /* JSBool JS_ValueToObject(JSContext *cx, jsval v, JSObject **op); */ #define JS_ValueToObject(c, v, o) \ (mmEnv.valueToObject? (*(mmEnv.valueToObject))(c, v, o) : JS_FALSE) /* JSBool JS_StringToValue(JSContext *cx, unsigned short *bytes, uint sz, jsval *vp); */ #define JS_StringToValue(c, b, s, v) \ (mmEnv.stringToValue? (*(mmEnv.stringToValue))(c, b, s, v) : JS_FALSE) /* JSBool JS_BytesToValue(JSContext *cx, unsigned char *bytes, uint sz, jsval *vp); */ #define JS_BytesToValue(c, b, s, v) \ (mmEnv.bytesToValue? (*(mmEnv.bytesToValue))(c, b, s, v) : JS_FALSE) /* JSBool JS_DoubleToValue(JSContext *cx, double dv, jsval *vp); */ #define JS_DoubleToValue(c, d, v) \ (mmEnv.doubleToValue? (*(mmEnv.doubleToValue))(c, d, v) : JS_FALSE) /* jsval JS_IntegerToValue(long lv); */ #define JS_IntegerToValue(lv) (((jsval)(lv) << 1) | 0x1) /* jsval JS_BooleanToValue(JSBool bv); */ #define JS_BooleanToValue(bv) (((jsval)(bv) << 3) | 0x6) /* jsval JS_ObjectToValue(JSObject *obj); */ #define JS_ObjectToValue(ov)((jsval)(ov)) /* unsigned short *JS_ObjectType(JSObject *obj); */ #define JS_ObjectType(o) \ (mmEnv.objectType ? (*(mmEnv.objectType))(o) : (char *)0) /* JSObject *JS_NewArrayObject(JSContext *cx, unsigned int length, jsval *v) */ #define JS_NewArrayObject(c, l, v) \

EXTENSION DE FLASH CS4 PROFESSIONAL 537

Extensibilit de niveau C

(mmEnv.newArrayObject ? (*(mmEnv.newArrayObject))(c, l, v) : (JSObject *)0) /* long JS_GetArrayLength(JSContext *cx, JSObject *obj) */ #define JS_GetArrayLength(c, o) \ (mmEnv.getArrayLength ? (*(mmEnv.getArrayLength))(c, o) : -1) /* JSBool JS_GetElement(JSContext *cx, JSObject *obj, jsint idx, jsval *vp) */ #define JS_GetElement(c, o, i, v) \ (mmEnv.getElement ? (*(mmEnv.getElement))(c, o, i, v) : JS_FALSE) /* JSBool JS_SetElement(JSContext *cx, JSObject *obj, jsint idx, jsval *vp) */ #define JS_SetElement(c, o, i, v) \ (mmEnv.setElement ? (*(mmEnv.setElement))(c, o, i, v) : JS_FALSE) /* JSBool JS_ExecuteScript(JSContext *cx, JSObject *obj, unsigned short *script, * unsigned int sz, jsval *rval) */ #define JS_ExecuteScript(c, o, s, z, r) \ (mmEnv.executeScript? (*(mmEnv.executeScript))(c, o, s, z, (LPCTSTR)__FILE__, \ __LINE__, r) : JS_FALSE) /* JSBool JS_ReportError(JSContext *cx, unsigned short *error, unsigned int sz) */ #define JS_ReportError(c, e, s) \ (mmEnv.reportError? (*(mmEnv.reportError))(c, e, s) : JS_FALSE)

/***************************************************************************** * Private data types, macros, and globals ****************************************************************************/ typedef struct { JSObject *libObj; JSBool (*defineFunction)(JSObject *libObj, unsigned short *name, JSNative call, unsigned int nargs); unsigned short *(*valueToString)(JSContext *cx, jsval v, unsigned int *pLength); unsigned char *(*valueToBytes)(JSContext *cx, jsval v, unsigned int *pLength); JSBool (*valueToInteger)(JSContext *cx, jsval v, long *lp); JSBool (*valueToDouble)(JSContext *cx, jsval v, double *dp); JSBool (*valueToBoolean)(JSContext *cx, jsval v, JSBool *bp); JSBool (*valueToObject)(JSContext *cx, jsval v, JSObject **op); JSBool (*stringToValue)(JSContext *cx, unsigned short *b, unsigned int sz, jsval *vp); JSBool (*bytesToValue)(JSContext *cx, unsigned char *b, unsigned int sz, jsval *vp); JSBool (*doubleToValue)(JSContext *cx, double dv, jsval *vp); unsigned short *(*objectType)(JSObject *obj); JSObject *(*newArrayObject)(JSContext *cx, unsigned int length, jsval *vp); long (*getArrayLength)(JSContext *cx, JSObject *obj); JSBool (*getElement)(JSContext *cx, JSObject *obj, unsigned int idx, jsval *vp); JSBool (*setElement)(JSContext *cx, JSObject *obj, unsigned int idx, jsval *vp); JSBool (*executeScript)(JSContext *cx, JSObject *obj, unsigned short *script, unsigned int sz, unsigned short *file, unsigned int lineNum, jsval *rval); JSBool (*reportError)(JSContext *cx, unsigned short *error, unsigned int sz); } MM_Environment; extern MM_Environment mmEnv;

EXTENSION DE FLASH CS4 PROFESSIONAL 538

Extensibilit de niveau C

// Declare the external entry point and linkage #ifdef _WIN32 # ifndef _MAC // Windows __declspec( dllexport ) void MM_InitWrapper( MM_Environment *env, unsigned int envSize ); # endif #else extern void MM_InitWrapper( MM_Environment *env, unsigned int envSize ); #endif

#define MM_STATE\ /* Definitions of global variables */ \ MM_Environment mmEnv; \ \ void\ MM_InitWrapper(MM_Environment *env, unsigned int envSize) \ { \ extern void MM_Init();\ \ char **envPtr = (char **)env; \ char **mmPtr =(char **)(&mmEnv);\ char **envEnd = (char **)((char *)envPtr + envSize);\ char **mmEnd =(char **)((char *)mmPtr+ sizeof(MM_Environment)); \ \ /* Copy fields from env to mmEnv, one pointer at a time */\ while (mmPtr < mmEnd && envPtr < envEnd)\ *mmPtr++ = *envPtr++; \ \ /* If env doesn't define all of mmEnv's fields, set extras to NULL */ \ while (mmPtr < mmEnd) \ *mmPtr++ = (char *)0; \ \ /* Call user's MM_Init function */\ MM_Init();\ } \ #endif /* _MM_JSAPI_H_ */

Exemple d'implmentation d'une DLL

Cette section montre comment crer une implmentation de DLL simple. Pour dcouvrir le fonctionnement du processus sans rellement crer la DLL, vous pouvez installer les exemples de fichier DLL fournis dans le fichier Samples.zip ; les fichiers sont situs dans le dossier ExtendingFlash/dllSampleComputeSum. (Pour plus d'informations sur le tlchargement du fichier Samples.zip, voir Exemples dimplmentation la page 13.) Extrayez les fichiers d'exemple du fichier dllSampleComputeSum.dmg ou dllSampleComputeSum.zip, puis procdez comme suit :

Enregistrez le fichier Sample.jsfl dans le rpertoire Configuration/Commands (voir Enregistrement des fichiers
JSFL la page 2).

Enregistrez le fichier Sample.dll dans le rpertoire Configuration/External Libraries (voir Intgration de fonctions
en C la page 534).

Dans l'environnement de programmation de Flash, choisissez Commandes > Echantillon. L'instruction trace du
fichier JSFL affiche dans le panneau Sortie les rsultats de la fonction dfinie dans Sample.dll.

EXTENSION DE FLASH CS4 PROFESSIONAL 539

Extensibilit de niveau C

La suite de cette section prsente le dveloppement de l'exemple. Dans ce cas prcis, la DLL ne contient quune fonction, qui additionne deux chiffres. Le code C est prsent dans lexemple suivant :
// Source code in C // Save the DLL or shared library with the name "Sample". #include <windows.h> #include <stdlib.h> #include "mm_jsapi.h" // A sample function // Every implementation of a JavaScript function must have this signature. JSBool computeSum(JSContext *cx, JSObject *obj, unsigned int argc, jsval *argv, jsval *rval) { long a, b, sum; // Make sure the right number of arguments were passed in. if (argc != 2) return JS_FALSE; // Convert the two arguments from jsvals to longs. if (JS_ValueToInteger(cx, argv[0], &a) == JS_FALSE || JS_ValueToInteger(cx, argv[1], &b) == JS_FALSE) return JS_FALSE; /* Perform the actual work. */ sum = a + b; /* Package the return value as a jsval. */ *rval = JS_IntegerToValue(sum); /* Indicate success. */ return JS_TRUE; }

Aprs l'criture de ce code, constituez le fichier DLL ou la bibliothque partage pour l'enregistrer ensuite dans le rpertoire appropri, Configuration/ExternalLibraries (voir Intgration de fonctions en C la page 534). Crez ensuite un fichier JSFL contenant le code suivant et enregistrez-le dans le rpertoire Configuration/Commands (voir Enregistrement des fichiers JSFL la page 2).
// JSFL file to run C function defined above. var a = 5; var b = 10; var sum = Sample.computeSum(a, b); fl.trace("The sum of " + a + " and " + b + " is " + sum );

Pour excuter la fonction dfinie dans la DLL, choisissez Commandes > Echantillon dans lenvironnement de programmation Flash.

Types de donnes
Linterprteur JavaScript dfinit les types de donnes dcrits dans cette section.

EXTENSION DE FLASH CS4 PROFESSIONAL 540

Extensibilit de niveau C

typedef struct JSContext JSContext

Un pointeur sur ce type de donnes opaque est transmis la fonction de niveau C. Certaines fonctions de lAPI acceptent ce pointeur parmi leurs arguments.

typedef struct JSObject JSObject

Un pointeur sur ce type de donnes opaque est transmis la fonction de niveau C. Ce type de donnes reprsente un objet, qui peut tre de type tableau ou autre.

typedef struct jsval jsval

Structure de donnes opaque pouvant contenir un entier ou un pointeur vers un nombre en virgule flottante, une chane ou un objet. Certaines fonctions de lAPI peuvent lire les valeurs des arguments de la fonction dans une structure jsval, et certaines permettent dcrire la valeur renvoye par la fonction dans une structure jsval.

typedef enum { JS_FALSE = 0, JS_TRUE = 1 } JSBool

Type de donnes simple contenant une valeur boolenne.

API de niveau C
LAPI dextensibilit de niveau C se compose de la signature de fonction JSBool (*JSNative) et des fonctions suivantes :

JSBool JS_DefineFunction() unsigned short *JS_ValueToString() JSBool JS_ValueToInteger() JSBool JS_ValueToInteger() JSBool JS_ValueToBoolean() JSBool JS_ValueToObject() JSBool JS_StringToValue() JSBool JS_DoubleToValue() JSVal JS_BooleanToValue() JSVal JS_BytesToValue() JSVal JS_IntegerToValue() JSVal JS_ObjectToValue() unsigned short *JS_ObjectType() JSObject *JS_NewArrayObject() long JS_GetArrayLength() JSBool JS_GetElement() JSBool JS_SetElement() JSBool JS_ExecuteScript()

EXTENSION DE FLASH CS4 PROFESSIONAL 541

Extensibilit de niveau C

typedef JSBool (*JSNative)(JSContext *cx, JSObject *obj, unsigned int argc, jsval *argv, jsval *rval)
Description Mthode qui dcrit les implmentations de niveau C des fonctions JavaScript dans les situations suivantes :

Le pointeur cx pointe sur une structure JSContext opaque, qui doit tre transmise certaines fonctions de lAPI
JavaScript. Cette variable contient le contexte dexcution de linterprteur.

Le pointeur obj pointe sur lobjet dans le contexte duquel le script sexcute. Pendant lexcution du script, le motcl this est gal cet objet.

Lentier argc correspond au nombre darguments transmis la fonction. Le pointeur argv pointe sur un tableau de structures jsval. La longueur du tableau correspond au nombre
dlments dfini par argc.

Le pointeur rval pointe sur une seule structure jsval. La valeur renvoye par la fonction doit tre crite dans *rval.
La fonction renvoie la valeur JS_TRUE si elle sexcute correctement, et JS_FALSE dans le cas contraire. Si la fonction renvoie JS_FALSE, lexcution du script est interrompue et un message derreur saffiche.

JSBool JS_DefineFunction()
Utilisation
JSBool JS_DefineFunction(unsigned short *name, JSNative call, unsigned int nargs)

Description Cette mthode enregistre une fonction de niveau C auprs de linterprteur JavaScript de Flash. Lorsque la fonction JS_DefineFunction() a enregistr la fonction de niveau C spcifie dans largument call, vous pouvez appeler cette dernire dans un script JavaScript laide du nom indiqu dans largument name. Largument name est sensible la casse. En rgle gnrale, cette fonction est appele depuis la fonction MM_Init(), que Flash appelle au dmarrage. Arguments
unsigned short *name, JSNativecall, unsigned int nargs

Largument name est le nom de la fonction tel quil est expos JavaScript. Largument call est un pointeur vers une fonction de niveau C. La fonction doit renvoyer une valeur JSBool qui
indique son succs ou son chec.

Largument nargs indique le nombre darguments attendus par la fonction.

Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

unsigned short *JS_ValueToString()

Utilisation
unsigned short *JS_ValueToString(JSContext *cx, jsval v, unsigned int *pLength)

EXTENSION DE FLASH CS4 PROFESSIONAL 542

Extensibilit de niveau C

Description Cette mthode extrait un argument de fonction dune structure jsval, le convertit en chane si possible, puis renvoie la valeur ainsi convertie la routine appelante. Remarque : Ne modifiez pas le pointeur sur le tampon renvoy ; vous risqueriez daltrer les structures de donnes de linterprteur JavaScript. Pour modifier la chane, copiez ses caractres dans un autre tampon et crez une nouvelle chane en JavaScript. Arguments
JSContext *cx, jsval v, unsigned int *pLength

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. L'argument v est la structure jsval dont la chane doit tre extraite. Largument pLength est un pointeur vers un entier non sign. Cette fonction dfinit *plength sur la longueur de
la chane (en octets). Valeur renvoye Un pointeur vers une chane termine par un octet nul en cas de succs, ou la valeur null en cas dchec. La routine appelante ne doit pas librer cette chane la fin de son excution.

JSBool JS_ValueToInteger()
Utilisation
JSBool JS_ValueToInteger(JSContext *cx, jsval v, long *lp);

Description Cette mthode extrait un argument de fonction dune structure jsval, le convertit en entier si possible, puis renvoie la valeur ainsi convertie la routine appelante. Arguments
JSContext *cx, jsval v, long *lp

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument v est la structure jsval dont lentier doit tre extrait. Largument lp est un pointeur vers un entier de 4 octets. Cette fonction enregistre la valeur convertie dans *lp.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_ValueToInteger()
Utilisation
JSBool JS_ValueToDouble(JSContext *cx, jsval v, double *dp);

Description Cette mthode extrait un argument de fonction dune structure jsval, le convertit en double si possible, puis renvoie la valeur ainsi convertie la routine appelante.

EXTENSION DE FLASH CS4 PROFESSIONAL 543

Extensibilit de niveau C

Arguments
JSContext *cx, jsval v, double *dp

Largument cx est le pointeur opaque vers JSContext qui est transmis la fonction JavaScript. Largument v est la structure jsval dont le double doit tre extrait. Largument dp est un pointeur vers un nombre double de 8 octets. Cette fonction stocke la valeur convertie dans *dp.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_ValueToBoolean()
Utilisation
JSBool JS_ValueToBoolean(JSContext *cx, jsval v, JSBool *bp);

Description Cette mthode extrait un argument de fonction dune structure jsval, le convertit en boolen si possible, puis renvoie la valeur ainsi convertie la routine appelante. Arguments
JSContext *cx, jsval v, JSBool *bp

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument v est la structure jsval dont la valeur boolenne doit tre extraite. Largument bp est un pointeur vers une valeur boolenne JSBool. Cette fonction stocke la valeur convertie dans *bp.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_ValueToObject()
Utilisation
JSBool JS_ValueToObject(JSContext *cx, jsval v, JSObject **op);

Description Cette mthode extrait un argument de fonction dune structure jsval , le convertit en objet si possible, puis renvoie la valeur ainsi convertie la routine appelante. Si lobjet est un tableau, utilisez JS_GetArrayLength() et JS_GetElement() pour lire son contenu. Arguments
JSContext *cx, jsval v, JSObject **op

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument v est la structure jsval dont lobjet doit tre extrait. Largument op est un pointeur vers un pointeur JSObject. Cette fonction stocke la valeur convertie dans *op.

EXTENSION DE FLASH CS4 PROFESSIONAL 544

Extensibilit de niveau C

Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_StringToValue()
Utilisation
JSBool JS_StringToValue(JSContext *cx, unsigned short *bytes, uint sz, jsval *vp);

Description Cette mthode stocke la valeur de renvoi dune chane dans une structure jsval. Elle alloue un nouvel objet chane JavaScript. Arguments
JSContext *cx, unsigned short *bytes, size_tsz, jsval *vp

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument bytes est la chane stocker dans la structure jsval. Les donnes de la chane sont copies. Il est donc
conseill de librer la chane lorsquelle nest plus ncessaire. Si la taille de la chane nest pas spcifie (voir largument sz), la chane doit se terminer par un octet de valeur nulle.

Largument sz est la taille de la chane, en octets. Si la valeur de sz est 0, la longueur de la chane termine par un
octet de valeur nulle est calcule automatiquement.

Largument vp est un pointeur vers la structure jsval dans laquelle le contenu de la chane doit tre copi.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_DoubleToValue()
Utilisation
JSBool JS_DoubleToValue(JSContext *cx, double dv, jsval *vp);

Description Cette mthode stocke la valeur de renvoi dun nombre en virgule flottante dans une structure jsval. Arguments
JSContext *cx, double dv, jsval *vp

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument dv est un nombre en virgule flottante de 8 octets. Largument vp est un pointeur vers la structure jsval dans laquelle le contenu du double doit tre copi.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

EXTENSION DE FLASH CS4 PROFESSIONAL 545

Extensibilit de niveau C

JSVal JS_BooleanToValue()
Utilisation
jsval JS_BooleanToValue(JSBool bv);

Description Cette mthode stocke la valeur boolenne de renvoi dans une structure jsval. Arguments
JSBool bv

L'argument bv est une valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.
Valeur renvoye Structure JSVal qui contient la valeur boolenne transmise en tant qu'argument la fonction.

JSVal JS_BytesToValue()
Utilisation
JSBool JS_BytesToValue(JSContext *cx, unsigned short *bytes, uint sz, jsval *vp);

Description Cette mthode convertit des octets en valeur JavaScript. Arguments

JSContext *cx, unsignedshort*bytes, uintsz, jsval *vp

Largument cx est le contexte JavaScript. Largument bytes est la chane doctets convertir en objet JavaScript. Largument sz est le nombre doctets convertir. Largument vp est la valeur JavaScript.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSVal JS_IntegerToValue()
Utilisation
jsval JS_IntegerToValue(long lv);

Description Cette mthode convertit un entier long en structure JSVal. Arguments lv Largument lv est la valeur de lentier long convertir en structure jsval.

EXTENSION DE FLASH CS4 PROFESSIONAL 546

Extensibilit de niveau C

Valeur renvoye Structure JSVal qui contient lentier transmis en tant qu'argument la fonction.

JSVal JS_ObjectToValue()
Utilisation
jsval JS_ObjectToValue(JSObject *obj);

Description Cette mthode stocke la valeur de renvoi dun objet dans une structure JSVal. Utilisez JS_NewArrayObject() pour crer un objet array, et JS_SetElement() pour dfinir son contenu. Arguments JSObject *obj Largument obj est un pointeur vers lobjet JSObject convertir en structure JSVal. Valeur renvoye Structure JSVal qui contient lobjet transmis en tant qu'argument la fonction.

unsigned short *JS_ObjectType()

Utilisation
unsigned short *JS_ObjectType(JSObject *obj);

Description Cette mthode reoit une rfrence un objet et renvoie le nom de la classe de cet objet. Par exemple, si lobjet est de type DOM, la fonction renvoie "Document". Si lobjet est un nud du document, la fonction renvoie "Element". Pour un objet tableau, la fonction renvoie "Array". Remarque : ne modifiez pas le pointeur sur le tampon renvoy ; vous risqueriez daltrer les structures de donnes de linterprteur JavaScript. Arguments JSObject *obj En gnral, cet argument est transmis et converti laide de la fonction JS_ValueToObject(). Valeur renvoye Un pointeur sur une chane termine par un octet nul. La routine appelante ne doit pas librer cette chane la fin de son excution.

JSObject *JS_NewArrayObject()
Utilisation
JSObject *JS_NewArrayObject(JSContext *cx, unsigned int length [, jsval *v])

EXTENSION DE FLASH CS4 PROFESSIONAL 547

Extensibilit de niveau C

Description Cette mthode cre un nouvel objet qui contient un tableau de JSVals. Arguments
JSContext *cx, unsigned int length, jsval *v

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. L'argument length est le nombre maximal d'lments du tableau. Largument v est un pointeur facultatif vers les structures jsval stocker dans le tableau. Si la valeur renvoye nest
pas null, v est un tableau qui contient des lments length. Si la valeur renvoye est null, le contenu initial de lobjet tableau est non dfini (undefined). Il peut tre dfini laide de la fonction JS_SetElement(). Valeur renvoye Un pointeur vers un nouvel objet tableau, ou la valeur null en cas dchec.

long JS_GetArrayLength()
Utilisation
long JS_GetArrayLength(JSContext *cx, JSObject *obj)

Description Cette mthode reoit un pointeur sur un objet tableau et extrait le nombre dlments de ce tableau. Arguments
JSContext *cx, JSObject*obj

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument obj est un pointeur vers un objet tableau.
Valeur renvoye Le nombre dlments du tableau, ou -1 en cas dchec.

JSBool JS_GetElement()
Utilisation
JSBool JS_GetElement(JSContext *cx, JSObject *obj, jsint idx, jsval *vp)

Description Cette mthode lit un seul lment dans un objet tableau. Arguments
JSContext *cx, JSObject *obj, jsint idx, jsval *vp

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument obj est un pointeur vers un objet tableau.

EXTENSION DE FLASH CS4 PROFESSIONAL 548

Extensibilit de niveau C

Largument idx est un index d'entiers dans le tableau. Le premier lment est lindex 0 et le dernier, lindex (length 1). Largument vp est un pointeur vers une structure jsval dans laquelle le contenu de la structure jsval du tableau
doit tre copi. Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_SetElement()
Utilisation
JSBool JS_SetElement(JSContext *cx, JSObject *obj, jsint idx, jsval *vp)

Description Cette mthode crit un seul lment dans un objet tableau. Arguments
JSContext *cx, JSObject *obj, jsint idx, jsval *vp

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument obj est un pointeur vers un objet tableau. Largument idx est un index d'entiers dans le tableau. Le premier lment est lindex 0 et le dernier, lindex (length 1). Largument vp est un pointeur vers une structure jsval dont le contenu doit tre copi dans la structure jsval du
tableau. Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

JSBool JS_ExecuteScript()
Utilisation
JS_ExecuteScript (JSContext *cx, JSObject *obj, unsigned short *script, unsigned int sz, jsval *rval)

Description Cette mthode compile et excute une chane en JavaScript. Si le script gnre une valeur de renvoi, celle-ci est renvoye dans *rval. Arguments
JSContext *cx, JSObject *obj, unsigned short *script, unsigned intsz, jsval *rval

Largument cx est le pointeur JSContext opaque qui est transmis la fonction JavaScript. Largument obj pointe vers lobjet dans le contexte duquel le script sexcute. Pendant lexcution du script, le motcl this est gal cet objet. En gnral, ce pointeur est le pointeur JSObject transmis la fonction JavaScript.

EXTENSION DE FLASH CS4 PROFESSIONAL 549

Extensibilit de niveau C

Largument script est une chane qui contient du code JavaScript. Si la taille de la chane nest pas spcifie (voir
largument sz), la chane doit se terminer par un octet de valeur nulle.

Largument sz est la taille de la chane, en octets. Si la valeur de sz est 0, la longueur de la chane termine par un
octet de valeur nulle est automatiquement calcule.

Largument rval pointe vers une structure jsval. La valeur renvoye par la fonction est stocke dans *rval.
Valeur renvoye Valeur boolenne : JS_TRUE indique le succs de l'opration ; JS_FALSE indique son chec.

550