Objekty MOVIE
Předdefinované objekty MOVIE většinou reprezentují, jak už název napovídá, grafické prvky animace, jako třeba tlačítko nebo MovieClip. Vytvoření instance objektu je většinou docíleno vložením objektu z knihovny do animace a jeho pojmenování.
Stránka má nastaveny tyto příznaky:
- Informace jsou dopředně nekompatibilní. Některé popsané jazykové pravidla nebo postupy byly v pozdějších verzích zavrženy.
Obsah
Button (tlačítko)
Objekt ovlivňující instanci tlačítka na scéně.
Metody Button
| getDepth | udá pozici v ose Z (hloubka neboli pořadí zobrazení) |
|---|
Vlastnosti Button
| enabled | Vrací nebo nastavuje TRUE/FALSE podle toho, jestli je (má být) tl. zablokováno nebo ne |
|---|---|
| tabEnabled | Povolit navigaci pomocí TAB |
| tabIndex | Pořadí výběru objektu při navigaci tlačítkem TAB |
| trackAsMenu | Umožňuje jinému tlačítku převzít událost "release" |
| useHandCursor | použít kurzor "ruka" |
Události Button
Tyto příkazy dovolují externě definovat funkci, která se má provést po určité události.
tlacitko.onRelease = function () { gotoAndPlay(5); };
Tento zápis je ekvivalentní k definici příkazů přímo v instanci tlačítka "tlacitko":
on (release) { gotoAndPlay(5); }
V obou případech přejde animace po kliknutí na tlačítko "tlacitko" na snímek č. 5.
| onDragOut | Tažení ven |
|---|---|
| onDragOver | Tažení dovnitř |
| onPress | Kliknutí |
| onRelease | Puštění tlačítka myši |
| onReleaseOutside | Puštění tlačítka myši mimo instanci |
| onRollOut | Přejetí ven |
| onRollOver | Přejetí dovnitř |
Capabilites (schopnosti)
Vrací vlastnosti přehrávače případně serveru.
System.capabilities.vlastnost;
Vlastnosti Capabilities
| hasAccessibility | Přítomnost pomocných komunikačních zařízení |
|---|---|
| hasAudio | Přehrávání audia |
| hasAudioEncoder | Přítomnost dekodéru audia |
| hasMP3 | Přítomnost dekodéru MP3 |
| hasVideoEncoder | Přítomnost dekodéru videa |
| pixelAspectRatio | Poměr stran pixelů (standardně 1) |
| screenColor | Barevnost monitoru |
| screenDPI | Počet bodů/palec monitoru (DPI = dots per inch) |
| screenResolutionX | Rozlišení monitoru v ose X |
| screenResolutionY | Rozlišení monitoru v ose Y |
Color (barva)
Umožňuje definovat barvu instance MC.
barva = new Color(nazevInstanceMC);
Metody Color
| getRGB | Vrací hexadecimální hodnotu barvy (0xRRGGBB) |
|---|---|
| getTransform | Vrací hodnotu barevné transformace nastavenou setTransform |
| setRGB | Nastaví hexadecimální hodnotu barvy |
| setTransform | Nastaví barevnou transformaci - viz níže |
Příklad na setTransform()
Tato metoda nastavuje hodnoty, které známe z panelu "properties" - viz Knihovna.barva = new Color(kruh); // vytvoření objektu "barva" s cílem na MovieClip "kruh" transform = new Object(); // vytvoření objektu "transform" pomocí generického objektu "Object()" transform = {ra:'50',rb:'244',ga:'40',gb:'112',ba:'12',bb:'90',aa:'40',ab:'70'}; // přiřazení hodnot barva.setTransform(transform); // aplikování hodnot v objektu "barva"
| ra | procento červené (-100 až 100). |
|---|---|
| rb | vyrovnání červené (-255 až 255). |
| ga | procento zelené (-100 až 100). |
| gb | vyrovnání zelené (-255 až 255). |
| ba | procento modré (-100 až 100). |
| bb | vyrovnání modré (-255 až 255). |
| aa | procento afla (-100 až 100). |
| ab | vyrovnání alfa (-255 až 255). |
Key (klávesa)
Objekt upravující výstup z klávesnice.
Metody Key
| addListener | Přidat objekt, který bude možno ovládat |
|---|---|
| getAscii | Vrací ASCII kód poslední zmáčknuté klávesy |
| getCode | Vrací kód poslední zmáčknuté klávesy |
| isDown | Vrací TRUE/FALSE podle toho, jestli je klávesa zmáčknuta |
| isToggled | Vrací TRUE/FALSE pokud je klávesa aktivována (platí pro NumLock a CapsLock) |
| removeListener | Odebrat objekt přidaný příkazem addListener |
Konstanty Key
Key.konstanta
| BACKSPACE | |
|---|---|
| CAPSLOCK | |
| CONTROL | |
| DELETEKEY | |
| DOWN | šipka dolů |
| END | |
| ENTER | |
| ESCAPE | |
| HOME | |
| INSERT | |
| LEFT | šipka doleva |
| PGDN | |
| PGUP | |
| RIGHT | šipka doprava |
| SHIFT | |
| SPACE | mezerník |
| TAB | |
| UP | šipka nahoru |
Události Key
| onKeyDown | Stisk tlačítka |
|---|---|
| onKeyUp | Uvolnění tlačítka |
onClipEvent (enterFrame){ if(Key.isDown(Key.RIGHT)){ _x += 10; } }
Pokud zde stiskneme šipku vpravo (Key.isDown bude TRUE), posune se každý snímek MovieClip (this) o 10px vpravo.
Ukázka metody AddListener objektu Key
objekt3 = new Object(); // vytvoření generického objektu Object() objekt3.onKeyDown = function () { Play(); } // deklarace metody onKeyDown (viz Objekty-úvod) objekt3.onKeyUp = function () { Stop(); } // deklarace metody onKeyUp (viz Objekty-úvod) Key.addListener(objekt3); // asociace objektu "objekt3" s objektem Key
Kdybychom teď zmáčkli nějakou klávesu, začalo by přehrávání animace. Po uvolnění klávesy by se animace zastavila.
Mouse (myš)
Objekt upravující výstup z myši
Metody Mouse
| addListener* | Přidat objekt, který bude možno ovládat |
|---|---|
| hide | Schovat kurzor |
| removeListener | Odebrat objekt přidaný příkazem addListener |
| show | Zobrazit kurzor |
Události Mouse
| onMouseDown | Kliknutí |
|---|---|
| onMouseMove | Pohyb |
| onMouseUp | Uvolnění |
MovieClip
Objekt ovlivňující instanci MovieClipu na scéně.
Zde je dobré si uvědomit, že hlavní časová osa je taky MovieClip, který nenese žádné jméno (případně "_root"). Můžete tedy klidně jako název MC napsat "_root" a příkaz tak bude platit pro hlavní časovou osu. Samozřejmě není možné používat příkazy, které na hlavní časové ose postrádají smysl.
Metody MovieClip
| attachMovie | Připojuje MC z knihovny (IDjméno, jméno, hloubka) |
|---|---|
| createEmptyMovieClip | Vytvořit prázdný MC (jméno, hloubka) |
| createTextField | Vytvořit uvnitř MC textové pole.(jméno, hloubka, x, y,
šířka, výška)Jeho vlastnosti umožňuje nastavit objekt TextFormat (viz níže) |
| duplicateMovieClip | Duplikovat MC (novéJméno, hloubka, objekt*)* Pokud definujete objekt, budou jeho vlastnosti zkopírovány do nového MC |
| getBounds | Vrací souřadnice rámečku, ohraničujícího MC v definovaném
souřadnicovém prostoru např (._root) |
| getBytesLoaded | Vrací hodnotu načtených bytů animace do MC |
| getBytesTotal | Vrací hodnotu celkové velikosti animace do MC |
| getDepth | Vrací hloubku instance MC |
| getURL | Přejde na URL adresu a umožňuje odesílat proměnné
(URL,
okno, proměnné) |
| globalToLocal | Konvertuje globální souřadnice na lokální souř. MC |
| gotoAndPlay | Přejde na snímek MC a spustí přehrávání |
| gotoAndStop | Přejde na snímek MC |
| hitTest | Metoda kontrolující kolize 2 MC nebo MC a bodu na scéně.
Vrací TRUE/FALSE
(cílovýMC) nebo (x, y, true/false*)* true = uvažovat skutečný tvar instance (nikoliv celý rámeček) |
| loadMovie | Načte SWF animaci do přehrávače
(URL, proměnné) |
| loadVariables | Načte a zároveň odešle proměnné z (do) souboru
(URL,
proměnné) |
| localToGlobal | Konvertuje lokální souřadnice MC na souř. scény |
| nextFrame | Posune MC o jeden snímek dopředu |
| play | Spustí přehrávání MC |
| prevFrame | Vrátí MC o jeden snímek zpět |
| removeMovieClip | Odstraní instanci MC na scéně |
| setMask | Použije cílový MC jako masku
(maskovacíMC) |
| startDrag | Započne tažení MC myší
(zamknoutNaStřed, vlevo, vpravo,
nahoře, dole*)* ohraničující prostor, kde je možný pohyb |
| stop | Zastaví přehrávání MC |
| stopDrag | Ukončí tažení MC |
| swapDepths | Výměna hloubky s cílovým MC
(cílovýMC) |
| unloadMovie | Odstraní načtenou SWF animaci z přehrávače |
Vlastnosti MovieClip
| enabled | viz objekt Button |
|---|---|
| focusEnabled | Povolit výběr objektu modou setFocus |
| hitArea | Definuje plochu jiného MC jako citlivou na kliknutí (událost onPress - viz níže) |
| tabChildren | Povolit nebo zakázat TAB navigaci mezi vnořenými instancemi uvnitř MC (TRUE/FALSE) - implicitně povoleno |
| tabEnabled | Povolit navigaci pomocí TAB - (TRUE/FALSE) - implicitně povoleno |
| tabIndex | viz dříve |
| tracAsMenu | viz Button |
| useHandCursor | viz Button |
Události MovieClip
Podobně jako u objektu Button, i zde je možné definovat události vně instance. Tento způsob navíc umožňuje použít události, které jsou jinak MovieClipu cizí (např. onPress). Takto je možné MC upravit tak aby se choval jako tlačítko.
movieclip.onMouseDown = function () { gotoAndPlay(5); };
| onData | obdržení údajů z LoadVariables nebo LoadMovie |
|---|---|
| onDragOut | tažení ven |
| onDragOver | tažení dovnitř |
| onEnterFrame | akce jsou vykonány v každém snímku MC |
| onKeyDown | stisk klávesy |
| onKeyUp | uvolnění klávesy |
| onKillFocus | odznačení výběru instance (např. navigací TAB) |
| onLoad | načtení nebo vygenerování MC |
| onMouseDown | stisk levého tl. myši (kdekoliv v animaci) |
| onMouseMove | pohyb myši (kdekoliv v animaci) |
| onMouseUp | uvolnění levého tl. myši (kdekoliv v animaci) |
| onPress | stisk levého tl. myši nad instancí |
| onRelease | uvolnění levého tl. myši nad instancí |
| onReleaseOutside | uvolnění levého tl. myši mimo instanci |
| onRollOut | přejetí kurzorem dovnitř |
| onRollOver | přejetí kurzorem ven |
| onSetFocus | označení instance (např. navigací TAB) |
| onUnload | odstranění MC z časové osy |
Selection (výběr)
Objekt kontrolující výběr textu, případně MovieClipu a Tlačítka
Metody Selection
| addListener | Připojit objekt reagující na událost onSetFocus |
|---|---|
| getBeginIndex | Číslo prvního znaku výběru |
| getCaretIndex | Udává pozici kurzoru |
| getEndIndex | Číslo posledního znaku výběru |
| getFocus | Udává jméno zobrazované proměnné vybraného objektu. Pokud není vybráno textové pole, vrací pozici objektu. |
| removeListener | Odpojit objekt přidaný pomocí addListener |
| setFocus | Nastavit ukazatel do textového pole |
| setSelection(od, do) | Vybere část textu editovaného textového pole |
Události Selection
| onSetFocus | Při změně výběru zavolat metodu připojeného objektu |
|---|
prvni = new Object(); prvni.onSetFocus = function() { submit.enabled = true; } Selection.addListener(prvni)
Při změně výběru textového pole se zavolá metoda generického objektu onSetFocus a zavolá se funkce, kde je příkaz na odblokování tlačítka s názvem "submit".
Sound (zvuk)
Souží k manipulaci se zvukem
zvuk = new Sound();
Metody Sound
| attachSound | Připojit zvuk z knihovny ("IDjméno") |
|---|---|
| getBytesLoaded | Počet načtených bytů zvuku |
| getBytesTotal | Celková velikost zvuku |
| getPan | Vrací vyvážení zvuku (L/P reproduktor: -100/+100) |
| getTransform | Vrací informace o transformaci zvuku |
| getVolume | Vrací hlasitost |
| loadSound | Načte externí MP3 do objektu |
| setPan | Nastaví vyvážení |
| setTransform | Nastaví transformaci * |
| setVolume | Nastaví hlasitost |
| start | Spustí zvuk |
| stop | Zastaví zvuk |
Vlastnosti Sound
| duration | Délka zvuku v milisekundách - jen pro čtení |
|---|---|
| position | Pozice přehrávání (ms) - jen pro
čtení |
Události Sound
| onLoad | Po načtení zvuku zavolá definovanou funkci |
|---|---|
| onSoundComplete | Po skončení přehrávání zavolá definovanou funkci |
Ukázka nastavení transformace zvuku
Tato metoda umožňuje nastavit hlasitost jednotlivých reproduktorů (L a P) a u stereo zvuků také definovat, která stopa(y) se má v daném reproduktoru přehrávat.
zvuk.setTransform(transformObjekt);
Definování stereo zvuku jako mono by se nastavilo třeba takto:
transformObjekt = new Object(); transformObjekt.ll = 50; transformObjekt.lr = 50; transformObjekt.rr = 50; transformObjekt.rl = 50; zvuk.setTransform(transformObjekt);
ll- Procentuální hlasitost levého vstupu v levém reproduktorulr- Procentuální hlasitost pravého vstupu v levém reproduktorurr- Procentuální hlasitost pravého vstupu v pravém reproduktorurl- Procentuální hlasitost levého vstupu v pravém reproduktoru
Stage (nastavení scény)
Tento objekt umí nastavit vlastnosti scény v přehrávači podobně jako příkaz FSCommand. Přináší však některé novinky - například událost onResize
Metody Stage
| addListener | Připojení vlastního objektu, který bude reagovat na událost onResize * |
|---|---|
| removeListener | Odpojení předchozího objektu |
Vlastnosti Stage
| align | Zarovnání animace v přehrávači:
("vert_horiz")"T" - nahoře, "B" - dole, nic -
uprostřed
"L" - vlevo, "R" - vpravo, nic -
uprostřed
např.: "BL" - vlevo dole, "R" - vpravo
uprostřed |
|---|---|
| height | Výška okna v pixelech |
| scaleMode | Volba zobrazení (podobně jako u FScommand)
"exactFit",
"showAll", "noBorder", "noScale" (implicitní je "showAll") |
| showMenu | Zobrazit menu (true/false) |
| width | Šířka okna v pixelech |
Události Stage
| onResize | Po změně velikosti animace (např. vlivem změny velikosti okna prohlížeče) zavolat funkci |
|---|
pokus = new Object(); pokus.onResize = function () { _root.Play() } Stage.addListener(pokus);
Nejprve je vytvořen generický objekt Object, kterému je definována metoda onResize. Nakonec je objekt připojen objektu Stage.
Pokud tedy dojde ke změně proporcí okna přehrávače je zavolána funkce a vykonán příkaz Play().
TextField (textové pole)
Slouží k manipulaci s textovými poli typu dynamic a input text
Metody TextField
| addListener | Připojit vlastní objekt, který bude reagovat na události
(onChanged, atd...) |
|---|---|
| getDepth | Vrací hloubku pole |
| getFontList | Vrací datové pole Array s názvy všech nainstalovaných fontů v operačním systému + názvy připojených fontů |
| getNewTextFormat | Vrací formátování nastavené pomocí setNewTextFormat |
| getTextFormat | Vrací formátování nastavené pomocí setTextFormat |
| removeListener | Odpojit objekt připojený metodou addListener |
| removeTextField | Odstraní textového pole MovieClipu vytvořené metodou
createTextField (objekt MovieClip - viz výše) |
| replaceSel | Odstraní vybranou část textu a nahradí ji novým textem |
| setNewTextFormat | Nastaví formátování pro nově vkládaný text |
| setTextFormat | Nastaví formátování (viz objekt TextFormat) |
Vlastnosti TextFiled
| autoSize | Nastavuje zarovnání textu a povoluje automatickou změnu velikosti (podle velikosti textu) |
|---|---|
| background | Určuje, zda se má zobrazovat pozadí (TRUE/FALSE) |
| backgroundColor | Nastavuje barvu pozadí (implicitně bílá - 0xFFFFFF) |
| border | Určuje, zda se mají zobrazovat okraje (TRUE/FALSE) |
| borderColor | Nastavuje barvu okrajů (implicitně černá - 0x000000) |
| bottomScroll | Vrací číslo dolního viditelného řádku (u Multiline TextField) |
| embedFonts | Vrací booleovskou hodnotu, zda má pole přibalené fonty |
| hscroll | Nastavuje horizontální scrolling |
| html | Vrací booleovskou hodnotu, zda pole zobrazuje HTML tagy |
| htmlText | Zobrazí v poli text a zformátuje podle HTML tagů |
| length | Vrací počet znaků |
| maxChars | Nastavuje maximální počet zobrazovaných znaků |
| maxhscroll | Vrací maximální hodnotu hscroll |
| maxscroll | Vrací maximální hodnotu scroll |
| multiline | Vrací booleovskou hodnotu, zda je pole typu Multiline |
| password | Vrací booleovskou hodnotu, zda je pole typu Password |
| restrict | Nastavuje povolené znaky, které může uživatel napsat do
pole:
"A-Z 0-9" povoleny jsou znaky A-Z a číslice
"A-Z^Q" povoleny jsou znaky A-Z kromě
znaku Q |
| scroll | Nastavuje vertikální scrolling |
| selectable | Vrací booleovskou hodnotu, zda půjde text v poli vybrat |
| tabEnabled | Povolit navigaci pomocí TAB |
| tabIndex | Pořadí výběru objektu při navigaci tlačítkem TAB |
| text | Zobrazí v poli text |
| textColor | Nastavuje barvu textu v poli |
| textHeight | Vrací výšku bloku textu [px] |
| textWidth | Vrací šířku bloku textu [px] |
| type | Nastavuje typ pole - ("dynamic") nebo
("input") |
| variable | Nastavuje proměnnou, která se bude zobrazovat v poli |
| wordWrap | Vrací booleovskou hodnotu, zda se text má zalamovat |
Události TextField
| onChanged | Po editaci pole zavolá funkci |
|---|---|
| onKillFocus | Ukončení editace |
| onScroller | Po scrollování zavolá funkci |
| onSetFocus | Začátek editace |
TextFormat (formát textu)
Objekt definující hodnoty metod setTextFormat a setNewTextFormat objektu TextField.
nadpis = new TextFormat(); nadpis.vlastnost = hodnota; kolonka3.setTextFormat(nadpis);
Metody TextFormat
| getTextExtend("text") | Vrací šířku a výšku řetězce v závislosti na nastaveném
formátování v pixelech
getTextExtend("text").widthgetTextExtend("text").height |
|---|
Vlastnosti TextFormat
| align | zarovnání (left, right, center) |
|---|---|
| blockIndent | Odsazení textu |
| bold | Tučné (TRUE/FALSE) |
| bullet | Zobrazit každý odstavec jako položku seznamu |
| color | Barva textu |
| font | Použitý font |
| indent | Odsazení prvního řádku odstavce |
| italic | Kurzíva |
| leading | Velikost řádkování |
| leftMargin | Levý okraj |
| rightMargin | Pravý okraj |
| target | Cílové okno odkazu |
| size | Velikost textu |
| underline | Podtržený text |
| url | Vytvořit odkaz |