Dodatki




Części składowe języka HTML
Poniższe tabele zawierają posumowanie predefiniowanych obiektów Flasha,
omówionych w książce, wraz z ich metodami i właściwościami. Nazwy parametrów
zapisano czcionką pochyłą.

Obiekt tablicowy (Array)


Metoda Opis Argumenty


new Array(length)
Tworzy nowy obiekt tablicowy.
length, opcjonalny argument długości tablicy
concat(array1,...,arrayN)
Wiąże wskazane wartości i zwraca nową tablicę.
array1,...,arrayN, elementy wiÄ…zane w nowej tablicy
join(separator)
Wiąże elementy w tablicy, wstawia pomiędzy elementy separator i zwraca łańcuch
znakowy.
separator, znak lub łańcuch znakowy
pop()
Usuwa ostatni element w tablicy i zwraca wartość tego elementu.

push(value)
Dodaje elementy do końca tablicy i zwraca nową długość.
value, elementy dodawane do tablicy
reverse()
Odwraca kolejność elementów w tablicy.

shift()
Usuwa pierwszy element w tablicy i zwraca wartość tego elementu.

slice(indexA, indexB)
Zwraca nową tablicę zaczynającą się od indexA i kończącą się na (indexB-1).
indexA, element początkowy (dołączony)
indexB, element końcowy (niedołączony)
sort()
Sortuje tablicę, używając operatora <. Liczby są sortowane w porządku rosnącym,
łańcuchy znakowe w porządku alfabetycznym.

splice(index, count, elem1,...,elemN)
Wstawia lub usuwa elementy. Ustaw count to 0 w celu wstawienia wskazanych
wartości, zaczynając o indeksu. Ustaw count>0 w celu usunięcia danej liczby
elementów, zaczynając od indeksu (i łącznie z tym indeksem).
index, poczÄ…tek wstawiania lub usuwania
count, liczba elementów do usunięcia
elem1,...,elemN, elementy do wstawienia





Obiekt tablicowy (Array)



Metoda Opis Argumenty



toString()
Zwraca łańcuch znakowy z każdym elementem powiązanym i oddzielonym przecinkiem.


unshift(value)
Dodaje elementy do początku tablicy i zwraca nową długość.

value, elementy dodawane do tablicy
Właściwość Opis



length
Liczba wpisów w tablicy.







Obiekt koloru (Color)



Metoda Opis Argumenty



new Color(target)

Tworzy nowy obiekt koloru.
target, ścieżka dostępu do klipu filmowego
getRGB()

Zwraca numeryczną wartość koloru klipu filmowego, przypisaną przez getRGB.

getTransform()

Zwraca informacje o transformacji kolorów klipu filmowego, przypisanej przez
setTransform.

setRGB(0xRRGGBB)

Ustawia kolor obiektu koloru.
0xRRGGBB, wartości składowych: czerwonej, zielonej, niebieskiej
setTransform(cxform)

Przekształca kolor i przezroczystość obiektu koloru.
cxform, obiekt przechowujÄ…cy parametry transformacji koloru ra, rb, ga, gb, ba,
bb, aa i ab





Obiekt daty
(Uwaga: czas UTC jest tożsamy z czasem GMT)



Metoda Opis Argumenty



new Date(year, month, date, hour, min, sec, ms)

Tworzy nowy obiekt daty.
year, month, date, hour, min, sec, ms, opcjonalne argumenty określające
specyficzną datę (kolejno: rok, miesiąc, dzień, godzina, minuta, sekunda,
milisekunda)
getDate()

Zwraca dzień miesiąca, w postaci liczby z zakresu 1 do 31.

getDay()

Zwraca dzień tygodnia, w postaci liczby z zakresu 0 (niedziela) do 6 (sobota).







Obiekt daty
(Uwaga: czas UTC jest tożsamy z czasem GMT)


Metoda Opis Argumenty


getFullYear()
Zwraca rok, w postaci czterocyfrowej liczby.

getHours()
Zwraca godzinÄ™ w ciÄ…gu dnia, w postaci liczby z zakresu 0 do 23.

getMiliseconds()
Zawraca milisekundy, w postaci liczby z zakresu 0 do 999.

getMinutes()
Zwraca minuty, w postaci liczby z zakresu 0 do 59.

getMonth()
Zwraca miesiąc, w postaci liczby z zakresu 0 (styczeń) do 11 (grudzień).

getSeconds()
Zwraca sekundy, w postaci liczby z zakresu 0 do 59.

getTime()
Zwraca liczbę milisekund, które upłynęły od północy 1 stycznia 1970, czasu UTC.

getTimezoneOffset()
Zwraca różnicę pomiędzy czasem lokalnym i czasem UTC w minutach.

getUTCdate()
Zwraca dzień miesiąca, w postaci liczby z zakresu 1 do 31, UTC.

getUTCday()
Zwraca dzień tygodnia, w postaci liczby z zakresu 0 (niedziela) do 6 (sobota),
UTC.

getUTCFullYear()
Zwraca rok, w postaci czterocyfrowej liczby, UTC.

getUTCHours()
Zwraca godzinÄ™ w ciÄ…gu dnia, w postaci liczby z zakresu 0 do 23, UTC.

getUTCMiliseconds()
Zawraca milisekundy, w postaci liczby z zakresu 0 do 999, UTC.

getUTCMinutes()
Zwraca minuty, w postaci liczby z zakresu 0 do 59, UTC.

getUTCMonth()
Zwraca miesiąc, w postaci liczby z zakresu 0 (styczeń) do 11 (grudzień), UTC.

getUTCSeconds()
Zwraca sekundy, w postaci liczby z zakresu 0 do 59, UTC.

getYear()
Zwraca rok, obliczony na podstawie wzoru: bieżący rok minus 1900.

setDate(date)
Ustawia dzień miesiąca.
date, liczba całkowita z zakresu 1 do 31





Obiekt daty
(Uwaga: czas UTC jest tożsamy z czasem GMT)


Metoda Opis Argumenty


setFullYear(year, month, date)
Ustawia rok, miesiąc i dzień.
year, liczba całkowita czterocyfrowa
month, opcjonalna liczba całkowita z zakresu 0 do 11
date, opcjonalna liczba całkowita z zakresu 1 do 31
setHours(hours, minutes, seconds, ms)
Ustawia godzinÄ™, minutÄ™, sekundÄ™ i milisekundÄ™.
hours, liczba całkowita z zakresu 0 do 59
minutes, opcjonalna liczba całkowita z zakresu 0 do 59
seconds, opcjonalna liczba całkowita z zakresu 0 do 59
ms, opcjonalna liczba całkowita z zakresu 0 do 999
setMiliseconds(ms)
Ustawia milisekundÄ™.
ms, liczba całkowita z zakresu 0 do 999
setMinutes(minutes, seconds, ms)
Ustawia minutÄ™, sekundÄ™ i milisekundÄ™.
minutes, liczba całkowita z zakresu 0 do 59
seconds, opcjonalna liczba całkowita z zakresu 0 do 59
ms, opcjonalna liczba całkowita z zakresu 0 do 999
setMonth(month, date)
Ustawia miesiąc i dzień.
month, liczba całkowita z zakresu 0 do 11
date, opcjonalna liczba całkowita z zakresu 1 do 31
setSeconds(seconds, ms)
Ustawia sekundy i milisekundy.
seconds, liczba całkowita z zakresu 0 do 59
ms, opcjonalna liczba całkowita z zakresu 0 do 999
setTime(value)
Ustawia liczbę milisekund, które upłynęły od północy 1 stycznia 1970, czasu
UTC.
value, liczba całkowita reprezentująca czas, który upłynął
setUTCDate(date)
Ustawia dzień miesiąca, UTC.
date, liczba całkowita z zakresu 1 do 31





Obiekt daty
(Uwaga: czas UTC jest tożsamy z czasem GMT)


Metoda Opis Argumenty


setUTCFullYear(year, month, date)
Ustawia rok, miesiąc i dzień, UTC.
year, liczba całkowita czterocyfrowa
month, opcjonalna liczba całkowita z zakresu 0 do11
date, opcjonalna liczba całkowita z zakresu 1 do31
setUTCHours(hours, minutes, seconds, ms)
Ustawia godzinÄ™, minutÄ™, sekundÄ™ i milisekundÄ™, UTC.
hours, liczba całkowita z zakresu 0 do59
minutes, opcjonalna liczba całkowita z zakresu 0 do 59
seconds, opcjonalna liczba całkowita z zakresu 0 do 59
ms, opcjonalna liczba całkowita z zakresu 0 do 999
setUTCMiliseconds
(ms)
Ustawia milisekundÄ™, UTC.
ms, liczba całkowita z zakresu 0 do 999
setUTCMinutes(minutes, seconds, ms)
Ustawia minutÄ™, sekundÄ™ i milisekundÄ™, UTC.
minutes, liczba całkowita z zakresu 0 do 59
seconds, opcjonalna liczba całkowita z zakresu 0 do 59
ms, opcjonalna liczba całkowita z zakresu 0 do 999
setUTCMonth(month, date)
Ustawia miesiąc i dzień, UTC.
month, liczba całkowita z zakresu 0 do 11
date, opcjonalna liczba całkowita z zakresu 1 do 31
setUTCSeconds(seconds, ms)
Ustawia sekundy i milisekundy, UTC.
seconds, liczba całkowita z zakresu 0 do 59
ms, opcjonalna liczba całkowita z zakresu 0 do 999
setYear(year, month, date)
Ustawia rok, liczba czterocyfrowa.
year, liczba całkowita czterocyfrowa
month, opcjonalna liczba całkowita z zakresu 0 do11
date, opcjonalna liczba całkowita z zakresu 1 do31
toString()
Zwraca łańcuch znakowy wartości obiektu daty.






Obiekt Key


Metoda Opis Argumenty


getAscii()
Zwraca wartość ASCII ostatnio naciśniętego klawisza.

getCode()
Zwraca kod ostatnio naciśniętego klawisza.

isDown(keycode)
Zwraca prawdę, jeśli naciśnięto odpowiedni klawisz.
keycode, kod numeryczny przypisany do każdego klawisza
isToggled(keycode)
Zwraca prawdę, jeśli wciśnięto klawisze Caps Lock lub Num Lock.
keycode, kod numeryczny przypisany do każdego klawisza
Właściwość Opis


BACKSPACE
Kod klawisza Backspace.

CAPSLOCK
Kod klawisza Caps Lock.

CONTROL
Kod klawisza Ctrl.

DELETEKEY
Kod klawisza Delete.

DOWN
Kod klawisza "strzałka w dół".

END
Kod klawisza End.

ENTER
Kod klawisza Enter.

ESCAPE
Kod klawisza Esc.

HOME
Kod klawisza Home.

INSERT
Kod klawisza Insert.

LEFT
Kod klawisza "strzałka w lewo".

PGDN
Kod klawisza Page Down.

PGUP
Kod klawisza Page Up.

RIGHT
Kod klawisza "strzałka w prawo".

SHIFT
Kod klawisza Shift.

SPACE
Kod klawisza spacji.

TAB
Kod klawisza Tab.

UP
Kod klawisza "strzałka w górę".





Obiekt matematyczny (Math)


Metoda Opis Argumenty


abs(number)
Oblicza wartość bezwzględną.
number, dowolna liczba lub wyrażenie
acos(number)
Oblicza wartość cosinusa łuku.
number, liczba od
1 do 1
asin(number)
Oblicza wartość sinusa łuku.
number, liczba od
1 do 1





Obiekt matematyczny (Math)


Metoda Opis Argumenty


atan(number)
Oblicza wartość tangensa łuku.
number, liczba
atan2(y, x)
Oblicza wartość tangensa łuku.
y, współrzędna y punktu
x, współrzędna x punktu
ceil(number)
Zaokrągla liczbę w górę do najbliższej liczby całkowitej.
number, dowolna liczba lub wyrażenie
cos(number)
Oblicza wartość cosinusa kąta w radianach.
number, kÄ…t w radianach
exp(number)
Oblicza wartość wykładnika potęgi stałej Eulera (e).
number, wykładnik potęgi
floor(number)
Zaokrągla liczbę w dół do najbliższej liczby całkowitej.
number, dowolna liczba lub wyrażenie
log(number)
Oblicza wartość logarytmu naturalnego.
number, dowolna liczba lub wyrażenie
max(x, y)
Zwraca większą z dwóch porównywanych wartości.
x, dowolna liczba lub wyrażenie
y, dowolna liczba lub wyrażenie
min(x, y)
Zwraca mniejszą z dwóch porównywanych wartości.
x, dowolna liczba lub wyrażenie
y, dowolna liczba lub wyrażenie
pow(base, exponent)
Oblicza wartość potęgi danej liczby.
base, dowolna liczba lub wyrażenie (podstawa potęgi)
exponent, dowolna liczba lub wyrażenie (wykładnik potęgi)
random()
Zwraca liczbÄ™ losowÄ… z zakresu 0 do 1,0.

round(number)
Zaokrągla liczbę do najbliższej wartości.
number, dowolna liczba lub wyrażenie
sin(number)
Oblicza wartość sinusa kąta w radianach.
number, kÄ…t w radianach
sqrt(number)
Oblicza wartość kwadratu potęgi.
number, dowolna liczba lub wyrażenie
tan(number)
Oblicza wartość tangensa kąta w radianach.
number, kÄ…t w radianach
Właściwość Opis


E
Stała Eulera; podstawa logarytmów naturalnych.

LN2
Logarytm naturalny liczby 2.

LOG2E
Logarytm Eulera podstawy równej 2.

LN10
Logarytm naturalny liczby 10.

LOG10E
Logarytm Eulera podstawy równej 10.






Obiekt matematyczny (Math)


Właściwość Opis


PI
Obwód koła podzielony przez jego średnicę.

SQRT1_2
Kwadrat potćgi liczby ½.

SQRT2
Kwadrat potęgi liczby 2.





Obiekt myszy (Mouse)


Metoda Opis


hide()
Ukrywa wskaźnik.

show()
Odsłania wskaźnik.

Właściwość Opis


_xmouse
Współrzędna x położenia wskaźnika.

_ymouse
Współrzędna y położenia wskaźnika.





Obiekt klipu filmowego (Movie Clip)


Metoda Opis Argumenty


attachMovie(idName, newName, depth)
Przyłącza klip filmowy z biblioteki do klonu klipu filmowego na scenie.
idName, identyfikator symbolu klipu filmowego w bibliotece
newName, nazwa klonu przyłączonego klipu filmowego
depth, poziom głębokości (kolejność ułożenia w stosie)
duplicateMovieClip(newName, depth)
Tworzy kolejny klon klipu filmowego obecnego na scenie.
newName, nazwa klonu przyłączonego klipu filmowego
depth, poziom głębokości (kolejność ułożenia w stosie)
getBounds(targetCoodinateSpace)
Zwraca minimalne i maksymalne wartości współrzędnych x, y położenia klipu
filmowego w obrębie przestrzeni wskazanego obiektu. Obiekt zwracany posiada
właściwości xMin, xMax, yMin i yMax.
targetCoordinateSpace, listwa czasowa, której współrzędne przestrzeni służą
jako odnośnik
getBytesLoaded()
Zwraca ilość wczytanych danych klipu filmowego, w bajtach.






Obiekt klipu filmowego (Movie Clip)


Metoda Opis Argumenty


getBytesTotal()
Zwraca całkowitą wielkość klipu filmowego, w bajtach.

globaltoLocal(point)
Konwertuje współrzędne globalne położenia punktu na współrzędne względne wobec
klipu filmowego.
point, obiekt o współrzędnych x, y
gotoAndPlay(frame)
Przeskakuje do podanej klatki i rozpoczyna odtwarzanie.
frame, numer klatki lub etykieta
gotoAndStop(frame)
Przeskakuje do podanej klatki i zatrzymuje odtwarzanie.
frame, numer klatki lub etykieta
hitTest(x, y, shapeFlag)
Zwraca prawdę, jeśli współrzędne x, y przecinają klip filmowy.
x, współrzędna x
y, współrzędna y
shapeflag, parametr o wartości prawda lub fałsz, określający, czy współrzędne
przecinają kształt klipu filmowego (prawda), czy jego obramowanie (fałsz)
hitTest(target)
Zwraca prawdę, jeśli wskazany klip filmowy przecina inny klip filmowy.
target, klon przecinanego klipu filmowego
loadMovie(URL, method)
Wczytuje zewnętrzny plik SWF do klipu filmowego.
URL, ścieżka dostępu do zewnętrznego pliku SWF
method, opcjonalny argument, określający metodę CGI GET lub POST
loadVariables(URL, method)
Wczytuje do klipu filmowego zewnętrzne zmienne, przechowywane w pliku
tekstowym.
URL, ścieżka dostępu do zewnętrznego pliku SWF
method, opcjonalny argument, określający metodę CGI GET lub POST
localtoGlobal (point)
Konwertuje współrzędne położenia punktu z wartości względnych wobec klipu
filmowego na wartości względne wobec sceny.
point, obiekt o współrzędnych x, y
nextFrame()
Przeskakuje do następnej klatki i zatrzymuje odtwarzanie.

play()
Rozpoczyna odtwarzanie ujęć z listwy czasowej klipu filmowego od bieżącej
pozycji.

prevFrame()
Przeskakuje do poprzedniej klatki i zatrzymuje odtwarzanie.






Obiekt klipu filmowego (Movie Clip)


Metoda Opis Argumenty


removeMovieClip()
Usuwa klon klipu filmowego utworzony z użyciem metody duplicateMovieClip
lub attachMovie.

startDrag(lockCenter, left, top, right, bottom)
Sprawia, że klip filmowy podąża za wskaźnikiem myszy.
lockCenter, parametr prawda lub fałsz, określający, czy punkt środkowy klipu
filmowego jest przyciągany do wskaźnika myszy
left, top, right, bottom, wartości ograniczające położenie klipu filmowego
stop()
Zatrzymuje odtwarzanie.

stopDrag()
Sprawia, że klip filmowy przestaje podążać za wskaźnikiem myszy.

swapDepths(depth)
Zamienia pozycję w stosie klipów filmowych.
depth, poziom głębokości, na którym znajduje się klip filmowy przeznaczony do
zmiany kolejności ułożenia
swapDepths(target)
Zamienia pozycję w stosie klipów filmowych.
target, klip filmowy, którego pozycja w stosie jest zmieniana
unloadMovie()
Usuwa wczytany do klonu klipu filmowego plik SWF lub klip filmowy przyłączony
do innego klipu za pomocÄ… metody attachMovie.

Właściwość Opis


_alpha
Określa przezroczystość, gdzie 0 oznacza całkowicie przezroczysty, a 100

kryjÄ…cy.

_currentframe
Bieżąca klatka (tylko do odczytu).

_droptarget
Ścieżka dostępu do pliku, na który upuszczany jest przeciągany klip
filmowy (składnia z ukośnikiem, tylko do odczytu).

_framesloaded
Liczba klatek wczytanych do komputera odbiorcy (tylko do odczytu).

_height
Określa rozmiar w pionie (w pikselach).

_name
Określa nazwę nowego klonu klipu filmowego.

_rotation
Określa stopień obrotu zgodnie z ruchem wskazówek zegara.






Obiekt klipu filmowego (Movie Clip)



Właściwość Opis



_target

Ścieżka dostępu do klonu klipu filmowego (tylko do odczytu).

_totalframes

Całkowita liczba klatek symbolu klipu filmowego (tylko do odczytu).

_url

Ścieżka do pliku SWF wczytanego do symbolu klipu filmowego (tylko do odczytu).

_visible

Określa widzialność klipu filmowego (prawda lub fałsz).

_width

Określa rozmiar w poziomie (w pikselach).

_x

Określa pozycję w poziomie punktu początkowego klipu filmowego.

_xscale

Określa procent rozmiaru w poziomie oryginalnego symbolu klipu filmowego.

_y

Określa pozycję w pionie punktu początkowego klipu filmowego.

_yscale

Określa procent rozmiaru w pionie oryginalnego symbolu klipu filmowego.






Obiekt selekcji (Selection)



Metoda Opis Argumenty



getBeginIndex()

Odczytuje indeks poczÄ…tku selekcji.

getCaretIndex()

Odczytuje indeks pozycji kursora.

getEndIndex()

Odczytuje indeks końca selekcji.

getFocus

Odczytuje nazwÄ™ zmiennej aktywnego w danym momencie bloku tekstowego.

setFocus(variableName)

Ustawia ogniskowanie bloku tekstowego o podanej nazwie zmiennej, dzięki czemu
można odczytywać informacje o tekście zawartym w danym bloku tekstowym, jeśli
istnieje kilka bloków tekstowych.
variableName, nazwa bloku tekstowego

setSelection(beginIndex, endIndex)
Ustawia selekcję według określonych indeksów początku oraz końca.
beginIndex, indeks poczÄ…tku zaznaczenia
endIndex, indeks końca zaznaczenia






Obiekt dźwiękowy (Sound)



Metoda Opis Argumenty



new Sound (target)
Tworzy nowy obiekt dźwiękowy.

target, ścieżka dostępu do klipu filmowego
attachSound(idName)
Dołącza plik dźwiękowy z biblioteki do obiektu dźwiękowego.

idName, identyfikator dźwięku w bibliotece
getPan()
Zwraca poziom panoramy, ustawiony przez setPan.


getTransform()
Zwraca informacje o przekształceniu dźwięku, wykonanym przez setTransform.


getVolume()
Zwraca poziom głośności przypisany przez setVolume.


setPan(pan)
Ustawia balans kanałów lewy-prawy.

pan, liczba od
100 (lewy) do 100 (prawy)
setTransform(sxform)
Ustawia sposób rozdzielenia dźwięku z kanałów lewego i prawego na poszczególne
głośniki.

sxform, obiekt przechowujący parametry transformacji dźwięku: ll, lr, rr i rl
setVolume(volume)
Ustawia procentową wartość poziomu głośności.

volume, liczba od 0 (cisza) do 100 (głośno)
start(secondOffset, loops)
Odtwarza przyłączony dźwięk.

secondOffset, punkt startowy dźwięku (w sekundach)
loops, liczba określająca, ile razy dźwięk będzie odtwarzany
stop()
Zatrzymuje odtwarzanie przyłączonego dźwięku.







Obiekt łańcucha znakowego (String)



Metoda Opis Argumenty



new String (value)

Tworzy nowy obiekt łańcucha znakowego.
value, wartość obiektu łańcucha znakowego
charAt (index)

Zwraca znak znajdujÄ…cy siÄ™ na pozycji wskazanej indeksem.
index, pozycja, na której znajduje się znak
charCodeAt (index)

Zwraca kod znaku z pozycji o wskazanym indeksie.
index, pozycja, na której znajduje się znak
concat (string1,...,stringN)

Wiąże wskazane łańcuchy.
string1,...,stringN, łańcuchy przeznaczone do powiązania






Obiekt łańcucha znakowego (String)


Metoda Opis Argumenty


fromCharCode (num1,...,numN)
Zwraca łańcuch znakowy utworzony ze wskazanych elementów.
num1,...,numN, znaki tworzące łańcuch
indexOf(searchString, fromIndex)
Przeszukuje łańcuch znakowy i zwraca miejsce wystąpienia po raz pierwszy
podłańcucha wskazanego parametrem searchString.
searchString, znak lub znaki
fromIndex, indeks startowy
lastIndexOf(searchString, fromIndex)
Przeszukuje łańcuch znakowy i zwraca miejsce wystąpienia po raz ostatni
podłańcucha wskazanego parametrem searchString.
searchString, znak lub znaki
fromIndex, indeks startowy
slice (indexA, indexB)
Zwraca podłańcuch umieszczony pomiędzy wskazanymi indeksami, łącznie z indexA,
lecz bez indexB.
indexA, punkt początkowy łańcucha
indexB, punkt końcowy łańcucha
split (separator, limit)
Zwraca tablicę dwóch lub więcej podłańcuchów na podstawie argumentu separator.
separator, znak oddzielający podłańcuchy
limit, maksymalna ilość podłańcuchów możliwych do umieszczenia w tablicy
substr(start, length)
Zwraca łańcuch znakowy o podanej długości, zaczynający się od indeksu start.
start, indeks startowy
length, długość podłańcucha
substring(indexA, indexB)
Zwraca łańcuch znakowy, którego pozycję wyznaczają parametry indexA i indexB.
indexA, punkt początkowy łańcucha
indexB, punkt końcowy łańcucha
toLowerCase()
Zamienia znaki w łańcuchu na pisane małą literą.

toUpperCase()
Zamienia znaki w łańcuchu na pisane wielką literą.