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ą.

Dodatek A

430

429

Podsumowanie metod obiektów i właściwości

A

Podsumowanie metod obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

Metody obiektów i właściwości

---