User manual MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

[. . . ] ActionScript Language Reference Trademarks Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware, Authorware Star, Backstage, Bright Tiger, Clustercats, ColdFusion, Contribute, Design In Motion, Director, Dream Templates, Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Flash Lite, Flex, Fontographer, FreeHand, Generator, HomeSite, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Breeze, Macromedia Flash, Macromedia M Logo and Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel, Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic, Open Sesame!, Roundtrip, Roundtrip HTML, Shockwave, Sitespring, SoundEdit, Titlemaker, UltraDev, Web Design 101, what the web can be, and Xtra are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] You can define the function on the Timeline or in a class file that extends the MovieClip class or is linked to a symbol in the library. For more information, see "Assigning a class to a movie clip symbol" in Using ActionScript in Flash. Example The following example defines a function for the onEnterFrame method that sends a trace() action to the Output panel: my_mc. onEnterFrame = function () { trace ("onEnterFrame called"); }; 554 Chapter 2: ActionScript Language Reference MovieClip. onKeyDown Availability Flash Player 6. Usage my_mc. onKeyDown = function() { // your statements here } Parameters None. Returns Nothing. Description Event handler; invoked when a movie clip has input focus and a key is pressed. You can use the Key. getAscii() and Key. getCode() methods to determine which key was pressed. You must define a function that executes when the event handler is invoked. You can define the function on the Timeline or in a class file that extends the MovieClip class or is linked to a symbol in the library. For more information, see "Assigning a class to a movie clip symbol" in Using ActionScript in Flash. The onKeyDown event handler works only if the movie clip has input focus enabled and set. First, the MovieClip. focusEnabled property must be set to true for the movie clip. This can be done either by using Selection. setFocus() or by setting the Tab key to navigate to the clip. Selection. setFocus(). If Selection. setFocus() is used, the path for the movie clip must be passed to It is very easy for other elements to take the focus back after the mouse is moved. Example The following example defines a function for the onKeyDown() method that sends a trace() action to the Output panel. Create a movie clip called my_mc and add the following ActionScript to your FLA or AS file: my_mc. onKeyDown = function() { trace("key was pressed"); }; The movie clip must have focus for the onKeyDown event handler to work. Add the following ActionScript to set input focus. my_mc. tabEnabled = true; my_mc. focusEnabled = true; Selection. setFocus(my_mc); MovieClip. onKeyDown 555 When you tab to the movie clip and press a key, key was pressed displays in the Output panel. However, this does not occur after you move the mouse, because the movie clip loses focus. Therefore, you should use Key. onKeyDown in most cases. See also MovieClip. onKeyUp 556 Chapter 2: ActionScript Language Reference MovieClip. onKeyUp Availability Flash Player 6. Usage my_mc. onKeyUp = function() { // your statements here } Parameters None. Returns Nothing. Description Event handler; invoked when a key is released. You can use the Key. getAscii() and Key. getCode() methods to determine which key was pressed. You must define a function that executes when the event handler is invoked. You can define the function on the Timeline or in a class file that extends the MovieClip class or is linked to a symbol in the library. For more information, see "Assigning a class to a movie clip symbol" in Using ActionScript in Flash. The onKeyUp event handler works only if the movie clip has input focus enabled and set. First, the MovieClip. focusEnabled property must be set to true for the movie clip. This can be done either by using Selection. setFocus() or by setting the Tab key to navigate to the clip. Selection. setFocus(). If Selection. setFocus() is used, the path for the movie clip must be passed to It is very easy for other elements to take the focus back after the mouse is moved. Example The following example defines a function for the onKeyUp method that sends a trace() action to the Output panel: my_mc. onKeyUp = function () { trace ("onKeyUp called"); }; The following example sets input focus: my_mc. focusEnabled = true; Selection. setFocus(my_mc); See Also MovieClip. onKeyDown MovieClip. onKeyUp 557 MovieClip. onKillFocus Availability Flash Player 6. Usage my_mc. onKillFocus = function (newFocus:Object) { // your statements here } Parameters newFocus Returns The object that is receiving the keyboard focus. Nothing. Description Event handler; invoked when a movie clip loses keyboard focus. The onKillFocus method receives one parameter, newFocus, which is an object that represents the new object receiving the focus. You must define a function that executes when the event handler is invoked. [. . . ] This property was deprecated in favor of the scroll property of the TextField class. Usage textFieldVariableName. scroll = x Description Property; controls the display of information in a text field associated with a variable. The scroll property defines where the text field begins displaying content; after you set it, Flash Player updates it as the user scrolls through the text field. The scroll property is useful for directing users to a specific paragraph in a long passage or creating scrolling text fields. This property can be retrieved and modified. Example The following code is attached to an Up button that scrolls the text field named myText: on (release) { myText. scroll = myText. scroll + 1; } See also TextField. maxscroll, TextField. scroll 1098 Appendix: Deprecated Language Elements substring Availability Flash Player 4. [. . . ]