background image

MovieClip

461

duplicateMovieClip (MovieClip.duplicateMovieClip 
method)

public duplicateMovieClip(name:

String

, depth:

Number

, [initObject:

Object

]) : 

MovieClip

Creates an instance of the specified movie clip while the SWF file is playing. Duplicated 
movie clips always start playing at Frame 1, no matter what frame the original movie clip is on 
when the 

duplicateMovieClip()

 method is called. Variables in the parent movie clip are not 

copied into the duplicate movie clip. Movie clips that are created with the 

duplicateMovieClip()

 method are not duplicated if you call the 

duplicateMovieClip()

 

method on their parent. If the parent movie clip is deleted, the duplicate movie clip is also 
deleted. If you used 

MovieClip.loadMovie()

 or the MovieClipLoader class to load a movie 

clip, the contents of the SWF file are not duplicated. This means that you cannot save 
bandwidth by loading a JPEG, GIF, PNG, or SWF file and then duplicating the movie clip. 

Contrast this method with the global function version of 

duplicateMovieClip()

. The 

global version of this method requires a parameter that specifies the target movie clip to 
duplicate. Such a parameter is unnecessary for the MovieClip class version, because the target 
of the method is the movie clip instance on which the method is invoked. Moreover, the 
global version of 

duplicateMovieClip()

 supports neither the 

initobject

 parameter nor 

the return value of a reference to the newly created MovieClip instance.

Availability: 

 ActionScript 1.0; Flash Lite 2.0

Parameters

name

:

String

 - A unique identifier for the duplicate movie clip.

depth

:

Number

 - A unique integer specifying the depth at which the new movie clip is placed. 

Use depth -16384 to place the new movie clip instance beneath all content created in the 
authoring environment. Values between -16383 and -1, inclusive, are reserved for use by the 
authoring environment and should not be used with this method. The remaining valid depth 
values range from 0 to 1048575, inclusive.

initObject

:

Object

 [optional] - (Supported for Flash Player 6 and later.) An object 

containing properties with which to populate the duplicated movie clip. This parameter 
allows dynamically created movie clips to receive clip parameters. If 

initObject

 is not an 

object, it is ignored. All properties of 

initObject

 are copied into the new instance. The 

properties specified with 

initObject

 are available to the constructor function.

Returns

MovieClip

 - A reference to the duplicated movie clip (supported for Flash Player 6 and later).

Содержание Flash Lite 2

Страница 1: ...Flash Lite 2 x ActionScript Language Reference...

Страница 2: ...pendent JPEG Group Nellymoser Inc Speech compression and decompression technology licensed by Nellymoser Inc http www nellymoser com Opera browser Copyright 1995 2002 Opera Software ASA and its suppli...

Страница 3: ...constant 30 Global Functions 32 Array function 38 Boolean function 39 call function 40 chr function 41 clearInterval function 42 duplicateMovieClip function 42 escape function 43 eval function 44 fsc...

Страница 4: ...nction 76 random function 76 removeMovieClip function 77 setInterval function 78 setProperty function 81 startDrag function 82 stop function 83 stopAllSounds function 83 stopDrag function 84 String fu...

Страница 5: ...twise left shift operator 126 bitwise left shift and assignment operator 128 bitwise NOT operator 128 bitwise OR operator 130 bitwise OR assignment operator 131 bitwise right shift operator 132 bitwis...

Страница 6: ...ogical OR operator 163 modulo operator 164 modulo assignment operator 164 multiplication operator 165 multiplication assignment operator 166 new operator 167 ne not equal strings operator 167 object i...

Страница 7: ...atteryLevel fscommand2 Command 228 GetDevice fscommand2 Command 228 GetDeviceID fscommand2 Command 229 GetFreePlayerMemory fscommand2 Command 229 GetMaxBatteryLevel fscommand2 Command 230 GetMaxSignal...

Страница 8: ...rray pop method 256 push Array push method 257 RETURNINDEXEDARRAY Array RETURNINDEXEDARRAY property 257 reverse Array reverse method 258 shift Array shift method 258 slice Array slice method 258 sort...

Страница 9: ...sible property 293 _width Button _width property 293 _x Button _x property 294 _xmouse Button _xmouse property 294 _xscale Button _xscale property 295 _y Button _y property 296 _ymouse Button _ymouse...

Страница 10: ...313 imageMIMETypes capabilities imageMIMETypes property 314 isDebugger capabilities isDebugger property 314 language capabilities language property 315 localFileReadDisable capabilities localFileRead...

Страница 11: ...method 342 getUTCYear Date getUTCYear method 343 getYear Date getYear method 343 setDate Date setDate method 344 setFullYear Date setFullYear method 345 setHours Date setHours method 346 setMillisecon...

Страница 12: ...od 372 BACKSPACE Key BACKSPACE property 373 CAPSLOCK Key CAPSLOCK property 374 CONTROL Key CONTROL property 374 DELETEKEY Key DELETEKEY property 374 DOWN Key DOWN property 375 END Key END property 376...

Страница 13: ...e addXMLPath method 408 checkXMLStatus Locale checkXMLStatus method 408 initialize Locale initialize method 409 loadLanguageXML Locale loadLanguageXML method 409 loadString Locale loadString method 40...

Страница 14: ...frame property 457 curveTo MovieClip curveTo method 457 _droptarget MovieClip _droptarget property 460 duplicateMovieClip MovieClip duplicateMovieClip method 461 enabled MovieClip enabled property 462...

Страница 15: ...andler 501 onMouseUp MovieClip onMouseUp handler 502 onPress MovieClip onPress handler 502 onRelease MovieClip onRelease handler 502 onReleaseOutside MovieClip onReleaseOutside handler 503 onRollOut M...

Страница 16: ...Init MovieClipLoader onLoadInit event listener 538 onLoadProgress MovieClipLoader onLoadProgress event listener 539 onLoadStart MovieClipLoader onLoadStart event listener 541 removeListener MovieClipL...

Страница 17: ...method 587 data SharedObject data property 587 flush SharedObject flush method 589 getLocal SharedObject getLocal method 591 getMaxSize SharedObject getMaxSize method 592 getSize SharedObject getSize...

Страница 18: ...bstring String substring method 638 toLowerCase String toLowerCase method 639 toString String toString method 640 toUpperCase String toUpperCase method 641 valueOf String valueOf method 641 System 642...

Страница 19: ...674 _rotation TextField _rotation property 675 scroll TextField scroll property 676 selectable TextField selectable property 677 setNewTextFormat TextField setNewTextFormat method 678 setTextFormat T...

Страница 20: ...roperty 710 url TextFormat url property 710 Video 711 close Video close method 713 onStatus Video onStatus handler 713 pause Video pause method 714 play Video play method 714 resume Video resume metho...

Страница 21: ...52 nodeValue XMLNode nodeValue property 753 parentNode XMLNode parentNode property 754 previousSibling XMLNode previousSibling property 755 removeNode XMLNode removeNode method 756 toString XMLNode to...

Страница 22: ...22 Contents...

Страница 23: ...your ActionScript file to direct the compiler to preprocess certain instructions Compiler Directives summary endinitclip directive endinitclip Compiler directive indicates the end of a block of initia...

Страница 24: ...hich is one of the following Windows 2000 or Windows XP C Documents and Settings user Local Settings Application Data Macromedia Flash 8 language Configuration Include Macintosh OS X Hard Drive Users...

Страница 25: ...tories AS file is in a directory at the same level as the directory that contains the script file The directory is named ALL_includes include ALL_includes init_script as AS file is specified by an abs...

Страница 26: ...al values are allowed and not by using a variable If you include multiple initclip blocks in a single movie clip symbol then the compiler uses the last order value specified in that movie clip symbol...

Страница 27: ...ion false A unique Boolean value that represents the opposite of true Infinity Specifies the IEEE 754 value representing positive infinity Infinity Specifies the IEEE 754 value representing negative i...

Страница 28: ...Number POSITIVE_INFINITY Availability ActionScript 1 0 Flash Lite 2 0 See also POSITIVE_INFINITY Number POSITIVE_INFINITY property Infinity constant Specifies the IEEE 754 value representing negative...

Страница 29: ...myAge Number 30 trace myName myAge trace trace myName newline myAge output Lisa30 Lisa 30 See also trace function null constant A special value that can be assigned to variables or returned by a func...

Страница 30: ...the if statement could also be written if shouldExecute trace your statements here The following example shows how automatic data typing converts true to the number 1 var myNum Number myNum 1 true tr...

Страница 31: ...In the first section of code the equality operator compares the value of x to the value undefined and the appropriate result is sent to the Output panel In the first section of code the equality oper...

Страница 32: ...true or false call frame Object Deprecated since Flash Player 5 This action was deprecated in favor of the function statement Executes the script in the called frame without moving the playhead to th...

Страница 33: ...that have elapsed since the SWF file started playing getURL url String window String method String Loads a document from a specific URL into a window or passes variables to another application at a de...

Страница 34: ...tring length property to perform the same operations Returns the length of the specified string or variable loadMovie url String target Object method String Loads a SWF or JPEG file into Flash Player...

Страница 35: ...te number mbsubstring value String index Number count Number String Deprecated since Flash Player 5 This function was deprecated in favor of String substr method Extracts a new multibyte character str...

Страница 36: ...as deprecated in favor of Math random Returns a random integer between 0 and one less than the integer specified in the value parameter removeMovieClip target Object Deletes the specified movie clip s...

Страница 37: ...ment Applies the instructions specified in the statements parameter to the Timeline specified in the target parameter toggleHighQuality Deprecated since Flash Player 5 This function was deprecated in...

Страница 38: ...pt more than one data type are listed as in the signature as type Object Availability ActionScript 1 0 Flash Lite 2 0 Parameters numElements optional A positive integer that specifies the number of el...

Страница 39: ...ing is first converted to a number the value is true if the number is not zero false otherwise In files published for Flash Player 7 or later the result is true if the string has a length greater than...

Страница 40: ...t false This example shows a significant difference between use of the Boolean function and the Boolean class The Boolean function creates a Boolean value and the Boolean class creates a Boolean objec...

Страница 41: ...ne variables Availability ActionScript 1 0 Flash Lite 1 0 Parameters frame Object The label or number of a frame in the Timeline See also function statement call Function call method chr function chr...

Страница 42: ...Int_btn and use the following ActionScript to clear setInterval clearInt_btn onRelease function clearInterval intervalID trace cleared interval See also setInterval function duplicateMovieClip functio...

Страница 43: ...The duplicated clip is called newImg_mc and this new clip is moved on the Stage so it does not overlap the original clip and the same image is loaded into the second clip this createEmptyMovieClip img...

Страница 44: ...com loggedin true username Gus getURL http www myothersite com returnurl escape redirectUrl See also unescape function eval function eval expression Object Objecteval expression String Object Accesse...

Страница 45: ...ot properties or objects Parameters expression Object The name of a variable property object or movie clip to retrieve This parameter can be either a String or a direct reference to the object instanc...

Страница 46: ...Example In the following example fscommand would open wap yahoo com on the services Web browser on Series 60 phones on keyPress 9 status fscommand launch z system apps browser browser app http wap ya...

Страница 47: ...Commands section under ActionScript language elements for the values you can specify for the fscommand function s commands and parameters These values control SWF files that are playing in the Flash...

Страница 48: ...ed property for the movie clip my_mc Availability ActionScript 1 0 Flash Lite 1 0 Parameters my_mc Object The instance name of a movie clip for which the property is being retrieved property Object A...

Страница 49: ...document from a specific URL into a window or passes variables to another application at a defined URL To test this function make sure the file to be loaded is at the specified location To use an abso...

Страница 50: ...istener listenerObject logo loadClip http www helpexamples com flash images image1 jpg this createEmptyMovieClip macromedia_mc this getNextHighestDepth In the following example getURL is used to send...

Страница 51: ...n WIN 8 0 1 0 This returned string indicates that the platform is Microsoft Windows and the version number of Flash Player is major version 8 minor version 1 8 1 See also os capabilities os property v...

Страница 52: ...gotoAndPlay MovieClip gotoAndPlay method nextFrame function play function prevFrame function gotoAndStop function gotoAndStop scene String frame Object Void Sends the playhead to the specified frame i...

Страница 53: ...frame statement s Deprecated since Flash Player 5 This function has been deprecated Macromedia recommends that you use the MovieClip _framesloaded property Checks whether the contents of a specific f...

Страница 54: ...Flash Lite 1 0 Parameters value Number A number to be rounded to an integer Returns Number The truncated integer value See also round Math round method floor Math floor method ceil Math ceil method is...

Страница 55: ...ot a number This function is useful for checking whether a mathematical expression evaluates successfully to a number Availability ActionScript 1 0 Flash Lite 2 0 Parameters expression Object A Boolea...

Страница 56: ...N constant NaN Number NaN property length function length expression length variable Deprecated since Flash Player 5 This function along with all the string functions has been deprecated Macromedia re...

Страница 57: ...e loaded image or SWF file aligns with the registration point of the targeted movie clip Alternatively if the target is the root Timeline the upper left corner of the image or SWF file aligns with the...

Страница 58: ...this createEmptyMovieClip logo_mc 999 loadMovie sub swf logo_mc You could add the following code to load a JPEG image called image1 jpg from the same directory as the SWF file loading sub swf The JPEG...

Страница 59: ...le in level 0 sets the frame rate background color and frame size for all other loaded SWF files The loadMovieNum action also lets you load JPEG files into a SWF file while it plays For images and SWF...

Страница 60: ...xt at the specified URL must be in the standard MIME format application x www form urlencoded a standard format used by CGI scripts Any number of variables can be specified For example the following p...

Страница 61: ...the variables to the end of the URL and is used for small numbers of variables The POST method sends the variables in a separate HTTP header and is used for long strings of variables Example The foll...

Страница 62: ...onent of a file s URL For example a SWF file at www someDomain com can load data from a source at store someDomain com because both files are in the same superdomain of someDomain com In SWF files of...

Страница 63: ...used to check the progress of the data being loaded into the SWF The script checks for a variable in the params txt file named done loadVariablesNum params txt 2 function checkParamsLoaded if _level2...

Страница 64: ...gth of the multibyte character string Availability ActionScript 1 0 Flash Lite 1 0 Parameters string String The string to measure Returns Number The length of the multibyte character string See also S...

Страница 65: ...multibyte character string from a multibyte character string Availability ActionScript 1 0 Flash Lite 1 0 Parameters value String The multibyte string from which to extract a new multibyte string ind...

Страница 66: ...The listener is initialized to wait for the arrow key to be pressed and the init variable is used to prevent the listener from being redefined if the playhead returns to Frame 1 stop if init undefined...

Страница 67: ...Depth 200 0 100 22 nextscene_mc nextscene_txt autoSize true nextscene_mc nextscene_txt border true nextscene_mc nextscene_txt text Next Scene this createEmptyMovieClip prevscene_mc this getNextHighest...

Страница 68: ...yer 7 or later the result is NaN Availability ActionScript 1 0 Flash Lite 2 0 Parameters expression Object An expression to convert to a number Numbers or strings that begin with 0x are interpreted as...

Страница 69: ...n value Returns Object An object Example In the following example a new empty object is created and then the object is populated with values var company Object new Object company name Macromedia Inc c...

Страница 70: ...s hasMouse is true or System capabilities hasStylus is true rollOver The mouse pointer rolls over the button dragOut While the pointer is over the button the mouse button is pressed and then rolls out...

Страница 71: ...d Any of the following values can be specified for the movieEvent parameter load The action is initiated as soon as the movie clip is instantiated and appears in the Timeline unload The action is init...

Страница 72: ...the data event occurs repeatedly as each section of data is retrieved Example The following example uses onClipEvent with the keyDown movie event and is designed to be attached to a movie clip or but...

Страница 73: ...number of the specified character See also String charCodeAt String charCodeAt method parseFloat function parseFloat string String Number Converts a string to a floating point number The function rea...

Страница 74: ...nnot be converted to a number the function returns NaN Strings beginning with 0x are interpreted as hexadecimal numbers Integers beginning with 0 or specifying a radix of 8 are interpreted as octal nu...

Страница 75: ...urn 511 which is the decimal representation of the octal 777 parseInt 0777 parseInt 777 8 See also parseFloat function play function play Void Moves the playhead forward in the Timeline Availability A...

Страница 76: ...vious frame stop this myBtn_btn onRelease function prevFrame See also nextFrame function prevFrame MovieClip prevFrame method prevScene function prevScene Void Sends the playhead to Frame 1 of the pre...

Страница 77: ...ateMovieClip or MovieClip createEmptyMovieClip Example The following example creates a new movie clip called myClip_mc and duplicates the movie clip The second movie clip is called newClip_mc Images a...

Страница 78: ...ters a frame this minimizes the impact each time the screen is refreshed Note In Flash Lite 2 0 the interval passed into this method is ignored if it is less than the SWF file s frame rate and the int...

Страница 79: ...ion callback1 trace interval called function callback2 arg trace arg setInterval callback1 1000 setInterval callback2 1000 interval called Usage 3 This example uses a method of an object You must use...

Страница 80: ...mer 1000 seconds when the target movie clip is clicked and released you clear the interval and remove the movie clip If you don t clear the interval before deleting the movie clip the function still c...

Страница 81: ...ActionScript 1 0 Flash Lite 1 0 Parameters target Object The path to the instance name of the movie clip whose property is to be set property Object The property to be set expression Object Either the...

Страница 82: ...alue specifying whether the draggable movie clip is locked to the center of the mouse position true or locked to the point where the user first clicked the movie clip false left top right bottom Numbe...

Страница 83: ...ver the frames in which they are located Availability ActionScript 1 0 Flash Lite 1 0 Example The following code creates a text field in which the song s ID3 information appears A new Sound object ins...

Страница 84: ...ps the current drag operation Note This method is supported in Flash Lite only if System capabilities hasMouse is true or System capabilities hasStylus is true Availability ActionScript 1 0 Flash Lite...

Страница 85: ...movie clip in slash notation If expression is undefined the return values are as follows In files published for Flash Player 6 or earlier the result is an empty string In files published for Flash Pl...

Страница 86: ...to include in the extracted string not including the index character Returns String The extracted substring See also substr String substr method targetPath function targetpath targetObject Object Stri...

Страница 87: ...useful for navigation controls Assign tellTarget to buttons that stop or start movie clips elsewhere on the Stage You can also make movie clips go to a particular frame in that clip For example you mi...

Страница 88: ...tation to achieve the same results on release _parent ball gotoAndPlay 2 If you need to issue multiple commands to the ball instance you can use the with action as shown in the following statement on...

Страница 89: ...o record programming notes or to display messages in the Output panel while testing a SWF file Use the expression parameter to check whether a condition exists or to display values in the Output panel...

Страница 90: ...valuates the parameter x as a string decodes the string from URL encoded format converting all hexadecimal sequences to ASCII characters and returns the string Availability ActionScript 1 0 Flash Lite...

Страница 91: ...ded using the MovieClipLoader class When you click the image the movie clip unloads from the SWF file var pic_mcl MovieClipLoader new MovieClipLoader pic_mcl loadClip http www helpexamples com flash i...

Страница 92: ...ess to the timelines of other loaded movie clips both relative _parent and absolute _root They also let you restrict this or expand super scope And you can use global properties to adjust runtime sett...

Страница 93: ...he loadMovie loadMovieNum loadVariables and loadVariablesNum functions _capMFi Deprecated since Flash Lite Player 2 0 This action was deprecated in favor of the System capabilities hasMFi property Ind...

Страница 94: ...abilities hasStreamingAudio property Indicates whether the device can play streaming synchronized sound _focusrect Property global specifies whether a yellow rectangle appears around the button or mov...

Страница 95: ...In the Flash Lite 1 1 player the following code sets the value of myVersion to 5 2 12 0 myVersion version See also version capabilities version property _parent Specifies or returns a reference to th...

Страница 96: ...finds none Flash control navigation occurs However if an event handler is found no navigation action occurs for that key For example if a key press handler for the Down Arrow key is found the user can...

Страница 97: ...t is undefined in Flash Lite 1 0 useCompoundSound _capCompoundSound if useCompoundSound 1 gotoAndPlay withSound else gotoAndPlay withoutSound See also capabilities System capabilities _capEmail proper...

Страница 98: ...nScript 1 0 Flash Lite 1 1 Example If the host application can perform dynamic loading of movies and variables the following example sets CanLoad to 1 canLoad _capLoadData if canLoad 1 loadVariables h...

Страница 99: ...hasMIDI property Numeric variable indicates whether the device can play sound data in the Musical Instrument Digital Interface MIDI audio format If so this variable is defined and has a value of 1 if...

Страница 100: ...owever not all Flash Lite 1 1 phones can send MMS messages so this code is still dependent on the phone on release canMMS _capMMS if canMMS 1 send an MMS myMessage mms 4156095555 body sample mms messa...

Страница 101: ...2 0 This action was deprecated in favor of the System capabilities hasSMS property Numeric variable indicates whether Flash Lite can send Short Message Service SMS messages by using the GetURL ActionS...

Страница 102: ...streaming sound if canStreamSound is enabled on press canStreamSound _capStreamSound if canStreamSound play a streaming sound in a movieclip with this button tellTarget music gotoAndPlay 2 See also ca...

Страница 103: ...t events but will not receive the press and release events Also for Flash Lite 2 0 you can change the color of the focus rectangle by using the fscommand2 SetFocusRectColor command This behavior is di...

Страница 104: ...le of the same name that obscures the global variable you are attempting to set ReturnsA reference to the global object that holds the core ActionScript classes such as String Object Math and Array Av...

Страница 105: ..._levelN You must use loadMovieNum to load SWF files into the Flash Player before you use the _level property to target them You can also use _levelN to target a loaded SWF file at the level assigned b...

Страница 106: ...Flash Player 5 This property was deprecated in favor of TextField maxscroll Indicates the line number of the top line of visible text in a text field when the bottom line in the field is also visible...

Страница 107: ...y String Sets or retrieves the rendering quality used for a movie clip Device fonts are always aliased and therefore are unaffected by the _quality property The _quality property can be set to the fol...

Страница 108: ...ne of the loading movie clip not the Timeline that contains _root If you want to ensure that _root refers to the Timeline of the loaded movie clip even if it is loaded into another movie clip use Movi...

Страница 109: ...long passage or creating scrolling text fields This property can be retrieved and modified Availability ActionScript 1 0 Flash Lite 1 1 Example The following code is attached to an Up button that scro...

Страница 110: ...nce var bg_sound Sound new Sound load the MP3 sound file and set streaming to true bg_sound loadSound yourSound mp3 true function is triggered when the song finishes loading bg_sound onLoad function d...

Страница 111: ...obj addStr call abj null output defined in FLA or AS trace obj addStr call this null output undefined trace obj addStr call obj null output Defined in applyThis as Similarly to call a function defined...

Страница 112: ...ement inside a MovieClip onPress handler the keyword this references the current movie clip this square_mc onPress function startDrag this this square_mc onRelease function stopDrag See also on handle...

Страница 113: ...d expression2 to 32 bit unsigned integers and returns a 1 in each bit position where the corresponding bits of either expression1 or expression2 are 1 bitwise OR assignment Assigns expression1 the val...

Страница 114: ...Instructs Flash to evaluate expression1 and if the value of expression1 is true it returns the value of expression2 otherwise it returns the value of expression3 decrement A pre decrement and post dec...

Страница 115: ...nt A pre increment and post increment unary operator that adds 1 to expression inequality Tests for the exact opposite of the equality operator inequality Deprecated since Flash Player 5 This operator...

Страница 116: ...cal NOT operation in Flash Player 4 logical OR Evaluates expression1 the expression on the left side of the operator and returns true if the expression evaluates to true or logical OR Deprecated since...

Страница 117: ...strict equality operator performs in the same way as the equality operator except that data types are not converted strict inequality Tests for the exact opposite of the strict equality operator strin...

Страница 118: ...ersion of a Flash 4 file that contains a numeric quality comparison Flash 4 file x y Converted Flash 5 or later file Number x Number y Operands expression1 A number or string expression2 A number or s...

Страница 119: ...s use the Number function to convert the string to a number as in the following var oldBalance Number 1345 23 var currentBalance Number Number deposit_txt text oldBalance trace currentBalance The foll...

Страница 120: ...re called elements which are each identified by a number called an index When you create an array you surround the elements with the array access operator or brackets An array can contain elements of...

Страница 121: ...ically set and retrieve values for movie clip names or any property of an object The following line of code sends the number 6 to the Output panel name mc i left_corner Availability ActionScript 1 0 F...

Страница 122: ...d from the my_mc movie clip In this example the variable i must live on the same Timeline as the button If the variable i is equal to 5 for example the value of the variable piece5 in the my_mc movie...

Страница 123: ...the operator is used to evaluate equality Flash 4 files that are brought into the Flash 5 or later authoring environment undergo a conversion process to maintain data type integrity Flash 4 file x y...

Страница 124: ...ration on each bit of the integer parameters Floating point numbers are converted to integers by discarding any digits after the decimal point The result is a new 32 bit integer Positive integers are...

Страница 125: ...bits at the same position are 1 In the following ActionScript code you add 13 binary 1101 and 11 binary 1011 and return 1 only in the position where both numbers have a 1 var insert Number 13 var upd...

Страница 126: ...y Number 9 trace x y output 9 See also bitwise AND operator bitwise XOR operator bitwise XOR assignment operator bitwise OR operator bitwise OR assignment operator bitwise NOT operator bitwise left s...

Страница 127: ...A number or expression to be shifted left expression2 Number A number or expression that converts to an integer from 0 to 31 Returns Number The result of the bitwise operation Example In the followin...

Страница 128: ...ator to shift all bits one space to the left var x Number 4 shift all bits one slot to the left x 1 trace x output 8 4 decimal 0100 binary 8 decimal 1000 binary See also bitwise left shift operator bi...

Страница 129: ...st significant digits discarded The return value is interpreted as a two s complement number with sign so the return value is an integer in the range 2147483648 to 2147483647 Availability ActionScript...

Страница 130: ...ficant digits discarded when they are converted so the value is still 32 bit Negative numbers are converted to an unsigned hex value via the two s complement notation with the minimum being 2147483648...

Страница 131: ...ability ActionScript 1 0 Flash Lite 2 0 Operands expression1 Number A number or variable expression2 Number A number or variable Returns Number The result of the bitwise operation Example The followin...

Страница 132: ...the value is still 32 bit Negative numbers are converted to an unsigned hex value via the two s complement notation with the minimum being 2147483648 or 0x800000000 numbers less than the minimum are c...

Страница 133: ...signment operator bitwise right shift and assignment operator expression1 expression2 This operator performs a bitwise right shift operation and stores the contents as a result in expression1 The foll...

Страница 134: ...converted to an unsigned hex value with a maximum value of 4294967295 or 0xFFFFFFFF values larger than the maximum have their most significant digits discarded when they are converted so the value is...

Страница 135: ...erator bitwise unsigned right shift and assignment operator expression1 expression2 Performs an unsigned bitwise right shift operation and stores the contents as a result in expression1 The following...

Страница 136: ...tation with the minimum being 2147483648 or 0x800000000 numbers less than the minimum are converted to two s complement with greater precision and also have the most significant digits discarded The r...

Страница 137: ...xpression2 Number Integers and variables Returns Number The result of the bitwise operation Example The following example shows a bitwise XOR assignment operation 15 decimal 1111 binary var x Number 1...

Страница 138: ...aced between them Availability ActionScript 1 0 Flash Lite 1 0 Operands comment Any characters Example The following script uses comment delimiters at the beginning of the script records the X and Y p...

Страница 139: ...turns only the value of the first expression without the parentheses operator var v Number 0 v 4 5 6 trace v output 4 The following example uses the comma operator with the parentheses operator and il...

Страница 140: ...dition operator when creating content for Flash Player 5 or later Note Flash Lite 2 0 also deprecates the add operator in favor of the addition operator Concatenates two or more strings The add operat...

Страница 141: ...Object Values of any type expression3 Object Values of any type Returns Object The value of expression2 or expression3 Example The following statement assigns the value of variable x to variable z bec...

Страница 142: ...ession Number A number or a variable that evaluates to a number Returns Number The result of the decremented value Example The pre decrement form of the operator decrements x to 2 x 1 2 and returns th...

Страница 143: ...5 and 150 See also modulo operator division assignment operator expression1 expression2 Assigns expression1 the value of expression1 expression2 For example the following two statements are equivalent...

Страница 144: ...associated with an object All the valid methods and properties for the built in classes are listed in the method and property summary tables for that class This parameter is always to the right of the...

Страница 145: ...qual depends on the data type of the parameter Numbers and Boolean values are compared by value and are considered equal if they have the same value String expressions are equal if they have the same...

Страница 146: ...erence requires that they both refer to the same array The second example creates the thirdArray variable which points to the same array as the variable firstArray The equality operator will return tr...

Страница 147: ...less than or equal to expression2 the operator returns false String expressions are evaluated using alphabetical order all capital letters come before lowercase letters Availability ActionScript 1 0...

Страница 148: ...Compares the string representation of expression1 with the string representation of expression2 and returns true if expression1 is greater than expression2 false otherwise Availability ActionScript 1...

Страница 149: ...nteger or floating point number Returns Boolean The Boolean result of the comparison Example In the following example the greater than or equal to operator is used to determine whether the current hou...

Страница 150: ...the operator expression adds 1 to expression and returns the initial value of expression the value prior to the addition The pre increment form of the operator increments x to 2 x 1 2 and returns the...

Страница 151: ...2 3 4 5 6 7 8 9 10 This example also uses as a pre increment operator var a Array for var i 1 i 10 i a push i trace a toString traces 1 2 3 4 5 6 7 8 9 10 This script shows the following result in th...

Страница 152: ...pressions have the same value For example the expression 2 3 is equal to the expression 1 4 when compared by value Comparison by reference means that two expressions are equal only if they both refer...

Страница 153: ...t foo foo true foo foo false The following example illustrates comparison by reference with two arrays var a Array 1 2 3 var b Array 1 2 3 trace a 1 2 3 trace b 1 2 3 trace a b true a b trace a 1 2 3...

Страница 154: ...ct array or function expression2 Object A number string Boolean value variable object array or function Returns Boolean The Boolean result of the comparison See also inequality operator instanceof ope...

Страница 155: ...phabetical order all capital letters come before lowercase letters Availability ActionScript 1 0 Flash Lite 1 0 In Flash 4 is a numeric operator In Flash 5 and later the less than operator is a compar...

Страница 156: ...expression2 and returns true if expression1 is less than expression2 false otherwise Availability ActionScript 1 0 Flash Lite 1 0 Operands expression1 Object Numbers strings or variables expression2 O...

Страница 157: ...umber or string expression2 Object A number or string Returns Boolean The Boolean result of the comparison Example The following examples show true and false results for both numeric and string compar...

Страница 158: ...omment and ignored by the ActionScript interpreter Availability ActionScript 1 0 Flash Lite 1 0 Operands comment Any characters Example The following script uses comment delimiters to identify the fir...

Страница 159: ...that converts to a Boolean value expression2 Number A Boolean value or an expression that converts to a Boolean value Returns Boolean A Boolean result of the logical operation Example The following e...

Страница 160: ...ssions that evaluate to true or false Returns Boolean A Boolean result of the logical operation See also logical AND operator logical NOT operator expression Inverts the Boolean value of a variable or...

Страница 161: ...See also inequality operator strict inequality operator logical AND operator logical OR operator equality operator strict equality operator not logical NOT operator not expression Deprecated since Fl...

Страница 162: ...with any number of operands if any operand evaluates to true the result is true Availability ActionScript 1 0 Flash Lite 1 0 Operands expression1 Number A Boolean value or an expression that converts...

Страница 163: ...e fx1 called IF statement entered See also logical NOT operator inequality operator strict inequality operator logical AND operator equality operator strict equality operator or logical OR operator co...

Страница 164: ...ns of Flash Player Operands expression1 Number A number or expression that evaluates to a number expression2 Number A number or expression that evaluates to a number Returns Number The result of the a...

Страница 165: ...variable x var x Number 14 var y Number 5 trace x y output 4 See also modulo operator multiplication operator expression1 expression2 Multiplies two numerical expressions If both expressions are inte...

Страница 166: ...ession1 Number A number or expression that evaluates to a number expression2 Number A number or expression that evaluates to a number Returns Number The value of expression1 expression2 If an expressi...

Страница 167: ...Number or Object to be constructed Example The following example creates the Book function and then uses the new operator to create the objects book1 and book2 function Book name price this name name...

Страница 168: ...newly created object is generically named the Object object This operator is also used to mark blocks of contiguous code associated with flow control statements for while if else switch and functions...

Страница 169: ...the previous example and produces the same result using constructor functions var person Object new Object person name Gina Vechio person children new Array person children 0 Ruby person children 1 C...

Страница 170: ...ion to be performed on the contents of the parentheses parameter1 parameterN Object A series of parameters to execute before the results are passed as parameters to the function outside the parenthese...

Страница 171: ...if they have the same value String expressions are equal if they have the same number of characters and the characters are identical Variables representing objects arrays and functions are compared b...

Страница 172: ...ace string1 bool2 true trace string1 bool2 false The following examples show how strict equality treats variables that are references differently than it treats variables that contain literal values T...

Страница 173: ...A variable is compared by value or by reference depending on its type Availability ActionScript 1 0 Flash Lite 2 0 Operands expression1 Object A number string Boolean value variable object array or fu...

Страница 174: ...name of a variable The value of province is a variable not a literal to determine the value of province the value of yourGuess must be located var yourGuess String Prince Edward Island submit_btn onR...

Страница 175: ...3 The following statement subtracts the floating point number 1 5 from the floating point number 3 25 trace 3 25 1 5 output 1 75 The result 1 75 is a floating point number subtraction assignment opera...

Страница 176: ...ator specifies the function s return type when used with a function parameter in a function definition this operator specifies the variable type expected for that parameter Types are a compile time on...

Страница 177: ...med val of the Number type and returns the square root of val also a Number type function squareRoot val Number Number return Math sqrt val trace squareRoot 121 See also var statement function stateme...

Страница 178: ...specify an action For example the return statement returns a result as a value of the function in which it executes The if statement evaluates a condition to determine the next action that should be t...

Страница 179: ...f the condition in the initial if statement returns false extends Defines a class that is a subclass of another class the latter is the superclass for Evaluates the init initialize expression once and...

Страница 180: ...caller return Specifies the value returned by a function set Permits implicit setting of properties associated with objects based on classes you have defined in external class files set variable Assi...

Страница 181: ...expression parameter of the switch statement using strict equality then Flash Player will execute statements in the statement s parameter until it encounters a break statement or the end of the switch...

Страница 182: ...ce Some summer month break case 8 trace September break default trace some other month See also break statement class statement dynamic class className extends superClass implements interfaceName inte...

Страница 183: ...re you begin creating classes Otherwise if you decide to move class files after you create them you have to modify the class declaration statements to reflect their new location You cannot nest class...

Страница 184: ...operty of a class function getLeafType String return leafType function getBloomSeason String return bloomSeason In an external script file or in the Actions panel use the new operator to create a Plan...

Страница 185: ...the next iteration of the loop as if control had passed through to the end of the loop normally It has no effect outside a loop Availability ActionScript 1 0 Flash Lite 1 0 Example In the following wh...

Страница 186: ...or i in _root if i version continue trace i default statement default statements Defines the default case for a switch statement The statements execute if the expression parameter of the switch statem...

Страница 187: ...eak default trace Weekend See also switch statement delete statement delete reference Destroys the object reference specified by the reference parameter and returns true if the reference is successful...

Страница 188: ...ct uses it and deletes it after it is no longer needed var account Object new Object account name Jon account balance 10000 trace account name output Jon delete account trace account name output undef...

Страница 189: ...dition Subsequently the statements are executed only if the condition evaluates to true A do while loop ensures that the code inside the loop executes at least once Although this can also be done with...

Страница 190: ...add and access dynamic properties at runtime Type checking on dynamic classes is less strict than type checking on nondynamic classes because members accessed inside the class definition and on class...

Страница 191: ...Person2 new Person2 Craiggers 32 for i in craig trace craig i craig i output craig age 32 craig name Craiggers If you add an undeclared function dance an error is generated as shown in the following e...

Страница 192: ...Object accessAllowed false In the following example curly braces are not necessary because only one statement follows the else statement if age_txt text 18 trace welcome user else trace sorry junior S...

Страница 193: ...ord is supported only when used in external script files not in scripts written in the Actions panel Defines a class that is a subclass of another class the latter is the superclass The subclass inher...

Страница 194: ...ends the Vehicle class modifying it in three ways First the Car class adds a variable fullSizeSpare to track whether the car object has a full size spare tire Second it adds a new method specific to c...

Страница 195: ...example shows a third AS file called Truck as again in the same directory The Truck class uses the super keyword in the constructor and again in the overridden reverse function class Truck extends Veh...

Страница 196: ...nScript 1 0 Flash Lite 1 0 Parameters init An expression to evaluate before beginning the looping sequence usually an assignment expression A var statement is also permitted for this parameter Example...

Страница 197: ...both contain the property prop the for in statement called on child enumerates prop from child but ignores the one in parent The curly braces used to enclose the block of statements to be executed by...

Страница 198: ...veral children _RedRadioButton_ _GreenRadioButton_ and _BlueRadioButton_ for var name in RadioButtonGroup RadioButtonGroup name gotoAndStop 2 function statement Usage 1 Declares a named function funct...

Страница 199: ...ctionality you can use the arguments object in your function definition Some common uses of the arguments object are creating a function that accepts a variable number of parameters and creating a rec...

Страница 200: ...defined in external class files Using implicit get methods lets you access properties of objects without accessing the property directly Implicit get set methods are syntactic shorthand for the Object...

Страница 201: ...urly braces If the condition is false Flash skips the statements inside the curly braces and runs the statements following the curly braces Use the if statement along with the else and else if stateme...

Страница 202: ...me Number getTimer this submit_btn onRelease function var difference Number getTimer startTime 1000 if difference 10 this _parent message_txt text Not very speedy you took difference seconds else this...

Страница 203: ...util users You must issue the import statement before you try to access the imported class without fully specifying its name If you import a class but don t use it in your script the class isn t expor...

Страница 204: ...hod declared in the interface Only public members are allowed in an interface definition instance and class members are not permitted The get and set statements are not allowed in interface definition...

Страница 205: ...function o Void trace o external script or Actions panel script file mvar new D trace mvar k 15 trace mvar n 7 49 trace mvar o o interface Ic extends Ia function p Void class E implements Ib Ic funct...

Страница 206: ...eeking to enable compile time type checking with previously defined classes especially if the classes are defined using ActionScript 1 0 This keyword is supported only when used in external script fil...

Страница 207: ...keyword you must specify ActionScript 2 0 and Flash Player 6 or later in the Flash tab of your FLA file s Publish Settings dialog box This keyword is supported only when used in external script files...

Страница 208: ...aram_password In the same directory as Login as create a new FLA or AS document Enter the following ActionScript in Frame 1 of the Timeline import Login var gus Login new Login Gus Smith trace gus use...

Страница 209: ...or AS file in the same directory and enter the following ActionScript in Frame 1 of the Timeline import User var jimmy User new User jimmy age 27 jimmy name jimmy If you change one of the public vari...

Страница 210: ...atement function set property varName your statements here Note To use this keyword you must specify ActionScript 2 0 and Flash Player 6 or later in the Flash tab of your FLA file s Publish Settings d...

Страница 211: ...at is in the same directory as Login as enter the following ActionScript in Frame 1 of the Timeline var gus Login new Login Gus Smith trace gus username output Gus gus username Rupert trace gus userna...

Страница 212: ...s assigned to it For example if you create a string variable named myVariable and assign it the value Tuesday and then forget to use quotation marks you will inadvertently create a new variable named...

Страница 213: ...an instance of the class you can also access a static member using the instance but only through a non static function that accesses the static member You can use this keyword in class definitions on...

Страница 214: ...dd additional behavior to superclass methods but also invoke the superclass methods to perform their original behavior The second syntax style may be used within the body of a constructor function to...

Страница 215: ...rs expression Any expression Example In the following example if the String fromCharCode Key getAscii parameter evaluates to A the trace statement that follows case A executes if the parameter evaluat...

Страница 216: ...that is passed to it is a properly formatted e mail address If the string does not contain an symbol the function throws an error function checkEmail email String if email indexOf 1 throw new Error In...

Страница 217: ...statement control passes to the catch block if one exists and then to the finally code block if one exists The finally block always executes regardless of whether an error was thrown If code within th...

Страница 218: ...0 Flash Lite 2 0 Parameters error Object The expression thrown from a throw statement typically an instance of the Error class or one of its subclasses Example The following example shows how to creat...

Страница 219: ...ccount information finally if account null delete account The following example demonstrates a try catch statement The code within the try block is executed If an exception is thrown by any code withi...

Страница 220: ...Error class Each is defined in its own AS class file In RecordSetException as class RecordSetException extends Error var message Record set exception occurred In MalformedRecord as class MalformedRec...

Страница 221: ...all More specifically a variable defined using var is local to the code block containing it Code blocks are demarcated by curly braces If you declare variables outside a function the variables are ava...

Страница 222: ...eries of statements is skipped and the loop ends The while statement performs the following series of steps Each repetition of steps 1 through 4 is called an iteration of the loop The condition is ret...

Страница 223: ...with the statement s parameter This prevents you from having to repeatedly write the object s name or the path to the object The object parameter becomes the context in which the properties variables...

Страница 224: ...tatement without declaring it the with statement will look for the value according to the scope chain If the variable doesn t already exist the new value will be set on the Timeline from which the wit...

Страница 225: ...3 The following result is displayed in the Output panel area 28 2743338823081 x 3 y 3 fscommand2 Commands The following commands are available for the fscommand2 function For a description of the fsc...

Страница 226: ...ered and whether the phone is currently roaming GetPlatform Sets a parameter that identifies the current platform which broadly describes the class of device GetPowerSource Returns a value that indica...

Страница 227: ...the duration of the backlight for 45 seconds status FSCommand2 ExtendBacklightDuration 45 FullScreen fscommand2 Command FullScreen Sets the size of the display area to be used for rendering The size...

Страница 228: ...el fscommand2 GetBatteryLevel GetDevice fscommand2 Command GetDevice Sets a parameter that identifies the device on which Flash Lite is running This identifier is typically the model name Availability...

Страница 229: ...mple the serial number Availability ActionScript 1 0 Flash Lite 1 1 Example The following example assigns the unique identifier to the deviceID variable status fscommand2 GetDeviceID deviceID GetFreeP...

Страница 230: ...the maximum battery level maxBatt fscommand2 GetMaxBatteryLevel GetMaxSignalLevel fscommand2 Command GetMaxSignalLevel Returns the maximum signal strength level as a numeric value Availability Action...

Страница 231: ...fault network connection For mobile devices this connection is also known as an access point Availability ActionScript 1 0 Flash Lite 2 0 Example The following example returns the name of the active o...

Страница 232: ...ommand2 GetNetworkConnectStatus switch connectstatus case 1 _root myText connectstatus not supported n break case 0 _root myText connectstatus shows active connection n break case 1 _root myText conne...

Страница 233: ...e current network to the myNetName parameter and a status value to the netNameStatus variable netNameStatus fscommand2 GetNetworkName myNetName Command Parameters Value Returned GetNetworkGeneration N...

Страница 234: ...tworkRequestStatus None 1 The command is not supported 0 There is a pending request a network connection has been established the server s host name has been resolved and a connection to the server ha...

Страница 235: ...t no HTTP request has been made n break GetNetworkStatus fscommand2 Command GetNetworkStatus Returns a value indicating the network status of the phone that is whether there is a network registered an...

Страница 236: ...describes the class of device For devices with open operating systems this identifier is typically the name and version of the operating system Availability ActionScript 1 0 Flash Lite 1 1 Example Th...

Страница 237: ...alLevel fscommand2 Command GetSignalLevel Returns the current signal strength as a numeric value Availability ActionScript 1 0 Flash Lite 1 1 Example The following example assigns the signal level val...

Страница 238: ...GetVolumeLevel Returns the current volume level of the device as a numeric value Availability ActionScript 1 0 Flash Lite 1 1 Example The following example assigns the current volume level to the vol...

Страница 239: ...running in stand alone mode status fscommand2 Quit ResetSoftKeys fscommand2 Command ResetSoftKeys Resets the soft keys to their original settings This command is supported only when Flash Lite is runn...

Страница 240: ...ifies the mode in which the input text field should be opened Flash Lite supports input text functionality by asking the host application to start the generic device specific text input interface ofte...

Страница 241: ...ted only when Flash Lite is running in stand alone mode It is not supported when the player is running in the context of another application for example as a plug in to a browser InputTextType Mode Se...

Страница 242: ...SOFT2 soft key Next status fscommand2 SetSoftKeys Previous Next You can define variables or use constant string values for each soft key status fscommand2 SetSoftKeys soft1 soft2 soft3 soft4 softn Not...

Страница 243: ...ate 2500 1000 2 StopVibrate fscommand2 Command StopVibrate Stops the current vibration if any Availability ActionScript 1 0 Flash Lite 1 1 Example The following example calls StopVibrate and saves the...

Страница 244: ...244 ActionScript language elements...

Страница 245: ...in the Index arguments Object arguments public class arguments extends Object An arguments object is used to store and access a function s arguments While inside the function s body it can be accessed...

Страница 246: ...Description callee Object A reference to the currently executing function caller Object A reference to the function that called the currently executing function or null if it wasn t called from anoth...

Страница 247: ...is 0 the second element is 1 and so on To create an Array object you use the constructor new Array To access the elements of an array you use the array access operator You can store a wide variety of...

Страница 248: ...that you can then use an object literal to populate your associative array but only at the time you declare it The following example creates an associative array using an object literal accesses item...

Страница 249: ...nts in the array static NUMERIC Number Represents numeric sorting instead of string based sorting static RETURNINDEXEDARRAY Number Represents the option to return an indexed array as a result of calli...

Страница 250: ...verses the array in place shift Object Removes the first element from an array and returns that element slice startIndex Number endIndex Number Array Returns a new array that consists of a range of el...

Страница 251: ...more arbitrary values The values can be of type Boolean Number String Object or Array The first element in an array always has an index or position of 0 Note If only a single numeric parameter is pas...

Страница 252: ...gos_array 1 Gina go_gos_array 2 Kathy go_gos_array 3 Charlotte go_gos_array 4 Jane The following code adds a sixth element to the go_gos_array array and changes the second element go_gos_array 5 Donna...

Страница 253: ...y new Array a b c var numeric_array Array new Array 1 2 3 var alphaNumeric_array Array alpha_array concat numeric_array trace alphaNumeric_array Creates array a b c 1 2 3 The following code concatenat...

Страница 254: ...ring A nested array is always separated by a comma not by the separator passed to the join method Availability ActionScript 1 0 Flash Lite 2 0 Parameters delimiter String optional A character or strin...

Страница 255: ...is a number and index 1 is greater than the length property the length property is updated to index 1 Note If you assign a value to the length property that is shorter than the existing length the arr...

Страница 256: ...the sort or sortOn method The value of this constant is 16 Availability ActionScript 1 0 Flash Lite 2 0 See also sort Array sort method sortOn Array sortOn method pop Array pop method public pop Objec...

Страница 257: ...of myPets_array 4 to the Output panel var myPets_array Array new Array cat dog var pushed Number myPets_array push bird fish trace pushed Displays 4 See also pop Array pop method shift Array shift met...

Страница 258: ...urns Object The first element in an array Example The following code creates the array myPets_array and then removes the first element from the array and assigns it to the variable shifted var myPets_...

Страница 259: ...xample creates an array of five pets and uses slice to populate a new array that contains only four legged pets var myPets_array Array new Array cat dog fish canary parrot var myFourLeggedPets_array A...

Страница 260: ...unction to do the sorting If you create a custom function you can use it by calling the sort method using the name of your custom function as the first parameter compareFunction Availability ActionScr...

Страница 261: ...use of Array sort with and without a value passed for options var fruits_array Array new Array oranges apples strawberries pineapples cherries trace fruits_array Displays oranges apples strawberries p...

Страница 262: ...objects have at least one property in common the values of which can be used to sort the array Such a property is called a field If you pass multiple fieldName parameters the first field represents t...

Страница 263: ...eter Array CASEINSENSITIVE or 1 Array DESCENDING or 2 Array UNIQUESORT or 4 Array RETURNINDEXEDARRAY or 8 Array NUMERIC or 16 Code hinting is enabled if you use the string form of the flag for example...

Страница 264: ...city name for i 0 i rec_array length i trace rec_array i name rec_array i city Results john kansas city bob omaha john omaha The following array of objects is used by subsequent examples that show how...

Страница 265: ...cending numeric sort on the age field produces the following results my_array sortOn age Array DESCENDING Array NUMERIC my_array 0 age 35 my_array 1 age 29 my_array 2 age 4 my_array 3 age 3 When using...

Страница 266: ...parameter This removes all elements from the array starting with the second element leaving only the element at index 0 in the original array var myPets_array Array new Array cat dog bird fish trace m...

Страница 267: ...my_array Array new Array my_array 0 1 my_array 1 2 my_array 2 3 my_array 3 4 my_array 4 5 trace my_array toString Displays 1 2 3 4 5 This example outputs 1 2 3 4 5 as a result of the trace statement S...

Страница 268: ...h trace pets_array Displays dog cat fish pets_array unshift ferrets gophers engineers trace pets_array Displays ferrets gophers engineers dog cat fish See also pop Array pop method push Array push met...

Страница 269: ...constructor Object constructor property __proto__ Object __proto__ property prototype Object prototype property __resolve Object __resolve property Signature Description Boolean value Object Creates a...

Страница 270: ...lue to a string for use in the trace statement var myBool Boolean true trace The value of the Boolean myBool is myBool toString myBool false trace The value of the Boolean myBool is myBool toString va...

Страница 271: ...stance name in the Property inspector and use the methods and properties of the Button class to manipulate buttons with ActionScript Button instance names are displayed in the Movie Explorer and in th...

Страница 272: ...t MovieClip A reference to the movie clip or object that contains the current movie clip or object _quality String Property global sets or retrieves the rendering quality used for a SWF file _rotation...

Страница 273: ...ymouse Number read only Returns the y coordinate of the mouse position relative to the button _yscale Number The vertical scale of the button as applied from the registration point of the button expre...

Страница 274: ...tside function Invoked when the mouse is released with the pointer outside the button after the mouse button is pressed with the pointer inside the button onRollOut function Invoked when the button lo...

Страница 275: ...sable part of your navigation for example you may want to disable a button in the currently displayed page so that it can t be clicked and the page cannot be reloaded Availability ActionScript 1 0 Fla...

Страница 276: ...must set _focusrect to true Note For the Flash Lite 2 0 player when the _focusrect property is disabled in other words Button focusRect is false the button receives all events This behavior is differ...

Страница 277: ...yBtn3_btn onRelease function trace myClip_mc myBtn4_btn getDepth You might notice that two of these buttons have the same depth value one in the main SWF file and one in the loaded SWF file This is mi...

Страница 278: ...h bitmap smoothing always on Specify 1 high quality to apply anti aliasing this smooths bitmaps if the SWF file does not contain animation and is the default value Specify 0 low quality to prevent ant...

Страница 279: ...er outside of the button You must define a function that is executed when the event handler is invoked Note The onDragOut Event Handler is supported for Flash Lite 2 0 only if System capabilities hasM...

Страница 280: ...called my_btn on the Stage and enter the following ActionScript on the Timeline my_btn onDragOut function trace onDragOut this _name my_btn onDragOver function trace onDragOver this _name When you te...

Страница 281: ...Test Movie to test the SWF file Make sure you select Control Disable Keyboard Shortcuts in the test environment Then press the Tab key until the button has focus a yellow rectangle appears around the...

Страница 282: ...Press Control Enter to test the SWF file Make sure you select Control Disable Keyboard Shortcuts in the test environment Then press the Tab key until the button has focus a yellow rectangle appears ar...

Страница 283: ...rowser window and try using the Tab key to move through the elements in the window When the button instance loses focus text is sent to the output_txt text field onPress Button onPress handler onPress...

Страница 284: ...nReleaseOutside Event Handler is supported for Flash Lite 2 0 only if System capabilities hasMouse is true or System capabilities hasStylus is true Availability ActionScript 1 0 Flash Lite 2 0 Example...

Страница 285: ...ity ActionScript 1 0 Flash Lite 2 0 Example In the following example a function that sends a trace statement to the Output panel is defined for the onRollOver handler my_btn onRollOver function trace...

Страница 286: ...arent property public _parent MovieClip A reference to the movie clip or object that contains the current movie clip or object The current object is the one containing the ActionScript code that refer...

Страница 287: ...hed if the movie is static This is the default rendering quality setting used by Flash Note Although you can specify this property for a Button object it is actually a global property and you can spec...

Страница 288: ...Other_btn Button this createEmptyMovieClip rotater_mc this getNextHighestDepth rotater_mc onEnterFrame function myOther_btn _rotation 2 See also _rotation MovieClip _rotation property _rotation TextFi...

Страница 289: ...order because tabEnabled is set to false for that instance To set the tab ordering for the four buttons add the following ActionScript to Frame 1 of the Timeline three_btn tabEnabled false two_btn ta...

Страница 290: ...Script is used to set the tabEnabled property for one of four buttons to false However all four buttons one_btn two_btn three_btn and four_btn are placed in a custom tab order using tabIndex Although...

Страница 291: ...val this _target trace target_btn _name displays my_btn See also _target MovieClip _target property trackAsMenu Button trackAsMenu property public trackAsMenu Boolean A Boolean value that indicates wh...

Страница 292: ...contain trackAsMenu and test the SWF file again to see the difference in button behavior See also trackAsMenu MovieClip trackAsMenu property _url Button _url property public _url String read only Retr...

Страница 293: ...Frame 1 of the Timeline myBtn1_btn onRelease function this _visible false trace clicked this _name myBtn2_btn onRelease function this _alpha 0 trace clicked this _name Notice how you can still click m...

Страница 294: ...e system that is rotated 90 degrees counterclockwise The button s coordinates refer to the registration point position Availability ActionScript 1 0 Flash Lite 2 0 Example The following example sets t...

Страница 295: ...ymouse newline table_str b Button b t x my_btn _xmouse t y my_btn _ymouse newline table_str textformat mouse_txt htmlText table_str Mouse addListener mouseListener See also _ymouse Button _ymouse prop...

Страница 296: ...refers to the upper left corner of the Stage as 0 0 If the button is inside another movie clip that has transformations the button is in the local coordinate system of the enclosing movie clip Thus fo...

Страница 297: ...button called my_btn that is placed on the Stage Enter the following ActionScript in Frame 1 of the Timeline this createTextField mouse_txt 999 5 5 150 40 mouse_txt html true mouse_txt wordWrap true m...

Страница 298: ...operty _xscale Button _xscale property capabilities System capabilities Object System capabilities public class capabilities extends Object The Capabilities class determines the abilities of the syste...

Страница 299: ...Lite player does not support the development nor playback of screen broadcast applications to be run through Flash Media Server that does not support printing on the device that the Flash Lite player...

Страница 300: ...value that is true if the player is running in an environment that supports communication between Flash Player and accessibility aids false otherwise static hasAudio Boolean read only Specifies if the...

Страница 301: ...mobile device can send MMS messages with the GetURL ActionScript command static hasMouse Boolean read only Indicates whether the mobile device sends mouse related events to a Flash Lite player static...

Страница 302: ...ly A Boolean value that is true if the player can play streaming audio false otherwise static hasStreamingVideo Boolean read only A Boolean value that is true if the player can play streaming video fa...

Страница 303: ...rrent screen orientation static screenResolutionX Number read only An integer that indicates the maximum horizontal resolution of the screen static screenResolutionY Number read only An integer that i...

Страница 304: ...olean value that specifies whether access to the user s camera and microphone has been administratively prohibited true or allowed false The server string is AVD Note For Flash Lite 2 0 the value retu...

Страница 305: ...h Lite 2 0 Example The following example traces the value of this read only property trace System capabilities has4WayKeyAS hasAccessibility capabilities hasAccessibility property public static hasAcc...

Страница 306: ...Flash Lite 2 0 Example The following example traces the value of this read only property trace System capabilities hasAudioEncoder hasCMIDI capabilities hasCMIDI property public static hasCMIDI Boolea...

Страница 307: ...ns loadMovie loadMovieNum loadVariables loadVariablesNum XML parseXML Sound loadSound MovieClip loadVariables MovieClip loadMovie MovieClipLoader loadClip LoadVars load LoadVars sendAndLoad Otherwise...

Страница 308: ...this read only property trace System capabilities hasEmbeddedVideo hasMappableSoftKeys capabilities hasMappableSoftKeys property public static hasMappableSoftKeys Boolean Returns true if the mobile d...

Страница 309: ...MIDI hasMMS capabilities hasMMS property public static hasMMS Boolean read only Returns true if the mobile device can send MMS messages with the GetURL ActionScript command Otherwise this property ret...

Страница 310: ...hasPrinting property public static hasPrinting Boolean read only A Boolean value that is true if the player is running on a mobile device that supports printing false otherwise The server string is P...

Страница 311: ...ead only property trace System capabilities hasScreenBroadcast hasScreenPlayback capabilities hasScreenPlayback property public static hasScreenPlayback Boolean read only A Boolean value that is true...

Страница 312: ...value of this read only property trace System capabilities hasSMAF hasSMS capabilities hasSMS property public static hasSMS Number read only Indicates if the mobile device can send SMS messages with t...

Страница 313: ...stem capabilities hasStreamingVideo hasStylus capabilities hasStylus property public static hasStylus Boolean read only Indicates if the mobile device supports stylus related events This property retu...

Страница 314: ...urns an array that contains all MIME types that the loadMovie function and the codecs for a mobile device support for processing images Availability ActionScript 1 0 Flash Lite 2 0 Example The followi...

Страница 315: ...n Flash Player 6 all English systems return the language code and the two letter country code subtag en US In Flash Player 7 English systems return only the language code en Second on Microsoft Window...

Страница 316: ...t Flash Player launches with from the user s hard disk For example attempts to read a file on the user s hard disk using XML load LoadMovie or LoadVars load will fail if this property is set to true R...

Страница 317: ...T Windows 98 ME Windows 95 Windows CE available only in Flash Player SDK not in the desktop version Linux and MacOS The server string is OS Availability ActionScript 1 0 Flash Lite 2 0 Example The fol...

Страница 318: ...olutionX screenResolutionY capabilities screenResolutionY property public static screenResolutionY Number read only An integer that indicates the maximum vertical resolution of the screen The server s...

Страница 319: ...cates all the MIME types for video that the mobile device s codecs support This property returns an array of all the MIME types for video that the mobile device s codecs support Availability ActionScr...

Страница 320: ...r target Object Creates a Color object for the movie clip specified by the target_mc parameter Modifiers Signature Description getRGB Number Returns the R G B combination currently in use by the color...

Страница 321: ...lue for the color specified Example The following code retrieves the RGB value for the Color object my_color converts the value to a hexadecimal string and assigns it to the myValue variable To see th...

Страница 322: ...tTransform See also setTransform Color setTransform method setRGB Color setRGB method public setRGB offset Number Void Specifies an RGB color for a Color object Calling this method overrides any previ...

Страница 323: ...omponent 255 to 255 ba is the percentage for the blue component 100 to 100 bb is the offset for the blue component 255 to 255 aa is the percentage for alpha 100 to 100 ab is the offset for alpha 255 t...

Страница 324: ...Date class lets you retrieve date and time values relative to universal time Greenwich mean time now called universal time or UTC or relative to the operating system on which Flash Player is running...

Страница 325: ...ing time are always applied which leads to incorrect transitions in Europe and other areas that employ daylight saving time but have different transition times than the U S Flash correctly detects whe...

Страница 326: ...etLocaleLongDate String Returns a string representing the current date in long form formatted according to the currently defined locale getLocaleShortDate String Returns a string representing the curr...

Страница 327: ...tUTCFullYear Number Returns the four digit year of the specified Date object according to universal time getUTCHours Number Returns the hour an integer from 0 to 23 of the specified Date object accord...

Страница 328: ...setMinutes minute Number Number Sets the minutes for a specified Date object according to local time and returns the new time in milliseconds setMonth month Number date Number Number Sets the month fo...

Страница 329: ...ied Date object in universal time and returns the new time in milliseconds setYear year Number Number Sets the year for the specified Date object in local time and returns the new time in milliseconds...

Страница 330: ...he third line a Date object is created with year month and date parameters passed to it resulting in the time 09 30 15 GMT 0 milliseconds March 6 1965 Note that since the year parameter is specified a...

Страница 331: ...The following example creates a new Date object and concatenates the returned values of Date getMonth Date getDate and Date getFullYear var today_date Date new Date var date_str String today_date get...

Страница 332: ...al time is determined by the operating system on which Flash Player is running Availability ActionScript 1 0 Flash Lite 2 0 Returns Number An integer representing the day of the week Example The follo...

Страница 333: ...is determined by the operating system on which Flash Player is running Availability ActionScript 1 0 Flash Lite 2 0 Returns Number An integer Example The following example uses the constructor to crea...

Страница 334: ...nt time It also uses the getLocaleLongDate method to return the current date in long form formatted according to the currently defined locale as follows var my_date Date new Date trace my_date getLoca...

Страница 335: ...e mobile device and the locale Availability ActionScript 1 0 Flash Lite 2 0 Returns String A string representing the current time formatted according to the currently defined locale Example The follow...

Страница 336: ...d by the operating system on which Flash Player is running Availability ActionScript 1 0 Flash Lite 2 0 Returns Number An integer Example The following example uses the constructor to create a Date ob...

Страница 337: ...eptember October November December return monthNames_array month getSeconds Date getSeconds method public getSeconds Number Returns the seconds an integer from 0 to 59 of the specified Date object acc...

Страница 338: ...An integer Example The following example returns the difference between the local daylight saving time for San Francisco and universal time Daylight saving time is factored into the returned result on...

Страница 339: ...Number Returns the day of the week 0 for Sunday 1 for Monday and so on of the specified Date object according to universal time Availability ActionScript 1 0 Flash Lite 2 0 Returns Number An integer E...

Страница 340: ...differ from the value returned by Date getFullYear if today s date is December 31 or January 1 depending on the relationship between your local time zone and universal time var today_date Date new Dat...

Страница 341: ...tUTCMilliseconds Date getUTCMilliseconds method public getUTCMilliseconds Number Returns the milliseconds an integer from 0 to 999 of the specified Date object according to universal time Availability...

Страница 342: ...e creates a new Date object and uses Date getUTCMonth and Date getMonth The value returned by Date getUTCMonth can differ from the value returned by Date getMonth if today s date is the first or last...

Страница 343: ...ses Date getUTCFullYear and Date getFullYear The value returned by Date getUTCFullYear may differ from the value returned by Date getFullYear if today s date is December 31 or January 1 depending on t...

Страница 344: ...mber Number Sets the day of the month for the specified Date object according to local time and returns the new time in milliseconds Local time is determined by the operating system on which Flash Pla...

Страница 345: ...year Number A four digit number specifying a year Two digit numbers do not represent four digit years for example 99 is not the year 1999 but the year 99 month Number optional An integer from 0 Janua...

Страница 346: ...new Date object setting the time and date to 8 00 a m on May 15 2004 and uses Date setHours to change the time to 4 00 p m var my_date Date new Date 2004 4 15 8 trace my_date getHours output 8 my_dat...

Страница 347: ...ed by the operating system on which Flash Player is running Availability ActionScript 1 0 Flash Lite 2 0 Parameters minute Number An integer from 0 to 59 Returns Number An integer Example The followin...

Страница 348: ...getMonth output 5 setSeconds Date setSeconds method public setSeconds second Number Number Sets the seconds for the specified Date object in local time and returns the new time in milliseconds Local...

Страница 349: ...my_date getTime convert my_date to milliseconds myDate_num 30 60 1000 add 30 minutes in milliseconds my_date setTime myDate_num set my_date Date object 30 minutes forward trace my_date getFullYear ou...

Страница 350: ...rns the new time in milliseconds Optionally this method can also set the month and date represented by the specified Date object Calling this method does not modify the other fields of the specified D...

Страница 351: ...nute Number second Number millisecond Number Number Sets the hour for the specified Date object in universal time and returns the new time in milliseconds Availability ActionScript 1 0 Flash Lite 2 0...

Страница 352: ...CMilliseconds method public setUTCMilliseconds millisecond Number Number Sets the milliseconds for the specified Date object in universal time and returns the new time in milliseconds Availability Act...

Страница 353: ...Number An integer Example The following example initially creates a new Date object setting the time and date to 8 00 a m on May 15 2004 and uses Date setUTCMinutes to change the time to 8 30 a m var...

Страница 354: ...trace today_date getUTCMonth output 4 today_date setUTCMonth 5 trace today_date getUTCMonth output 5 See also getUTCDay Date getUTCDay method getDay Date getDay method setUTCSeconds Date setUTCSeconds...

Страница 355: ...tem on which Flash Player is running Availability ActionScript 1 0 Flash Lite 2 0 Parameters year Number A number that represents the year If year is an integer between 0 and 99 setYear sets the year...

Страница 356: ...mber date Number hour Number minute Number second Number millisecond Number Number Returns the number of milliseconds between midnight on January 1 1970 universal time and the time specified in the pa...

Страница 357: ...valueOf Date valueOf method public valueOf Number Returns the number of milliseconds since midnight January 1 1970 universal time for this Date Availability ActionScript 1 0 Flash Lite 2 0 Returns Num...

Страница 358: ...ototype property __resolve Object __resolve property Signature Description Error message String Creates a new Error object Modifiers Signature Description toString String Returns the string Error by d...

Страница 359: ...t are not identical function compareStrings str1_str String str2_str String Void if str1_str str2_str throw new Error Strings do not match try compareStrings Dog dog output Strings do not match catch...

Страница 360: ...ou test this ActionScript without any modifications to the numbers you divide you see an error displayed in the Output panel because you are trying to divide by 0 See also throw statement try catch fi...

Страница 361: ...ng DivideByZeroError var message String Unable to divide by zero See also throw statement try catch finally statement toString Error toString method public toString String Returns the string Error by...

Страница 362: ...sh Lite 2 0 Example The following example creates a listener that is called when a key is pressed It uses the Key getCode method to get the key code for the key that was pressed var myListener new Obj...

Страница 363: ...SOFT4 soft key static SOFT5 String The key code value for the SOFT5 soft key static SOFT6 String The key code value for the SOFT6 soft key static SOFT7 String The key code value for the SOFT7 soft ke...

Страница 364: ...unction var keyCode Key getCode switch keyCode case ExtendedKey SOFT1 Handle left soft key break case ExtendedKey SOFT2 Handle right soft key break Key addListener myListener SOFT10 ExtendedKey SOFT10...

Страница 365: ...the SOFT3 soft key Availability ActionScript 2 0 Flash Lite 2 0 SOFT4 ExtendedKey SOFT4 property public static SOFT4 String The key code value for the SOFT4 soft key Availability ActionScript 2 0 Flas...

Страница 366: ...soft key Availability ActionScript 2 0 Flash Lite 2 0 Function Object Function public dynamic class Function extends Object Both user defined and built in functions in ActionScript are represented by...

Страница 367: ...tion specifies as the return value Availability ActionScript 1 0 Flash Lite 2 0 Parameters thisObject Object The object to which myFunction is applied argArray Array optional An array whose elements a...

Страница 368: ...y null secondArray outputs a b c The following example shows how apply passes an array of parameters and specifies the value of this define a function function theFunction trace this myObj this myObj...

Страница 369: ...t as shown in the following example myObject myMethod 1 2 3 In some situations you might want thisObject to point somewhere else for example if a function must be invoked as a method of an object but...

Страница 370: ...obj true See also apply Function apply method Key Object Key public class Key extends Object The Key class is a top level class whose methods and properties you can use without a constructor Use the m...

Страница 371: ...ey code value for the Insert key 45 static LEFT Number The key code value for the Left Arrow key 37 static _listeners Array read only A list of references to all listener objects registered with the K...

Страница 372: ...iers Signature Description static addListener listener Object Void Registers an object to receive onKeyDown and onKeyUp notification static getAscii Number Returns the ASCII code of the last key press...

Страница 373: ...event listener removeListener Key removeListener method BACKSPACE Key BACKSPACE property public static BACKSPACE Number The key code value for the Backspace key 8 Availability ActionScript 1 0 Flash L...

Страница 374: ...cript 1 0 Flash Lite 2 0 Example The following example lets you draw lines with the mouse pointer using the Drawing API and listener objects Press the Backspace or Delete key to remove the lines that...

Страница 375: ...ple moves a movie clip called car_mc a constant distance 10 when you press the arrow keys A sound plays when you press the Spacebar Give a sound in the library a linkage identifier of horn_id for this...

Страница 376: ...istance 10 when you press the arrow keys The car_mc instance stops when you press Enter and delete the onEnterFrame event var DISTANCE Number 5 var keyListener Object new Object keyListener onKeyDown...

Страница 377: ...two decimal places var timer Number Math round getTimer 10 100 trace you pressed the Esc key getTimer ms timer s Key addListener keyListener When using this example make sure that you select Control...

Страница 378: ...i differentiates between uppercase and lowercase letters and Key getCode does not var keyListener Object new Object keyListener onKeyDown function trace For the last key typed trace tThe Key code is K...

Страница 379: ...de ENTER key else trace Virtual key code Key getCode Key addListener keyListener When using this example make sure that you select Control Disable Keyboard Shortcuts in the test environment The follow...

Страница 380: ...movie clip that has a linkage ID car_id and add the following ActionScript to Frame 1 of the Timeline this attachMovie car_id car_mc this getNextHighestDepth _x 0 _y 0 car_mc onPress function this sta...

Страница 381: ...Key addListener keyListener isDown Key isDown method public static isDown code Number Boolean Returns true if the key specified in code is pressed false otherwise Availability ActionScript 1 0 Flash L...

Страница 382: ...ou press the Spacebar Give a sound in the library a linkage identifier of horn_id for this example var DISTANCE Number 10 var horn_sound Sound new Sound horn_sound attachSound horn_id var keyListener_...

Страница 383: ...n function trace You pressed a key Key addListener myListener trace Key _listeners length Output 1 onKeyDown Key onKeyDown event listener onKeyDown function Notified when a key is pressed To use onKey...

Страница 384: ...Ascii tKey chr Key getAscii Key addListener keyListener Listeners enable different pieces of code to cooperate because multiple listeners can receive notification about a single event Availability Act...

Страница 385: ..._rotation 5 else if Key isDown Key PGUP car_mc _rotation 5 Key addListener keyListener removeListener Key removeListener method public static removeListener listener Object Boolean Removes an object...

Страница 386: ...erty public static RIGHT Number The key code value for the Right Arrow key 39 Availability ActionScript 1 0 Flash Lite 2 0 Example The following example moves a movie clip called car_mc a constant dis...

Страница 387: ...ipt 1 0 Flash Lite 2 0 Example The following example scales car_mc when you press Shift var keyListener Object new Object keyListener onKeyDown function if Key isDown Key SHIFT car_mc _xscale 2 car_mc...

Страница 388: ...horn_sound start break case Key LEFT car_mc _x DISTANCE break case Key UP car_mc _y DISTANCE break case Key RIGHT car_mc _x DISTANCE break case Key DOWN car_mc _y DISTANCE break Key addListener keyLis...

Страница 389: ...a constant distance 10 when you press the arrow keys A sound plays when you press the Spacebar Give a sound in the library a linkage identifier of horn_id for this example var DISTANCE Number 10 var h...

Страница 390: ...send specific variables rather than all the variables which can make your application more efficient You can use the LoadVars onLoad handler to ensure that your application runs when data is loaded a...

Страница 391: ...peration has completed undefined by default constructor Object constructor property __proto__ Object __proto__ property prototype Object prototype property __resolve Object __resolve property Event De...

Страница 392: ...adVars sendAndLoad load url String Boolean Downloads variables from the specified URL parses the variable data and places the resulting variables into my_lv send url String target String method String...

Страница 393: ...ipt 1 0 Flash Lite 2 0 Parameters header Object A string or array of strings that represents an HTTP request header name headerValue String A string that represents the value associated with header Ex...

Страница 394: ...ars decode method public decode queryString String Void Converts the variable string to properties of the specified LoadVars object This method is used internally by the LoadVars onData event handler...

Страница 395: ...r refers to a valid text file using HTTP If you attempt to use this example to load a local file that resides on your hard disk this example will not work properly because in Test Movie mode Flash Pla...

Страница 396: ...ad a text file When you test the file two things are displayed in the Output panel whether the file loads successfully and how much data loads into the SWF file You must replace the URL parameter of t...

Страница 397: ...rlencoded This is the same format used by loadVariables In SWF files running in a version of the player earlier than Flash Player 7 url must be in the same superdomain as the SWF file that is issuing...

Страница 398: ...lication from a server side PHP script and then loads the data in passvars php var my_lv LoadVars new LoadVars my_lv onLoad function success Boolean if success trace this toString else trace Error loa...

Страница 399: ...ActionScript 1 0 Flash Lite 2 0 Example The following example loads a text file and displays information in the Output panel when the operation completes var my_lv LoadVars new LoadVars my_lv onLoad...

Страница 400: ...es LoadVars onLoad You can override this default implementation by assigning a custom function to LoadVars onData but LoadVars onLoad is not called unless you call it in your implementation of LoadVar...

Страница 401: ...nce called submit_button to the Stage When the user clicks the Login button instance in the following example two LoadVars objects are created send_lv and result_lv The send_lv object copies the name...

Страница 402: ...pe sent in the HTTP request headers is the value of my_lv contentType or the default application x www form urlencoded The POST method is used unless GET is specified You must specify the target param...

Страница 403: ...ifies the parent of the current frame _top specifies the top level frame in the current window method String optional A string the GET or POST method of the HTTP protocol The default value is POST Ret...

Страница 404: ...t store someDomain com because both files are in the same superdomain of someDomain com In SWF files of any version running in Flash Player 7 or later url must be in exactly the same domain For exampl...

Страница 405: ...an if success result_ta text result_lv welcomeMessage else result_ta text Error connecting to server var send_lv LoadVars new LoadVars send_lv name name_ti text send_lv sendAndLoad http www flash mx c...

Страница 406: ...ation Interchange File Format XLIFF There are three ways to display the language specific strings contained in the XLIFF files automatically at runtime Flash Player replaces string IDs with strings fr...

Страница 407: ...e static initialize Void Determine the language to use and begin xml loading static loadLanguageXML xmlLanguageCode String customXmlCompleteCallback Function Void Load the specified language xml file...

Страница 408: ...public static addXMLPath langCode String path String Void Adds the languageCode and languagePath pair into the internal array for later use This is primarily used by Flash when the strings replacemen...

Страница 409: ...ile Availability ActionScript 2 0 Flash Lite 2 0 Parameters xmlLanguageCode String customXmlCompleteCallback Function loadString Locale loadString method public static loadString id String String Retu...

Страница 410: ...ethods of the Math class are static and must be called using the syntax Math method parameter or Math constant In ActionScript constants are defined with the maximum precision of double precision IEEE...

Страница 411: ...931471805599453 static LOG10E Number A mathematical constant for the base 10 logarithm of the constant e Math E expressed as log10e with an approximate value of 0 4342944819032518 static LOG2E Number...

Страница 412: ...of the circle static ceil x Number Number Returns the ceiling of the specified number or expression static cos x Number Number Computes and returns the cosine of the specified angle in radians static...

Страница 413: ...ue of the x parameter called num in this example var num Number 12 var numAbsolute Number Math abs num trace num output 12 trace numAbsolute output 12 static sin x Number Number Computes and returns t...

Страница 414: ...eral values trace Math acos 1 output 3 14159265358979 trace Math acos 0 output 1 5707963267949 trace Math acos 1 output 0 See also asin Math asin method atan Math atan method atan2 Math atan2 method c...

Страница 415: ...nd positive pi divided by 2 Availability ActionScript 1 0 Flash Lite 2 0 In Flash Player 4 the methods and properties of the Math class are emulated using approximations and might not be as accurate a...

Страница 416: ...ns Number A number Example The following example returns the angle in radians of the point specified by the coordinates 0 10 such that x 0 and y 10 Note that the first parameter to atan2 is always the...

Страница 417: ...using approximations and might not be as accurate as the non emulated math functions that Flash Player 5 supports Parameters x Number A number that represents an angle measured in radians Returns Numb...

Страница 418: ...er a one year period var principal Number 100 var simpleInterest Number 100 var continuouslyCompoundedInterest Number 100 Math E principal trace Beginning principal principal trace Simple interest aft...

Страница 419: ...parameter x The floor is the closest integer that is less than or equal to the specified number or expression Availability ActionScript 1 0 Flash Lite 2 0 In Flash Player 4 the methods and properties...

Страница 420: ...nt for the natural logarithm of 2 expressed as loge2 with an approximate value of 0 6931471805599453 Availability ActionScript 1 0 Flash Lite 2 0 In Flash Player 4 the methods and properties of the Ma...

Страница 421: ...tions and might not be as accurate as the non emulated math functions that Flash Player 5 supports Example This example shows how to obtain the base 10 logarithm of a number trace Math log 1000 Math L...

Страница 422: ...displays Thu Dec 30 00 00 00 GMT 0700 2004 which is the larger of the evaluated expressions var date1 Date new Date 2004 11 25 var date2 Date new Date 2004 11 30 var maxDate Number Math max date1 getT...

Страница 423: ...are emulated using approximations and might not be as accurate as the non emulated math functions that Flash Player 5 supports Example The following example draws a circle using the mathematical cons...

Страница 424: ...e the length of a line this createEmptyMovieClip canvas_mc this getNextHighestDepth var mouseListener Object new Object mouseListener onMouseDown function this origX _xmouse this origY _ymouse mouseLi...

Страница 425: ...nclusively function randRange min Number max Number Number var randomNum Number Math floor Math random max min 1 min return randomNum for var i 0 i 100 i var n Number randRange 4 11 trace n round Math...

Страница 426: ...public static sin x Number Number Computes and returns the sine of the specified angle in radians To calculate a radian see the description of the Math class entry Availability ActionScript 1 0 Flash...

Страница 427: ...th tan Math PI 8 r x r y x r y mc curveTo Math tan Math PI 8 r x r y Math sin Math PI 4 r x Math sin Math PI 4 r y mc curveTo r x Math tan Math PI 8 r y r x y See also acos Math acos method asin Math...

Страница 428: ...lineTo this newX this newY var hypLen Number Math sqrt Math pow line_mc _width 2 Math pow line_mc _height 2 line_mc createTextField length nextDepth _txt canvas_mc getNextHighestDepth this origX this...

Страница 429: ...s the value of Math SQRT2 trace Math SQRT2 Output 1 4142135623731 tan Math tan method public static tan x Number Number Computes and returns the tangent of the specified angle To calculate a radian us...

Страница 430: ...PI 4 r x Math sin Math PI 4 r y mc curveTo Math tan Math PI 8 r x r y x r y mc curveTo Math tan Math PI 8 r x r y Math sin Math PI 4 r x Math sin Math PI 4 r y mc curveTo r x Math tan Math PI 8 r y r...

Страница 431: ...mouse button is released Modifiers Signature Description static addListener listener Object Void Registers an object to receive notifications of the onMouseDown onMouseMove and onMouseUp listeners sta...

Страница 432: ...rs Note This method is supported in Flash Lite only if System capabilities hasMouse is true or System capabilities hasStylus is true Availability ActionScript 1 0 Flash Lite 2 0 Parameters listener Ob...

Страница 433: ...Mouse onMouseDown event listener onMouseDown function Notified when the mouse button is pressed To use the onMouseDown listener you must create a listener object You can then define a function for onM...

Страница 434: ...is orig_y _ymouse this target_mc canvas_mc createEmptyMovieClip canvas_mc getNextHighestDepth mouseListener onMouseMove function if this isDrawing this target_mc clear this target_mc lineStyle 1 0xFF0...

Страница 435: ...ut a single event Note This event listener is supported in Flash Lite only if System capabilities hasMouse is true Availability ActionScript 1 0 Flash Lite 2 0 Example The following example uses the m...

Страница 436: ...stener See also addListener Mouse addListener method onMouseUp Mouse onMouseUp event listener onMouseUp function Notified when the mouse button is released To use the onMouseUp listener you must creat...

Страница 437: ...terEvent mouseListener onMouseUp function this isDrawing false Mouse addListener mouseListener See also addListener Mouse addListener method removeListener Mouse removeListener method public static re...

Страница 438: ...start drawing startDrawing_button enabled false this createEmptyMovieClip canvas_mc this getNextHighestDepth var mouseListener Object new Object mouseListener onMouseDown function this isDrawing true...

Страница 439: ...e new movie clip instances The attachMovie method allows you to create a new movie clip instance based on a movie clip symbol that exists in the library The createEmptyMovieClip method allows you to c...

Страница 440: ...ifies whether a movie clip has a yellow rectangle around it when it has input focus _framesloaded Number read only The number of frames that are loaded from a streaming SWF file _height Number The hei...

Страница 441: ...fied in the MovieClip parameter trackAsMenu Boolean A Boolean value that indicates whether other buttons or movie clips can receive a release event from a mouse or stylus _url String read only Retriev...

Страница 442: ...object onDragOver function Invoked when the pointer is dragged outside and then over the movie clip onEnterFrame function Invoked repeatedly at the frame rate of the SWF file onKeyDown function Invoke...

Страница 443: ...rea onRollOut function Invoked when the pointer moves outside a movie clip area onRollOver function Invoked when the pointer moves over a movie clip area onSetFocus function oldFocus Object Invoked wh...

Страница 444: ...a child of an existing movie clip createTextField instanceName String depth Number x Number y Number width Number height Number TextField Creates a new empty text field as a child of the movie clip o...

Страница 445: ...ts on the same level and layer in the current movie clip getSWFVersion Number Returns an integer that indicates the Flash Player version for the movie clip was published getURL url String window Strin...

Страница 446: ...url String method String Void Reads data from an external file and sets the values for variables in the movie clip localToGlobal pt Object Void Converts the pt object from the movie clip s local coord...

Страница 447: ...t Number top Number right Number bottom Number Void Lets the user drag the specified movie clip stop Void Stops the movie clip currently playing stopDrag Void Ends a MovieClip startDrag method swapDep...

Страница 448: ...erty attachMovie MovieClip attachMovie method public attachMovie id String name String depth Number initObject Object MovieClip Takes a symbol from the library and attaches it to the movie clip Use Mo...

Страница 449: ...ovieClip method unloadMovie MovieClip unloadMovie method removeMovieClip function beginFill MovieClip beginFill method public beginFill rgb Number alpha Number Void Indicates the beginning of a new dr...

Страница 450: ...od beginGradientFill MovieClip beginGradientFill method public beginGradientFill fillType String colors Array alphas Array ratios Array matrix Object Void Indicates the beginning of a new drawing path...

Страница 451: ...ercent matrix Object A transformation matrix that is an object with either of the following two sets of properties a b c d e f g h i which can be used to describe a 3 x 3 matrix of the following form...

Страница 452: ...is the height of the gradient and r is the rotation in radians of the gradient The following example uses the beginGradientFill method with a matrix parameter of this type this createEmptyMovieClip g...

Страница 453: ...lip lineStyle Shapes and lines that are manually drawn during authoring time with the Flash drawing tools are unaffected Availability ActionScript 1 0 Flash Lite 2 0 Example The following example draw...

Страница 454: ...r for the new movie clip The registration point for a newly created empty movie clip is the upper left corner This method fails if any of the parameters are missing You can extend the methods and even...

Страница 455: ...dy occupied or MovieClip getNextHighestDepth to determine the highest unoccupied depth The text field is positioned at x y with dimensions width by height The x and y parameters are relative to the co...

Страница 456: ...the new text field y Number An integer that specifies the ycoordinate of the new text field width Number A positive integer that specifies the width of the new text field height Number A positive int...

Страница 457: ...the playhead of the actionClip_mc movie clip to advance five frames ahead of its current location actionClip_mc gotoAndStop actionClip_mc _currentframe 5 curveTo MovieClip curveTo method public curveT...

Страница 458: ...anchorY Number An integer that specifies the vertical position of the next anchor point relative to the registration point of the parent movie clip Example The following example draws a nearly circula...

Страница 459: ...in Math PI 4 r x Math sin Math PI 4 r y mc curveTo Math tan Math PI 8 r x r y x r y mc curveTo Math tan Math PI 8 r x r y Math sin Math PI 4 r x Math sin Math PI 4 r y mc curveTo r x Math tan Math PI...

Страница 460: ...s hasStylus is true Availability ActionScript 1 0 Flash Lite 2 0 Example The following example evaluates the _droptarget property of the garbage_mc movie clip instance and uses eval to convert it from...

Страница 461: ...ecessary for the MovieClip class version because the target of the method is the movie clip instance on which the method is invoked Moreover the global version of duplicateMovieClip supports neither t...

Страница 462: ...0 mc beginFill 0x333333 mc lineTo w 0 mc lineTo w h mc lineTo 0 h mc lineTo 0 0 mc endFill return mc See also loadMovie MovieClip loadMovie method removeMovieClip MovieClip removeMovieClip method dupl...

Страница 463: ...the fill that was specified in the previous call to beginFill or beginGradientFill If the current drawing position does not equal the previous position specified in a moveTo method and a fill is defin...

Страница 464: ...a movie clip has a yellow rectangle around it when it has input focus This property can override the global _focusrect property The default value of the _focusrect property of a movie clip instance is...

Страница 465: ...sing Enter or the Spacebar when _focusrect is disabled You can also test your SWF file in the test environment Select Control Disable Keyboard Shortcuts in the test environment This allows you to view...

Страница 466: ...Frame 3 Then add the following code to Frame 3 stop See also MovieClipLoader getBounds MovieClip getBounds method public getBounds bounds Object Object Returns properties that are the minimum and max...

Страница 467: ...n bounds_obj trace i bounds_obj i The following information appears in the Output panel yMax 110 yMin 10 xMax 110 xMin 10 See also globalToLocal MovieClip globalToLocal method localToGlobal MovieClip...

Страница 468: ...o Frame 3 stop See also getBytesTotal MovieClip getBytesTotal method getBytesTotal MovieClip getBytesTotal method public getBytesTotal Number Returns the size in bytes of the movie clip For movie clip...

Страница 469: ...getDepth method public getDepth Number Returns the depth of the movie clip instance Each movie clip button and text field has a unique depth associated with it that determines how the object appears i...

Страница 470: ...th parameter you want to pass to any of these methods already contains a movie clip You can extend the methods and event handlers of the MovieClip class by creating a subclass Availability ActionScrip...

Страница 471: ...he movie clip in front of all other objects on the same level and layer in the current movie clip The value returned is 0 or higher that is negative numbers are not returned You can extend the methods...

Страница 472: ...50 200 200 mc label text mc getDepth See also getDepth MovieClip getDepth method getInstanceAtDepth MovieClip getInstanceAtDepth method swapDepths MovieClip swapDepths method attachMovie MovieClip att...

Страница 473: ...ng window String method String Void Loads a document from the specified URL into the specified window The getURL method can also be used to pass variables to another application defined at the URL by...

Страница 474: ...eader and is used for long strings of variables Example The following ActionScript creates a new movie clip instance and opens the Macromedia website in a new browser window this createEmptyMovieClip...

Страница 475: ...m from values relative to the Stage global coordinates to values relative to a specific movie clip local coordinates For example if you create a movie clip that is positioned at the point _x 100 _y 10...

Страница 476: ...rds_txt multiline true coords_txt autoSize true this createEmptyMovieClip target_mc this getNextHighestDepth target_mc _x 100 target_mc _y 100 target_mc loadMovie photo1 jpg var mouseListener Object n...

Страница 477: ...sent Example The following example uses the _framesloaded property to start a SWF file when all of the frames are loaded If all of the frames aren t loaded the _xscale property of the loader movie cl...

Страница 478: ...WF file when all the frames are loaded If all the frames aren t loaded the _xscale property of the loader movie clip instance is increased proportionally to create a progress bar Enter the following A...

Страница 479: ...erty public _highquality Number Deprecated since Flash Player 7 This property was deprecated in favor of MovieClip _quality Specifies the level of anti aliasing applied to the current SWF file Specify...

Страница 480: ...clip Place these two movie clips on the Stage and test the document When you click circle_mc the square_mc movie clip traces that it was clicked square_mc hitArea circle_mc square_mc onRelease functi...

Страница 481: ...arameters target Object The target path of the hit area that may intersect or overlap with the movie clip The target parameter usually represents a button or text entry field Availability ActionScript...

Страница 482: ...pecified or if the parameter is undefined a line is not drawn If a value of less than 0 is passed Flash uses 0 The value 0 indicates hairline thickness the maximum thickness is 255 If a value greater...

Страница 483: ...g position defaults to 0 0 If any of the parameters are missing this method fails and the current drawing position is not changed You can extend the methods and event handlers of the MovieClip class b...

Страница 484: ...e MovieClip _lockroot property to true in the loader movie as shown in the following code example If you don t set _lockroot to true in the loader movie any references to _root in the loaded movie poi...

Страница 485: ...prior to the call to loadMovie var mc MovieClip this createEmptyMovieClip mc this getNextHighestDepth mc onRelease function Void trace this image _url http www w3 org Icons w3c_main png var image Movi...

Страница 486: ...ources that are also at www someDomain com To load data from a different domain you can place a cross domain policy file on the server hosting the data source that is being accessed To load variables...

Страница 487: ...i in target_mc trace i target_mc i trace clearInterval param_interval var param_interval setInterval checkParamsLoaded 100 The params txt file includes the following text var1 hello var2 goodbye done...

Страница 488: ...you send as the parameter It changes them from values relative to a specific movie clip local coordinates to values relative to the Stage global coordinates For example if you create a movie clip that...

Страница 489: ...ion this startDrag my_mc onRelease function this stopDrag See also globalToLocal MovieClip globalToLocal method _lockroot MovieClip _lockroot property public _lockroot Boolean A Boolean value that spe...

Страница 490: ...myMovieClip _lockroot true Availability ActionScript 1 0 Flash Lite 2 0 Example In the following example lockroot fla has _lockroot applied to the main SWF file If the SWF file is loaded into another...

Страница 491: ...wing information from current SWF file dumpRoot type Function version WIN 7 0 19 0 nolockroot_mc _level0 nolockroot_mc lockroot_mc _level0 lockroot_mc from nolockroot swf myVar 1 i lockroot_mc dumpRoo...

Страница 492: ...eClipLoader onLoadInit event listener moveTo MovieClip moveTo method public moveTo x Number y Number Void Moves the current drawing position to x y If any of the parameters are missing this method fai...

Страница 493: ...mc endFill See also createEmptyMovieClip MovieClip createEmptyMovieClip method lineStyle MovieClip lineStyle method lineTo MovieClip lineTo method _name MovieClip _name property public _name String Th...

Страница 494: ...r is linked to a symbol in the library This handler can be used only with movie clips for which you have a symbol in the library that is associated with a class If you want an event handler to be invo...

Страница 495: ...s function output trace Will never be called dynamic_mc onData output dynamic_mc loadMovie replacement swf The following function is invoked for any movie clip that receives data whether it is in the...

Страница 496: ...e MovieClip class or is linked to a symbol in the library Note This event handler is supported in Flash Lite only if System capabilities hasMouse is true or System capabilities hasStylus is true Avail...

Страница 497: ...utes 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 The onKeyDown event handl...

Страница 498: ...parameters 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 functi...

Страница 499: ...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 Avai...

Страница 500: ...Lite 2 0 Example This example shows you how to use the onLoad event handler in an ActionScript 2 0 class definition that extends the MovieClip class First create a class file named Oval as and define...

Страница 501: ...function for the onMouseDown method that sends a trace action to the Output panel my_mc onMouseDown function trace onMouseDown called onMouseMove MovieClip onMouseMove handler onMouseMove function Inv...

Страница 502: ...p function trace onMouseUp called onPress MovieClip onPress handler onPress function Invoked when the user clicks the mouse while the pointer is over a movie clip You must define a function that execu...

Страница 503: ...symbol in the library Note This event handler is supported in Flash Lite only if System capabilities hasMouse is true or System capabilities hasStylus is true Availability ActionScript 1 0 Flash Lite...

Страница 504: ...onRollOver method that sends a trace action to the Output panel my_mc onRollOver function trace onRollOver called onSetFocus MovieClip onSetFocus handler onSetFocus function oldFocus Object Invoked w...

Страница 505: ...processes the actions associated with the onUnload event handler before attaching any actions to the affected frame You must define a function that executes when the event handler is invoked You can d...

Страница 506: ...e is this _parent When you click the movie clip the following information appears in the Output panel You clicked the movie clip _level0 my_mc The parent of my_mc is _level0 See also _parent Button _p...

Страница 507: ...ovieClip class by creating a subclass Availability ActionScript 1 0 Flash Lite 2 0 Example In the following example two movie clip buttons control the Timeline The prev_mc button moves the playhead to...

Страница 508: ...uality Availability ActionScript 1 0 Flash Lite 2 0 Example This example sets the rendering quality of a movie clip named my_mc to LOW my_mc _quality LOW See also _quality property Value Description G...

Страница 509: ...Manager class to assign depth values you may find that removeMovieClip fails silently When any V2 component is used the DepthManager class automatically reserves the highest 1048575 and lowest 16383 a...

Страница 510: ...ase function this removeMovieClip bugNum See also duplicateMovieClip function createEmptyMovieClip MovieClip createEmptyMovieClip method duplicateMovieClip MovieClip duplicateMovieClip method attachMo...

Страница 511: ...hich is possible by using mask layers If you have device fonts in a masked movie clip they are drawn but not masked You can t set a movie clip to be its own mask for example my_mc setMask my_mc If you...

Страница 512: ...ipt 1 0 Flash Lite 2 0 See also _soundbuftime property startDrag MovieClip startDrag method public startDrag lockCenter Boolean left Number top Number right Number bottom Number Void Lets the user dra...

Страница 513: ...p s parent that specify a constraint rectangle for the movie clip Example The following example creates a draggable movie clip instance called mc_1 this createEmptyMovieClip mc_1 1 with mc_1 lineStyle...

Страница 514: ...ip is draggable at a time You can extend the methods and event handlers of the MovieClip class by creating a subclass Note This method is supported in Flash Lite only if System capabilities hasMouse i...

Страница 515: ...e MovieClip class by creating a subclass Availability ActionScript 1 0 Flash Lite 2 0 Parameters target Object This parameter can take one of two forms A number that specifies the depth level where th...

Страница 516: ...ms inside the list box should be excluded from tab ordering To do this the tabChildren property of the list box should be set to false The tabChildren property has no effect if the tabIndex property i...

Страница 517: ...abEnabled is false Availability ActionScript 1 0 Flash Lite 2 0 Example The following example does not include myMC2_mc in the automatic tab ordering myMC1_mc onRelease function myMC2_mc onRelease fun...

Страница 518: ...tab order for three movie clip instances myMC1_mc onRelease function myMC2_mc onRelease function myMC3_mc onRelease function myMC1_mc tabIndex 2 myMC2_mc tabIndex 1 myMC3_mc tabIndex 3 See also tabIn...

Страница 519: ...nt if parent_mc _currentframe 1 parent_mc prevFrame else parent_mc gotoAndStop parent_mc _totalframes next_mc onRelease function var parent_mc MovieClip this _parent if parent_mc _currentframe parent_...

Страница 520: ...h instance receives the event myMC1_mc trackAsMenu true myMC2_mc trackAsMenu true myMC3_mc trackAsMenu false myMC1_mc onRelease clickMC myMC2_mc onRelease clickMC myMC3_mc onRelease clickMC function c...

Страница 521: ...neTo 0 60 lineTo 0 0 endFill box onRelease function box unloadMovie See also removeMovieClip MovieClip removeMovieClip method attachMovie MovieClip attachMovie method loadMovie MovieClip loadMovie met...

Страница 522: ...ndicates whether the movie clip is visible Movie clips that are not visible _visible property set to false are disabled For example a button in a movie clip with _visible set to false cannot be clicke...

Страница 523: ...MovieClip _x property public _x Number An integer that sets the x coordinate of a movie clip relative to the local coordinates of the parent movie clip If a movie clip is in the main Timeline its coo...

Страница 524: ...e b my_mc onMouseMove function mouse_txt htmlText textformat tabStops 50 100 mouse_txt htmlText row1_str mouse_txt htmlText b _level0 b t _xmouse t _ymouse mouse_txt htmlText b my_mc b t this _xmouse...

Страница 525: ...his createEmptyMovieClip box_mc 1 box_mc _x 100 box_mc _y 100 with box_mc lineStyle 1 0xCCCCCC beginFill 0xEEEEEE moveTo 0 0 lineTo 80 0 lineTo 80 60 lineTo 0 60 lineTo 0 0 endFill box_mc onRollOver f...

Страница 526: ...MovieClip _xscale property _yscale MovieClip _yscale property _ymouse MovieClip _ymouse property public _ymouse Number read only Indicates the y coordinate of the mouse position Note This property is...

Страница 527: ...re at 100 Availability ActionScript 1 0 Flash Lite 2 0 Example The following example creates a movie clip at runtime called box_mc The Drawing API is used to draw a box in this instance and when the m...

Страница 528: ...ake place in the order listed When the first bytes of the downloaded file are written to disk the MovieClipLoader onLoadStart listener is invoked If you implemented the MovieClipLoader onLoadProgress...

Страница 529: ...vieClipLoader loadClip has failed to load onLoadInit function target_mc Invoked when the actions on the first frame of the loaded clip are executed onLoadProgress function target_mc loadedBytes totalB...

Страница 530: ...lip for compressed movies the getProgress method reflects the number of compressed bytes loadClip url String target Object Boolean Loads a SWF or JPEG file into a movie clip in Flash Player while the...

Страница 531: ...MovieClip target_mc _x Stage width 2 target_mc _width 2 target_mc _y Stage height 2 target_mc _width 2 var w Number target_mc _width var h Number target_mc _height target_mc lineStyle 4 0x000000 targe...

Страница 532: ...than using this method one will usually create a listener object and listen for the onLoadProgress event Another important note about this method is that the first synchronous call to getProgress can...

Страница 533: ...ner object You activate the listener by using MovieClipLoader addListener listenerObject to register it with the MovieClipLoader class The MovieClipLoader onLoadStart handler is invoked when loading b...

Страница 534: ...filer provides Availability ActionScript 1 0 Flash Lite 2 0 Parameters url String The absolute or relative URL of the SWF or JPEG file to be loaded A relative path must be relative to the SWF file at...

Страница 535: ...ners to respond to events while a SWF JPEG GIF or PNG file is downloading Availability ActionScript 1 0 Flash Lite 2 0 Example See MovieClipLoader loadClip See also addListener MovieClipLoader addList...

Страница 536: ...t and onLoadComplete events are used to determine how long it takes to load the image The information appears in a dynamically created text field called timer_txt this createEmptyMovieClip image_mc th...

Страница 537: ...is not found The string LoadNeverCompleted is returned if MovieClipLoader onLoadStart was called but MovieClipLoader onLoadComplete was not called for example if the download was interrupted because o...

Страница 538: ...e value for target_mc identifies the movie clip this call is being made for This parameter is useful if you are loading multiple files with the same set of listeners Parameterstarget_mc MovieClip opti...

Страница 539: ...er MovieClipLoader addListener method loadClip MovieClipLoader loadClip method onLoadStart MovieClipLoader onLoadStart event listener onLoadProgress MovieClipLoader onLoadProgress event listener onLoa...

Страница 540: ...Loader and an anonymous event listener It should periodically output the progress of a load and finally provide notification when the load is complete and the asset is available to ActionScript var co...

Страница 541: ...oads an image into a movie clip instance called image_mc The onLoadInit and onLoadComplete events are used to determine how long it takes to load the image This information appears in a text field cal...

Страница 542: ...A listener object that was added using MovieClipLoader addListener Returns Boolean Example The following example loads an image into a movie clip and enables the user to start and stop the loading pro...

Страница 543: ...rue stop_button enabled false image_mcl removeListener mclListener stop_button enabled false See also addListener MovieClipLoader addListener method unloadClip MovieClipLoader unloadClip method public...

Страница 544: ...Listener mclListener image_mcl loadClip http www helpexamples com flash images image1 jpg image_mc See also loadClip MovieClipLoader loadClip method onLoadError MovieClipLoader onLoadError event liste...

Страница 545: ...UE Number The largest representable number double precision IEEE 754 static MIN_VALUE Number The smallest representable number double precision IEEE 754 static NaN Number The IEEE 754 value representi...

Страница 546: ...69313486232e 308 MIN_VALUE Number MIN_VALUE property public static MIN_VALUE Number The smallest representable number double precision IEEE 754 This number is approximately 5e 324 Availability ActionS...

Страница 547: ...ITY Number NEGATIVE_INFINITY property public static NEGATIVE_INFINITY Number Specifies the IEEE 754 value representing negative infinity The value of this property is the same as that of the constant...

Страница 548: ...so toString Number toString method valueOf Number valueOf method POSITIVE_INFINITY Number POSITIVE_INFINITY property public static POSITIVE_INFINITY Number Specifies the IEEE 754 value representing po...

Страница 549: ...tion of the number 9 var myNumber Number new Number 9 trace myNumber toString 2 output 1001 trace myNumber toString 8 output 11 The following example results in a hexadecimal value var r Number new Nu...

Страница 550: ...onScript 2 0 or constructor function ActionScript 1 0 used to create the object static prototype Object A reference to the superclass of a class or function object __resolve Object A reference to a us...

Страница 551: ...etter property to a prototype object all object instances that inherit the prototype object inherit the getter setter property This makes it possible to add a getter setter property in one location th...

Страница 552: ...otherwise Example In the following example an object has two internal methods setQuantity and getQuantity A property bookcount can be used to invoke these methods when it is either set or retrieved A...

Страница 553: ...the properties to Book prototype so that the bookcount and bookname properties exist only in one place The effect however is the same as that of the code in the example that added bookcount and bookn...

Страница 554: ...name String return Catcher in the Rye The following code can then be placed in a FLA file and will function the same way as it does in the previous examples var myBook Book new Book myBook bookcount 5...

Страница 555: ...tes whether an object has a specified property defined This method returns true if the target object has a property that matches the string specified by the name parameter and false otherwise This met...

Страница 556: ...ject new Object myObj prop1 hello trace myObj isPropertyEnumerable prop1 Output true var myArray new Array trace myArray isPropertyEnumerable length Output false See also for in statement isPrototypeO...

Страница 557: ...ction ActionScript 1 0 used to create the object The __proto__ property is automatically assigned to all objects when they are created The ActionScript interpreter uses the __proto__ property to acces...

Страница 558: ...erty is shared by all instances of the class and is accessible only as a class property Instances of your custom class cannot directly access the prototype property but can access it through the __pro...

Страница 559: ...ctionScript class definition associated with the specified movie clip symbol or class identifier For movie clip symbols any existing instances of the movie clip remain unchanged but new instances of t...

Страница 560: ...ActionScript code refers to an undefined property or method of an object Flash Player determines whether the object s __resolve property is defined If __resolve is defined the function to which it re...

Страница 561: ...nction name return function this myFunction name test __resolve using undefined method names myObject someMethod output Method someMethod was called myObject someOtherMethod output Method someOtherMet...

Страница 562: ...ct var myObject Object new Object define a function for __resolve to call myObject myFunction function name trace Method name was called define the __resolve function myObject __resolve function name...

Страница 563: ...arguments create a new object method and assign it the reference this name f return the reference to the function return f test __resolve using undefined method names with parameters myObject someMet...

Страница 564: ...n t tell us whether the value is a string or number we will also use typeof to test whether toString works var myNumber Number 5 trace typeof myNumber output number trace myNumber toString output 5 tr...

Страница 565: ...false otherwise Availability ActionScript 1 0 Flash Lite 2 0 Parameters name String A string the name of the object property that should no longer be watched Returns Boolean A Boolean value true if t...

Страница 566: ...reate a new Date object set to February 1 2004 8 15 AM The toString method returns the current time in human readable form The valueOf method returns the primitive value in milliseconds var myDate Dat...

Страница 567: ...oint The Object watch method behaves similarly to the Object watch function in JavaScript 1 2 and later The primary difference is the userData parameter which is a Flash addition to Object watch that...

Страница 568: ...operty changes var speedWatcher Function function prop oldVal newVal speedLimit Check whether speed is above the limit if newVal speedLimit trace You are speeding else trace You are not speeding Retur...

Страница 569: ...tains methods that specify how SWF files in different domains can communicate with each other Availability ActionScript 1 0 Flash Lite 2 0 Property summary Properties inherited from class Object const...

Страница 570: ...owDomain www domain com store domain com Modifiers Signature Description static allowDomain domain1 String Void Lets SWF files and HTML files in the identified domains access objects and variables in...

Страница 571: ...when a child SWF finishes loading is to use MovieClipLoader onLoadComplete The opposite situation can also occur that is you might create a child SWF file that wants to allow its parent to script it b...

Страница 572: ...ver you might need to do so for example if you must permit access to HTTPS files published for Flash Player 7 or later from HTTP files published for Flash Player 6 A SWF file published for Flash Playe...

Страница 573: ...h Player 7 0 14 0 looked for policy files in only one location crossdomain xml on the server to which a data loading request was being made For an XMLSocket connection attempt Flash Player 7 0 14 0 lo...

Страница 574: ...nsmitting a policy file A server can also be set up to serve policy files over a separate port from standard connections in which case it can send a policy file as soon as a connection is established...

Страница 575: ...RL where the cross domain policy file to be loaded is located Selection Object Selection public class Selection extends Object The Selection class lets you set and control the text field in which the...

Страница 576: ...fiers Signature Description static addListener listener Object Void Registers an object to receive keyboard focus change notifications static getFocus String Returns a string specifying the target pat...

Страница 577: ...tener onSetFocus function oldFocus_txt newFocus_txt oldFocus_txt border false newFocus_txt border true Selection addListener focusListener When you test the SWF file try using Tab to move between the...

Страница 578: ...er Test the SWF file and use Tab to move between the instances on the Stage Make sure you have Control Disable Keyboard Shortcuts selected in the test environment See also onSetFocus Selection onSetFo...

Страница 579: ...txt 4 0 75 100 22 for var i in this if this i instanceof TextField this i border true this i type input this createTextField status_txt this getNextHighestDepth 200 10 300 100 status_txt html true sta...

Страница 580: ...several text field instances When you select a text field information displays in the Output panel When you click the remove_btn instance the listener is removed and information no longer displays in...

Страница 581: ...in a browser window If the user does not fill in one of the required text fields username_txt and password_txt the cursor automatically focuses in the text field thats missing data For example if the...

Страница 582: ...ts store a set of name value pairs to the device Note The name SharedObject is derived from the Flash SharedObject class The Flash version of this class allows multiple Flash SWF files to share their...

Страница 583: ...ts users store information about their favorite albums The information can be stored on the remote server but this causes problems if the application cannot connect to the service Also retrieving the...

Страница 584: ...turned from the call to the getLocal method in the same way a shared object is used in Flash The application can add modify or remove properties while the content is playing When the content is unload...

Страница 585: ...f attributes assigned to the data property of the object constructor Object constructor property __proto__ Object __proto__ property prototype Object prototype property __resolve Object __resolve prop...

Страница 586: ...data from the shared object and deletes the shared object from the disk flush minDiskSpace Number Object Writes shared object to a local persistent file static getLocal name String SharedObject Retur...

Страница 587: ...The following example sets data in the shared object and then empties all of the data from the shared object var my_so SharedObject SharedObject getLocal superfoo my_so data name Hector trace before m...

Страница 588: ...and the shared object contains the following information userName Ramona adminPrivileges true itemNumbers 101 346 483 Note Do not assign values directly to the data property of a shared object for ex...

Страница 589: ...ined when this script is first run if myText text undefined myText text changedListener new Object changedListener onChanged function changedField my_so data myTextSaved changedField text inputText te...

Страница 590: ...ble to shared objects To allow space for the shared object to expand when it is saved in the future which avoids return values of pending you can pass a value for minimumDiskSpace When the Flash Lite...

Страница 591: ...vailability ActionScript 1 0 Flash Lite 2 0 Parameters name String A string that represents the name of the object The name can include forward slashes for example work addresses is a valid name Space...

Страница 592: ...umeric value that specifies the total number of bytes the movie is allowed to store on the device This is also the size available to all content that is loaded dynamically through loadMovie Example Th...

Страница 593: ...erName currentUserName var soSize Number my_so getSize trace soSize onStatus SharedObject onStatus handler onStatus function infoObject Object Invoked every time an error warning or informational note...

Страница 594: ...Array new Array 101 346 483 var currentUserIsAdmin Boolean true var currentUserName String Ramona var my_so SharedObject SharedObject getLocal superfoo my_so data itemNumbers items_array my_so data a...

Страница 595: ...oveListener objectName String Removes any listeners that were added using the addListener method Availability ActionScript 2 0 Flash Lite 2 0 Parameters objectName String A string that represents the...

Страница 596: ...lliseconds a sound has been playing constructor Object constructor property __proto__ Object __proto__ property prototype Object prototype property __resolve Object __resolve property Event Descriptio...

Страница 597: ...the sound volume level as an integer from 0 to 100 where 0 is off and 100 is full volume loadSound url String isStreaming Boolean Void Loads an MP3 file into a Sound object setPan value Number Void D...

Страница 598: ...kage Properties dialog box Example The following example attaches the sound logoff_id to my_sound A sound in the library has the linkage identifier logoff_id var my_sound Sound new Sound my_sound atta...

Страница 599: ...loading progress When the music starts and completes loading information displays in the Output panel When the music starts and completes loading information writes to the log file Add the following A...

Страница 600: ...r 100 my_sound function updateProgressBar the_sound Sound Void var pos Number Math round the_sound position the_sound duration 100 pb bar_mc _xscale pos pb vBar_mc _x pb bar_mc _width pb pos_txt text...

Страница 601: ...my_sound Sound new Sound my_sound onLoad function success Boolean if success this start message_txt text Finished loading my_sound onSoundComplete function message_txt text Clearing interval clearInte...

Страница 602: ...ts the left and right channels equally The pan setting controls the left right balance of the current and future sounds in a SWF file This method is cumulative with setVolume or setTransform Note Flas...

Страница 603: ...pecific to a host device are not supported Availability ActionScript 1 0 Flash Lite 2 0 Returns Object An object with properties that contain the channel percentage values for the specified sound obje...

Страница 604: ...l knob_ll onPress pressKnob knob_ll onRelease releaseKnob knob_ll onReleaseOutside releaseKnob knob_lr top knob_lr _y knob_lr bottom knob_lr _y 100 knob_lr left knob_lr _x knob_lr right knob_lr _x kno...

Страница 605: ...ansform ll ll_num lr lr_num rl rl_num rr rr_num transform_mc transform_txt htmlText textformat tabStops 0 30 60 90 transform_mc transform_txt htmlText ll_num t lr_num t rl_num t rr_num transform_mc tr...

Страница 606: ...ob_mc _x knob_mc right knob_mc left 100 knob_mc top knob_mc _y knob_mc bottom knob_mc _y knob_mc _x my_sound getVolume with knob_mc lineStyle 0 0x000000 beginFill 0xCCCCCC moveTo 0 0 lineTo 4 0 lineTo...

Страница 607: ...specifically 2 3 and 2 4 The following table lists the standard ID3 2 0 tags and the type of content the tags represent you query them in the format my_sound id3 COMM my_sound id3 TIME and so on MP3...

Страница 608: ...TPE3 Conductor performer refinement TPE4 Interpreted remixed or otherwise modified by TPOS Part of a set TPUB Publisher TRCK Track number position in set TRDA Recording dates TRSN Internet radio stati...

Страница 609: ...onScript Sound class and respond to all methods and properties of this class Streaming sounds play while they are downloading Playback begins when sufficient data is received to start the decompressor...

Страница 610: ...mp3 to an instance of the DataGrid component Add a DataGrid with the instance name id3_dg to your document and add the following ActionScript to your FLA or AS file import mx controls gridclasses Data...

Страница 611: ...lse otherwise Example The following example creates a new Sound object and loads a sound Loading the sound is handled by the onLoad handler which allows you to start the song after it is successfully...

Страница 612: ...Sound mySoundID my_sound onSoundComplete function trace mySoundID completed my_sound start Usage 2 The following example uses a named function function callback1 trace mySoundID completed var my_sound...

Страница 613: ...nce for a sound The range of valid values is 100 to 100 where 100 uses only the left channel 100 uses only the right channel and 0 balances the sound evenly between the two channels Example For a samp...

Страница 614: ...ker 0 100 rr A percentage value that specifies how much of the right input to play in the right speaker 0 100 rl A percentage value that specifies how much of the left input to play in the right speak...

Страница 615: ...bjectMono object has the following parameters var mySoundTransformObjectMono Object new Object mySoundTransformObjectMono ll 50 mySoundTransformObjectMono lr 50 mySoundTransformObjectMono rr 50 mySoun...

Страница 616: ...al The movie clip instance on which the Sound object operates Example The following example creates a new Sound object called global_sound The second line calls setVolume and adjusts the volume on all...

Страница 617: ...cessfully loaded Then the sound uses the start method to start playing Create a new FLA file and add the following ActionScript to your FLA or ActionScript file For this example to work you must have...

Страница 618: ...your FLA or AS file var my_sound Sound new Sound my_sound loadSound song1 mp3 true stop_btn onRelease function trace sound stopped my_sound stop play_btn onRelease function trace sound started my_sou...

Страница 619: ...__proto__ property prototype Object prototype property __resolve Object __resolve property Event Description onResize function Invoked when Stage scaleMode is set to noScale and the SWF file is resiz...

Страница 620: ...his example creates a new listener object called stageListener It then uses stageListener to call onResize and define a function that will be called when onResize is triggered Finally the code adds th...

Страница 621: ...ew Object cbListener change function evt Object var align String evt target selectedItem Stage align align stageAlign_cb addEventListener change cbListener Stage scaleMode noScale Select different ali...

Страница 622: ...also align Stage align property scaleMode Stage scaleMode property width Stage width property onResize Stage onResize event listener onResize function Invoked when Stage scaleMode is set to noScale an...

Страница 623: ...Add the following ActionScript to Frame 1 of the Timeline this createTextField stageSize_txt this getNextHighestDepth 10 10 100 22 stageSize_txt autoSize true stageSize_txt border true var stageListe...

Страница 624: ...e application exactFit makes the entire Flash content visible in the specified area without trying to preserve the original aspect ratio Distortion can occur noScale makes the size of the Flash conten...

Страница 625: ...presents the width of the SWF file as set at author time in the Document Properties dialog box This means that the value of width will stay constant as you resize the player window Availability Action...

Страница 626: ...ctionScript interpreter automatically converts it to a temporary String object calls the method and then discards the temporary String object You can also use the String length property with a string...

Страница 627: ...ising the characters represented by the Unicode values in the parameters indexOf value String startIndex Number Number Searches the string and returns the position of the first occurrence of value fou...

Страница 628: ...ber end Number String Returns a string comprising the characters between the points specified by the start and end parameters toLowerCase String Returns a copy of the String object with all uppercase...

Страница 629: ...charCodeAt index Number Number Returns a 16 bit integer from 0 to 65535 that represents the character specified by index If index is not a number from 0 to string length 1 NaN is returned This method...

Страница 630: ...ings and combines them using String concat var stringA String Hello var stringB String World var combinedAB String stringA concat stringB trace combinedAB output Hello World fromCharCode String fromCh...

Страница 631: ...for startIndex Number optional An integer specifying the starting index of the search Returns Number The position of the first occurrence of the specified substring or 1 Example The following examples...

Страница 632: ...artIndex Number optional An integer specifying the starting point from which to search for value Returns Number The position of the last occurrence of the specified substring or 1 Example The followin...

Страница 633: ...ode checks the characters within a string and if the string contains the character true displays in the Output panel If it does not contain the character then false displays in the Output panel functi...

Страница 634: ...by the end parameter is not included in the extracted string If this parameter is omitted String length is used If end is a negative number the ending point is determined by counting back from the en...

Страница 635: ...ials Samples ActionScript See also substr String substr method substring String substring method split String split method public split delimiter String limit Number Array Splits a String object into...

Страница 636: ...f you use an empty string for the delimiter parameter each character in the string is placed as an element in the array var my_str String new String Joe var my_array Array my_str split for var i 0 i m...

Страница 637: ...ers in a string from the index specified in the start parameter through the number of characters specified in the length parameter The substr method does not change the string specified by my_str it r...

Страница 638: ...ising the characters between the points specified by the start and end parameters If the end parameter is not specified the end of the substring is the end of the string If the value of start equals t...

Страница 639: ...ples ActionScript Macintosh Macintosh HD Applications Macromedia Flash 8 Samples and Tutorials Samples ActionScript toLowerCase String toLowerCase method public toLowerCase String Returns a copy of th...

Страница 640: ...her the properties are strings Availability ActionScript 1 0 Flash Lite 2 0 Returns String The string Example The following example outputs an uppercase string that lists all of an object s properties...

Страница 641: ...toUpperCase trace lowerCase lowerCase output lowerCase lorem ipsum dolor trace upperCase upperCase output upperCase LOREM IPSUM DOLOR An example is also found in the Strings fla file in the ActionScr...

Страница 642: ...s with shared objects and the clipboard Additional properties and methods are in specific classes within the System package the capabilities class see System capabilities and the security class see Sy...

Страница 643: ...dary error message handler If an instance of the SharedObject class passes an information object with a level property of error but you did not define an onStatus function for that particular instance...

Страница 644: ...the traditional code page of the operating system running the player Text that you load as an external file using the loadVariables or getURL statements or the LoadVars class or XML class must be enc...

Страница 645: ...ulate it with ActionScript TextField instance names are displayed in the Movie Explorer and in the Insert Target Path dialog box in the Actions panel To create a text field dynamically you do not use...

Страница 646: ...oolean A Boolean value that specifies whether extra white space spaces line breaks and so on in an HTML text field should be removed when the field is rendered in a browser embedFonts Boolean A Boolea...

Страница 647: ...field in degrees from its original orientation scroll Number Defines the vertical position of text in a text field selectable Boolean A Boolean value that indicates whether the text field is selectabl...

Страница 648: ...lip _xmouse Number read only Returns the x coordinate of the mouse position relative to the text field _xscale Number Determines the horizontal scale of the text field as applied from the registration...

Страница 649: ...eceive TextField event notifications getDepth Number Returns the depth of a text field getNewTextFormat TextFormat Returns a TextFormat object containing a copy of the text field s text format object...

Страница 650: ...at is passed to the onScroller event handler The parameter is then used in a trace statement to send the instance name of the text field to the Output panel The parameter is then used in a trace metho...

Страница 651: ...ce textfield_txt _name changed var txtListener Object new Object txtListener onChanged function textfield_txt TextField trace textfield_txt _name changed and notified myListener my_txt addListener txt...

Страница 652: ...none The values of autoSize and TextField wordWrap determine whether a text field expands or contracts to the left side right side or bottom side The default value for each of these properties is fals...

Страница 653: ...ent settings for autoSize this createTextField left_txt 997 10 10 70 30 this createTextField center_txt 998 10 50 70 30 this createTextField right_txt 999 10 100 70 30 this createTextField true_txt 10...

Страница 654: ...the keyboard is pressed this createTextField my_txt this getNextHighestDepth 10 10 320 240 my_txt border true my_txt text Lorum ipsum my_txt backgroundColor 0xFF0000 var keyListener Object new Object...

Страница 655: ...is 0x000000 black This property may be retrieved or set even if there is currently no border Availability ActionScript 1 0 Flash Lite 2 0 Example The following example creates a text field called my_t...

Страница 656: ...hexadecimal color system uses six digits to represent color values Each digit has sixteen possible values or characters The characters range from 0 to 9 and then A to F Black is represented by 000000...

Страница 657: ...ap true second_txt condenseWhite true second_txt border true second_txt htmlText my_str See also html TextField html property embedFonts TextField embedFonts property public embedFonts Boolean A Boole...

Страница 658: ...ordWrap true my_txt embedFonts true my_txt text Hello world my_txt setTextFormat my_fmt my_txt _rotation 45 getDepth TextField getDepth method public getDepth Number Returns the depth of a text field...

Страница 659: ...y_fmt TextFormat my_txt getNewTextFormat trace TextFormat has the following properties for var prop in my_fmt trace prop my_fmt prop getTextFormat TextField getTextFormat method public getTextFormat b...

Страница 660: ...endIndex the TextFormat object returned is for the entire TextField endIndex Number optional An integer that specifies the end position of a span of text If you specify beginIndex but do not specify e...

Страница 661: ...pecify 0 low quality to prevent anti aliasing Availability ActionScript 1 0 Flash Lite 2 0 See also _quality TextField _quality property hscroll TextField hscroll property public hscroll Number Indica...

Страница 662: ...xt multiline false my_txt wordWrap false my_txt text Lorem ipsum dolor sit amet consectetuer adipiscing scrollLeft_btn onRelease function my_txt hscroll 10 scroll_txt text my_txt hscroll of my_txt max...

Страница 663: ...text property You can indicate that a text field is an HTML text field in the Property inspector or by setting the text field s html property to true Availability ActionScript 1 0 Flash Lite 2 0 Exam...

Страница 664: ...xChars allows the maxChars property indicates only how much text a user can enter If the value of this property is null there is no limit on the amount of text a user can enter Availability ActionScri...

Страница 665: ...HighestDepth 10 30 320 240 my_txt multiline true my_txt wordWrap true for var i 0 i 10 i my_txt text Lorem ipsum dolor sit amet consectetuer adipiscing elit sed diam nonummy nibh euismod tincidunt ut...

Страница 666: ...he Stage Add the following ActionScript to your FLA or ActionScript file which dynamically creates two text fields at runtime and displays their depths in the Output panel this createTextField first_m...

Страница 667: ...lts from user interaction for example when the user is typing something on the keyboard changing something in the text field using the mouse or selecting a menu item Programmatic changes to the text f...

Страница 668: ...handler listener invoked when one of the text field scroll properties changes A reference to the text field instance is passed as a parameter to the onScroller handler You can capture this data by pu...

Страница 669: ...ollUp_btn and scrollDown_btn to scroll the contents of the text field When the onScroller event handler is called a trace statement is used to display information in the Output panel Create two button...

Страница 670: ...d object oldFocus contains a null value Availability ActionScript 1 0 Flash Lite 2 0 Parameters oldFocus Object The object to lose focus Example See the example for TextField onKillFocus See also onKi...

Страница 671: ...following information is displayed in the Output panel The following information writes to the log file first_txt s _parent is _level0 second_txt s _parent is _level0 holder_mc See also _parent Butto...

Страница 672: ...ile Device fonts are always aliased and therefore are unaffected by the _quality property Note Although you can specify this property for a TextField object it is actually a global property and you ca...

Страница 673: ...listener list the method returns a value of false Example The following example creates an input text field called my_txt When the user types into the field information about the number of characters...

Страница 674: ...ash Lite 2 0 Example The following example creates a text field that you can remove from the Stage when you click the remove_btn instance Create a button and call it remove_btn and then add the follow...

Страница 675: ...t this getNextHighestDepth 10 10 320 22 my_txt autoSize true my_txt text dog house net var symbol String var symbolPos Number my_txt text indexOf symbol if symbolPos 1 my_txt replaceText 0 symbolPos b...

Страница 676: ...Clip _rotation property TextFormat scroll TextField scroll property public scroll Number Defines the vertical position of text in a text field The scroll property is useful for directing users to a sp...

Страница 677: ...scroll of my_txt maxscroll See also hscroll TextField hscroll property maxscroll TextField maxscroll property selectable TextField selectable property public selectable Boolean A Boolean value that i...

Страница 678: ...Sets the default new text format of a text field The default new text format is the new text format used for newly inserted text such as text entered by a user When text is inserted the newly inserte...

Страница 679: ...r formatting settings such as font name font size bold and italic For paragraphs the first character of the paragraph is examined for the paragraph formatting settings for the entire paragraph Example...

Страница 680: ...formation Example The following example sets the text format for two different strings of text The setTextFormat method is called and applied to the my_txt text field var format1_fmt TextFormat new Te...

Страница 681: ...tionScript 1 0 Flash Lite 2 0 See also _soundbuftime property styleSheet TextField styleSheet property public styleSheet StyleSheet Attaches a style sheet to the text field For information on creating...

Страница 682: ...t onLoad span callback handler to determine when the file has finished loading span class important The CSS file must reside in exactly the same domain as the SWF file that is loading it span For more...

Страница 683: ...00 font family Arial Helvetica sans serif font size 18px font weight bold display block tabEnabled TextField tabEnabled property public tabEnabled Boolean Specifies whether the text field is included...

Страница 684: ...ed false See also tabEnabled Button tabEnabled property tabEnabled MovieClip tabEnabled property tabIndex TextField tabIndex property public tabIndex Number Lets you customize the tab ordering of obje...

Страница 685: ...s getNextHighestDepth 10 10 100 22 one_txt border true one_txt type input this createTextField two_txt this getNextHighestDepth 10 40 100 22 two_txt border true two_txt type input this createTextField...

Страница 686: ...eates an HTML text field called my_txt and assigns an HTML formatted string of text to the field When you trace the htmlText property the Output panel displays the HTML formatted stringthe HTML format...

Страница 687: ...Script 1 0 Flash Lite 2 0 Example The following example creates a text field and assigns a string of text to the field A trace statement is used to display the text height and width in the Output pane...

Страница 688: ...nput text field Availability ActionScript 1 0 ActionScript 1 0 Flash Lite 2 0 Example The following example creates two text fields username_txt and password_txt Text is entered into both text fields...

Страница 689: ...ample the URL of the SWF file you are testing and the file called best_flash_ever swf are displayed in the Output panel When you test this example the URL of the SWF file you are testing and the file...

Страница 690: ...border true my_txt type input visible_btn onRelease function my_txt _visible my_txt _visible See also _visible Button _visible property _visible MovieClip _visible property _width TextField _width pr...

Страница 691: ...extField _height property wordWrap TextField wordWrap property public wordWrap Boolean A Boolean value that indicates if the text field has word wrap If the value of wordWrap is true the text field ha...

Страница 692: ...ing example creates a text field wherever you click the mouse When it creates a text field that field displays the current x and y coordinates of the text field this createTextField coords_txt this ge...

Страница 693: ..._txt border true var mouseListener Object new Object mouseListener onMouseMove function mouse_txt text MOUSE X Math round _xmouse tY Math round _ymouse textfield_txt text TEXTFIELD X Math round my_txt...

Страница 694: ...t has transformations the text field is in the local coordinate system of the enclosing movie clip Thus for a movie clip rotated 90 degrees counterclockwise the enclosed text field inherits a coordina...

Страница 695: ...e for TextField _xscale See also _x TextField _x property _xscale TextField _xscale property _y TextField _y property TextFormat Object TextFormat public class TextFormat extends Object The TextFormat...

Страница 696: ...to the first character in the paragraph italic Boolean A Boolean value that indicates whether text in this text format is italicized leading Number An integer that represents the amount of vertical sp...

Страница 697: ...rty Signature Description TextFormat font String size Number color Number bold Boolean italic Boolean underline Boolean url String target String align String leftMargin Number rightMargin Number inden...

Страница 698: ...erty public blockIndent Number A number that indicates the block indentation in points Block indentation is applied to an entire block of text that is to all lines of the text In contrast normal inden...

Страница 699: ...xtFormat new TextFormat my_fmt bold true this createTextField my_txt 1 100 100 300 100 my_txt multiline true my_txt wordWrap true my_txt border true my_txt text This is my text field object text my_tx...

Страница 700: ...ewline my_txt setTextFormat my_fmt color TextFormat color property public color Number A number that indicates the color of text The number contains three 8 bit RGB components for example 0xFF0000 is...

Страница 701: ...ext in the format specified by my_fmt The text string is treated as plain text not HTML The method returns an object with six properties ascent descent width height textFieldHeight and textFieldWidth...

Страница 702: ...ont size and leading The default value for leading is 2 Availability ActionScript 1 0 Flash Lite 2 0 The width parameter is supported in Flash Player 7 Parameters text String A string width Number opt...

Страница 703: ...l wide text field that s high enough to display a string with the specified formatting Create a TextFormat object var my_fmt TextFormat new TextFormat Specify formatting properties for the TextFormat...

Страница 704: ...ext field object text mytext setTextFormat myformat See also blockIndent TextFormat blockIndent property italic TextFormat italic property public italic Boolean A Boolean value that indicates whether...

Страница 705: ...y_txt wordWrap true my_txt border true my_txt text This is my first text field object text my_txt setTextFormat my_fmt leftMargin TextFormat leftMargin property public leftMargin Number The left margi...

Страница 706: ...20 mytext text this is my first text field object text mytext setTextFormat myformat size TextFormat size property public size Number The point size of text in this text format The default value is nu...

Страница 707: ...xt A tB tC tD t is the tab stop character mytext setTextFormat myformat this createTextField mytext2 2 100 220 400 100 mytext2 border true var myformat2 TextFormat new TextFormat myformat2 tabStops 75...

Страница 708: ...er indent Number leading Number Creates a TextFormat object with the specified properties You can then change the properties of the TextFormat object to change the formatting of text fields Any parame...

Страница 709: ...rom the left margin to the first character in the paragraph leading Number optional A number that indicates the amount of leading vertical space between lines Example The following example creates a T...

Страница 710: ...00 200 100 mytext multiline true mytext wordWrap true mytext border true var myformat TextFormat new TextFormat myformat underline true mytext text This is my first text field object text mytext setTe...

Страница 711: ...e or stream it by using the Video object and assigning either a NetStream object or Camera object as the source of the video information However the player for Flash Lite 2 0 does not support the NetS...

Страница 712: ...ciated with this Video object and clears the video area onscreen pause Void Stops playback of the video and continues to render the current frame onscreen play Boolean Calling this method opens a vide...

Страница 713: ...bject Callback handler that can be invoked by the device to indicate status or error conditions Availability ActionScript 2 0 Flash Lite 2 0 Parameters infoObject Object The infoObject parameter has t...

Страница 714: ...ser clicks the close_btn instance video1 is the name of a Video object on Stage video1 pause See also play Video play method play Video play method public play Boolean Calling this method opens a vide...

Страница 715: ...ing in a Video object called video1 video1 resume See also pause Video pause method stop Video stop method public stop Void Stops playback of the video and continues to render the current frame onscre...

Страница 716: ...deName nodeType nodeValue parentNode previousSibling removeNode toString In earlier versions of the ActionScript Language Reference the methods and properties above were documented in the XML class Th...

Страница 717: ...ype String The MIME content type that is sent to the server when you call the XML send or XML sendAndLoad method docTypeDecl String Specifies information about the XML document s DOCTYPE declaration i...

Страница 718: ...ignature Description XML text String Creates a new XML object Modifiers Signature Description addRequestHeader header Obje ct headerValue String Void Adds or changes HTTP request headers such as Conte...

Страница 719: ...ends it to the specified URL using the POST method in a browser sendAndLoad url String resultXML XML Void Encodes the specified XML object into an XML document sends it to the specified URL using the...

Страница 720: ...s the value associated with header Example The following example adds a custom HTTP header named SOAPAction with a value of Foo to an XML object named my_xml my_xml addRequestHeader SOAPAction Foo The...

Страница 721: ...w flash mx com mm highscore cfm _blank Press F12 to test this example in a browser See also send XML send method sendAndLoad XML sendAndLoad method createElement XML createElement method public create...

Страница 722: ...e doc output element1 element2 element3 element1 See also createTextNode XML createTextNode method createTextNode XML createTextNode method public createTextNode value String XMLNode Creates a new XML...

Страница 723: ...he XML tree element2 appendChild textNode1 element3 appendChild textNode2 trace doc output with line breaks added between tags element1 element2 textNode1 String value element2 element3 textNode2 Stri...

Страница 724: ...d streamed for the XML document You can compare the value of getBytesLoaded with the value of getBytesTotal to determine what percentage of an XML document has loaded Availability ActionScript 1 0 Fla...

Страница 725: ...rogress 100 doc See also getBytesTotal XML getBytesTotal method getBytesTotal XML getBytesTotal method public getBytesTotal Number Returns the size in bytes of the XML document Availability ActionScri...

Страница 726: ...e kitchen bathroom linoleum bathroom foyer foyer house Create a new Flash document named flooring fla and save it to the same directory as the XML file Place the following code into the main Timeline...

Страница 727: ...n SWF files running in a version of the player earlier than Flash Player 7 the url parameter must be in the same superdomain as the SWF file that issues this call A superdomain is derived by removing...

Страница 728: ...o parameter null is passed true otherwise Use the onLoad event handler to check the success of a loaded XML document Example The following simple example uses the XML load method create a new XML obje...

Страница 729: ...m problems products xml Information displays in the Output panel when the onLoad handler invokes If the call completes successfully true displays for the loaded status in the Output panel success true...

Страница 730: ...ad handler onLoad XML onLoad handler onLoad function success Boolean Invoked by Flash Player when an XML document is received from the server If the XML document is received successfully the success p...

Страница 731: ...yLoginReply_xml firstChild nodeName packet myLoginReply_xml firstChild attributes success true gotoAndStop loggedIn else gotoAndStop loginFailed else gotoAndStop connectionFailed my_xml sendAndLoad ht...

Страница 732: ...String method String Boolean Encodes the specified XML object into an XML document and sends it to the specified URL using the POST method in a browser The Flash test environment only uses the GET me...

Страница 733: ...in the same superdomain as the SWF file that is issuing this call A superdomain is derived by removing the left most component of a file s URL For example a SWF file at www someDomain com can load dat...

Страница 734: ...ent that contains the user s name and password and uses an onLoad handler to process the reply from the server var login_str String login username username_txt text password password_txt text var my_x...

Страница 735: ...t matched with an end tag 10 An end tag was encountered without a matching start tag Availability ActionScript 1 0 Flash Lite 2 0 Example The following example loads an XML packet into a SWF file A st...

Страница 736: ...ed without a matching start tag break default errorMessage An unknown error has occurred break trace status my_xml status errorMessage else trace Unable to load parse XML status my_xml status my_xml l...

Страница 737: ...entation of the XML declaration not an XML node object If no XML declaration is encountered during a parse operation the property is set to undefined XML The XML toString method outputs the contents o...

Страница 738: ...ine my_xml docTypeDecl newline newline my_txt text packet newline my_xml toString newline newline else my_txt text Unable to load remote XML newline newline my_txt text loaded in elapsedTime ms my_xml...

Страница 739: ...d only An XMLNode value that references the next sibling in the parent node s child list nodeName String A string representing the node name of the XML object nodeType Number read only A nodeType valu...

Страница 740: ...s the specified node to the XML object s child list cloneNode deep Boolean XMLNode Constructs and returns a new XML node of the same type name value and attributes as the specified XML object hasChild...

Страница 741: ...new node and appends it to the root node of the XML document doc1 var doc1 XML new XML var doc2 XML new XML create a root node and add it to doc1 var rootnode XMLNode doc1 createElement root doc1 appe...

Страница 742: ...create a tag called mytag with an attribute called name with value Val var doc XML new XML mytag name Val item mytag assign the value of the name attribute to variable y var y String doc firstChild at...

Страница 743: ...ocument tree doc appendChild rootNode add each of the child nodes as children of rootNode rootNode appendChild oldest rootNode appendChild middle rootNode appendChild youngest create an array and use...

Страница 744: ...0 Flash Lite 2 0 Parameters deep Boolean A Boolean value if set to true the children of the specified XML object will be recursively cloned Returns XMLNode An XMLNode Object Example The following exam...

Страница 745: ...race rootNode output with line breaks added rootNode oldest middle middle youngest rootNode oldest middle middle youngest rootNode rootNode firstChild XMLNode firstChild property public firstChild XML...

Страница 746: ...h the child nodes of rootNode for var aNode XMLNode rootNode firstChild aNode null aNode aNode nextSibling trace aNode output oldest middle youngest The following example is from the XML_languagePicke...

Страница 747: ...value of the node Add the following ActionScript to your FLA or AS file var my_xml XML new XML hankrudolph if my_xml firstChild hasChildNodes use firstChild to iterate through the child nodes of rootN...

Страница 748: ...d list The XML lastChild property is null if the node does not have children This property cannot be used to manipulate child nodes use the appendChild insertBefore and removeNode methods to manipulat...

Страница 749: ...middle oldest The following example creates a new XML packet and uses the XML lastChild property to iterate through the child nodes of the root node create a new XML document var doc XML new XML var r...

Страница 750: ...how you can use the XML nextSibling property to loop through an XML node s child nodes for var aNode XMLNode rootNode firstChild aNode null aNode aNode nextSibling trace aNode See also firstChild XMLN...

Страница 751: ...trace myTextNode nodeName output rootNode null The following example creates a new XML packet If the root node has child nodes the code loops over each child node to display the name and value of the...

Страница 752: ...E Availability ActionScript 1 0 Flash Lite 2 0 Example The following example creates an element node and a text node and checks the node type of each create an XML document var doc XML new XML create...

Страница 753: ...ML object is an XML element nodeType is 1 nodeValue is null and read only Availability ActionScript 1 0 Flash Lite 2 0 Example The following example creates an element node and a text node and checks...

Страница 754: ...irstChild trace trace using firstChild nodeValue for var i 0 i my_xml firstChild childNodes length i trace t my_xml firstChild childNodes i firstChild nodeValue The following information is displayed...

Страница 755: ...pendChild method insertBefore XMLNode insertBefore method removeNode XMLNode removeNode method XML previousSibling XMLNode previousSibling property public previousSibling XMLNode read only An XMLNode...

Страница 756: ...d XML object and its descendant nodes var xml_str String state name California city San Francisco city state var my_xml XML new XML xml_str var cityNode XMLNode my_xml firstChild firstChild trace befo...

Страница 757: ...ility ActionScript 1 0 Flash Lite 2 0 Returns String String Example The following code uses the toString method to convert an XMLNode object to a String and then uses the toUpperCase method of the Str...

Страница 758: ...lass Object Method summary Methods inherited from class Object constructor Object constructor property __proto__ Object __proto__ property prototype Object prototype property __resolve Object __resolv...

Страница 759: ...get method public static get name String String Retrieves the value of the specified property of the current XMLUI dialog Availability ActionScript 1 0 Flash Lite 2 0 Parameters name String The name...

Страница 760: ...760 ActionScript classes...

Страница 761: ...function statement chr number Number String Deprecated since Flash Player 5 This function was deprecated in favor of String fromCharCode ifFrameLoaded scene String frame Object Deprecated since Flash...

Страница 762: ...ion was deprecated in favor of String substr ord character String Number Deprecated since Flash Player 5 This function was deprecated in favor of the methods and properties of the String class random...

Страница 763: ...y was deprecated in favor of _quality maxscroll Deprecated since Flash Player 5 This property was deprecated in favor of TextField maxscroll scroll Deprecated since Flash Player 5 This property was de...

Страница 764: ...an or equal to strings Deprecated since Flash Player 5 This operator was deprecated in Flash 5 in favor of the less than or equal to operator lt less than strings Deprecated since Flash Player 5 This...

Страница 765: ...ield getFontList TextField replaceSel Video attachVideo Video clear Button blendMode Button cacheAsBitmap Button filters Button menu Button useHandCursor System capabilities language System capabiliti...

Страница 766: ...rted Global Functions Unsupported Event Handlers Unsupported fscommands asfunction MMExecute print printAsBitmap printAsBitmapNum printNum updateAfterEvent onUpdate Mouse onMouseWheel allowscale exec...

Страница 767: ...rator 145 strict equality operator 171 greater than operator 147 greater than or equal to operator 148 bitwise right shift operator 132 bitwise right shift and assignment operator 133 bitwise unsigned...

Страница 768: ...er property 246 length property 247 arguments class 245 Array Array constructor 251 CASEINSENSITIVE property 252 concat method 252 DESCENDING property 254 join method 254 length property 255 NUMERIC p...

Страница 769: ...asAudioEncoder property 306 hasCMIDI property 306 hasCompoundSound property 306 hasDataLoading property 307 hasEmail property 307 hasEmbeddedVideo property 308 hasMappableSoftKeys property 308 hasMFI...

Страница 770: ...eTo method 457 D data property 587 Date Date constructor 330 getDate method 331 getDay method 332 getFullYear method 332 getHours method 333 getLocaleLongDate method 334 getLocaleShortDate method 334...

Страница 771: ...45 floor method 419 flush method 589 focusEnabled property 464 font property 701 for statement 196 for in statement 197 fromCharCode method 630 fscommand function 46 fscommand2 Commands 225 fscommand2...

Страница 772: ...es 92 globalToLocal method 474 gotoAndPlay function 51 gotoAndPlay method 477 gotoAndStop function 52 gotoAndStop method 478 gt greater than strings operator 148 H has4WayKeyAS property 305 hasAccessi...

Страница 773: ...language property 315 lastChild property 748 lastIndexOf method 632 le less than or equal to strings operator 157 leading property 705 LEFT property 382 leftMargin property 705 length function 56 len...

Страница 774: ...ring function 65 message property 359 MIMETypes property 317 min method 422 MIN_VALUE property 546 Mouse addListener method 432 removeListener method 437 Mouse class 430 onMouseDown event 433 onMouseM...

Страница 775: ...useUp event 502 onPress event 502 onRelease event 502 onReleaseOutside event 503 onRollOut event 503 onRollOver event 504 onSetFocus event 504 onUnload event 505 MovieClipLoader addListener method 530...

Страница 776: ...3 502 onRelease event 283 502 onReleaseOutside event 284 503 onResize event 622 onRollOut event 284 503 onRollOver event 285 504 onScroller event 668 onSetFocus event 285 504 578 670 onSoundComplete e...

Страница 777: ...346 setMinutes method 347 setMonth method 347 setNewTextFormat method 678 setPan method 613 setProperty function 81 setRGB method 322 setSeconds method 348 SetSoftKeys command 241 setTextFormat metho...

Страница 778: ...nction 84 stopDrag method 514 StopVibrate command 243 String charAt method 628 charCodeAt method 629 concat method 630 fromCharCode method 630 indexOf method 631 lastIndexOf method 632 length property...

Страница 779: ...operty 686 textColor property 687 textHeight property 687 textWidth property 688 type property 688 variable property 689 wordWrap property 691 TextField class 645 onChanged event 666 onKillFocus event...

Страница 780: ...od 722 docTypeDecl property 723 getBytesLoaded method 724 getBytesTotal method 725 ignoreWhite property 725 load method 727 loaded property 729 parseXML method 731 send method 732 sendAndLoad method 7...

Отзывы: