Gii thiu 1 Contents of the dictionary {Cc ni dung ca t in} 3 Accessibility (object :i tng) {S d b nh hng} 24 Accessibility.isActive 24 Button (object) : Nt (i tng) 25 Button.onDragOver 27 Color (object) : Mu sc (i tng) 27 Color.getTransform 28 CustomActions (object) {Cc hnh vi ty chnh (i tng)} 29 Date (object) : Ngy thng (i tng) 29 delete 34 duplicateMovieClip 35 FCheckBox (component: thnh phn) 36 FComboBox (component) 37 FPushButton (component) 40 FRadioButton (component: thnh phn) 41 FScrollBar (component) 42 FScrollPane (component) 44 FStyleFormat (object) 45 Constructor (ngi xy dng) cho i tng FStyleFormat 48 Function (object) : Hm (i tng) 49 Function.prototype 49 fscommand 50 Function 52 getProperty 54 getTimer 54 getURL 55 _global 56 Key (object) 57 LoadVars (object) {Np cc bin (i tng)} 59 _level 61 Math (object) 62 Mouse (object) {Con tr chut (i tng)} 64 MovieClip (object) 64 MovieClip._url 69 MovieClip.useHandCursor 70 MovieClip._visible 70 MovieClip._width 70 MovieClip._x 71 MovieClip._xmouse 71 1
MovieClip._xscale 72 Number (function) 72 Constructor cho Object object 74 Object.registerClass 74 onClipEvent 76 _parent 78 on 78 print 89 random {ngu nhin} 81 removeMovieClip 82 _root 82 scroll 83 Selection (object) {S la chn (i tng)} 84 Sound (object) {m thanh (i tng)} 85 Stage (object) {Sn khu (i tng)} 87 startDrag 88 String (function) 89 System.capabilities (object) 90 targetPath 91 tellTarget 92 TextField (object) 93 TextFormat (object) {nh dng Text (i tng)} 97 this 99 toggleHighQuality 100 trace 101 typeof 102 undefined 103 unescape 104 unloadMovie 105 unloadMovieNum 106 updateAfterEvent 107 void 108 while 108 with 109 XML (object) : XML (i tng) 113 XML.send 116 XML.status 117 XMLSocket (object) { cm XML (i tng)} 117
1
T in ny m t c php v cch s dng ca yu t ActionScript trong Macromedia Flash MX. s dng cc th d trong mt script, copy on m mu t ActionScript T in v dn n vo trong bng Actions ch expert mode. T in lit k tt c cc phn t ActionScript operators (cc ton t), keywords (t kho), statements (trnh by), actions (hot ng), properties (thuc tnh), functions (hm), objects (i tng), components (thnh phn), v methods (phng php). Cho mt khi qut v tt c cc mc ca T in, hy xem Contents of the dictionary (Ni dung ca t in); nhng bng trong phn ny l im khi u tt cho vic xem xt nhng thao tc hoc cch thc c tnh cht tng trng m cc i tng hoc cc lp hp thnh chng bn khng bit. ActionScript theo tiu chun ECMA-262 (tiu chun c t vit bi hi lin hip nhng ngi sn xut my tnh chu u: the specification written by the European Computer Manufacturers Association) ngoi tr mt s ch khc. Mt s phn t Flash 5 (v trc ) ActionScript b phn khng v thay th bi cc phn t ActionScript mi ph hp vi tiu chun ECMA Standard. Bn nn s dng cc phn t Flash MX mi, mc d cc phn t ny vn c h tr bi Flash Player 5. C hai loi mc t trong t in ny:
Nhng mc t ring cho cc ton t (operators), t kho (keywords), hm (functions), bin (variables), thuc tnh (properties), phng php (methods), v cc cu lnh (statements).
Nhng mc t i tng (Object) v thnh phn hp thnh (component), cung cp thng tin tng qut v nhng i tng v cc component Flash gn lin. S dng thng tin trong cc mc t sample (v d) lm sng t cu trc v quy c s dng trong hai kiu mc t ny. Sample entry for most ActionScript elements {Mc t V d cho hu ht cc phn t ActionScript} Mc t in V d (Sample) gii thch cc quy c s dng i vi tt c cc phn t ActionScript m khng phi l cc i tng hay cc components.
Tiu mc t Tt c cc mc t c lit k theo bng ch ci. S sp xp theo bng ch ci theo nhng ch hoa, cc t c gch di,... Availability {C th dng c, c hiu lc} Phn ny cho bit phin bn Flash Player no h tr phn t ny. iu ny khng ging vi phin bn ca Flash dng to ra ni dung. V d, nu bn s dng cng c thit ku Flash MX to ni dung cho Flash Player 5, bn ch c th s dng cc phn t ActionScript c hiu lc vi Flash Player 5. Usage {Cch s dng} 2
Phn ny cung cp c php chnh xc cho vic s dng phn t ActionScript trong on m ca bn. Phn quy nh ca c php nm trong italicized code font. Cc du ngoc vung ([]) cho bit cc tham s ty chn. Parameters {Tham s} Phn ny m t bt k tham s no c lit k trong c php. Returns {Tr v} Phn ny cho bit nhng gi tr no (nu c) phn t tr v. Description {Phn m t} Phn ny nhn dng kiu ca phn t (v d, l mt ton t operator, phng php method, hm function, v ...) v sau din t cch s dng phn t. Example {V d} Phn ny cung cp mt m v d gii thch cch s dng phn t. See also {Xem thm} Phn ny lit k cc mc t in ActionScript c lin quan. Sample entry for objects and components {Mc t v d cho cc i tng v cc component} Mc t in v d sau y gii ngha cc quy c dng cho cc i tng v cc component ActionScript gn km. Cc i tng (object) v cc component. Cc i tng v cc component u c lit k theo bng ch ci vi cc phn t khc trong t in. Cc component Flash u c lit k nh FCheckBox, FComboBox, ....
Mc t tiu The entry title provides the name of the object or component. The object or component name is followed by a paragraph containing general descriptive information.
Bng tng quan cc method v thuc tnh Mi mc t i tng v component cha mt bng lit k tt c cc method kt hp. Nu i tng hay component c cc thuc tnh (thng l hng s), nhng phn t ny c tm tt trong mt bng thm. Tt c cc method v thuc tnh lit k trong nhng bng ny cng c nhng mc t ring ca chng, theo sau mc t i tng hoc component.
Constructor 3
Nu mt i tng hoc component yu cu bn s dng mt constructor (trnh xy dng) truy cp cc method v thuc tnh ca n, constructor c m t trong mi mc t i tng hoc component. S m t ny c tt c cc phn t chun mc (c php, phn m t, ...) ca tt c cc mc t in khc.
Danh sch cc meethod v property Cc method v thuc tnh ca mt i tng hoc component u c lit k theo th t bng ch ci sau mc t i tng hoc component. Contents of the dictionary {Cc ni dung ca t in} Tt c cc mc t u c lit k theo bng ch ci. Tuy nhin, mt s ton t v symbol (biu tng) u c trnh by theo th t ASCII. Trong phn b sung, cc method kt hp vi mt i tng hoc component u c lit k theo cng vi tn ca i tng hoc componentv d, method abs ca i tng ton Math c lit k trong Math.abs, v method getValue ca component FRadioButton c lit k l FRadioButton.getValue. Hai bng sau y gip bn nh v nhng phn t ny. Bng u tin lit k cc ton t tng trng theo th t m chng xut hin trong t in. Bng th hai lit k tt c cc phn t ActionScript khc. Ch : Vi tnh th t v kt hp ca cc ton t, hy xem ph lc Appendix A, Operator Precedence and Associativity Symbolic operators -- -- (decrement) ++ ++ (increment) ! ! (logical NOT) != != (inequality) !== !== (strict inequality) % % (modulo) %= %= (modulo assignment) & & (bitwise AND) && && (short-circuit AND) &= &= (bitwise AND assignment) () () (parentheses) - - (minus) * * (multiplication) 4
trace trace trackAsMenu Button.trackAsMenu, MovieClip.trackAsMenu true true type TextField.type typeof typeof undefined undefined underline TextFormat.underline unescape unescape uninstall CustomActions.uninstall unloadMovie unloadMovie, MovieClip.unloadMovie unLoadMovieNum unloadMovieNum unshift Array.unshift unwatch Object.unwatch UP Key.UP updateAfterEvent updateAfterEvent url TextFormat.url _url MovieClip._url, TextField._url, Button._url useHandCursor Button.useHandCursor, MovieClip.useHandCursor UTC Date.UTC valueOf Boolean.valueOf, Number.valueOf, Object.valueOf var var variable TextField.variable version System.capabilities.version _visible MovieClip._visible, Button._visible, TextField._visible void void watch Object.watch while while width Stage.width _width MovieClip._width, TextField._width, Button._width 24
with with wordwrap TextField.wordWrap _x Button._x, MovieClip._x, TextField._x XML XML (object) xmlDecl XML.xmlDecl XMLSocket XMLSocket (object) _xmouse Button._xmouse, MovieClip._xmouse, TextField._xmouse _xscale Button._xscale, MovieClip._xscale, TextField._xscale _y Button._y, MovieClip._y, TextField._y _ymouse Button._ymouse, MovieClip._ymouse, TextField._ymouse _yscale Button._yscale, MovieClip._yscale, TextField._yscale
Accessibility (object :i tng) {S d b nh hng} Accessibility object l mt tp hp nhng phng php m bn c th s dng to ra cc ni dung c th p dng vii ActionScript. Trong Flash MX, ch c mt cch. Object ny ch c gi tr vi Flash Player 6.
Tm lc phng php cho i tng Arguments Property (Thuc tnh) Description (M t) Accessibility.isActive Ch ra mt chng trnh c mn hnh c hot ng tch cc khng Accessibility.isActive Availability (C hiu lc vi) Flash Player 6. Usage (S dng) Accessibility.isActive() Parameters (Tham s) 25
None. {khng} Returns (Fn hi) Mt gi tr logic. Description (M t) Phng php; ch ra xem mt chng trnh c mn hnh c thc s ang hot ng hay khng. S dng cch thc ny khi bn mun movie ca bn trnh din khc nhau trong s hin din ca mt ngi c mn nh ( Use this method when you want your movie to behave differently in the presence of a screen reader). See also (Xem thm) System.capabilities.hasAccessibility Button (object) : Nt (i tng) Tt c cc k hiu nt (button symbols) trong mt Flash movie l cc th hin (instance) ca i tng Button (nt). Bn c th gn cho mt button mt tn minh ha (an instance name) trong Property inspector, v s dng cc phng php (method) v cc thuc tnh (properties) ca i tng Button thao tc cc nt vi ActionScript. Cc tn minh ha (instance name) ca nt c hin th trong hp Movie Explorer v trong hp thoi Insert Target Path trong panel Actions. i tng Button k tha t i tng Object. i tng Button c h tr bi Flash Player 6.
Cch thc tm lc cho i tng Button Method Description Button.getDepth Tr li dy ca mt th hin nt (button instance).
Thuc tnh tm lc cho i tng Button Property Description Button._alpha Gi tr thuc tnh trong sut ca mt th hin nt. Button.enabled Cho bit mt nt c hot ng hay khng. Button._focusrect Ch bo liu c phi mt nt vi tiu im c mt hnh ch nht mu 26
vng bao quanh n khng. Button._height Chiu cao ca mt th hin nt, tnh theo pixel. Button._highquality Cho bit cht lng trnh din ca on phim movie Button._name Tn minh ha (instance name) ca mt th hin nt. Button._parent Mt s lin h ti mt th hin movie clip m l cha m ca th hin ny. Button._quality Cho bit cht lng trnh din ca on phim. Button._rotation Mc xoay vng ca mt th hin nt. Button._soundbuftime S giy cho mt m thanh preload. Button.tabEnabled Cho bit mt nt c bao gm c trong automatic tab ordering (Indicates whether a button is included in automatic tab ordering). Button.tabIndex Cho bit bng th t ca mt i tng (Indicates the tab order of an object). Button._target ng dn ti ch ca mt th hin nt. Button.trackAsMenu Cho bit c cc nt khc c th nhn cc s kin mouse release (Chng hiu dch th no). Button._url a ch ca file SWF to ra th hin nt. Button.useHandCursor Cho bit c phi con chut hnh bn tay c hin th khi chut di chuyn qua mt nt hay khng. Button._visible Mt gi tr Boolean xc nh mt th hin nt c tnh n (hidden) hay c th nhn thy c (visible). Button._width rng ca mt th hin nt, tnh theo pixel. Button._x Ta x ca mt th hin nt. Button._xmouse Ta x ca con tr so vi mt th hin nt. Button._xscale Gi tr xc nh t l phn trm theo chiu ngang ca mt th hin nt (The value specifying the percentage for horizontally scaling a button instance). Button._y Ta y ca mt th hin nt. Button._ymouse Ta y ca con tr so vi mt th hin nt. Button._yscale Gi tr xc nh t l phn trm theo chiu di ca mt th hin nt (The value specifying the percentage for vertically scaling a button instance). 27
Button.onDragOver Availability Flash Player 6. Usage myButton.onDragOver Parameters None. Returns Nothing. Description B qun l s kin; c vin dn khi ngi dng nhn v di chuyn con tr chut (trong khi vn gi phm trn chut) ra ngoi v sau li ln trn nt. Bn phi nh ngha mt hm thc thi khi s kin c vin dn. Example V d di y nh ngha mt hm cho phng php onKeyDown gi mt trace (du vt) ra ca s hin th (Output window): myButton.onDragOver = function () { trace ("onDragOver called");}; Color (object) : Mu sc (i tng) i tng Color (Mu sc) cho php bn thit t gi tr mu RGB (ba mu c bn Red, Green v Blue) v thay i mu sc ca cc movie clip v khi phc li cc gi tr mt khi chng c thit t. Bn phi s dng constructor (ngi xy dng) new Color() to mt th hin (instance) ca i tng Color trc khi gi cc method (phng php) ca n. i tng Color c h tr bi Flash 5 v cc phin bn v sau ca Flash Player.
Bng tm lc cc method ca i tng Color Method Description 28
Color.getRGB Tr li tp hp gi tr RGB thit lp bi ln cui cng gi setRGB. Color.getTransform Tr li tp hp thng tin bin i thit lp bi ln gi setTransform cui cng. Color.setRGB Thit t s th hin h 16 ca gi tr RGB cho mt i tng Color . Color.setTransform Thit t s bin i cho mt i tng mu Color.
Ngi xy dng cho i tng mu (Constructor for the Color object) Availability Flash Player 5. Usage new Color(target) Parameters target Tn minh ha ca mt movie clip. Returns Nothing. Description Ngi xy dng (Constructor); to ra mt th hin ca i tng Color cho movie clip c ch r bi tham s target. Bn c th dng cc method (cch thc, phng php) ca i tng Color thay i mu sc ca ton b movie clip ch (entire target movie clip). Example V d di y to mt th hin ca i tng mu sc Color c gi l myColor cho movie clip myMovieClip v thit t gi tr RGB ca n: myColor = new Color(myMovieClip);myColor.setRGB(0xff9933); Color.getTransform Availability Flash Player 5. 29
Usage myColor.getTransform() Parameters None. Returns Nothing. Description Phng php (Method); tr li gi tr thay i thit t bi ln gi setTransform cui cng. See also Color.setTransform CustomActions (object) {Cc hnh vi ty chnh (i tng)} Cc method ca i tng CustomActions cho php mt Flash movie ang chy trong cng c thit k Flash c qun l bt k hnh vi tu chnh no ng k bi cng c thit k. Mt Flash movie c th ci t v g b cc hnh vi ty chnh, tip nhn nh ngha XML ca mt hnh vi ty chnh, v truy lc danh sch cc hnh vi ty chnh ng k. Bn c th s dng cc method ny xy dng cc Flash movies vi cc phn m rng ca cng c thit k Flash. Chng hn nh mt phn m rng ca movie c th l, v d, s dng giao thc trnh ng dng Flash (Flash Application Protocol) iu hng mt kho UDDI v ti xung cc dch v Web vo trong hp cng c Actions toolbox.
Bng tng quan cc method cho i tng CustomActions Method Description CustomActions.get c cc ni dung ca mt file XML nh ngha hnh vi ty chnh. CustomActions.install Ci t mt file nh ngha hnh vi ty chnh XML mi (Installs a new custom action XML definition file). CustomActions.list Tr v mt danh sch tt c hnh vi ty chnh ng k. CustomActions.uninstall G b mt file nh ngha hnh vi ty chnh XML . Date (object) : Ngy thng (i tng) 30
i tng ngy thng Date cho php bn gi (retrieve) cc gi tr ngy thng v thi gian so vi gi quc t (Greenwich Mean Time l gi chun cn c theo kinh tuyn Greenwich, gi GMT, hin ti c gi l gi quc t hoc UTC) hoc so vi h iu hnh m Flash Player ang chy. Cc phng php (method) ca i tng ngy thng Date khng phi l tnh, nhng ch p dng cho cc th hin ring l ca i tng Date c ch r khi method c gi. Phng php Date.UTC l mt ngoi l; n l mt method tnh. i tng Date qun l thi gian ko di gi lm vic ban ngy ma h ( tit kim in ...) (ti dch t nguyn gc l daylight saving time) khc nhau tu thuc vo h iu hnh v phin bn Flash Player . Flash Player 6 iu khin daylight saving time trn cc h iu hnh theo cc cch sau:
Windowsi tng Date t ng iu chnh u ra (thng tin do my tnh cung cp) ca n cho daylight saving time. i tng Date pht hin ra daylight saving time c dng trong a phn hin ti (current locale), v nu nh th, n nhn ra tiu chun chuyn tip ti thi gian ko di gi lm vic ban ngy ma h (it detects what the standard-to-daylight-saving-time transition date and times are). Tuy nhin, nhng ngy thng chuyn tip hin thi trong thc t c ng dng ti nhng ngy thng trong qu kh v tng lai, v th thi gian ko di gi lm vic ban ngy ma h thin lch c th c tnh ton khng chnh xc cho ngy thng trong qu kh khi a phng c nhng ngy thng chuyn tip khc nhau.
Mac OS 8 v 9i tng Date dng thi gian ko di gi lm vic ban ngy ma h thc t (object uses the current daylight-saving-time bias), khng quan tm n ngy thng hoc thi gian ang c tnh ton. V d, khu vc c chung gi chun U.S. Pacific trong thi gian thng tm August, khi thi gian ko di gi lm vic ma h (DST) c hiu lc, mt i tng cha ng ngy thng Jan 1 2001 vn tng trnh thi gian DST mc d DST khng c hiu lc trong thng mt January. Vn ny khng c sa cha trn Mac OS 8 hoc 9 bi v mt c s d liu thng tin khu vc c cng gi chun khng c hiu lc (because a time zone information database is not available).
Mac OS Xi tng Date t ng iu chnh u ra ca n cho thi gian ko di gi lm vic ma h (daylight saving time). C s d liu thng tin timezone trong Mac OS X c s dng xc nh liu c phi bt k ngy thng hoc thi gian no trong hin ti hoc qu kh cn phi c mt thi gian ko di gi lm vic ma h thin lch c ng dng hay khng (used to determine whether any date or time in the present or past should have a daylight-saving-time bias applied). Flash Player 5 x l thi gian ko di gi lm vic ma h (daylight saving time) trn cc h iu hnh nh sau:
Mac OS 8 v 9tng t nh i vi Flash Player 6.
Windowscc quy tc U.S. cho daylight saving time lun lun c p dng, dn ti s chuyn tip khng ng Chu u (Europe) v cc vng khc dng daylight saving time nhng c thi gian chuyn tip khc nhau hn l U.S. Flash pht hin mt cch chnh xc DST c c s dng trong locale hin ti khng. (but have different transition times than the U.S. Flash correctly detects whether DST is employed in the current locale). 31
gi cc method ca i tng Date, u tin bn phi to mt th hin (instance) ca i tng Date s dng ngi xy dng (constructor) cho i tng Date. i tng Date i hi phi c Flash Player 5.
Bng tm lc cc method ca i tng Date object Method Description Date.getDate Tr li ngy trong thng theo thi gian cc b (local time : ti ngh thi gian cc b y chnh l thi gian trn my tnh ca bn). Date.getDay Tr li ngy trong tun theo thi gian cc b. Date.getFullYear Tr li nm bn ch s theo thi gian cc b. Date.getHours Tr li gi theo thi gian cc b. Date.getMilliseconds Tr li cc mili-giy (mt phn nghn giy) theo thi gian cc b. Date.getMinutes Tr li pht theo thi gian cc b. Date.getMonth Tr li thng theo thi gian cc b. Date.getSeconds Tr li giy theo thi gian cc b. Date.getTime Tr li s mili-giy k t mi hai gi m ngy 1 thng Ging, nm 1970, gi th gii. Date.getTimezoneOffset Tr li s chnh lch, theo pht, gia thi gian cc b trn cc my tnh v thi gian quc t ( universal time). Date.getUTCDate Tr li ngy (date) ca thng theo thi gian quc t. Date.getUTCDay Tr li ngy trong tun theo thi gian quc t. Date.getUTCFullYear Tr lai nm bn ch s theo thi gian quc t. Date.getUTCHours Tr li gi theo thi gian quc t. Date.getUTCMilliseconds Tr li mili-giy theo thi gian quc t. Date.getUTCMinutes Tr li pht theo thi gian quc t. Date.getUTCMonth Tr li thng theo thi gian quc t. Date.getUTCSeconds Tr li s giy ng h theo thi gian quc t. Date.getYear Tr li nm theo thi gian cc b. Date.setDate Thit lp ngy trong thng theo thi gian cc b. Tr li thi gian mi theo mili-giy. 32
Date.setFullYear Thit lp nm y theo thi gian cc b. Tr li thi gian mi theo mili-giy. Date.setHours Thit lp gi theo thi gian cc b. Tr li thi gian mi theo mili- giy. Date.setMilliseconds Thit lp s mili-giy theo thi gian cc b. Tr li thi gian mi theo mili-giy. Date.setMinutes Thit lp s pht theo thi gian cc b. Tr li thi gian mi theo mili-giy. Date.setMonth Thit lp thng theo thi gian cc b. Tr li thi gian mi theo mili-giy. Date.setSeconds Thit lp s giy theo thi gian cc b. Tr li thi gian mi theo mili-giy. Date.setTime Thit t ngy (date) theo mili-giy. Tr li thi gian mi theo mili-giy. Date.setUTCDate Thit lp ngy theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setUTCFullYear Thit lp nm theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setUTCHours Thit lp gi theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setUTCMilliseconds Thit lp s mili-giy theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setUTCMinutes Thit lp s pht theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setUTCMonth Thit lp thng theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setUTCSeconds Thit lp s giy theo thi gian quc t. Tr li thi gian mi theo mili-giy. Date.setYear Thit t nm theo thi gian cc b. Date.toString Tr li mt chui gi tr i din cho ngy v gi c lu gi trong i tng Date xc nh. Date.UTC Tr li thi s mili-giy gia na m ngy 1 thng Ging, nm 1970, gi quc t, v thi gian xc nh.
33
Constructor (Ngi xy dng) cho i tng Date object Availability Flash Player 5. Usage new Date() new Date(year, month [, date [, hour [, minute [, second [, millisecond ]]]]]) Parameters year Mt gi tr thuc khong 0 n 99 biu th khong thi gian t 1900 n nm 1999; nu khng th c bn ch s ca nm phi c ch r. month Mt s nguyn t 0 (January : thng Ging) n 11 (December: thng Mi Hai). date Mt s nguyn t 1 n 31. Thng s ny l tu chn. hour Mt s nguyn t 0 (midnight : na m) n 23 (11 p.m.). minute Mt s nguyn t 0 n 59. Thng s ny l tu chn. second Mt s nguyn t 0 n 59. Thng s ny l tu chn. millisecond Mt s nguyn t 0 n 999. Thng s ny l ty chn. Returns Mt s nguyn. Description i tng; xy dng mt i tng Date (ngy thng) mi lu gi ngy v gi hin thi, hoc ngy xc nh. Example V d sau y gi ra ngy v gi hin thi. now = new Date(); V d sau y to mt i tng ngy thng (Date object) mi cho ngy sinh nht ca Gary (Gary's birthday), August 7, 1974. gary_birthday = new Date (74, 7, 7); 34
V d sau to mt i tng Date mi, kt hp vi cc gi tr c tr li ca cc method ca i tng Date nh getMonth, getDate, v getFullYear, v trnh by chng trong trng vn bn (text field) c nh ngha bi bin dateTextField. myDate = new Date(); dateTextField = ((myDate.getMonth() + 1) + "/" + myDate.getDate() + "/" + myDate.getFullYear()); delete Availability Flash Player 5. Usage delete reference Parameters reference Tn ca bin hoc i tng loi tr. Returns Nothing. Description Ton t (Operator); ph hu i tng hoc bin c ch r bi tham s reference , v tr v true nu i tng c xa thnh cng; nu khng th tr v mt gi tr false. Ton t ny hu ch cho vic gii phng b nh c dng bi cc script. Mc d delete l mt ton t, n c dng c th nh mt pht biu (statement), nh sau: delete x; Ton t delete c th sai v tr v false nu tham s reference khng tn ti, hoc c th khng b xo. Cc i tng v thuc tnh xc nh trc, v cc bin khai bo vi var, c th khng b xa. Bn khng th dng ton t delete remove cc movie clip. Example V d sau to mt i tng, s dng n, v sau xa n sau khi khng cn dng na. account = new Object();account.name = 'Jon';account.balance = 10000;delete account; Example V d sau xa mt thuc tnh ca mt i tng. 35
// to mt i tng mi "account"account = new Object();// gn tn thuc tnh cho account account.name = 'Jon'; // xa thuc tnhdelete account.name; Example Sau y l mt v d khc ca vic xa mt thuc tnh i tng. // to mt i tng mng Array vi di 0array = new Array(); // di mng Array.length by gi l 1array[0] = "abc";// thm phn t khc vo mng,Array.length by gi l 2array[1] = "def"; // thm phn t khc vo mng,Array.length by gi l 3array[2] = "ghi";// array[2] b xa, nhng Array.length khng b thay i,delete array[2]; V d sau y minh ha hnh vi ca delete trn cc i tng lin quan (on object references): // to mt i tng mi, v gn bin ref1// tham chiu ti i tngref1 = new Object();ref1.name = "Jody";// copy bin tham kho vo trong mt bin mi// v xa ref1ref2 = ref1;delete ref1; Nu ref1 khng c sao chp thnh ref2, i tng s b xa khi ref1 b xa, bi v khng c s lin quan no ti n. Nu bn xa ref2, s khng cn bt k s lin h no ti i tng; n s b ph hy, v b nh (memory) m n s dng s li sn sng dng c. See also var duplicateMovieClip Availability Flash Player 4. Usage duplicateMovieClip(target, newname, depth) Parameters target ng dn ca movie clip nhn i (duplicate). newname Mt t nh danh (trong qun l c s d liu, y l mt t m t dng xc nh tnh duy nht ca thng tin cha trong bn ghi d liu) duy nht cho movie clip sao li (A unique identifier for the duplicated movie clip). depth Mt mc nng lc (hay mc chiu su) n nht cho movie clip bn sao (A unique depth level for the duplicated movie clip). Mc chiu su (depth level) l mt sp xp th bc (stacking order) cho cc movie clip bn sao. Sp xp th bc ny tng t nh sp xp th bc ca cc layer trong Timeline; cc movie clip vi mt mc nng lc thp hn n di cc clip c mc nng lc cao hn. Bn phi gn cho mi movie clip bn sao mt mc nng lc (hay mc chiu su) duy nht 36
ngn cn n thay th cc movie trn cc mc nng lc ang s dng (You must assign each duplicated movie clip a unique depth level to prevent it from replacing movies on occupied depths). Returns Nothing. Description Hnh vi (Action); to mt th hin ca mt movie clip trong khi movie (phim) ang c chi. Thanh playhead (y l thanh ko trong Timeline) trong cc movie clip bn sao lun lun bt u ti Frame 1, khng quan tm n playhead trong movie clip gc(hoc movie clip m "parent"). Cc bin trong movie clip gc khng c sao chp vo trong movie clip bn sao. Nu movie clip gc (parent movie clip) b xa th movie clip bn sao cng b xa. S dng hnh vi (action) hoc phng php (method) removeMovieClip xa mt movie clip th hin c to vi duplicateMovieClip. Example Pht biu (statement) ny sao li movie clip th hin (movie clip instance) flower mi ln. Bin i c s dng to mt tn minh ha (instance name) v mt chiu su duy nht (unique depth) mi cho mi movie clip bn sao. on (release) { amount = 10; while (amount>0) { duplicateMovieClip (_root.flower, "mc"+i, i); setProperty ("mc"+i, _x, random(275)); setProperty ("mc"+i, _y, random(275)); random(50)); i++; amount--; }} See also MovieClip.duplicateMovieClip, removeMovieClip, MovieClip.removeMovieClip
FCheckBox (component: thnh phn) Thnh phn CheckBox trong mi trng thit k Flash cung cp chc nng ko v th (drag-and- drop) thm cc check box (hp kim tra) vo cc ti liu Flashl; n cng cung cp mt giao din ngi dng thit lp cc tham s c bn. Cc method (phng php) ca thnh phn FCheckBox cho php bn iu khin cc check box khi chy: bn c th to cc check box, iu khin cc check box c to trong chng trnh, thit lp hoc b qua cc tham s c bn, v thit lp cc tu chn b sung khi thc hin. Bn khng cn s dng mt constructor (ngi thit k) truy cp cc method ca cc thnh phn. Thnh phn CheckBox c h tr bi Flash Player 6. Cc method thnh phn khng thc hin vic kim tra cc li cho kiu (Component methods do not perform error checking for type), nh cc i tng v hnh vi ActionScript t nhin khc; v th, 37
n khuyn bn nn ph chun xc nhn tnh hp l ca cc tham s trc khi gi chng n cc method. bit thm thng tin v vic s dng thnh phn CheckBox component, thit lp cc tham s trong sut thi gian thit k, v thay i mu sc v din mo ca cc thnh phn (component), hy xem Customizing component colors and text v Customizing component skins trong chng Using Components ca Using Flash.
Phng php tm lc cho thnh phn FCheckBox Method Description FCheckBox.getEnabled Tr li true nu hp kim tra check box c cho php, false nu n b v hiu ho. FCheckBox.getLabel Tr li nhn ng dng ti hp kim nh mt chui. FCheckBox.getValue Tr li true nu hp kim c la chn, false nu n khng c la chn. FCheckBox.registerSkinElement ng k mt phn t ngoi ti mt thuc tnh (Registers a skin element to a property). FCheckBox.setChangeHandler Ch r mt ngi iu khin thay i (change handler) c gi khi gi tr ca hp kim thay i. FCheckBox.setEnabled Xc nh xem hp kim c cho php hay b v hiu ha. FCheckBox.setLabel Ch r text cho nhn ca hp kim. FCheckBox.setLabelPlacement Ch r xem nhn xut hin ti bn tri hay bn phi ca hp kim. FCheckBox.setSize Thit lp chiu rng ca hp kim, theo pixel, v v li n. FCheckBox.setStyleProperty Thit lp mt thuc tnh style n cho mt thnh phn component. FCheckBox.setValue La chn hy b hp kim v gy ra hm iu khin thay i (Selects or deselects the check box and triggers the change handler function).
FComboBox (component) Thnh phn ComboBox (tm dch l Hp kt hp) trong mi trng thit k Flash cung cp chc nng ko-v-th cho vic thm cc danh sch la chn ring th xung c th cun c (scrollable single-selection drop-down lists : xin li cc bn v cm t ny dch hi lng cng) vo cc ti liu Flash; n cng cung cp mt giao din ngi dng cho vic thit lp cc tham s c bn. Cc 38
method (cch thc, phng php) ca thnh phn FComboBox cho php bn iu khin cc hp kt hp khi thc hin (at runtime): bn c th to cc hp kt hp combo box, iu khin cc combo box to trong trnh thit k Flash, thit t hoc ghi cc tham s c bn, v thit t cc tu chn b sung khi chy. Bn khng cn dng mt constructor (ngi xy dng) truy xut cc method ca cc thnh phn. Thnh phn ComboBox to ra c hai loi hp kt hp (combo box) tnh v c th hiu chnh c. Mt combo box tnh l mt danh sch th xung c th cun c cho php ngi dng la chn cc mc. Mt combo box c th hiu chnh c l mt danh sch th xung c th cun c vi mt trng text trn cng. Bn c th cho ngi dng nhp text vo trng text lm cho hp combo box cun ti mc yu cu, hoc bn c th s dng trng text thit t text c hin th khi chy chng trnh. C hai phin bn tnh v hiu chnh ca thnh phn ComboBox u lit k cc mc t trn xung di s dng mt h thng lit k ho trn nn c s zero (zero-based indexing system). Nu s cc mc trong danh sch combo box to mt danh sch th xung m vt qu khong trng bn di mi component (thnh phn), danh sch s m ln trn thay v th xung di. Nhng method thnh phn khng thc hin s kim tra li cho kiu , nh lm vi nhng hnh vi (action) v i tng ActionScript bm sinh khc; bi vy, khuyn bn nn thng qua (xc nhn tnh hp l) cc tham s trc khi chuyn chng ti cc method. Thnh phn ComboBox c h tr bi Flash Player 6 v cc phin bn v sau ca Flash Player. bit thm thng tin v vic s dng thnh phn ComboBox , hy thit t cc tham s trong sut qu trnh thc hnh, v thay i mu sc v hnh thc ca cc thnh phn, xem Customizing component colors and text v Customizing component skins trong chng Using Components ca S dng Flash.
Phng php tm lc cho thnh phn FComboBox Method Description FComboBox.addItem Thm mt mc mi vo cui ca danh sch combo box. FComboBox.addItemAt Thm mt mc mi vo danh sch ti mt ch mc xc nh. FComboBox.getEnabled Tr li true nu combo box c hiu lc, false nu n b v hiu ha. FComboBox.getItemAt Tr li mc (item) ti ch mc xc nh (specified index) nh mt i tng (object) vi cc thuc tnh label v data. FComboBox.getLength Tr li s cc mc lit k trong combo box. FComboBox.getRowCount Tr li s cc hng thy c trong combo box. 39
FComboBox.getScrollPosition Tr li eturns the index of the item at the top of the combo box. FComboBox.getSelectedIndex Returns the index of the currently selected item. FComboBox.getSelectedItem Returns the currently selected item as an object with the properties label and data. FComboBox.getValue Returns the text in the input field for editable combo boxes; returns the label or data of the selected item for static combo boxes. FComboBox.registerSkinElement Registers a skin element to a property. FComboBox.removeAll Removes all items from the combo box. FComboBox.removeItemAt Removes the item at the specified index. FComboBox.replaceItemAt Replaces the label and data of an item at the specified index. FComboBox.setChangeHandler Assigns a function to call each time an item is selected or the user enters text in the text field. FComboBox.setDataProvider Registers an outside object to the component as a data source. FComboBox.setEditable Determines whether the combo box is editable (true) or static (false). FComboBox.setEnabled Specifies whether the combo box is enabled (true) or disabled (false). FComboBox.setItemSymbol Registers a symbol linkage ID to use for displaying list items in the combo box. FComboBox.setRowCount Determines the number of items displayed in the combo box without a scroll bar. FComboBox.setSelectedIndex Selects the item at the specified index. FComboBox.setSize Sets the pixel width of the combo box. FComboBox.setStyleProperty Sets a single style property for an instance of a component. FComboBox.setValue Specifies the text displayed in the text field at the top of an editable combo box. FComboBox.sortItemsBy Sorts the items in the list box alphabetically or numerically by label or by data.
40
FPushButton (component) Thnh phn PushButton trong mi trng thit k Flash cung cp chc nng ko-v-th thm cc nt vo cc ti liu Flash; n cng cung cp mt giao din ngi dng cho vic thit t cc tham s c bn. Cc method ca thnh phn FPushButton cho php bn iu khin cc nt khi thc thi chng trnh: bn c th to cc nt, iu khin cc nt to trong khi thit k, thit t hoc ghi ln cc tham s c bn, v thit t cc tu chn b sung khi chy chng trnh. Bn khng cn s dng mt constructor truy lc cc method ca cc thnh phn. Thnh phn PushButton chp nhn tt c cc tng tc chut v bn phm chut. Bn c th dng cc method FPushButton xc nh mt hm iu khin cho cc push buttons, v hiu ho hoc hiu lc ho cc nt, v iu chnh kch thc cc nt m khng cn bp mo khi thc hin chng trnh (disable or enable buttons, and resize buttons without distortion at runtime). Cc method thnh phn khng thc thi cc kim tra li cho kiu, nh vi cc i tng v hnh vi ActionScript t nhin khc; v th, khuyn bn nn thng qua cc tham s trc khi chuyn chng ti cc methods. Thnh phn PushButton component c h tr bi Flash Player 6 v cc phin bn v sau ca Flash Player. bit thm thng tin v cch s dng thnh phn (component) PushButton, thit t cc tham s trong sut qu trnh thit k, v thay i mu sc v din mo ca cc components, xem Customizing component colors and text (Tu bin mu sc v text ca thnh phn) v Customizing component skins (Tu bin cc skin thnh phn) trong chng Using Components (S dng cc thnh phn) trong Using Flash.
Bng tm tt cc method cho thnh phn FPushButton Method Description FPushButton.getEnabled Tr v true nu nt c hiu lc ho, false nu n b v hiu ho. FPushButton.getLabel Tr v nhn ca nt nh mt chui. FPushButton.registerSkinElement ng k mt phn t giao din (skin element) thnh mt thuc tnh. FPushButton.setClickHandler Xc nh hm c gi khi ngi dng nh nt. FPushButton.setEnabled Quyt nh xem nt c hiu lc ho hay v hiu ho. FPushButton.setLabel Thit t nhn ca nt khi thc hin chng trnh. FPushButton.setSize Thit t chiu cao v chiu rng ca nt, theo pixels. FPushButton.setStyleProperty Thit t mt thuc tnh style (kiu dng) n cho mt thnh phn (component). 41
FRadioButton (component: thnh phn) Cc nt Radio l nhm nt c th chn c t ch mt nt c chn mt thi im. Thnh phn RadioButton component trong mi trng thit k Flash cung cp chc nng ko-v-th cho vic thm cc nhm nt radio vo cc ti liu Flash; n cng cung cp mt giao din ngi dng cho vic thit t cc tham s c bn. Cc method ca thnh phn (component) FRadioButton cho php bn iu khin cc nt radio khi chy chng trnh: bn c th to cc nt radio, iu khin cc nt radio to khi thit k, thit t hoc ghi ln cc tham s c bn, v thit t cc ty chn b sung khi chy chng trnh. Bn khng cn s dng mt constructor (trnh xy dng, ngi xy dng) truy cp cc method ca cc components. Thnh phn RadioButton component c h tr bi Flash Player 6 v cc phin bn v sau ca Flash Player. Cc method thnh phn (component methods) khng thc hin kim tra li cho kiu, nh lm vi cc i tng v hnh vi ActionScript t nhin khc; v th, khuyn bn nn xem xt lm cho hp l cc tham s trc khi chuyn chng n cho cc method. bit thm thng tin v vic s dng thnh phn RadioButton component, thit t cc tham s trong sut qu trnh thit k, v thay i mu sc v hnh thc ca cc component, xem Customizing component colors and text (ty chnh mu sc v ch ca thnh phn hp thnh) v Customizing component skins (ty chnh cc thnh phn giao din) trong chng Using Components (s dng cc thnh phn hp thnh) ca Using Flash.
Bng tm tt cc method ca FRadioButton component Method Description FRadioButton.getData Tr v mt gi tr d liu cho mt instance (trng hp, th hin) ca nt radio. FRadioButton.getEnabled Tr v true nu nt radio c hiu lc ha (cho php hot ng), false nu n b v hiu ha. FRadioButton.getLabel Tr v nhn (label) ca nt radio nh mt chui. FRadioButton.getState Tr v trng thi la chn ca mt instance ca nt radio. FRadioButton.getValue Tr v gi tr d liu ca nt radio c la chn trong mt nhm, hoc tr v nhn nu khng c d liu no c xc nh. FRadioButton.registerSkinElement ng k mt phn t giao din (skin element) thnh mt thuc tnh kiu dng (style). 42
FRadioButton.setChangeHandler Ch nh mt hm gi khi s la chn nt radio thay i. FRadioButton.setData Thit t d liu kt hp vi mt instance ca nt radio. FRadioButton.setEnabled Xc nh xem nt radio c hiu lc ha hay b v hiu ha. FRadioButton.setGroupName Xc nh mt tn nhm cho mt instance (trng hp, th hin) ca nt radio, hoc thit t mt tn mi cho mt nhm cc nt radio. FRadioButton.setLabel p dng mt nhn (label) cho nt radio khi chy chng trnh. FRadioButton.setLabelPlacement Xc nh xem nhn xut hin bn tri hay bn phi ca nt radio. FRadioButton.setSize Thit t chiu rng ca nt radio, theo pixels. FRadioButton.setState Thit t trng thi la chn ca mt instance ca nt radio. FRadioButton.setStyleProperty Thit t mt thuc tnh style (kiu dng) n cho mt instance. FRadioButton.setValue La chn mt nt radio trong mt nhm nt radio khi chy chng trnh.
FScrollBar (component) Thnh phn (component) ScrollBar trong mi trng thit k Flash cung cp chc nng ko-v-th cho vic thm cc thanh cun vo cc trng text ng v text (ch) nhp vo trong cc ti liu Flash; n cng cung cp mt giao din ngi dng cho vic thit t cc tham s c bn. Cc method (phng php, cch thc) ca thnh phn FScrollBar cho php bn iu khin cc thanh cun khi chy chng trnh: bn c th to cc thanh cun, iu khin cc thanh cun to trong khi thit k, thit t hoc ghi ln cc tham s c bn, v thit t cc ty chn b sung khi chy chng trnh. Bn khng cn s dng mt constructor (trnh xy dng) truy cp cc method ca cc component. Mt s method ca component FScrollBar khng c khuyn khch dng vi cc thanh cun km theo cc trng ch (text field). Xem cc mc t method ring l bit chi tit. Nhng ngi dng v cc lp trnh vin cao cp c th dng thnh phn ScrollBar vi cc yu t Flash khc to cc giao din ngi dng tu thch (custom user interfaces). Cc method thnh phn (component methods) khng thc hin kim tra cc li do kiu, nh cc i tng v hnh vi ActionScript thng thng khc; v th, bn nn kim tra tnh hp l ca cc tham s trc khi chuyn chng ti cc method. 43
Thnh phn (component) ScrollBar c h tr bi Flash Player 6 v cc phin bn sau ny ca Flash Player. bit thm thng tin trong vic s dng thnh phn ScrollBar component, thit t cc tham s trong sut qu trnh thit k, v thay i mu sc v hnh thc ca cc component, xem Customizing component colors and text (ty chnh cc mu sc v ch ca thnh phn) v Customizing component skins trong chng Using Components (S dng cc thnh phn) ca Using Flash.
Bng tm tt cc method ca FScrollBar component Method Description FScrollBar.getEnabled Tr v true nu thanh cun c cho php hot ng, false nu n b v hiu ha. FScrollBar.getScrollPosition Tr v mt s nguyn tng ng vi v tr hin ti ca hp cun (thumb). FScrollBar.registerSkinElement ng k mt yu t giao din (skin element) thnh mt thuc tnh xc nh cho mt skin trong layer Read Me nh v trn khung Frame 1 ca mt skin movie clip trong th vin. FScrollBar.setChangeHandler Ch nh mt hm gi mi ln v tr cun thay i. (Bn khng th dng method ny vi cc trng ch.) FScrollBar.setEnabled Xc nh xem thanh cun c hiu lc ha (true) hay b v hiu ha (false). FScrollBar.setHorizontal Xc nh xem thanh cun l ngang (true) hay dc (false). FScrollBar.setLargeScroll Xc nh s v tr cun khi ngi dng click vo rnh cun. FScrollBar.setScrollContent Ch nh instance (th hin, trng hp) ca trng ch m thanh cun c p dng. FScrollBar.setScrollPosition Thit t v tr ca hp cun nh mt s nguyn gia minPos (v tr cc tiu) v maxPos (v tr cc i). FScrollBar.setScrollProperties Thit t cc thuc tnh pageSize (kch c trang), minPos, v maxPos cho thanh cun. (Bn khng th dng method ny vi cc trng ch.) FScrollBar.setScrollTarget Ch nh mt trng ch (text field) nh ng dn (target: ch) cho thanh cun. FScrollBar.setSize Thit t di ca thanh cun, theo pixel. 44
FScrollBar.setSmallScroll Ch nh s v tr cun khi ngi dng click vo mt mi tn cun. FScrollBar.setStyleProperty Thit t mt thuc tnh style (kiu dng) n cho mt component.
FScrollPane (component) Thnh phn ScrollPane component trong mi trng thit k Flash cung cp chc nng ko-v-th cho vic thm cc cun (scroll pane) hin th (trnh by) cc movie clip trong cc ti liu Flash; n cng cung cp mt giao din ngi dng cho qu trnh thit t cc tham s c bn. Cc method (phng php, cch thc) ca component FScrollPane cho php bn iu khin cc cun khi chy chng trnh: bn c th to cc cun, iu khin cc cun to khi thit k, thit t hoc ghi ln cc tham s c bn, v thit lp cc ty chn b sung khi chy chng trnh. Bn khng cn s dng mt constructor (trnh xy dng) truy cp cc method ca nhng component. Thnh phn (component) ScrollPane cung cp cc thanh cun ngang v dc cho php bn hin th cc movie clip m khng cn tng nhiu khng gian trng ca Stage (mn hnh trnh din). Cc iu khin chut v bn phm chun u c ci t sn. Ch : Thnh phn ScrollPane ch hin th cc movie clip; thm cc thanh cun vo cc trng ch ng (dynamic text field) v trng ch nhp vo (input text field), bn s dng component ScrollBar. Thnh phn ScrollPane khng th hin th bt k ni dung no m c s dng cc device fonts (khng bit dch ci t device ny th no cho hp l----> c nguyn gc) . Cc method ca component khng thc thi vic kim tra li cho kiu, nh nhng i tng v hnh vi ActionScript thng thng khc; bi vy, bn nn kim tra tnh hp l ca cc tham s trc khi chuyn chng ti cc method. Thnh phn ScrollPane component c h tr bi Flash Player 6 v cc phin bn sau ny ca Flash Player. bit thm thng tin v vic s dng thnh phn (component) ScrollPane, vic thit t cc tham s trong sut qu trnh thit k, v thay i mu sc v hnh thc ca cc component, hy xem Customizing component colors and text (ty chnh mu sc v text ca cc component) v Customizing component skins (ty chnh b mt, giao din ca cc component) trong chng Using Components ca Using Flash.
Bng cc method tm lc cho FScrollPane component Method Description FScrollPane.getPaneHeight Tr v chiu cao ca cun. FScrollPane.getPaneWidth Tr v chiu rng ca cun. 45
FScrollPane.getScrollContent Tr v mt instance (trng hp, th hin) ca ni dung c trnh by trong cun. FScrollPane.getScrollPosition Tr v cc ta x v y ca v tr cun hin ti. FScrollPane.loadScrollContent Np mt file SWF hoc JPEG vo trong mt cun. FScrollPane.refreshPane iu chnh li kch thc ca cc thanh cun trong cun khi ni dung thay i kch c. FScrollPane.registerSkinElement ng k mt yu t b mt (skin element) thnh mt thuc tnh xc nh cho mt skin trong layer Read Me nh v trn Frame 1 ca mt skin movie clip trong th vin. FScrollPane.setDragContent Thit t ni dung ca cun thnh c kh nng ko (di chuyn con tr chut trong khi vn n v gi phm trn chut). FScrollPane.setHScroll Thit t kiu dng cun ngang ( horizontal scrolling style) cho cun. FScrollPane.setScrollContent Thit t mt movie clip thnh cun ch (scroll pane target). FScrollPane.setScrollPosition Lm cho cun ti cc ta x, y c ch nh trc. FScrollPane.setSize Thit t chiu rng v chiu cao ca cun, theo pixel. FScrollPane.setStyleProperty Thit t mt thuc tnh style (kiu dng) n cho mt component. FScrollPane.setVScroll Thit t style cun n ca cun.
FStyleFormat (object) i tng FStyleFormat cho php bn thit t hoc thay i cc thuc tnh trong nh dng kiu dng chung (global style format) gn cho tt c cc thnh phn giao din Flash UI components theo mc nh, hoc to cc custom style formats (cc nh dng kiu dng do ngi dng t to) s dng vi cc Flash UI components hoc cc custom components m bn to hoc c c t cc ngun khc. nh dng kiu dng chung, hoc i tng globalStyleFormat, l mt instance (th hin) ca i tng FStyleFormat m xc nh cc thuc tnh mu sc v nh dng ch vit dng hin th tt c cc thnh phn Flash UI components. to mt custom style format mi, bn to mt instance (th hin) ca i tng FStyleFormat s dng constructor (ngi xy dng) new FStyleFormat(), thit t cc thuc tnh FStyleFormat m bn mun km theo trong nh dng kiu dng ca bn, v sau dng method FStyleFormat.addListener ng k cc component instances thnh mt nh dng kiu dng (style format) mi. Mt th hin ca thnh phn hp thnh (a component instance) c th "listen" 46
(ch ny chng bt dch th no c, dch tm l nghe vy nha) nhiu style format, nhng ch c th ly gi tr ca mt style format cho mt thuc tnh c th. Nu bn thm mt component (thnh phn hp thnh) nh mt listener (???) thnh mt nh dng kiu dng (style format), n s s dng dng style mi cho cc thuc tnh c ch nh trong nh dng, v n dng dng style c cho tt c cc thuc tnh khc. Bn khng cn dng constructor (ngi xy dng) FStyleFormat thm hoc g b cc listeners hoc thit t hoc thay i cc thuc tnh trong nh dng kiu dng chung bi v i tng globalStyleFormat tn ti ngay khi bt k thnh phn giao din Flash UI component c t trn Stage. Bn c th thit t bt k thuc tnh no trong cc thuc tnh FStyleFormat cho mt instance n ca mt component s dng method setStyleProperty c sn cho tt c cc Flash UI components. Vic s dng setStyleProperty cho php bn thit t mt thuc tnh cho mt component m khng phi to mt instance ca i tng FStyleFormat. Vic s dng method setStyleProperty ghi ln thit t cho mt thuc tnh dng style c th gn cho component m khng phi thay i cc thit t cho nhng thuc tnh khc. bit thm thng tin, xem mc t setStyleProperty cho cc component ring l. Khi gn mt gi tr mu vo mt thuc tnh FStyleFormat, ch nh mt mu RGB theo nh dng 0xRRGGBB. bit thm thng tin v nh dng kiu dng chung v to cc nh dng kiu dng ty chn, xem Customizing component colors and text trong chng Using Components ca Using Flash.
Method summary for the FStyleFormat object Method Description FStyleFormat.addListener ng k mt component thnh mt style format. FStyleFormat.applyChanges p dng nhng thay i lm vo cc gi tr thuc tnh trong mt style format. FStyleFormat.removeListener G b mt component nh mt listener thnh mt style format.
Bng tm tt cc thuc tnh cho i tng FStyleFormat Bng sau lit k tm tt cc thuc tnh cho i tng FStyleFormat. Property Description FStyleFormat.arrow Mu sc ca mi tn dng trong cc thanh cun v cc danh sch th xung. 47
FStyleFormat.background Mu sc phn nn pha sau ca mt thnh phn (component). FStyleFormat.backgroundDisabled Mu sc phn nn sau ca mt component b v hiu ha. FStyleFormat.check Mu sc ca du chn nh du trong mt hp kim c chn. FStyleFormat.darkshadow Mu sc ng vin trong hoc phn bng ti ca mt component. FStyleFormat.face Mu sc chnh ca component. FStyleFormat.foregroundDisabled Mu tin cnh ca mt component b v hiu ha. FStyleFormat.highlight Mu sc cho vin trong hoc phn bng ti ca mt component khi n c la chn. FStyleFormat.highlight3D Mu sc cho vin ngoi hoc phn bng sng ca mt component khi n c la chn. FStyleFormat.radioDot Mu sc ca chm bn trong mt nt radio c la chn. FStyleFormat.scrollTrack Mu sc ca rnh (track) trong mt thanh cun. FStyleFormat.selection Mu sc ca thanh chn lm ni bt (highlighting: lm ni bt, t sng) mt danh sch mc trong mt component. FStyleFormat.selectionDisabled Mu sc ca mt thanh chn (selection bar) m t sng mt danh sch mc trong mt component b v hiu ha. FStyleFormat.selectionUnfocused Mu sc ca mt thanh chn khi component khng c trng tm vo bn phm (does not have key board focus). FStyleFormat.shadow Mu sc ca vin ngoi hoc phn bng sng ca mt component. FStyleFormat.textAlign S canh l (left: tri, right: phi, hoc center: gia) cho ch (text) trnh by trong hoc trn mt component. FStyleFormat.textBold Xc nh xem ch l m (true) hay khng (false). FStyleFormat.textColor Mu ch mc nh trong tt c cc component gn cho nh dng kiu dng (style format). FStyleFormat.textDisabled Mu sc ca ch trong mt component b v hiu ha. 48
FStyleFormat.textFont Tn ca font hin th ch. FStyleFormat.textIndent S tht dng ca ch t l tri n k t text u tin, theo pixel. FStyleFormat.textItalic Xc nh xem ch c in nghing (true) hay khng (false). FStyleFormat.textLeftMargin L tri ca on vn cho text, theo pixels. FStyleFormat.textRightMargin L phi ca on vn cho text, theo pixel. FStyleFormat.textSelected Mu sc ca mt danh sch mc la chn trong mt component. FStyleFormat.textSize Kch c ca ch, theo point (1 point = 1/72 inch). FStyleFormat.textUnderline Xc nh xem ch c c gch chn (true) hay khng (false).
Constructor (ngi xy dng) cho i tng FStyleFormat Availability Flash Player 6. Usage new FStyleFormat() Parameters None. Returns Mt instance ca i tng FStyleFormat. Description Method (phng php, cch thc); to mt i tng FStyleFormat mi. Bn to cc i tng FStyleFormat mi nh ngha cc thuc tnh ch vit (text) v mu sc cho cc custom style formats (cc nh dng kiu dng do ngi dng to ra) dng vi cc custom components hoc vi cc thnh phn giao din Flash UI components. Tt c cc thnh phn giao din Flash UI components c gn mc nh l globalStyleFormat, y l mt instance (th hin) ca i tng FStyleFormat. Bn khng cn to mt instance mi ca i tng FStyleFormat thay i 49
cc thuc tnh trong nh dng kiu dng chung (global style format), bi v n hin nhin tn ti. Bn cng c th dng setStyleProperty thay i cc thuc tnh cho cc instance ca component c th m khng s dng mt constructor. bit thm thng tin, xem method setStyleProperty c sn i vi mi component FCheckBox.setStyleProperty, FComboBox.setStyleProperty, v nhiu method khc. Ngoi ra bn nn xem Customizing component colors and text ca chng Using Components ca Using Flash. Example Mu sau y to nh dng kiu dng mi formStyleFormat. formStyleFormat = new StyleFormat();
Function (object) : Hm (i tng) i tng Function c sn trong Flash MX.
Bng tm tt cc thuc tnh cho i tng hm Function object Method Description Function.prototype cp ti mt i tng m l mu ban u (prototype) cho mt lp (class).
Bng tm lc cc method cho i tng Function object Method Description Function.apply Hiu lc ho m ActionScript gi mt hm. Function.call Vin dn (gi) hm c m t li bi mt i tng Function object. Function.prototype Availability Flash Player 6. Usage myFunction.prototype 50
Description Property (thuc tnh); trong mt hm xy dng (constructor function), thuc tnh prototype (mu ban u) cp ti mt i tng l mu ban u ca lp c xy dng. Mi th hin (instance) ca lp u c to bi hm xy dng tha k tt c cc thuc tnh v method t i tng mu ban u. fscommand Availability Flash Player 3. Usage fscommand("command", "parameters") Parameters command Mt chui chuyn ti trnh ng dng my ch (host application) cho bt k s dng hoc mt lnh chuyn ti trnh Flash Player c lp. parameters Mt chui chuyn n trnh ng dng my ch cho bt k s dng hoc mt gi tr chuyn ti Flash Player. Returns Nothing. Description Action (hnh vi); cho php Flash movie truyn t (communicate) vi c trnh Flash Player, hoc chng trnh c km theo Flash Player, chng hn nh mt trnh duyt Web browser. Bn cng c th s dng hnh vi fscommand chuyn cc tin nhn (messages) ti Macromedia Director, hoc ti Visual Basic, Visual C++, v cc chng trnh khc c th host cc iu khin ActiveX. Cch dng 1: gi mt message ti Flash Player, bn phi dng cc lnh v tham s c nh ngha trc. Bng sau cho thy nhng gi tr m bn c th ch nh cho cc tham s command v parameters ca hnh vi fscommand iu khin mt phim movie trnh din trong trnh ng dng c lp Flash player (k c cc projectors : cc file .exe to bi Flash): Command Parameters Purpose quit None ng projector. fullscreen true hoc false Vic ch nh l true thit t Flash Player thnh ch ton mn hnh full-screen. Ch nh l false tr trnh player v ch bnh thng nhn thy thc n menu iu khin. 51
allowscale true hoc false Vic ch nh l false thit t player movie lun lun c trnh by nh kch thc gc ca n v khng bao gi co dn (b thay i kch thc). Ch nh l true bt buc movie phi thay i kch thc bng 100% kch thc ca player. showmenu true hoc false Vic ch nh l true lm cho thit lp y ca cc mc thc n ng cnh c hin th (thc n File, View, Control, Help... trn thanh menu trn cng ca Flash Player v khi bn click chut phi vo trnh Flash Player). Ch nh l false lm m i (bn s khng nhn thy c) tt c cc mc trn trnh n ng cnh ngoi tr About Flash Player. exec ng dn ti trnh ng dng Chy mt trnh ng dng t bn trong projector. trapallkeys true hoc false Vic ch nh l true gi tt c cc s kin phm, k c cc phm gia tc (accelerator keys), ti trnh iu khin onClipEvent(keyDown/keyUp) trong Flash Player.
Cch dng 2: S dng hnh vi fscommand gi mt message ti mt ngn ng kch bn (scripting language) nh l JavaScript trong mt Web browser, bn c th chuyn hai tham s bt k trong cc tham s command (lnh) v parameters (thng s). Nhng tham s ny c th l cc chui hoc cc biu thc c dng trong mt hm JavaScript "catches," (ly) hoc iu khin, hnh vi fscommand . Trong mt Web browser, hnh vi fscommand gi hm JavaScript moviename_DoFScommand trong trang HTML ang cha Flash movie. Tham s moviename l tn ca Flash Player c gn bi thuc tnh NAME (tn) ca th EMBED hoc c tnh ID ca th OBJECT tag. Nu bn gn cho Flash Player tn myMovie, hm JavaScript c gi l myMovie_DoFScommand. Cch dng 3: Hnh vi fscommand c th gi cc message ti Macromedia Director m c gii thch bi Lingo nh strings (cc chui), events (cc s kin), hoc m Lingo c th thc thi c. Nu message l mt chui hoc mt s kin, bn phi vit m Lingo code tip nhn message t hnh vi fscommand v mang thc hin mt hnh vi action trong Director. tm hiu thm thng tin, xem Director Support Center. Cch dng 4: Trong Visual Basic, Visual C++, v cc chng trnh khc m c th thc hin (host) cc iu khin ActiveX, fscommand gi mt s kin VB vi hai chui m c th c iu khin trong mi trng ngn ng lp trnh. tm hiu thm thng tin, dng t kho Flash method tm kim Flash Support Center. Example Cch dng 1: Trong v d sau, hnh vi fscommand thit t trnh Flash Player co dn movie thnh kch c ton mn hnh khi nt c nh ra (release). 52
on(release){ fscommand("fullscreen", true); } Cch dng 2: V d sau dng hnh vi fscommand p dng cho mt nt trong Flash m mt hp message JavaScript trong mt trang HTML. Bn thn message c gi ti JavaScript nh tham s fscommand. Bn phi thm mt hm vo trang HTML c cha Flash movie. Hm ny, myMovie_DoFSCommand t trong trang HTML v ch i mt hnh vi fscommand trong Flash. Khi no mt fscommand c khi s trong Flash (v d, khi mt ngi dng nhn nt), cc chui command v parameter c chuyn ti hm myMovie_DoFSCommand. Bn c th dng cc chui chuyn n trong m JavaScript hoc VBScript ca bn theo bt k cch no m bn thch. Trong v d ny, hm cha mt cu lnh iu kin if kim tra vic quan st nu chui lnh l "messagebox". Nu l n, mt JavaScript alert box (hay "messagebox") m ra v hin th ni dung ca chui parameters. function myMovie_DoFSCommand(command, args) { if (command == "messagebox") { alert(args); } } Trong ti liu Flash, thm mt hnh vi fscommand vo mt nt: fscommand("messagebox", "ay la mot hop message duoc goi tu ben trong Flash.") Bn cng c th dng cc biu thc cho hnh vi v cc tham s fscommand, nh trong v d sau: fscommand("messagebox", "Xin chao, " + name + ", Chao mung ban vao tham Web site cua chung toi!") kim tra movie, chn File > Publish Preview > HTML. Ch : Nu bn xut bn movie ca bn bng cch s dng Flash vi khun mu (template) FSCommand trong HTML Publish Settings, hm myMovie_DoFSCommand c chn vo mt cch t ng. Cc thuc tnh NAME v ID ca movie s l tn file. V d, cho file myMovie.fla, cc thuc tnh s c thit lp l myMovie. function Availability Flash Player 5. Usage function functionname ([parameter0, parameter1,...parameterN]){ statement(s) } function ([parameter0, parameter1,...parameterN]){ 53
statement(s) } Parameters functionname Tn ca hm mi. parameter Mt t nh danh i din cho mt tham s chuyn ti hm. Cc tham s ny l tu chn. statement(s) Bt k lnh ActionScript m bn nh ngha cho phn thn ca function. Returns Nothing. Description Action (hnh vi); mt thit t ca cu lnh m bn nh ngha thc hin mt nhim v no . Bn c th trnh by, hoc nh ngha, mt hm trong mt v tr xc nh v gi, hoc vin dn n t cc script khc nhau trong mt movie. Khi bn nh ngha mt hm, bn cng c th ch nh cc tham s cho hm. Cc tham s l trnh gi ch (placeholders) cho cc gi tr m hm iu khin. Bn c th chuyn cc tham s khc nhau ti mt hm mi ln bn gi n. iu ny cho php bn dng li mt hm trong nhiu hon cnh khc nhau. S dng hnh vi return trong statement(s) (cu lnh) ca mt hm to ra mt hm tr li, hoc to, mt gi tr. Cch dng 1: Biu th mt hm function vi functionname (tn hm), parameters (cc tham s), v statement(s)(cc cu lnh) xc nh. Khi mt hm c gi, vic khai bo hm c vin dn. S gii thiu tip ti c cho php (Forward referencing is permitted); bn trong cng danh sch Action, mt hm c th c cng khai sau khi n c gi. Mt hm cng b thay th (function declaration) thay th bt k tuyn b trc ca cng hm (replaces any prior declaration of the same function). Bn c th dng c php ny bt c khi no mt khai bo c tha nhn (You can use this syntax wherever a statement is permitted). Cch dng 2: To mt hm nc danh v tr n v. C php ny c dng trong cc biu thc, v c bit hu ch cho vic ci t cc method trong cc i tng. Example Cch dng 1: V d sau nh ngha hm sqr, l hm chp nhn mt tham s v tr v bnh phng square(x*x) ca tham s. Ch rng nu hm c cng khai v c dng trong cng script, s cng b hm c th xut hin sau khi dng hm. y=sqr(3);
function sqr(x) { return x*x; 54
} Cch dng 2: Hm sau y nh ngha mt i tng Circle (hnh trn): function Circle(radius) { this.radius = radius; } Khai bo sau nh ngha mt hm nc danh tnh ton din tch ca mt hnh trn v gn n cho i tng Circle nh mt method: Circle.prototype.area = function () {return Math.PI * this.radius * this.radius}
getProperty Availability Flash Player 4. Usage getProperty(instancename , property) Parameters instancename Tn minh ha ca mt movie clip cho ci m thuc tnh ang c gi (The instance name of a movie clip for which the property is being retrieved). property Mt thuc tnh ca mt movie clip. Returns Nothing. Description Hm (Function); tr li gi tr ca thuc tnh xc nh property cho movie clip instancename. Example on m sau gi trc ta ngang (_x) cho movie clip myMovie v gn n cho bin myMovieX: myMovieX = getProperty(_root.myMovie, _x);
getTimer 55
Availability Flash Player 4. Usage getTimer() Parameters None. Returns Nothing. Description Hm; tr li s mili-giy (mt phn nghn giy) tri qua k t khi movie bt u chi. getURL Availability Flash 2. Cc ty chn GET (ly) v POST (gi, b sung d liu) ch c c hiu lc s dng trong Flash Player 4 v cc phin bn v sau ca Player. Usage getURL(url [, window [, "variables"]]) Parameters url a ch URL (a ch ti mt trm Internet hay mng ni b) m cha ti liu. window Mt tham s ty chn ch nh ca s (window) hoc HTML frame m ti liu s np vo trong. Bn c th nhp tn ca mt ca s xc nh hoc chn t cc tn c sn sau:
_self ch nh frame hin ti trong ca s hin ti.
_blank ch nh mt ca s mi.
_parent ch nh parent (m) ca frame hin ti.
_top ch nh frame c mc cao nht (top-level frame) trong ca s hin ti. variables Mt method GET hoc POST cho vic gi cc bin. Nu khng c bin no, b qua tham s ny. Method GET b sung cc bin vo cui ca URL, v c dng cho s bin nh. Method POST gi cc bin trong mt u HTTP c ngn cch v c dng gi cc chui di ca bin. 56
Returns Nothing. Description Action (hnh vi); np mt ti liu t mt URL xc nh vo trong mt ca s hoc chuyn cc bin ti mt trnh ng dng khc ti mt URL c xc nh. kim tra hnh vi ny, hy chc chn rng file c np t mt v tr xc nh. s dng mt a ch URL tuyt i (v d, http://www.myserver.com), bn cn mt kt ni vo mng my tnh. Example V d ny np mt a ch URL mi vo trong mt ca s trnh duyt trng (blank browser window). Hnh vi getURL nhm ti bin incomingAd nh tham s url vi kt qu l bn c th thay i a ch URL np m khng phi chnh sa Flash movie. Gi tr ca bin incomingAd c chuyn vo trong Flash nhanh hn movie s dng mt hnh vi loadVariables. on(release) { getURL(incomingAd, "_blank"); } See also loadVariables, XML.send, XML.sendAndLoad, XMLSocket.send _global Availability Flash Player 6. Usage _global.identifier Parameters None. Returns Mt tham chiu ti i tng chung (global object) nm gi phn li ca cc lp ActionScript, nh l String (chui), Object (i tng), Math (ton), v Array (mng). Description Identifier (t nh danh); to cc bin, i tng, hoc lp chung. V d, bn c th to mt th vin c t vo nh mt i tng ActionScript chung, ging nh i tng Math hoc Date. Khc 57
vi Timeline-cng khai hoc mang tnh cc b-cng khai cc bin v hm, cc bin v hm chung u nhn thy c trong mi Timeline v phm vi trong Flash movie, min l chng khng b lm m i bi cc t nh danh cng tn vi cc phm vi bn trong. Example V d sau to mt hm mc cao nht factorial c hiu lc vi mi Timeline v phm vi (scope) trong mt Flash movie: _global.factorial = function (n) { if (n <= 1) { return 1; } else { return n * factorial(n-1); } } See also var, set variable
Key (object) i tng Key (phm) l mt i tng cao cp m bn c th truy cp (access) m khng cn s dng mt constructor (trnh xy dng). S dng cc method (phng php) ca i tng Key to mt giao din m c th c iu khin bi mt ngi dng vi mt bn phm chun. Cc thuc tnh ca i tng Key object l nhng hng s i din cho cc phm vn hu nh thng xuyn c s dng iu khin cc tr chi. bit mt danh sch y ca cc gi tr m phm, hy xem ph lc Keyboard Keys and Key Code Values (Cc phm trn bn phm v cc gi tr m phm) trong phn Using Flash. Example on script sau y s dng i tng Key nhn bit cc phm trn bn phm bt k ngi s dng c th iu khin mt movie clip. onClipEvent (enterFrame) { if(Key.isDown(Key.RIGHT)) { this._x=_x+10; } else if (Key.isDown(Key.DOWN)) { this._y=_y+10; } }
Tm tt cc method ca i tng Key object Method Description Key.addListener ng k mt i tng tip nhn thng bo khi cc method 58
onKeyDown v onKeyUp c vin dn. Key.getAscii Tr v gi tr ASCII ca phm cui cng nhn. Key.getCode Tr v m phm tng trng (virtual key code) ca phm cui cng nhn. Key.isDown Tr v true nu phm xc nh trong tham s c nhn. Key.isToggled Tr v true nu phm Num Lock hoc Caps Lock c kch hot. Key.removeListener G b mt i tng m trc ng k vi addListener.
Tm tt cc thuc tnh ca i tng Key object Tt c cc thuc tnh cho i tng Key u l cc hng s. Property Description Key.BACKSPACE Hng s kt hp vi gi tr m phm (key code value) cho phm Backspace (8). Key.CAPSLOCK Hng s kt hp vi gi tr m phm i din cho phm Caps Lock (20). Key.CONTROL Hng s kt hp vi gi tr m phm i din cho phm Control (17). Key.DELETEKEY Hng s kt hp vi gi tr m phm i din cho phm Delete (46). Key.DOWN Hng s kt hp vi gi tr m phm i din cho phm mi tn xung Down Arrow (40). Key.END Hng s kt hp vi gi tr m phm i din cho phm End (35). Key.ENTER Hng s kt hp vi gi tr m phm i din cho phm Enter (13). Key.ESCAPE Hng s kt hp vi gi tr m phm i din cho phm Escape (27). Key.HOME Hng s kt hp vi gi tr m phm i din cho phm Home (36). Key.INSERT Hng s kt hp vi gi tr m phm i din cho phm Insert (45). Key.LEFT Hng s kt hp vi gi tr m phm i din cho phm mi tn tri Left Arrow (37). Key.PGDN Hng s kt hp vi gi tr m phm i din cho phm Page Down (34). Key.PGUP Hng s kt hp vi gi tr m phm i din cho phm Page Up (33). Key.RIGHT Hng s kt hp vi gi tr m phm i din cho phm mi tn sang phi Right 59
Arrow (39). Key.SHIFT Hng s kt hp vi gi tr m phm i din cho phm Shift (16). Key.SPACE Hng s kt hp vi gi tr m phm i din cho phm Spacebar (32). Key.TAB Hng s kt hp vi gi tr m phm i din cho phm Tab (9). Key.UP Hng s kt hp vi gi tr m phm i din cho phm mi tn ln Up Arrow (38).
Listener summary for the Key object Method Description Key.onKeyDown c thng bo khi mt phm c nhn Key.onKeyUp c thng bo khi mt phm c nh (release). LoadVars (object) {Np cc bin (i tng)} i tng LoadVars l mt s la chn n hnh vi loadVariables chuyn giao cc bin gia mt Flash movie v mt my ch server. Bn c th s dng i tng LoadVars thu c cc thng tin li, cc s ch tin trnh, v d liu stream trong khi n ang ti xung. i tng LoadVars lm vic tng t nh i tng XML; n s dng cc method load, send, v sendAndLoad giao tip vi mt server. im khc nhau c bn gia i tng LoadVars v i tng XML l ch LoadVars tn v cc cp gi tr ActionScript, hn l mt cy XML DOM tree ct gi trong i tng XML. i tng LoadVars cng theo cng nhng hn ch bo mt nh i tng XML. Bn phi s dng constructor new LoadVars() to mt instance (th hin) ca i tng LoadVars trc khi gi cc method ca n. i tng LoadVars c h tr bi Flash Player 6 v cc phin bn sau .
Bng tng quan cc method cho i tng LoadVars Method Description LoadVars.load Ti xung cc bin t mt a ch URL xc nh. LoadVars.getBytesTotal Tr v s byte np t mt method load hoc sendAndLoad. 60
LoadVars.getBytesTotal Tr v tng s byte m s c ti xung bi mt method load hoc sendAndLoad. LoadVars.send Gi cc bin t mt i tng LoadVars ti mt a ch URL. LoadVars.sendAndLoad Gi cc bin t mt i tng LoadVars ti mt a ch URL v ti xung s tr li ca server ti mt i tng ch (target object). LoadVars.toString Tr v mt a ch URL m ha chui m cha tt c cc bin c th lit k trong i tng LoadVars.
Bng tng quan cc thuc tnh cho i tng LoadVars Tt c cc thuc tnh cho i tng Key u l nhng hng s. Property Description LoadVars.contentType Cho bit kiu MIME ca d liu LoadVars.load Mt gi tr logic Boolean cho bit xem mt thao tc load hoc sendAndLoad c hon thnh hay cha.
Bng tng quan cc s kin cho i tng LoadVars Method Description LoadVars.onLoad Vin dn khi mt thao tc load (np) hoc sendAndLoad (gi v np) c hon thnh.
Constructor (ngi xy dng) cho i tng LoadVars Availability Flash Player 6. Usage new LoadVars() 61
Parameters None. Returns Nothing. Description Constructor (trnh xy dng); to mt instance (th hin, minh ha) ca i tng LoadVars. Sau bn c th s dng cc method ca i tng LoadVars gi v np d liu. Example V d sau to mt instance ca i tng LoadVars gi myLoadVars: myLoadVars = new LoadVars(); _level Availability Flash Player 4. Usage _levelN Description Property (thuc tnh); mt tham chiu ti Timeline ca movie gc ca _levelN. Bn phi dng hnh vi loadMovieNum np cc movie vo trong trnh Flash Player trc khi bn s dng thuc tnh _level hng ti chng. Bn c th dng _levelN hng (target) ti mt movie c np ti level (mc) gn bi N. Movie ban u np vo trong mt instance (th hin) ca Flash Player c t ng np vo trong _level0. Movie trong _level0 thit t tc frame, mu nn, v kch thc cc frame i vi tt c cc movie c np sau . Cc movie sau c xp ngn trong cc mc (level) c s ln hn trn movie trong _level0. Bn phi gn mt level vo mi movie m bn np vo trong Flash Player s dng hnh vi loadMovieNum . Bn c th gn cc mc trong bt k th bc no. Nu bn gn mt level m cha mt file SWF (bao gm c _level0) movie ti level m b unload v thay th bi mt movie mi. Example 62
V d sau dng u playhead trong Timeline chnh ca movie bn trong _level9. _level9.stop(); V d sau gi playhead trong Timeline chnh ca movie trong _level4 ti frame 5. Movie trong _level4 phi c np trc vi mt hnh vi loadMovieNum. _level4.gotoAndStop(5); See also loadMovie, MovieClip.swapDepths Math (object) i tng Math l mt i tng cp cao nht m bn c th truy xut m khng dng mt constructor (ngi xy dng). S dng cc method v cc thuc tnh ca i tng ny truy xut (access) v vn dng cc hm v hng s ton hc. Tt c cc thuc tnh v method ca i tng Math u tnh, v phi c gi s dng c php Math.method(parameter) hoc Math.constant. Trong ActionScript, cc hng s c xc nh vi chnh xc ln nht ca gp i- chnh xc IEEE-754 ch s thp phn. Mt s method ca i tng Math nhn radian ca mt gc nh mt tham s. Bn c th dng phng trnh di y tnh ton cc gi tr radian, hoc n gin chuyn qua phng trnh (nhp vo mt gi tr theo ) cho thng s radian. tnh ton mt gi tr radian, dng cng thc sau: radian = Math.PI/180 * degree Sau y l mt v d ca vic chuyn i mt phng trnh thnh nh mt tham s tnh sin ca mt gc 45 : Math.SIN(Math.PI/180 * 45) cng ging ht nh Math.SIN(.7854) i tng Math c h tr y trong Flash Player 5. Trong Flash Player 4, bn c th s dng cc method cho i tng Math , nhng chng cnh tranh vi vic dng cc php xp x v c th khng chnh xc nh cc hm ton hc khng xung t c h tr bi Flash Player 5.
Bng tm lc cc method ca i tng Math object Method Description Math.abs Tnh ton mt gi tr tuyt i. Math.acos Tnh ton mt cung cosin. 63
Math.asin Tnh ton mt cung sin. Math.atan Tnh ton mt cung tang. Math.atan2 Tnh ton mt gc t trc x n im. Math.ceil Lm trn mt s ln s nguyn gn nht. Math.cos Tnh cosin. Math.exp Tnh ton mt gi tr m. Math.floor Lm trn mt s xung s nguyn gn nht. Math.log Tnh ton mt loga t nhin. Math.max Tr li s ln ca hai s nguyn. Math.min Tr li s nh hn trong hai s nguyn Math.pow Computes x raised to the power of the y. Math.random Tr li mt s gi ngu nhin gia 0.0 v 1.0. Math.round Lm trn thnh s nguyn gn nht Math.sin Tnh mt sin. Math.sqrt Tnh ton mt s cn bnh phng. Math.tan Tnh tang.
Bng tm lc cc thuc tnh ca i tng Math object Tt c cc thuc tnh (properties) cho i tng Math u l cc hng s. Property Description Math.E Hng s Euler v c s ca loga t nhin (khong 2.718). Math.LN2 Loga t nhin ca 2 (khong 0.693). Math.LOG2E Loga c s 2 ca e (khong 1.442). Math.LN10 Loga t nhin ca 10 (khong 2.302). Math.LOG10E Loga c s 10 ca e (khong 0.434). Math.PI T l gia chu vi ca mt ng trn vi ng knh ca n (khong 3.14159). 64
Math.SQRT1_2 S nghch o ca cn bc hai ca 1/2 (khong 0.707). Math.SQRT2 S cn bc hai ca 2 (khong 1.414).
Mouse (object) {Con tr chut (i tng)} i tng Mouse l mt i tng cp cao cho php bn truy cp m khng cn s dng mt constructor (trnh xy dng). Bn c th s dng cc method ca i tng Mouse n v hin con tr (cursor) trong movie. Con tr chut c nhn thy theo mc nh, nhng bn c th n n i v b sung mt con tr do bn to bnngf cch s dng mt movie clip.
Bng tm lc cc method ca i tng Mouse Method Description Mouse.addListener ng k mt i tng tip nhn thng bo onMouseDown, onMouseMove, v onMouseUp . Mouse.hide n con tr chut trong movie. Mouse.removeListener G b mt i tng m c ng k vi method addListener. Mouse.show Hin th con tr chut trong movie.
Bng tm lc cc Mouse listener Method Description MovieClip.onMouseDown Thng bo khi nt bm chut c nhn xung. MovieClip.onMouseMove Thng bo khi nt bm chut c di chuyn. MovieClip.onMouseUp Thng bo khi nt bm chut c nh ra (release).
MovieClip (object) Cc method cho i tng MovieClip cung cp tnh nng tng t nh cc action hng ti cc movie clip. Cng c c cc method b sung m khng c cc action tng t trong hp cng c Actions toolbox trong Actions panel. Bn khng cn s dng mt method xy dng (constructor method) gi cc method ca i tng MovieClip; thay v th, bn tham chiu cc instance movie clip bi tn, s dng c php sau: 65
myMovieClip.play();myMovieClip.gotoAndPlay(3);
Bng tng quan cc method cho i tng MovieClip object Method Description MovieClip.attachMovie nh km mt movie trong th vin (library). MovieClip.createEmptyMovieClip To mt movie clip rng. MovieClip.createTextField To mt trng text rng. MovieClip.duplicateMovieClip Sao chp movie clip ch nh. MovieClip.getBounds Tr v cc ta x v y nh nht v ln nht ca mt movie trong mt khong ta xc nh. MovieClip.getBytesLoaded Tr v s byte np cho movie clip ch nh. MovieClip.getBytesTotal Tr v kch c ca movie clip theo byte. MovieClip.getDepth Tr v dy ca mt movie clip. MovieClip.getURL Truy lc mt ti liu t mt a ch URL. MovieClip.globalToLocal Chuyn i i tng tr (point object) t cc ta Stage thnh cc ta cc b ca movie clip ch nh. MovieClip.gotoAndPlay Gi u chy playhead ti mt frame xc nh trong movie clip v trnh din movie. MovieClip.gotoAndStop Gi u chy playhead ti mt frame xc nh trong movie clip v dng movie li. MovieClip.hitTest Tr v true nu khung gii hn ca movie clip ch nh giao vi khung gii hn ca movie clip ch (target movie clip). MovieClip.loadMovie Np movie ch nh vo trong movie clip. MovieClip.loadVariables Np cc bin t mt a ch URL hoc v tr khc vo trong movie clip. MovieClip.localToGlobal Chuyn i mt i tng Point object t cc ta cc b ca movie clip thnh cc ta Stage chung. MovieClip.nextFrame Gi u chy playhead ti frame k tip ca movie clip. MovieClip.play Trnh din movie clip ch nh. MovieClip.prevFrame Gi u chy playhead n frame lin trc ca movie 66
clip. MovieClip.removeMovieClip G b movie clip t Timeline nu n c to bi action duplicateMovieClip hoc method attachMovie. MovieClip.setMask Ch nh mt movie clip nh mt lp mt n (mask) cho movie clip khc. MovieClip.startDrag Ch nh mt movie clip c kh nng ko (draggable) v bt u ko movie clip. MovieClip.stop Dng movie ang trnh din. MovieClip.stopDrag Dng vic ko bt k movie clip no ang c ko. MovieClip.swapDepths i mc dy (depth level) ca hai movie. MovieClip.unloadMovie G b mt movie m c np bi hnh vi loadMovie.
Drawing method summary cho MovieClip Method Description MovieClip.beginFill Bt u v (drawing) mt fill (vng ha hin th tt c cng mt mu hoc cng mt mu) trn Stage. MovieClip.beginGradientFill Bt u v mt khong y chnh lch (gradient fill: trong ha vi tnh, khong y bao gm mt s kt hp hi ha t t mu u tin ti mu cui cng) trn Stage. MovieClip.clear G b tt c cc lnh v kt hp vi mt movie clip instance. MovieClip.curveTo V mt ng cong bng cch s dng kiu ng thng sau cng (Draws a curve using the latest line style). MovieClip.endFill Kt thc fill xc nh bi beginFill hoc beginGradientFill. MovieClip.lineStyle Xc nh nt ca cc ng (stroke of lines) to bi cc method lineTo v curveTo. MovieClip.lineTo V mt ng k bng cch s dng kiu ng (line style) hin ti. MovieClip.moveTo Di chuyn v tr ang v hin ti ti cc ta xc nh. 67
Bng tng quan cc thuc tnh cho i tng MovieClip object Property Description MovieClip._alpha Gi tr trong sut ca mt movie clip instance. MovieClip._currentframe S ca frame m ti u chy playhead ang c nh v. MovieClip._droptarget ng dn tuyt i trong k hiu c php vch xin (slash syntax notation) ca instance movie clip trn mt movie clip c kh nng ko (graggable) c th (was dropped). MovieClip.enabled Cho bit xem mt nt movie clip (button movie clip) c c hiu lc ha, cho php hot ng hay khng. MovieClip.focusEnabled Hiu lc ha mt movie clip tip nhn tiu im. MovieClip._focusrect Cho bit xem mt movie clip c t tiu im c mt hnh ch nht mu vng bao quanh n hay khng. MovieClip._framesloaded S cc frame c np t mt streaming movie (d liu movie lu tr trong mt dng thc cho php phn u ca file c thi hnh ngay c trc khi cc phn sau ca file c c). MovieClip._height Chiu cao ca mt movie clip instance, theo pixel. MovieClip.hitArea Ch r mt movie clip dng nh vng bm (hit area) cho mt button movie clip. MovieClip._highquality Thit t cht lng bin i hnh nh ca mt movie. MovieClip._name Tn minh ha (instance name) ca mt instance movie clip. MovieClip._parent Mt tham chiu ti movie clip m c cha movie clip. MovieClip._rotation xoay vng ca mt movie clip instance. MovieClip._soundbuftime S giy trc khi mt m thanh bt u stream. MovieClip.tabChildren Cho bit xem cc "con" (children) ca mt movie clip c bao gm trong trnh t tab t ng (Indicates whether the children of a movie clip are included in automatic tab ordering). MovieClip.tabEnabled Cho bit xem mt movie clip c bao gm trong trnh t tab hay khng (Indicates whether a movie clip is included in tab ordering). MovieClip.tabIndex Cho bit trnh t tab ca mt i tng (Indicates the tab order of an object). 68
MovieClip._target ng dn ch ca mt movie clip instance. MovieClip._totalframes Tng s frame trong mt instance movie clip. MovieClip.trackAsMenu Cho bit xem cc nt khc c th tip nhn cc s kin chut c nh khng. MovieClip._url a ch URL ca file SWF t mt movie clip c ti xung. MovieClip.useHandCursor Quyt nh xem bn tay c c hin th khi mt ngi dng cun ln trn mt nt button movie clip. MovieClip._visible Mt gi tr logic Boolean quyt nh xem mt instance movie clip l n hay nhn thy c. MovieClip._width Chiu rng ca mt movie clip instance, theo pixels. MovieClip._x Ta x ca mt instance movie clip MovieClip._xmouse Ta x ca con tr bn trong mt movie clip instance. MovieClip._xscale Gi tr xc nh t l phn trm cho vic thu phng mt movie clip theo chiu ngang. MovieClip._y Ta y ca mt instance movie clip MovieClip._ymouse Ta y ca con tr bn trong mt movie clip instance. MovieClip._yscale Gi tr xc nh t l phn trm cho vic thu phng mt movie clip theo chiu dc.
Event handler summary cho i tng MovieClip object Property Description MovieClip.onData Vin dn khi tt c d liu c np vo trong mt movie clip. MovieClip.onDragOut Vin dn khi con tr ngoi nt; nt chut c nhn bn trong, v sau cun ra ngoi vng nt. MovieClip.onDragOver Vin dn trong khi con tr trn nt; nt chut c nhn sau cun ra ngoi nt, v sau li cun tr li ln trn nt. MovieClip.onEnterFrame Vin dn lin tc theo vn tc frame ca movie. Cc action kt hp vi s kin clip enterFrame u c gii quyt trc bt k frame action no c gn km vo cc frame b gn. 69
MovieClip.onKeyDown Vin dn khi mt phm c nhn. S dng cc method Key.getCode v Key.getAscii tip nhn thng tin v phm cui cng nhn. MovieClip.onKeyUp Vin dn khi mt phm c nh ra (release). MovieClip.onKillFocus Vin dn khi tiu im b g b khi mt nt. MovieClip.onLoad Vin dn khi movie clip c thuyt minh (instantiated) v xut hin trong Timeline. MovieClip.onMouseDown Vin dn khi nt chut tri c nhn. MovieClip.onMouseMove Vin dn mi khi chut c di chuyn. MovieClip.onMouseUp Vin dn khi nt chut tri c nh. MovieClip.onPress Vin dn khi chut c nhn trong khi con tr ang trn mt nt. MovieClip.onRelease Vin dn khi chut c nh ra trong khi con tr ang trn mt nt. MovieClip.onReleaseOutside Vin dn khi chut c nh trong khi con tr ra ngoi nt sau khi nt c nhn khi con tr trong nt. MovieClip.onRollOut Vin dn khi con tr cun ra ngoi mt vng nt. MovieClip.onRollOver Vin dn khi con tr chut cun ln trn mt nt. MovieClip.onSetFocus Vin dn khi mt nt c mt tiu im nhp vo (input focus) v mt phm c nh. MovieClip.onUnload Vin dn trong frame u tin sau khi movie clip c g b t Timeline. Cc hnh vi kt hp vi s kin movie clip Unload u c x l trc khi cc hnh vi bt k c gn vo cc affected frame(cc frame b nh hng).
MovieClip._url Availability Flash Player 4. Usage myMovieClip._url Description 70
Property (read only) {Thuc tnh (ch c)}; truy lc (gi ra) a ch URL ca file SWF t movie clip c ti xung. MovieClip.useHandCursor Availability Flash Player 6. Usage myMovieClip.useHandCursor Description Property (thuc tnh); mt gi tr logic Boolean cho bit xem mt con tr hnh bn tay c hin th khi mt ngi dng cun ngang qua mt nt button movie clip hay khng. Gi tr mc nh ca useHandCursor l true. Nu useHandCursor c thit t l true, con tr chun hnh bn tay s dng cho cc nt s c hin th khi mt ngi dng cun trn mt button movie clip. Nu useHandCursor l false, con tr hnh mi tn s c dng thay th. Bn c th thay i thuc tnh useHandCursor bt k lc no; button movie clip sa i ngya lp tc nhn mt x l con tr mi (new cursor behavior). Thuc tnh useHandCursor c th c c bn ngoi mt i tng mu ban u. MovieClip._visible Availability Flash Player 4. Usage myMovieClip._visible Description Property (thuc tnh); mt gi tr logic Booloean xc nh xem movie ch nh bi tham s MovieClip l nhn thy c hay khng. Cc movie clip khng nhn thy c (thuc tnh _visible thit t l false) u b v hiu ha. V d, mt nt trong mt movie clip vi thuc tnh _visible thit t thnh false khng th click c. MovieClip._width Availability Flash Player 4 as a read-only property. Usage 71
myMovieClip._width Description Property (thuc tnh); thit t v truy gi chiu rng ca movie clip, theo pixel. Example V d sau thit t cc thuc tnh chiu cao v chiu rng ca mt movie clip khi ngi dng click chut. onclipEvent(mouseDown) { _width=200; _height=200;} See also MovieClip._height MovieClip._x Availability Flash Player 3. Usage myMovieClip._x Description Property (thuc tnh); mt s nguyn thit t ta x ca movie ng vi cc ta a phng (local coordinates) ca movie clip m (parent movie clip). Nu mt movie clip trong Timeline chnh, khi h ta ca n quy cho gc trn bn tri ca Stage l (0, 0). Nu movie clip bn trong movie clip khc m c s bin i, movie clip trong h ta a phng (cc b) ca movie clip bao quanh. Do , vi mt movie clip quay 90 theo chiu kim ng h, cc "con" ca movie clip (movie clip's children) tha hng mt h ta c b cng quay 90 theo chiu kim ng h. Cc ta ca movie clip da vo v tr ca im ng k. MovieClip._xmouse Availability Flash Player 5. Usage myMovieClip._xmouse Description 72
Property (read-only) {Thuc tnh (ch c)}; tr v ta x ca v tr chut. MovieClip._xscale Availability Flash Player 4. Usage myMovieClip._xscale Description Property (thuc tnh); xc nh co dn theo chiu ngang (percentage: t l phn trm) ca movie clip p dng t im ng k ca movie clip. im ng k mc nh l (0,0). Vic chia t l h ta cc b nh hng n cc thit t thuc tnh _x v _y, c nh ngha theo pixel. V d, nu movie clip m c co li thnh 50%, vic thit t thuc tnh _x di chuyn mt i tng trong movie clip bng mt na s pixel m n c th nu movie c thit t 100%. Number (function) Availability Flash Player 4. Usage Number(expression) Parameters expression Mt biu thc chuyn thnh mt s. Returns Nothing. Description Function (hm); chuyn i tham s expression thnh mt s v tr v mt gi tr nh sau: Nu expression l mt s, gi tr tr v l expression. Nu expression l mt gi tr logic Boolean, gi tr tr v l 1 nu expression l true, 0 nu expression l false. 73
Nu expression l mt chui, hm c gng phn tch expression nh mt s thp phn vi s m ko theo ty chn, l, 1.57505e-3. Nu expressionx l undefined, gi tr tr v l 0. Hm ny c dng chuyn i cc file Flash 4 ang cha nhng ton t khng c tn thnh m c nhp (imported) vo trong mi trng thit k Flash 5. Hy xem ton t & bit thm thng tin. Object (object) {i tng (i tng)} c im chung ca i tng Object l gc (root) ca phn lp ActionScript. im chung ca i tng ActionScript Object u cha mt nhm nh cc tnh nng cung cp bi i tng JavaScript Object. Trong Flash MX, i tng Object tr thnh mt i tng t nhin (c sn). V vy, bn s tri qua nhng ci tin ng ngc nhin trong khi thc thi. im chung ca i tng Object l u c h tr trong Flash Player 5.
Bng tm lc cc method ca i tng Object Method Description Object.addProperty To mt thuc tnh ly/thit lp (getter/setter property) trn mt i tng. Object.registerClass Gn mt lp ActionScript vo mt instance ca movie clip. Object.toString Chuyn i i tng ch nh thnh mt chui, v tr n v. Object.unwatch G b ng k m mt method Object.watch to ra. Object.valueOf Tr v gi tr nguyn gc ca mt i tngObject. Object.watch ng k mt hm gi tr v (callback function) vin dn khi mt thuc tnh ch nh ca mt i tng ActionScript thay i.
Bng tm lc cc thuc tnh ca i tng Object Property Description Object.__proto__ Mt tham chiu ti thuc tnh prototype (mu ban u) ca hm xy dng ca i tng.
74
Constructor cho Object object Availability Flash Player 5. Usage new Object([value]) Parameters value Mt s, gi tr logic Boolean, hoc chui c chuyn i thnh mt i tng. Tham s ny l ty chn. Nu bn khng ch nh gi tr value, trnh xy dng constructor s to mt i tng mi vi cc thuc tnh khng c nh ngha. Description Constructor; to mt i tng Object mi. Object.registerClass Availability Flash Player 6 Usage Object.registerClass(symbolID, theClass) Parameters symbolID T nh dang lin kt ca movie clip symbol, hoc chui t nh danh ca lp ActionScript. theClass Mt tham chiu ti trnh xy dng hm (constructor function) ca lp ActionScript, hoc null vi symbol cha ng k. Returns Nu s ng k lp thnh cng, mt gi tr true s c tr v; nu khng th, false c tr v. Decription Method (phng php, cch thc); kt hp mt movie clip symbol vi mt lp i tng ActionScript. Nu mt symbol khng tn ti, Flash to mt s kt hp gia mt chui nh danh (a string identifier) v mt lp i tng (an object class). 75
Khi mt instance ca movie clip symbol xc nh c t vo Timeline, n c ng k thnh lp xc nh bi tham s theClass hn l thnh lp MovieClip. Khi mt instance ca movie clip symbol xc nh c to bng cch s dng cc method attachMovie hoc duplicateMovieClip , n c ng k thnh lp xc nh bi tham s theClass parameter hn l thnh lp MovieClip. Nu theClass l null, Object.registerClass s g b bt k s nh ngha lp ActionScript kt hp vi movie clip symbol xc nh hoc lp nh danh (class identifier). i vi cc movie clip symbol, bt k instance no ang tn ti ca movie clip vn gi nguyn khng thay i, nhng cc instance mi ca symbol u kt hp vi lp MovieClip mc nh. Nu mt biu tng (symbol) c ng k thnh mt lp, method Object.registerClass s thay th n vi s ng k mi. Khi mt instance movie clip c t bi Timeline hoc to bng cch s dng attachMovie hoc duplicateMovieClip, ActionScript vin dn constructor (trnh xy dng) cho lp thch hp vi t kho this nhm vo i tng. Hm xy dng (constructor function) c vin dn khng c tham s no c. Nu bn s dng method Object.registerClass ng k mt movie clip vi mt lp ActionScript khc so vi MovieClip, movie clip symbol khng c tha hng cc method, cc thuc tnh (properties), v s kin gn lin vi lp MovieClip tr phi bn km c (include) lp MovieClip trong chui ban u ca lp mi. on m sau to mt lp ActionScript mi gi l theClass tha hng cc thuc tnh ca lp MovieClip: theClass.prototype = new MovieClip(); Example V d ny to mt component cho mt standard check box UI widget (hp kim giao din ngi dng...). u tin bn to mt movie clip symbol gi l Check Box (hp kim) trong th vin library. Sau bn to mt lp CheckBox trong ActionScript ci m s i din cho check box. // nh ngha constructor cho (v do nh ngha) CheckBox classfunction CheckBox() {...}// Thit t chui ban u CheckBox// tha k t MovieClipCheckBox.prototype = new MovieClip();// nh ngha cc method cho lp CheckBox CheckBox.prototype.setLabel = function (newLabel) { this.label = newLabel; ...};CheckBox.prototype.setValue = function (newValue) { this.value = value; ...};CheckBox.prototype.getValue = function () { return this.value;};CheckBox.prototype.getLabel = function () { return this.label;}; By gi bn phi kt hp lp CheckBox vi movie clip symbol Check Box. u tin, bn cn c kh nng nhn dng movie clip symbol Check Box vi ActionScript. lm iu , nhp mt t nh danh trong hp thoi Linkage (s lin kt) trong th vin (library) v chn Export for ActionScript (Xut ra cho ActionScript).. 76
Tip , vit ActionScript kt hp lp CheckBox vi symbol CheckBox: Object.registerClass("CheckBox" /*symbolID*/, CheckBox /*theClass*/ ); Cch dng 1(Timeline sp t): By gi bn t cc instance (th hin, trng hp) ca CheckBox trn stage trong cng c thit k (chnh l ci chng trnh Macromedia Flash ), v ti thi gian chy (at runtime) cc instance s t ng tip nhn lp ActionScript l CheckBox. Nu bn t hai instance, myCheckBox1 (hp kim th nht ca ti) v myCheckBox2, bn c th iu khin chng bng cch vin dn cc method, nh sau: myCheckBox1.setValue(true);myCheckBox2.setValue(false);myCheckBox2.setLabel("new label for #2"); Cch dng 2 (Dynamic instances: cc instance ng): Bn c th s dng method attachMovie (nh km Movie) to mt instance mi ca hp kim check box trn Stage chng hn nh movie plays (trnh din movie). Bi v symbol CheckBox c ng k thnh lp ActionScript l CheckBox, instance ng mi s t ng tip nhn lp . // createCheckBox l mt hm tr gip // tch cc trong vic to cc CheckBoxesfunction createCheckBox(name, depth) { attachMovie("CheckBox", name, depth);}createCheckBox("myCheckBox3", 100);myCheckBox3.setValue(false);myCheckBox3.setLabel("new label for #3"); See also onClipEvent Availability Flash Player 5. Usage onClipEvent(movieEvent){ statement(s);} Parameters Mt movieEvent (s kin movie) l mt hnh ng nhanh c gi l mt s kin. Khi s kin c t vo, cc cu lnh, pht biu theo sau n bn trong bn trong cc du ngoc xon s c thc thi. Bt k gi tr no sau y u c th c ch nh lm tham s cho movieEvent:
load (np) Hnh vi c khi xng ngay khi movie clip c th hin v xut hin trong Timeline.
unload Hnh vi c khi xng trong frame (khung) u tin sau khi movie clip b g b khi Timeline. Cc action (hnh vi) kt hp vi s kin movie clip Unload c x l trc khi bt k hnh vi no c gn vo frame b nh hng (processed before any actions are attached to the affected frame).
enterFrame (nhp frame) Hnh vi c khi s lin tc theo tc frame ca movie. Cc hnh 77
vi kt hp vi s kin clip enterFrame c x l trc khi bt k action cho frame no c nh km vo cc affected frame.
mouseMove (di chuyn chut) Hnh vi c bt u mi ln con tr chut c di chuyn. S dng cc thuc tnh _xmouse (honh v tr chut) v _ymouse (tung v tr chut) xc nh v tr con chut hin ti.
mouseDown (nhn chut) Hnh vi c khi xng khi phm chut tri c nhn.
mouseUp (nh chut) Hnh vi c khi xng khi phm tri chut c nh ra.
keyDown (nhn phm) Hnh vi c khi xng khi mt phm c nhn. S dng method Key.getCode gi (truy lc) thng tin v phm c nhn cui cng .
keyUp (nh phm) Hnh vi c khi xng khi mt phm c nh ra. S dng method Key.getCode truy lc thng tin v phm cui cng c nhn.
data (d liu) Hnh vi c khi xng khi d liu c tip nhn trong mt hnh vi loadVariables (np cc bin) vloadMovie (np movie). Khi xc nh vi mt hnh vi loadVariables, s kin data xy ra ch mt ln, khi bin cui cng c np. Khi ch nh vi mt hnh vi loadMovie, s kin data xy ra lp i lp li nhiu ln, nh mi phn ca d liu c truy lc. statement(s) Cc lnh thc thi khi s kin mouseEvent xy ra. Description Event handler (b qun l s kin); cc hnh vi xy ra rt nhanh nh ngha cho mt instance xc nh ca mt movie clip. Example Lnh sau bao gm script t mt file bn ngoi khi movie c xut ra; cc hnh vi bn trong script km theo c chy khi movie clip m chng c nh km c np: onClipEvent(load) { #include "myScript.as"} V d sau y s dng onClipEvent vi s kin movie keyDown. S kin movie keyDown thng c s dng trong s kt hp vi mt hoc nhiu method v thuc tnh ca i tng Key (phm). on script bn di s dng method Key.getCode tm ra phm no m ngi dng va nhn; nu phm va nhn khp vi thuc tnh Key.RIGHT, movie c gi ti frame tip theo; nu phm nhn khp vi thuc tnh Key.LEFT, movie c chuyn ti frame trc (previous frame). onClipEvent(keyDown) { if (Key.getCode() == Key.RIGHT) { _parent.nextFrame(); } else if (Key.getCode() == Key.LEFT){ _parent.prevFrame(); }} V d sau s dng onClipEvent vi s kin movie mouseMove. Cc thuc tnh _xmouse v _ymouse theo di v tr ca con chut mi ln chut di chuyn. onClipEvent(mouseMove) { stageX=_root.xmouse; stageY=_root.ymouse;} 78
See also Key (object), MovieClip._xmouse, MovieClip._ymouse,on _parent Availability Flash Player 4. Usage _parent.property_parent._parent.property Description Property (thuc tnh); xc nh hoc tr v mt tham chiu ti movie clip hoc i tng m cha movie clip hoc i tng hin ti (current). i tng hin ti l i tng ang cha m ActionScript tham chiu _parent. S dng _parent ch nh mt ng dn tng i ti cc movie clip hoc cc i tng cp cao hn ( trn, parent c ngha l cha m) movie clip hoc i tng hin ti. Example Trong v d sau, movie clip desk (ci bn hc sinh) l mt "a con" (child) ca movie clip classroom (phng lp hc). Khi on script di thc thi bn trong movie clip desk, u chy playhead s nhy ti Frame 10 trong Timeline ca movie clip classroom. _parent.gotoAndStop(10); See also _root, targetPath on Availability Flash 2. Khng phi tt c cc s kin u c h tr trong Flash 2. Usage on(mouseEvent) { statement(s);} Parameters statement(s) Cc lnh thc thi khi mouseEvent xy ra. 79
Mt mouseEvent l mt hnh ng din ra nhanh c gi l mt "s kin" (event). Khi s kin xy ra, cc lnh theo sau n bn trong du ngoc xon c thc thi. Cc gi tr bt k trong nhng gi tr sau c th c ch nh cho tham s mouseEvent:
press Phm chut c nhn trong khi con tr ngang qua nt.
release Phm chut c nh ra trong khi con tr ngang qua nt.
releaseOutside Phm chut c nh ra trong khi con tr ra bn ngoi nt sau khi nt c nhn trong khi con tr gia nt.
rollOut Con tr cun ngoi vng nt.
rollOver Con tr chut cun qua nt.
dragOut Trong khi con tr qua nt, phm chut c nhn v sau cun ra ngoi vng nt.
dragOver Trong khi con tr qua nt, phm chut va c nhn v sau cun ra ngoi ca nt v sau cun tr li ngang qua nt.
keyPress ("key") Phm key xc nh c nhn. Phn key ca tham s c xc nh bng cch s dng bt k m phm no c lit k trong Ph lc B, Keyboard Keys and Key Code Values (Cc phm trn bn phm v cc gi tr m phm) ca Using Flash hoc bt k hng phm no c lit k trong Property summary for the Key object (Thuc tnh tng quan cho i tng Phm). Description Event handler (b qun l s kin); ch nh s kin chut, hoc phm nhn (keypress) m khi s mt hnh vi. Example Trong on script sau, hnh vi startDrag thc thi khi con chut c nhn v script iu kin c thc thi khi con chut c nh ra v i tng th (dropped). on(press) { startDrag("rabbit");}on(release) { trace(_root.rabbit._y); trace(_root.rabbit._x);
print (in) Trong ch bnh thng (normal mode) trong panel Actions, chn As vectors (nh l vect) in cc frame khng cha cc hnh nh bitmap hoc s dng tnh trong sut transparency (alpha) hoc cc hiu ng mu sc (color effects); chn As bitmap (dng bitmap) in cc frame cha cc hnh nh nh phn bitmap, tnh trong sut transparency hoc cc hiu ng mu sc. Nu bn la chn tham s in l As bitmap, c php AsBitmap c b sung vo hnh vi print trong panel Actions. level (mc, cp) Cp trong Flash Player c in. Trong panel Actions trong ch normal mode, nu bn chn mt cp level, hnh vi print chuyn i thnh printNum hoc printAsBitmapNum; trong ch chuyn mn (expert mode), bn phi ch nh hoc printNum hoc printAsBitmapNum. Theo mc nh, tt c cc frame trong level c in. Nu bn mun in cc frame xc nh trong level, hy gn mt nhn frame #p vo cc frame . target (ch dn) Tn th hin (instance name) ca mt movie clip c in. Theo mc nh, tt c cc frame trong instance ch s c in. Nu bn mun in cc frame xc nh trong movie clip, gn mt nhn frame #p vo nhng frame . Bounding box (hp gii hn) Mt sa i thit t vng in ca movie. Tham s ny l ty chn. Bn c th chn la mt trong cc loi sau:
bmovie Ch r khung gii hn ca mt frame xc nh trong mt movie nh vng in cho tt c nhng frame c th in c trong movie. Gn mt nhn frame #b vo frame m bn mun dng khung gii hn ca n nh vng in.
bmax Chn la mt bn tng hp ca tt c cc khung gii hn ca tt c cc frame c th in c nh vng in. Ch nh tham s bmax khi cc frame c th in c trong movie ca bn c kch thc khc nhau.
bframe Chn la khi khung gii hn ca mi frame c th in c (printable frame) c dng nh vng in cho frame . iu ny thay i vng in vi mi frame v iu chnh kch thc (thu, phng t l) cc i tng cho va vi vng in. S dng bframe nu bn c cc i tng c kch thc khc nhau trong mi frame v mun mi i tng lp y trang in. Returns None. Description Action (hnh vi); in movie clip ch target theo cc ng bin ch nh trong tham s (bmovie, bmax, hoc bframe). Nu bn mun in cc frame xc nh trong movie ch, hy nh km mt nhn frame #P vo nhng frame . Mc d hnh vi print cho kt qu in c cht lng cao hn hnh vi printAsBitmap, nhng n khng th c dng in cc movie s dng thuc tnh trong sut alpha hoc cc hiu ng mu sc xc nh. Nu bn khng ch nh mt tham s in ng bin ranh gii (a print boundary parameter), th theo mc nh vng in c quyt nh bi kch c Stage ca movie np. Movie khng tha hng kch c Stage ca movie chnh. Bn c th iu khin vng in bng cch ch nh cc tham s bmovie, bmax, hoc bframe parameters. 81
Tt c cc phn t c kh nng in trong mt movie phi c np y trc khi qu trnh in c th bt u. Tnh nng in Flash Player h tr cc my in PostScript (mt my in, ch yu l loi laser, trong c lp mch x l gii m v bin dch cc lnh in c vit thnh cu theo PostScript-mt loi ngn ng m t trang phc tp c dng cho vic in cht lng cao bng my laser v cc thit b in phn gii cao khc) v non-PostScript. Cc my in Non-PostScript chuyn i cc hnh nh vect thnh bitmap. Example V d sau y s in tt c cc frame c kh nng in trong movie clip myMovie vi vng in nh ngha bi khung gii hn ca frame vi nhn frame #b gn km: print("myMovie","bmovie"); V d sau y s in tt c cc frame c th in c trong myMovie vi vng in nh ngha bi khung gii hn ca mi frame: print("myMovie","bframe"); See also printNum, printAsBitmap, printAsBitmapNum random {ngu nhin} Availability Flash Player 4. Hm ny b phn i trong Flash 5; c thay th bi vic s dng method Math.random. Usage random(value) Parameters value Mt s nguyn. Returns Mt s nguyn. Description Function (hm); tr v mt s nguyn ngu nhin gia 0 mt s nh hn s nguyn c ch nh trong tham s. 82
Example Cch s dng sau y ca hm random tr v mt trong cc gi tr 0, 1, 2, 3, hoc 4: random(5); See also Math.random removeMovieClip Availability Flash Player 4. Usage removeMovieClip(target) Parameters target ng dn ch ca mt instance movie clip to vi duplicateMovieClip, hoc tn th hin (instance name) ca movie clip to vi cc method attachMovie hoc duplicateMovieClip ca i tng MovieClip. Returns None. Description Action (hnh vi); xo mt movie clip instance m c to vi cc method attachMovie (nh km movie) hoc duplicateMovieClip (nhn i movie clip) ca i tng MovieClip, hoc vi hnh vi duplicateMovieClip. See also duplicateMovieClip, MovieClip.duplicateMovieClip, MovieClip.attachMovie, MovieClip.removeMovieClip _root Availability Flash Player 4. Usage 83
_root.movieClip_root.action_root.property Parameters movieClip Tn minh ha (instance name) ca mt movie clip. action Mt hnh vi hoc method. property Mt thuc tnh ca i tng MovieClip. Description Property (thuc tnh); xc nh hoc tr v mt tham chiu ti Timeline ca movie gc (root movie Timeline). Nu mt movie c nhiu level (cp), root movie Timeline trn level ang cha on script hin ti ang thc thi. V d, nu mt script trong level 1 c lng _root, _level1 s c tr v. Vic ch nh _root ging nh khi s dng k hiu vch xin (/) xc nh mt ng dn tuyt i bn trong level hin ti. Example V d sau dng Timeline ca level cha on script hin ang thc thi. _root.stop(); V d sau gi Timeline trong level hin ti ti frame 3: _root.gotoAndStop(3); See also _parent, targetPath scroll Availability Flash Player 4. Usage textFieldVariableName.scroll = x Description Property (thuc tnh); mt thuc tnh b phn i iu khin s hin th thng tin trong mt trng ch (text field) kt hp vi mt bin. Thuc tnh scroll nh ngha ni trng ch bt u hin th (trnh by) ni dung; sau khi bn thit t n, trnh Flash Player cp nht n khi ngi dng 84
cun ln, cun xung trong sut trng ch. Thuc tnh cun scroll rt hu ch cho ngi dng iu khin mt on vn c th trong mt bi vn di, hoc vic to kh nng cun trong nhng trng ch. Thuc tnh ny c th c khi phc v thay i. Example on m sau c gn vo mt nt Up (nt ln) cun trng ch myText: on (release) { myText.scroll = myText.scroll + 1; } See also TextField.maxscroll, TextField.scroll Selection (object) {S la chn (i tng)} i tng vng chn Selection cho php bn thit t v iu khin trong trng ch m con tr c nh v trong mt Flash movie. Trng ch (text field) c gi l c "tiu im" (focus) l trng m con tr hin ang nh v. Cc ch mc ni ca vng chn (selection-span indexes) ly c s t 0 (cho v d, v tr u tin l 0, v tr th hai l 1, v c nh th). Khng c constructor method no cho i tng Selection , v th mi ln ch c mt trng hint ti c tp trung.
Bng tm lc cc method cho i tng vng chn Selection Method Description Selection.addListener ng k mt i tng nhn thng bo khi method onSetFocus c vin dn. Selection.getBeginIndex Tr v ch mc (index) ti m u ca chiu di vng chn (selection span). Tr v -1 nu khng ch mc hoc trng no hin ti ang c la chn. Selection.getCaretIndex Tr v v tr du st ( nh du ch phi thm ch cn st) hin ti trong chiu di vng chn hin ang t tiu im (ang xt). Tr v -1 nu khng c v tr du st hoc chiu di vng chn no hin ang c t trng tm (if there is no caret position or currently focused selection span). Selection.getEndIndex Tr v ch mc ti cui ca selection span. Tr v -1 nu khng c ch mc no hoc trng no hin ang c la chn. Selection.getFocus Tr v tn bin cho trng text hin ti ang c ch . Tr v null nu hin ti khng c trng text no c t trng tm 85
(c tp trung xt). Selection.removeListener G b mt i tng m c ng k vi addListener. Selection.setFocus Tp trung vo trng text kt hp vi bin ch nh trong tham s. Selection.setSelection Thit t cc ch mc m u v kt thc ca chiu di vng chn (selection span).
Bng tm lc cc listener ("ngi nghe", tc l chu s tc ng, chu nh hng) cho i tng Selection Method Description Selection.onSetFocus Thng bo khi tiu im nhp vo thay i (Notified when the input focus changes).
Sound (object) {m thanh (i tng)} i tng Sound cho php bn iu khin m thanh trong mt movie. Bn c th thm cc m thanh vo mt movie clip t th vin Library trong khi phim movie ang trnh din v iu khin nhng m thanh . Nu bn khng ch nh mt ng dn target khi bn to mt i tng m thanh mi (new Sound object), bn c th s dng cc method (phng php, cch thc) iu khin m thanh cho ton b phim movie. Bn phi s dng constructor (trnh xy dng) new Sound to mt th hin (instance) ca i tng Sound trc khi gi cc method ca i tng Sound. i tng Sound c h tr trong Flash Player 5 v Flash Player 6.
Bng tm lc cc method dnh cho i tng Sound object Method Description Sound.attachSound nh km m thanh ch nh trong tham s. Sound.getBytesLoaded Tr v s byte np ca m thanh ch nh. Sound.getBytesTotal Tr v kch c ca m thanh theo bytes. Sound.getPan Tr v gi tr ca lnh gi setPan (iu khin loa) lin trc. 86
Sound.getTransform Tr v gi tr ca lnh gi setTransform (iu khin s bin i) lin trc. Sound.getVolume Tr v gi tr ca lnh gi setVolume (thit t m lng) trc . Sound.loadSound Np mt file MP3 vo trong Flash Player. Sound.setPan Thit t s cn bng gia hai loa tri/phi ca m thanh. Sound.setTransform Thit t s lng ca mi knh, tri v phi, trnh din trong mi loa. Sound.setVolume Thit t mc m lng cho mt m thanh. Sound.start Bt u trnh din mt m thanh t u hoc, do tu chn, t mt im trng (offset point) thit t trong tham s. Sound.stop Dng m thanh ch nh hoc tt c cc m thanh hin ang c trnh din.
Bng tm lc cc thuc tnh ca i tng Sound object Method Description Sound.duration di ca mt m thanh theo mili-giy (mt phn nghn giy). Sound.position S mili-giy m thanh c trnh din.
Event handler summary for the Sound object Method Description Sound.onLoad c vin dn khi mt m thanh c np. Sound.onSoundComplete c vin dn khi mt m thanh ngng trnh din.
Constructor dnh cho i tng Sound object Availability 87
Flash Player 5. Usage new Sound([target]) Parameters target Th hin ca movie clip trn i tng m thanh Sound hot ng. Tham s ny l ty chn. Returns Nothing. Description Constructor (trnh xy dng, bin tp); to mt i tng m thanh mi (new Sound object) dnh cho mt movie clip xc nh. Nu bn khng ch nh mt ng dn xc nh, i tng Sound s iu khin tt c cc m thanh trong movie. Example V d sau to mt th hin (instance) mi ca i tng Sound object gi l GlobalSound. Dng th hai gi method setVolume v iu chnh m lng trn tt c cc m thanh trong movie thnh 50%. globalsound = new Sound(); globalsound.setVolume(50); V d sau to mt th hin mi ca i tng Sound, chuyn n ti movie clip ch myMovie, v gi method start, n s bt u chy bt k m thanh no c trong myMovie. moviesound = new Sound(myMovie); moviesound.start();
Stage (object) {Sn khu (i tng)} i tng Stage l mt i tng cp cao nht m bn c th truy cp m khng cn s dng mt constructor. S dng cc method v thuc tnh ca i tng ny truy cp (access) v thao tc thng tin v cc ng bin ranh gii ca mt movie Flash. i tng Stage c sn trong Flash Player 6 v cc phin bn v sau.
Bng tm lc cc method dnh cho i tng Stage 88
Method Description Stage.addListener Thm mt listener object (ta tm hiu l i tng chu s tc ng, "ngi nghe") vo i tng Stage. Stage.removeListener G b mt listener object t i tng Stage.
Bng cc thuc tnh ca i tng Stage object Method Description Stage.align S canh chnh v tr ca Flash movie trong trnh duyt. Stage.height Chiu cao ca Stage, theo pixel. Stage.width Chiu rng ca Stage, theo pixel. Stage.scaleMode T l thu phng hin thi ca Flash movie.
B qun l s kin ca i tng Stage Method Description Stage.onResize Cho bit movie c iu chnh li kch thc.
startDrag Availability Flash Player 4. Usage startDrag(target,[lock ,left , top , right, bottom]) Parameters target ng dn ti movie clip ko (drag: di chuyn con tr chut trong khi vn nhn v gi phm trn chut). 89
lock Mt gi tr logic Boolean xc nh xem movie clip c kh nng ko (draggable movie clip) b kho i vi im gia ca v tr con tr (true), hay b kho vi im m ngi dng click ln trn movie clip ln u tin (false). Tham s ny l ty chn. left, top, right, bottom Cc gi tr lin quan n cc ta ca movie clip's parent ("m" ca movie clip, ta hiu l instance cp cao hn, ni movie clip c t) xc nh mt hnh ch nht cha movie clip (a constraint rectangle for the movie clip). Nhng tham s ny l ty chn. Returns Nothing. Description Action (hnh vi); to mt target movie clip c th ko c khi movie ang trnh din. mt thi im ch mt movie clip c th ko c. Ngay khi mt thao tc startDrag (bt u ko) c thc thi, movie clip gi nguyn kh nng ko c (remains draggable) cho n khi dt khot c dng li bi mt hnh vi stopDrag, hoc cho n khi hnh vi startDrag i vi mt movie clip khc c gi. Example to mt movie clip m ngi dng c th nh v trong bt k v tr no, km theo cc hnh vi startDrag v stopDrag vo mt nt bn trong movie clip. on(press) { startDrag(this,true); } on(release) { stopDrag(); }
String (function) Availability Flash Player 4. Usage String(expression) Parameters expression Mt biu thc chuyn i thnh mt chui. Returns 90
Nothing. Description Function (hm); tr v mt chui i din ca tham s c ch nh nh sau y: Nu expression l mt gi tr logic Boolean, chui tr v l true hoc false. Nu expression l mt s, chui tr v l mt text (ch bao gm cc k t ASCII) i din ca s. Nu expression l mt chui, chui tr v l biu thc expression. Nu expression l mt i tng, gi tr tr v l mt chui i din ca i tng to bi vic gi thuc tnh chui (string property) cho i tng, hoc bi vic gi Object.toString nu khng c thuc tnh no tn ti. Nu expression l mt movie clip, gi tr tr v l ng dn ca movie clip trong k hiu vch cho (/). Nu expression l khng xc nh (undefined), gi tr tr v l mt chui rng (""). See also Number.toString, Object.toString, String (object), " " (string delimiter) System.capabilities (object) Bn c th dng i tng System.capabilites (nng lc h thng) xc nh nhng nn lc ca h thng v player ang chy mt Flash movie. iu ny cho php bn bin i ni dung cho nhiu nh dng. Cho v d, mn hnh ca mt in thoi dng (en v trng, 100 im nh hnh vung) khc khc vi mn hnh mu my vi tnh 1000 im nh hnh vung. chun b ni dung thch hp vi nhiu ngi dng l iu c th thc hin c, bn c th dng i tng Capabilities xc nh loi thit b (device) m mt ngi dng c. Sau bn c th hoc ch nh server (my ch) gi cc file SWFs khc nhau da trn c s nng lc ca thit b, hoc nh hng n Flash movie bin i bn trnh by ca n da trn cc nng lc ca thit b. Bn c th gi thng tin nng lc (capabilities information) s dng mt method GET hoc POST HTTP. Sau y l mt v d ca mt chui my ch (server string) cho mt thit b m khng h tr MP3 v c mt mn hnh 400 x 200 pixel, 8 x 4 centimet: "A=t&MP3=f&AE=gsm&VE=h11&ACC=f&V=WIN%206%2C0%2C0%2C129&M=Macromedia%WINDOWS&R=40 0x200&DP=72&COL=color&AR=1.0&OS=WINDOWS%2000&L=en-US" i tng Capabilities c sn trong Flash Player 6. Bn phi truy cp tt c cc thuc tnh ca i tng Capabilities cho n i tng System.capabilities . 91
Bng tm lc cc thuc tnh ca i tng Capabilities Property Description System.capabilities.hasAudioEncoder Cho bit trnh m ho h tr m thanh. System.capabilities.hasAccessibility Cho bit xem thit b c ph hp vi cc tiu chun c kh nng truy cp khng. System.capabilities.hasAudio Cho bit thit b (device) c kh nng m thanh khng. System.capabilities.hasMP3 Cho bit xem thit b c b gii m MP3 khng. System.capabilities.language Cho bit ngn ng m Flash Player h tr. System.capabilities.manufacturer Cho bit ngi sn xut ca Flash Player. System.capabilities.os Chobit h thng hot ng cha Flash Player. System.capabilities.pixelAspectRatio Cho bit s pixel v chiu rng ca mn hnh hin th so vi chiu cao ca n. System.capabilities.screenColor Cho bit xem mn hnh l mu, en trng, hay thang xm (grayscale). System.capabilities.screenDPI Cho bit cc im mn hnh theo inch. System.capabilities.screenResolution.x Cho bit kch thc chiu ngang ca mn hnh. System.capabilities.screenResolution.y Cho bit kch thc chiu dc ca mn hnh. System.capabilities.version Cho bit phin bn thp nht h tr Flash Player. System.capabilities.hasVideoEncoder Cho bit c h tr trnh m ho video.
targetPath Availability Flash Player 5. Usage targetpath(movieClipObject) Parameters 92
movieClipObject Tham chiu (v d, _root hoc _parent : c hai t ny u ch gc r, ngun) ti movie clip cho ng dn ang c truy gi. Returns Nothing. Description Hm s (Function); tr li mt chui cha ng ng dn ch (target path) ca movieClipObject. ng dn ch c tr v ti k hiu du chm (dot). gi ng dn ch ti k hiu gch xin ( / ), s dng thuc tnh _target. Example V d sau y hin th ng dn ch ca mt movie clip ngay khi n c ti. onClipEvent(load){ trace(targetPath(this));}
tellTarget Availability Flash Player 3. (Khng dng trong Flash 5; vic s dng k hiu chm (dot) v hnh vi with c khuyn co.) Usage tellTarget("target") { statement(s);} Parameters target Mt chui m ch r ng dn ch ca Timeline s c iu khin. statement(s) Cc lnh thc thi nu iu kin xc nh l true. Returns Nothing. Description Hnh vi (Action); p dng cc ch dn ch nh trong tham s statements ti Timeline c ch nh trong tham s target. Hnh vi tellTarget hu dng cho cc iu khin iu hng (navigation controls). Gn tellTarget cho cc nt button dng hoc khi ng cc on phim (movie clip) mt ni no khc trn Stage. Bn cng c th to cc on phim nhy ti mt 93
frame ring bit trong on clip . V d, bn c th gn tellTarget ti cc nt dng hoc khi ng cc movie clip trn Stage hoc nhc cc movie clip nhy ti mt frame ring bit. Trong Flash 5, bn c th dng k hiu du chm (dot) thay th cho hnh vi tellTarget. Bn c th dng hnh vi (action) with pht hnh nhiu action ti cng mt Timeline . Bn c th dng hnh vi with nhm ti bt k i tng object no, trong khi hnh vi tellTarget ch c th nhm ch ti cc on phim movie clip. Example Cu lnh tellTarget ny iu khin movie clip minh ha (movie clip instance) ball trn Timeline chnh. Frame 1 ca ball instance (movie clip th hin qu bng) trng v c mt action l stop v th n khng th thy c trn Stage. Khi nt vi action sau y c click, tellTarget ra lnh cho playhead trong ball nhy ti frame 2 ni on hot cnh bt u. on(release) { tellTarget("ball") { gotoAndPlay(2); }} V d sau y dng k hiu du chm (dot) cho kt qa tng t. on(release) { ball.gotoAndPlay(2);} Nu bn cn pht hnh nhiu mnh lnh cho instance ball , bn c th dng hnh vi with, nh trong pht biu sau. on(release) { with(ball) { gotoAndPlay(2); _alpha = 15; _xscale = 50; See also with TextField (object) Tt c cc trng text ng (dynamic text) v cc trng text nhp d liu vo trong mt Flash movie l cc trng hp ring ca i tng TextField. Bn c th t cho mt trng text mt tn minh ha trong Property inspector (thanh tra thuc tnh) v dng cc method (phng php) v thuc tnh ca i tng TextField ch tc n vi ActionScript. Nhng tn th hin TextField c trnh by trong hp thoi Movie Explorer v trong hp thoi Insert Target Path trong bng Actions. i tng TextField tha k t i tng Object . to ra mt trng text ng, bn c th dng method MovieClip.createTextField . i tng TextField c h tr bi Flash Player 6 v cc phin bn sau ny ca Flash Player.
Phng php tm lc cho i tng TextField 94
Method Description TextField.addListener ng k mt i tng tip nhn thng bo khi cc s kin onChanged v oNScroller c vin dn. TextField.getDepth Tr li dy (depth) ca mt trng text. TextField.getNewTextFormat Mang nh dng text mc nh c gn cho text mi c nhp vo. TextField.removeListener G b mt i tng ngi nghe (listener objec). TextField.removeTextField G b mt trng text m c to vi MovieClip.createTextField. TextField.setNewTextFormat Thit t mt i tng nh dng text (ch) cho text m c nhp vo bi mt ngi dng hoc bi mt method. TextField.replaceSel Thay th vng la chn hin ti. TextField.setTextFormat Thit t nh dng text mc nh gn cho on text mi c chn vo.
Cc thuc tnh tm lc cho i tng TextField object Property Description TextField._alpha Gi tr trong sut ca mt th hin (instance) ca trng ch. TextField.autoSize iu khin s canh thng hng mt cch mc nh v iu chnh kch thc ca mt trng ch. TextField.background Ch ra nu trng text c mt nn (background fill). TextField.backgroundColor Cho bit mu sc ca nn y . TextField.border Biu th nu trng text c mt ng vin. TextField.borderColor Cho bit mu sc ca ng vin. TextField.bottomScroll Dng di cng nhn thy c trong trng text. TextField.embedFonts Cho bit xem trng text s dng cc font phc tho c nhng vo (embedded font outlines) hay cc font ngoi vi (device font). TextField._highquality Cho bit cht lng bin i hnh v phc ho ra hnh nh ba chiu ca movie. 95
TextField._height Chiu cao ca mt instance ca trng text theo pixel. iu ny ch c tc dng vi khung gii hn ca trng text, n khng nh hng n b dy ng vin hoc kch thc font ch. TextField.hscroll Cho bit gi tr cun sang ngang ca mt trng text. TextField.html Cho bit v tr cun cc i hin ti (current maximum scrolling position) ca mt trng text. TextField.htmlText Cha biu din HTML ca cc ni dung ca mt trng text. TextField.length S k t trong mt trng text. TextField.maxChars S k t cc i m mt trng text c th cha. TextField.maxhscroll Gi tr cc i ca TextField.hscroll. TextField.maxscroll Gi tr cc i ca TextField.scroll. TextField.multiline Ch ra nu trng text bao gm nhiu dng. TextField._name Tn minh ha (instance name) ca mt th hin ca trng text. TextField._parent Mt tham chiu ti instance m l "m" (parent: tc l cp cao hn) ca instance ny; hoc l nt Button hoc MovieClip. TextField.password Biu th nu mt trng text giu cc k t nhp vo. TextField._quality Biu th cht lng bin i hnh phc tho thnh hnh ba chiu (rendering) ca mt movie. TextField.restrict S thit t cc k t m mt ngi dng c th nhp vo trong mt trng text. TextField._rotation Mc xoay vng ca mt instance ca trng text. TextField.scroll Biu th v tr ang cun ca mt trng text. TextField.selectable Cho bit xem mt trng text c kh nng la chn hay khng. TextField._soundbuftime Tng s thi gian mt m thanh phi nh m trc (prebuffer) trc khi n stream (hot ng, chy). TextField.tabEnabled Cho bit xem mt movie clip c bao gm trong ch th tab t ng (Indicates whether a movie clip is included in automatic tab ordering). TextField.tabIndex Cho bit lnh tab (tab order) ca mt i tng. TextField.text Text hin ti trong trng text. TextField.textColor Mu sc ca text hin thi trong trng text. 96
TextField.textHeight Chiu cao khung gii hn ca trng text. TextField.textWidth Chiu rng khung gii hn ca trng text. TextField.type Ch ra xem mt trng text l mt trng text nhp vo (input text field) hay trng text ng (dynamic text field). TextField._url a ch URL ca file SWF to text field instance. TextField.variable Tn bin kt hp vi trng text. TextField._visible Mt gi tr logic Boolean quyt nh xem mt instance ca trng text l n hay nhn thy c. TextField._width Chiu rng ca text field instance theo pixel. Ci ny ch c tc dng vi khung gii hn (bounding box) ca trng text, n khng nh hng n dy ca ng vin hay kch c font ch). TextField.wordWrap Cho bit xem trng text c kh nng ngt t khng (word- wraps: chc nng ngt cc t xung u dng k tip nu chng vt qu l phi). TextField._x Ta x ca mt text field instance TextField._xmouse To x ca con tr lin quan n mt instance ca trng text. TextField._xscale Gi tr ch nh t l phn trm cho vic chia t l (scaling) theo chiu ngang ca mt text field instance. TextField._y Ta y ca mt instance ca trng text. TextField._ymouse Ta y ca con tr lin quan n mt text field instance. TextField._yscale Gi tr ch nh t l phn trm cho vic chia t l (scaling) theo chiu dc ca mt text field instance.
Tng quan v cc b qun l s kin (Event handler) cho i tng TextField Method Description TextField.onChanged c vin dn khi trng text c thay i. TextField.onKillFocus c vin dn khi trng text mt tiu im (loses focus). TextField.onScroller c vin dn khi thuc tnh scroll, maxscroll, hscroll, maxhscroll,hoc bottomscroll ca mt trng text thay i 97
TextField.onSetFocus c vin dn khi trng text tip nhn tiu im.
Bng tm lc listener cho i tng TextField Method Description TextField.onChanged Thng bo khi trng text b thay i. TextField.onScroller Thng bo khi thuc tnh scroll hoc maxscroll ca mt trng text thay i. TextFormat (object) {nh dng Text (i tng)} i tng TextFormat i din cho thng tin v nh dng k t. Bn phi s dng constructor new TextFormat to mt instance (th hin) ca i tng TextFormat trc khi gi cc method ca n. Bn c th thit t cc tham s TextFormat thnh null ch ra rng chng khng c nh ngha. Khi bn p dng mt i tng TextFormat vo mt trng text bng cch s dng method setTextFormat, ch c nhng thuc tnh nh ngha l c p dng, nh trong v d sau y: myTextFormat = new TextFormat();myTextFormat.bold = true;myTextField.setTextFormat(myTextFormat); on m ny u tin to mt i tng TextFormat rng vi tt c cc thuc tnh cha nh ngha, sau thit t thuc tnh bold cho mt gi tr c nh ngha. M myTextField.setTextFormat(myTextFormat) ch thay i thuc tnh m bold property ca dng text mc nh ca trng text, bi v thuc tnh bold ch l mt thuc tnh nh ngha trong myTextFormat. Tt c cc mt khc ca dng text mc nh ca trng text vn gi nguyn khng thay i. Khi getTextFormat c vin dn, i tng TextFormat c tr v vi tt c cc thuc tnh nh ngha ca n; khng c thuc tnh no l null.
Bng tng quan cc method cho i tng TextFormat Method Description TextFormat.getTextExtent Tr v mt i tng vi hai thuc tnh, chiu rng width v chiu cao height, cho bit kch thc ca text trong mt trng text. 98
bng tng quan v cc thuc tnh property i vi i tng TextFormat Property Description TextFormat.align Cho bit s canh thng ca mt on vn. TextFormat.blockIndent Cho bit mu tht dng theo point (1 point = 1/72 inch). TextFormat.bold Cho bit text c kiu ch m hay khng. TextFormat.bullet Cho bit c hay khng text bn trong mt danh sch bulleted list (danh sch c nh du u dng). TextFormat.color Cho bit mu sc ca text TextFormat.font Cho bit tn font ca text vi mt nh dng text. TextFormat.indent Cho bit s tht dng t l tri ti k t u tin trong on. TextFormat.italic Cho bit text c in nghing hay khng. TextFormat.leading Cho bit khong cch gia cc dng. TextFormat.leftMargin Cho bit l tri ca on vn, theo point. TextFormat.rightMargin Cho bit l phi ca on vn, theo point. TextFormat.tabStops Ch nh trnh t tab la chn (custom tab) dng TextFormat.target Biu th ca s trong mt trnh duyt khi mt siu lin kt c hin th. TextFormat.size Cho bit c point ca text TextFormat.underline Cho bit mt text c c gch di khng. TextFormat.url Cho bit a ch URL m text lin kt ti.
Constructor cho i tng TextFormat object Usage new TextFormat([font, [size, [color, [bold, [italic, [underline, [url, [target, [align, [leftMargin, [rightMargin, [indent, [leading]]]]]]]]]]]]]) Parameters 99
font Tn ca mt font cho text di dng mt chui. size Mt s nguyn cho bit kch c point (n v o c ch 1 point = 1/72 inch). color Mu sc ca text s dng nh dng text ny. Mt s mang 3 component 8-bit RGB; v d, 0xFF0000 l , 0x00FF00 l xanh l cy. bold Mt gi tr logic Boolean cho bit xem text c c in m khng. italic Mt gi tr logic Boolean cho bit text c c in nghing khng. underline Mt gi tr logic Boolean cho bit xem text c gch di. url a ch URL m text trong dng text ny siu lin kt. Nu url l mt chui rng, text khng c mt siu lin kt. target Ca s ch (target window) ni siu lin kt c hin th. Nu target window l mt chui rng, text c hin th trong ca s target mc nh _self. Nu thuc tnh TextFormat.url c thit t thnh chui rng hoc thnh gi tr null, thuc tnh ny c th ly (get) nhng khng c nh hng (has no effect). align S canh chnh ca on vn, biu th nh mt chui. Nu l "left", on vn c canh l tri. Nu l "center", on vn c canh gia. Nu l "right", on vn c canh l phi. leftMargin Cho bit l tri ca on vn, theo point. rightMargin Cho bit l phi ca on vn, theo point. indent Mt s nguyn cho bit s tht dng t l tri ti k t u tin trong on vn. leading Mt s cho bit s lng khong trng dc gia cc dng. Description Constructor; to mt instance (th hin) ca i tng TextFormat vi cc thuc tnh c ch nh. Sau bn c th thay i cc thuc tnh ca i tng TextFormat thay i nh dng ca cc trng text. Mi tham s c th c thit t thnh gi tr null ch ra rng n khng c xc nh. Tt c cc tham s ty chn, tham s no b b qua u c xem l null. Availability Flash Player 6.
100
this Availability Flash Player 5. Usage this Description Keyword (t kha); tham chiu mt instance (th hin) ca i tng hoc movie clip. Khi script thc thi, this tham chiu movie clip instance cha script. Khi mt method c gi, this cha mt tham chiu ti i tng m c cha method gi. Bn trong mt b qun l s kin hnh vi on gn vo mt nt, this chuyn n Timeline m cha nt. Bn trong mt hnh vi qun l s kin onClipEvent gn vo mt movie clip, this chuyn ti Timeline ca chnh movie clip Example Trong v d sau, t kho this tham chiu i tng Circle (hnh trn). function Circle(radius) { this.radius = radius; this.area = Math.PI * radius * radius;} Trong cu lnh sau c gn cho mt frame, t kho this tham chiu movie clip hin ti. // thit t thuc tnh trong sut alpha ca movie clip thnh 20this._alpha = 20; Trong cu lnh sau gn cho b qun l s kin onClipEvent, t kho this tham chiu movie clip hin ti. // khi movie clip np, mt thao tc startDrag// c bt u vi movie clip hin thi.onClipEvent (load) { startDrag (this, true);} See also new toggleHighQuality Availability Flash 2. Usage 101
toggleHighQuality() Parameters None. Returns Nothing. Description Action (hnh vi); bt v tt ch kh rng ca trong Flash Player. Ch kh rng ca lm trn cc ra ca i tng v lm chm s pht li ca movie. Hnh vi toggleHighQuality nh hng n tt c cc movie trong Flash Player. Example on m sau c th p dng cho mt nt m, khi c click, s bt hoc tt ch kh rng ca: on(release) { toggleHighQuality(); } See also _quality, _highquality trace Availability Flash Player 4. Usage trace(expression) Parameters expression Mt biu thc c lng. Khi mt file SWF c m trong cng c thit k Flash (qua lnh Test Movie), gi tr ca tham s expression c trnh by trong ca s Output. Returns Nothing. Description 102
Action (hnh vi); nh gi biu thc expression v hin th kt qu trong ca s Output ch kim tra. S dng trace (ghi li chui trong cc pht biu ca chng trnh c thc thi v mt cch ty chn, cc gi tr ca bin chng trnh c thc hin trong cc pht biu y) ghi li nhng lu , ch gii khi lp trnh hoc hin th cc thng bo trong ca s Output trong khi ang kim tra mt movie. Dng tham s expression kim tra nu mt iu kin tn ti, hoc hin th cc gi tr trong ca s Output. Hnh vi trace tng t nh hm alert (cnh bo) trong JavaScript. Bn c th s dng cc lnh hnh ng Omit Trace (b qua Trace) trong Publish Settings loi b cc hnh vi trace t file SWF xut ra. Example V d ny l t mt tr chi ti mt th hin (instance) ca movie clip c th ko c (draggable) t tn l rabbi phi c nh ra trn mt target (ch) xc nh. Mt cu lnh c iu kin nh gi thuc tnh _droptarget v thc thi cc hnh vi khc nhau tu thuc vo ni rabbi c released (gii thot). Hnh vi trace c dng cui ca on script nh gi v tr ca movie clip rabbi, v hin th kt qa trong ca s Output. Nu rabbi khng chy nh mong i (v d, nu n canh ti ng dn sai), cc gi tr gi ti ca s Output bi hnh vi trace s gip bn xc nh trc trc trong on script. on(press) { rabbi.startDrag(); }
typeof Availability Flash Player 5. Usage typeof expression 103
Parameters expression Mt chui (string), movie clip, nt (button), i tng (object), hoc hm (function). Description Operator (ton t); mt ton t n nguyn (ch c mt s hng) t trc mt tham s n (single parameter). Ton t typeof ra lnh cho Flash interpreter (ngi phin dch, trnh din Flash) c lng biu thc expression; kt qu l mt chui xc nh xem biu thc l mt chui, movie clip, i tng, hay hm. Bng sau y cho bit kt qu ca ton t typeof trn mi kiu ca biu thc expression: Parameter Output String (chui) string MovieClip movieclip Button (nt) object Text field (trng ch) object Number (s) number Boolean (gi tr logic) boolean Object (i tng) object Function (hm) function
Mt gi tr c bit, thng c s dng cho bit mt bin c gn mt gi tr. Mt s chuyn n mt gi tr khng xc nh tr li gi tr c bit undefined. on m ActionScript typeof(undefined) tr li chui "undefined". Gi tr duy nht ca kiu undefined l undefined. Khi undefined c chuyn thnh mt chui, n chuyn i thnh chui rng (it converts to the empty string). Gi tr undefined tng t nh gi tr c bit null. Trong thc t, khi null v undefined c so snh vi du ng thc (equality operator), chng ngang nhau. Example Trong v d sau, bin x khng c khai bo v v th c gi tr khng xc nh undefined. Trong phn u tin ca on m, ton t ng thc (==) so snh gi tr ca x vi gi tr undefined v kt qu thch hp c gi ti ca s xut ra Output window. Trong phn th hai ca on m, ton t ng thc so snh cc gi tr null v undefined. // x khng c khai botrace ("The value of x is " + x);if (x == undefined) { trace ("x is undefined");} else { trace ("x is not undefined");}trace ("typeof (x) is " + typeof (x));if (null == undefined) { trace ("null and undefined are equal");} else { trace ("null and undefined are not equal");} Kt qu nh sau c hin th trong ca s Output window: The value of x is x is undefinedtypeof (x) is undefinednull and undefined are equal Ch : Trong ECMA-262 specification (c im k thut), undefined chuyn thnh chui "undefined", khng phi l chui rng. y l im khc bit gia ActionScript v ECMA-262 specification. unescape Availability Flash Player 5. Usage unescape(x) Parameters x Mt chui vi cc dy thuc h 16 thot ra (A string with hexadecimal sequences to escape). Returns Nothing. 105
Description Hm cp cao (Top-level function); c lng tham s x nh mt chui, c chui t URL-dng c m ho (chuyn i tt c cc dy h 16 thnh cc k t ASCII), v tr li chui. Example V d sau minh ha qu trnh chuyn i escape-ti-unescape . escape("Hello{[World]}"); Kt qu thot ra (escaped result) nh sau: ("Hello%7B%5BWorld%5D%7D'); Dng unescape tr li dng nguyn gc: unescape("Hello%7B%5BWorld%5D%7D") Kt qu nh sau: Hello{[World]} unloadMovie Availability Flash Player 3. Usage unloadMovie[Num](level/"target") Parameters level Mc (_levelN) ca mt movie c load. Khi bn ngng np (unload) mt movie t mt mc (level), hnh vi unloadMovie trong bng Action ch normal (bnh thng) chuyn i thnh unloadMovieNum; trong ch expert mode, bn phi ch nh unloadMovieNum hoc chn n t hp cng c Actions. target ch ng dn ca mt movie clip. Returns None. Description 106
Hnh vi (Action); g b mt movie hoc mt movie clip (on phim) c np t Flash Player. ngng np (unload) mt movie m c np vo trong mt mc trong Flash Player, s dng thng s level . unload mt movie clip c np, dng tham s target . Example V d sau y unload movie clip draggable trn Timeline chnh, v np movie movie.swf vo level 4. on (press) { unloadMovie ("_root.draggable"); loadMovieNum ("movie.swf", 4); } V d sau unload movie c np vo level 4: on (press) { unloadMovieNum (4); } See also loadMovie, loadMovieNum, unloadMovieNum
unloadMovieNum Availability Flash Player 3. Usage unloadMovieNum(level) Parameters level Mc (_levelN) ca mt movie c np. Returns Nothing. Description Hnh vi (Action); g b mt movie c np t trnh Flash Player. See also 107
loadMovie, loadMovieNum updateAfterEvent Availability Flash Player 5. Usage updateAfterEvent() Parameters None. Returns Nothing. Description Hnh vi (Action); cp nht s hin th (s c lp ca cc khung frame mi giy thit t cho movie) khi bn gi n bn trong mt trnh x l (handler) onClipEvent hoc nh mt phn ca mt hm hoc method m bn chuyn thnh (pass to) setInterval. Flash b qua cc lnh gi ti updateAfterEvent m khng trong mt trnh x l onClipEvent handler hoc mt phn ca mt hm hoc method c chuyn thnh setInterval. See also onClipEvent, setInterval var Availability Flash Player 5. Usage var variableName1 [= value1] [...,variableNameN [=valueN]] Parameters variableName (c ngha l tn bin) Mt t nh danh. value Gi tr c gn cho bin. 108
Returns Nothing. Description Hnh vi (Action); c dng biu th cc bin cc b. Nu bn trnh by cc bin cc b bn trong mt hm, cc bin c nh ngha cho hm v ht hiu lc khi kt thc lnh gi hm. Nu cc bin khng c trnh by trong mt khi ({}), nhng danh sch hnh vi (action list) c thc thi vi mt hnh vi gi call , cc bin l cc b v ht hiu lc kt thc ca danh sch hin ti. Nu cc bin khng c biu th bn trong mt khi v danh sch hnh vi hin ti khng c thc thi vi mt hnh vi gi call action, cc bin khng phi l cc b. Example Cc v d sau dng hnh vi var biu th v gn cc bin: var x; var y = 1; var z = 3, w = 4; var s, t, u = z; void Availability Flash Player 5. Usage void (expression) Description Ton t (Operator); mt ton t n nguyn (a unary operator: ton t s hc ch c mt s hng) loi b gi tr expression (biu thc) v tr li mt gi tr khng xc nh. Ton t void (b trng) thng c dng trong s so snh s dng ton t == kim tra cho cc gi tr khng xc nh. while Availability Flash Player 4. Usage while(condition) { statement(s); } 109
Parameters condition (iu kin) Biu thc m c c lng li mi ln hnh vi while c thc thi. Nu khai bo c lng l ng true, th statement(s) s chy. statement(s) on m thc thi nu iu kin c lng l true. Returns Nothing. Description Hnh vi (Action); kim tra mt biu thc v thc hin mt cu lnh hoc mt chui cc lnh lp li trong mt vng lp cho n khi biu thc nhn gi tr true. Trc khi khi lnh c chy, iu kin condition c kim tra; nu qu trnh kim tra tr v l ng true, khi lnh s c chy. Nu iu kin l sai false, khi lnh s c b qua v cu lnh u tin sau khi lnh ca hnh vi while s c thc thi. Qu trnh lp thng thng c dng thc hin mt hnh vi trong khi mt bin m (counter variable) nh hn mt gi tr xc nh. Ti im kt ca mi vng lp, my m c gia tng mt tr s cho n khi t ti gi tr xc nh trn. im , iu kin condition khng tr li gi tr true na, v vng lp kt thc. Cu lnh while thc hin chui cc bc nh sau. Mi bn sao ca cc bc t 1-4 c gi l mt php lp ca vng lp. iu kin condition c kim tra li im bt u ca mi php lp, nh trong cc bc sau: 1 Biu thc iu kin condition c c lng. 2 Nu condition c lng l ng true hoc mt gi tr m khi chuyn i sang gi tr logic Boolean l true, chng hn nh mt s khc khng, chuyn sang bc 3. Nu khng th, cu lnh while c hon thnh v thc thi li cu lnh tip theo sau vng lp while . 3 Thc thi khi lnh statement(s). 4 Chuyn ti bc 1. Example V d sau sao li 5 movie clip trn Stage, mi ci vi mt v tr x v y c to ngu nhin, thuc tnh xscale v yscale, v _alpha thc hin mt hiu ng ri rc (a scattered effect). Bin foo c khi chy vi gi tr 0. Tham s iu kin condition c thit t vi mc ch vng lp while s chy nm ln, cho n khi no gi tr ca bin foo cn nh hn 5. Bn trong vng lp while , mt movie clip c sao li (duplicate) v setProperty c dng iu chnh cc thuc tnh khc nhau ca movie clip bn sao. Cu lnh cui cng ca vng lp gia tng mt tr s foo vi 110
mc ch n khi gi tr t ti 5, tham s iu kin condition c lng l sai false, v vng lp s khng c thc thi. on(release) { foo = 0; while(foo < 5) { duplicateMovieClip("_root.flower", "mc" + foo, foo); setProperty("mc" + foo, _x, random(275)); setProperty("mc" + foo, _y, random(275)); setProperty("mc" + foo, _alpha, random(275)); setProperty("mc" + foo, _xscale, random(200)); setProperty("mc" + foo, _yscale, random(200)); foo++; } } See also do while, continue, for, for..in with Availability Flash Player 5. Usage with (object) { statement(s); } Parameters object Mt instance (trng hp) ca mt i tng ActionScript hoc mt movie clip. statement(s) Mt hnh vi hoc mt nhm hnh vi bao bn trong cc du ngoc xon. Returns Nothing. Description Hnh vi (Action); cho php bn ch nh mt i tng (nh l mt movie clip) vi tham s object v c lng cc biu thc v cc hnh vi bn trong i tng vi tham s statement(s) . iu ny ngn cn bn t vic phi vit i vit li tn i tng hoc ng dn ti i tng. Tham s object tr thnh ng cnh trong cc thuc tnh, cc bin, v cc hm trong tham s statement(s) c c. V d, nu object l myArray, v hai thuc tnh c ch nh l length v concat, cc thuc tnh t ng c c nh myArray.length v myArray.concat. 111
Trong v d khc, nu object l state.california, bt k hnh vi hoc cu lnh no bn trong hnh vi with c gi t bn trong california instance. tm gi tr ca mt t nh danh trong tham s statement(s) , ActionScript bt u ti m u ca scope chain (ti tm dch l phm vi ca chui) c ch nh bi object v tm kim cho t nh danh ti mi level (mc) ca scope chain, theo mt th t xc nh. The scope chain dng bi hnh vi with phn tch cc t nh danh bt u vi mc u tin trong danh sch sau v tip tc ti mc cui cng:
i tng ch nh trong tham s object tn trong cng ca hnh vi (action) with .
i tng ch nh trong tham s object pha ngoi cng ca hnh vi with .
i tng kch hot. (Mt i tng tm thi c t ng to khi mt hm c gi cha cc bin cc b gi trong hm.)
on movie clip cha on script hin ang c thc thi.
i tng chung :The Global object (gn lin vi cc i tng chng hn nh Math v String). thit t mt bin bn trong mt hnh vi (action) with , bin phi c khai bo (declare) bn ngoi hnh vi with hoc bn phi nhp ng dn y n Timeline m trn bn mun t bin. Nu bn thit t mt bin trong mt hnh vi with m khng khai bo n, hnh vi with s tm kim gi tr theo scope chain. Nu bin cha tn ti, gi tr mi s c thit lp trn Timeline t ch hnh vi with c gi. Trong Flash 5, hnh vi with thay th hnh vi khng c chp nhn tellTarget. Bn nn hng ng vic s dng with thay v tellTarget bi v n l mt phn ActionScript tiu chun m rng ca chun ECMA-262 . S khc nhau c bn gia cc hnh vi with v tellTarget l ch with a mt tham chiu ti mt movie clip hoc i tng khc nh tham s ca n, trong khi tellTarget a mt chui ng dn nhn bit mt movie clip nh tham s ca n, v khng th s dng cc i tng ng dn. Example V d sau thit t cc thuc tnh x v y ca instance (th hin, trng hp) someOtherMovieClip, v sau ch th cho someOtherMovieClip i n frame 3 v dng li. with (someOtherMovieClip) { _x = 50; _y = 100; gotoAndStop(3); } on m sau cho ta thy cch vit code c trc m khng cn dng hnh vi with. someOtherMovieClip._x = 50; someOtherMovieClip._y = 100; someOtherMovieClip.gotoAndStop(3); 112
Bn cng c th vit on m ny bng cch s dng hnh vi tellTarget. Tuy nhin, nu someOtherMovieClip khng phi l mt movie clip, nhng l mt i tng, bn khng th s dng hnh vi with. tellTarget ("someOtherMovieClip") { _x = 50; _y = 100; gotoAndStop(3); } Hnh vi with rt hu dng trong vic truy cp vo nhiu mc phc tp trong mt danh sch scope chain (chui mc ch, chui kin thc...---> chng bit dch th no) xy ra cng mt lc ( is useful for accessing multiple items in a scope chain list simultaneously). Trong v d sau, i tng c ci t sn Math c t pha trc ca scop chain. Vic thit lp Math nh mt i tng mc nh phn tch cc t nh danh cos, sin, v PI to Math.cos, Math.sin, v Math.PI, mt cch ln lt. Cc t nh danh a, x, y, v r khng phi l cc method (phng php, cch thc) hoc cc thuc tnh (properties) ca i tng Math, nhng t khi chng tn ti trong phm vi kch hot ca hm polar, chng phn tch ti cc bin cc b tng ng (they resolve to the corresponding local variables). function polar(r) { var a, x, y; with (Math) { a = PI * r * r; x = r * cos(PI); y = r * sin(PI/2); } trace("area = " +a); trace("x = " + x); trace("y = " + y); } Bn c th dng cc hnh vi with lng vo nhau truy cp thng tin trong nhiu scope (phm vi). Trong v d sau, instance fresno v instance salinas l c mc l con ca instance california. Cu lnh thit lp cc gi tr _alpha ca fresno v salinas m khng lm thay i gi tr _alpha ca california. with (california){ with (fresno){ _alpha = 20; } with (salinas){ _alpha = 40; } } See also tellTarget
113
XML (object) : XML (i tng) S dng cc method v thuc tnh ca i tng XML np, phn tch, gi, xy dng, v thao tc cc cy ti liu XML. Trong Flash MX, i tng XML tr thnh mt i tng t nhin (tc l c sn t cc phin bn trc). Theo ngha thng thng, bn s thy s ci tin n tng trong khi tin hnh cng vic. Bn phi dng constructor (ngi xy dng) new XML() to mt th hin (instance) ca i tng XML trc khi gi bt k i tng XML no. XML c h tr bi Flash Player 5 v Flash Player 6.
Bn tm tt cc method cho i tng XML. Method Description XML.appendChild B sung thm mt nt d liu vo cui ca danh sch i tng con xc nh (Appends a node to the end of the specified object's child list). XML.cloneNode Bt chc nt d liu xc nh v, mc nhin, sao chp c tnh quy tt c cc thnh phn con (Clones the specified node and, optionally, recursively clones all children). XML.createElement To mt phn t XML mi. XML.createTextNode To mt XML text node mi. XML.getBytesLoaded Tr v s byte np cho ti liu XML xc nh. XML.getBytesTotal Tr v kch c ca ti liu XML theo byte. XML.hasChildNodes Tr v true nu nt d liu ch nh c cc nt con; nu khng th, tr v l false. XML.insertBefore Chn mt nt vo trc mt nt c trong danh sch cc nt con xc nh (Inserts a node in front of an existing node in the specified node's child list). XML.load Np mt ti liu (nh r bi i tng XML ) t mt URL. XML.parseXML Phn tch mt ti liu XML vo trong cy i tng XML xc nh. XML.removeNode Loi b nt ch nh t m ca n (Removes the specified node from its parent). XML.send Gi i tng XML xc nh ti mt URL. XML.sendAndLoad Gi i tng XML xc nh ti mt URL v np cu tr li ca my ch (server response) vo trong mt i tng XML khc. 114
XML.toString Chuyn i nt d liu xc nh v bt k cc nt con ca chng thnh vn bn XML.
Bn tm tt cc thuc tnh ca i tng XML Property Description XML.contentType Cho bit kiu MIME truyn ti server. XML.docTypeDecl Thit lp v tr v thng tin v mt tuyn b kiu vn bn ca mt ti liu XML (Sets and returns information about an XML document's DOCTYPE declaration). XML.firstChild Chuyn n (lin h) nt con u tin trong danh sch cho cc nt xc nh. XML.ignoreWhite Khi thit lp l true, cc nt d liu vn bn (text nodes) m ch cha du cch trng b loi b trong sut qu trnh phn tch. XML.lastChild Chuyn n nt con cui cng trong danh sch cc nt xc nh. XML.load Kim tra nu i tng XML c ch nh c np. XML.nextSibling Chuyn n sibling (anh ch em rut) tip theo trong danh sch nhng a con ca nt d liu m (References the next sibling in the parent node's child list). XML.nodeName Tr v tn tag ca mt phn t XML XML.nodeType Tr v kiu ca nt d liu c ch r (phn t XML hoc nt vn bn). XML.nodeValue Tr v text (vn bn) ca nt d liu xc nh nu nt l mt nt vn bn (text node). XML.parentNode Tr v nt m (parent node) ca nt c ch r (specified node). XML.previousSibling Tr v sibling ngay trc trong danh sch cc nt con ca nt m (References the previous sibling in the parent node's child list). XML.status Tr v mt m trng thi cho bit vic phn tch mt ti liu XML thnh cng hay tht bi (Returns a numeric status code indicating the success or failure of an XML document parsing operation). XML.xmlDecl Thit t v tr v thng tin v mt "tuyn b" ca ti liu XML (Sets and returns information about an XML document's document declaration). 115
Collections summary for the XML object Method Description XML.attributes Tr v mt mng kt hp cha tt c cc thuc tnh (attribute) ca nt d liu c ch r. XML.childNodes Tr v mt mng cha cc lin h (references) ti cc nt con ca nt d liu c ch r (specified node).
Bn tm tt b qun l s kin (Event handler) cho i tng XML Method Description XML.onData Mt hm gi tr v (callback function) vin dn khi vn bn XML c download trn vn t my ch (server), hoc mt li xy ra trong khi ang ownload vn bn XML t mt server. XML.onLoad Mt callback function dnh cho load (np) v sendAndLoad (gi v np).
Constructor (ngi xy dng) cho i tng XML object Availability Flash Player 5. Usage new XML([source]) Parameters source Vn bn XML phn tch to i tng XML mi. Returns Nothing. Description 116
Constructor; to mt i tng XML mi. Bn phi dng method constructor to mt th hin (instance) ca i tng XML trc khi gi bt k method no ca i tng XML. Ch : Cc method (phng php, cch thc) createElement (to phn t) v createTextNode (to nt text) l cc method xy dng 'constructor' cho vic to cc phn t v nt d liu text (text nodes) trong mt cy ti liu XML. Example Cch dng 1: V d sau to mt i tng XML mi v rng (khng c g trong). myXML = new XML(); Cch dng 2: V d sau to mt i tng XML bng cch phn tch vn bn XML c ch r trong tham s source , v a (populates) i tng XML mi c to vi vic a n cy ti liu XML (populates the newly created XML object with the resulting XML document tree). anyOtherXML = new XML("<state>California<city>san francisco</city></state>"); See also XML.createElement, XML.createTextNode XML.send Availability Flash Player 5. Usage myXML.send(url, [window]) Parameters url a ch URL ch i vi i tng XML ch nh. window Ca s trnh duyt hin th d liu tr v bi server: _self ch nh khung hin ti trong ca s hin ti, _blank ch nh mt ca s mi, _parent ch nh "m" (cp cao hn) ca frame hin ti, v _top ch nh frame cp cao nht trong ca s hin ti. Tham s ny l ty chn; nu khng tham s window no c ch nh, s tng t nh ch nh _self. Returns Nothing. Description 117
Method (phng php, cch thc); m ha i tng XML ch nh vo trong mt ti liu XML v gi n ti a ch URL xc nh bng cch dng method POST. XML.status Availability Flash Player 5. Usage myXML.status Description Property (thuc tnh); t ng thit t v tr v mt gi tr s cho bit xem mt ti liu XML c phn tch thnh cng vo trong mt i tng XML. M trng thi s v mt phn m t ca mi m c lit k nh di y:
0 Khng c li; vic phn tch hon ton thnh cng (No error; parse was completed successfully).
-2 Mt phn CDATA khng c hon thnh ng cch (A CDATA section was not properly terminated).
-3 Tuyn b XML khng c hon thnh ng cch (The XML declaration was not properly terminated).
-4 Tuyn b kiu ti liu khng c hon thnh mt cch thch hp (The DOCTYPE declaration was not properly terminated).
-5 Mt ni dung khng c hon thnh ng cch (A comment was not properly terminated).
-6 Mt phn t XML b d dng (An XML element was malformed).
-7 Xut b nh (Out of memory).
-8 Mt gi tr thuc tnh khng c hon thnh mt cch thch hp (An attribute value was not properly terminated).
-9 Mt th bt u khng khp vi mt th kt thc (A start-tag was not matched with an end- tag).
-10 Mt th kt thc c bt gp m khng khp vi mt th bt u (An end-tag was encountered without a matching start-tag). XMLSocket (object) { cm XML (i tng)} B sung kin thc: Socket: cm : trong vic ghi a ch trn Internet l mt s kt hp mt a ch IP (a ch ny xc nh mt my ch) v mt a ch cng (a ch ny xc nh mt trnh ng dng chy trn my ch ny). Hai a ch ny cng c s dng xc nh mt dch v c bit trn khp Internet. iu ny khng cn thit cho cc dch v ni ting chng hn nh FTP v Telnet, bi l cc dch v ny s dng cc cng tiu chun. Nh bn mun s dng mt chng trnh duy nht 118
nh mt MUD (tr chi sn tm trn Internet) ang chy trn mt my ch t xa no , th bn s phi c mt cm. V d, truy cp mt MUD bn s dng Telnet v nh a ch s ca ID v sau l s cng. i tng XMLSocket thc thi cc cm khch (client socket) m cho php my tnh chy Flash Player giao tip vi mt my tnh ch nhn dng bi mt a ch IP hoc tn min (domain name).
S dng i tng XMLSocket s dng i tng XMLSocket , my ch (server computer) phi chy mt daemon (trong cc h thng UNIX, y l mt trnh tin ch hot ng kn o trong nn sau, thc hin cc nhim v cn thit nh tip nhn th in t gi n chng hn, ngi dng khng nhn bit s c mt ca daemon) hiu c giao thc s dng bi i tng XMLSocket. Giao thc nh l di y:
Cc thng bo XML c gi ln trn mt song cng hon ton (mt nh c truyn thng, trong knh truyn thng c th gi v nhn cc tn hiu ng thi cng mt lc) TCP/IP lm thng kt ni socket (XML messages are sent over a full-duplex TCP/IP stream socket connection).
Mi thng bo XML l mt ti liu XML hon thnh, kt thc bi mt byte khng (Each XML message is a complete XML document, terminated by a zero byte).
Mt s khng gii hn cc thng bo XML c th c gi v tip nhn trn mt kt ni XMLSocket n (An unlimited number of XML messages can be sent and received over a single XMLSocket connection). i tng XMLSocket rt hu ch i vi cc trnh ng dng khch-ch (client-server) i hi thi gian ch thp, chng hn nh cc h thng chat thi gian thc (real-time chat system). Mt gii php chat da trn HTTP truyn thng thng xuyn thm d my ch v ti xung nhng tin nhn mi bng cch s dng mt yu cu HTTP. Tri li, mt gii php chat XMLSocket duy tr mt kt ni m ti my ch, cho php my ch ngay lp tc gi cc tin nhn mi n m khng cn mt yu cu t my khch. Thit lp trn mt my ch giao tip vi i tng XMLSocket c th b khng tha nhn. Nu trnh ng dng ca bn khng ph thuc vo tng tc thi gian thc, hy s dng hnh vi loadVariables , hoc Flash HTTP-da vo XML server kt ni (XML.load, XML.sendAndLoad, XML.send), thay v s dng i tng XMLSocket . s dng cc method ca i tng XMLSocket, u tin bn phi dng trnh xy dng constructor, new XMLSocket, to mt i tng XMLSocket mi.
XMLSocket v bo mt Bi v i tng XMLSocket thit lp v duy tr mt kt ni m ti my ch, cc hn ch sau y c t trn i tng XMLSocket cho cc l do bo mt: 119
Method XMLSocket.connect ch c th kt ni ti TCP cc cng s hn hn hoc bng 1024. Mt kt qu ca hn ch ny l cc daemon my ch m giao tip vi i tng XMLSocket cng phi c gn vo cc s cng ln hn hoc bng 1024. Cc s cng nh hn 1024 thng c s dng bi cc h thng dch v nh FTP, Telnet, v HTTP, do i tng XMLSocket b chn t nhng cng ny bi nhng l do bo mt. S hn ch s cng gii hn tim nng m nhng ti nguyn ny s b truy cp v lm dng mt cch khng thch hp.
Method XMLSocket.connect ch c th kt ni ti cc my tnh trong cng min con ni t file SWF (movie). Hn ch ny khng p dng cho cc movie chy khi mt a cc b ( running off a local disk). (Hn ch ny ging ht cc quy tc bo mt i vi loadVariables, XML.sendAndLoad, v XML.load.)
Bng tm lc cc method i vi i tng XMLSocket Method Description XMLSocket.close ng mt kt ni socket m XMLSocket.connect Thit lp mt kt ni ti my ch xc nh. XMLSocket.send Gi mt i tng XML ti my ch.
Event handler cho i tng XMLSocket Method Description XMLSocket.onClose Mt hm (chc nng) gi ngc li c vin dn khi mt kt ni XMLSocket b ng. XMLSocket.onConnect Mt hm gi ngc li (callback function) c vin dn khi mt kt ni XMLSocket c thit lp. XMLSocket.onData Mt hm gi ngc li c vin dn khi mt thng bo XML c ti xung t my ch. XMLSocket.onXML Mt hm gi ngc li c vin dn khi mt i tng XML n t my ch.
Constructor cho i tng XMLSocket object Availability 120
Flash Player 5. Usage new XMLSocket() Parameters None. Returns Nothing. Description Constructor (trnh xy dng); to mt i tng XMLSocket mi. i tng XMLSocket ban u khng kt ni vi bt k my ch no. Bn phi gi method XMLSocket.connect kt ni i tng ti mt server. Example myXMLSocket = new XMLSocket(); See also XMLSocket.connect