User manual MACROMEDIA FLEX 2-MIGRATING APPLICATIONS TO FLEX 2

[. . . ] Migrating Applications to Flex 2 Adobe Flex 2 ® TM © 2006 Adobe Systems Incorporated. Migrating Applications to FlexTM 2 If this guide is distributed with software that includes an end-user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end-user license agreement. [. . . ] References to ISystemManager have been removed from the compiler. mx. managers. IFocusManagerGroup mx. automation. IAutomationTabularData mx. logging. ILoggingTarget mx. managers. IToolTipManagerClient Removed. mx. validators. IValidatorListener ITabGroup ITabularData ITarget IToolTipClient ITreeDataProvider IValidationListener Managers This section describes changes to Flex classes in the mx. managers package. mx. managers. DepthManager This class has been removed. Managers 91 mx. managers. DragManager Instead of setting event. handled inside the dragEnter event listener, you must call the DragManager. acceptDragDrop(event. target) method. You cannot set the action property of the event object. Instead, you must call the setFeedback() method. For example, change the following code: event. action=DragManager. Link; to the following: DragManager. showFeedback(DragManager. LINK); This applies to all actions: MOVE, LINK, COPY, NONE. The signature to the doDrag() method has changed. There is no longer an imageInitObj argument, and there are two new arguments: mouseEvent and allowMove. When using the doDrag() method and dragging text-based controls, you should use the property of the Event object instead of the target property. This is because of the way text-based controls react during the bubbling event phase. currentTarget For a detailed description of these changes and a conversion example, see "Using the dragand-drop feature" on page 178. mx. managers. FocusManager The following table describes changes to the FocusManager class: Member isParentOf() Change description Removed. Use the contains() method on the DisplayObjectContainer class. mx. managers. LayoutManager The following table describes changes to the LayoutManager class: Member updateNow() Change description validateNow() 92 Flex Classes mx. managers. PopUpManager The following table describes changes to the PopUpManager class: Member closeButton Change description The default value of the closeButton property is now false. To enable a close button on your pop-ups, you must explicitly set the value of the closeButton property to true. The createPopUp() method now takes only three arguments, and returns an IFlexDisplayObject. You can no longer pass an initObj to the createPopUp() method. Instead, you declare the variables that you want to set inside the pop-up's definition, and set them on the pop-up in the calling application. removePopUp() createPopUp() deletePopUp() popUpWindow() (was popupWindow()) The name of the method also changed to addPopUp(). Formerly inherited from the Application object, this method is now a method of the PopUpManager class. mx. managers. SystemManager The SystemManager class now implements the ISystemManager interface. The following table describes changes to the SystemManager class: Member cursors (formerly cursorChildrenList) embeddedFontList() Change description cursorChildren This method is now private. Use the Font class's enumerateFonts() method. getDefinitionByName() getSystemManager() topLevelSystemManager childAdded() getClassByName() getManager() getTopLevelSystemManager() initializeChild() registerInitCallback() toolTips (formerly toolTipChildrenList) topMostChildrenList This method is now private. toolTipChildren popupChildren Managers 93 Media controls This section describes changes to media controls in Flex 2. mx. controls. MediaDisplay The MediaDisplay control has been replaced by the mx. controls. VideoDisplay control. The API is the same, but it does not support MP3 files. mx. controls. MediaController The MediaController control has been removed. Use the VideoDisplay control instead. mx. controls. MediaPlayback The MediaPlayback control has been removed. Use the VideoDisplay control instead. mx. controls. VideoDisplay This class replaces the mx. controls. MediaDisplay class. The following table describes changes to the VideoDisplay class: Member metadataReceived Change description Removed. Printing This section provides information about changes to classes in the mx. printing package. [. . . ] if (event. ctrlKey) { DragManager. showFeedback(DragManager. COPY); } else { DragManager. showFeedback(DragManager. MOVE); } } Using the drag-and-drop feature 181 Using Timer The setInterval() and clearInterval() methods were deprecated in favor of the Timer class. You can still use these methods; they are in the flash. util package. When you use Timers, keep the following in mind: When a Timer is first created with the new operator, it is stopped; you must use the start() method to start it. Instances of the Timer class dispatch events that you handle like any other event. The following example creates and destroys a Timer object each time you click the Start and Stop buttons. [. . . ]