White cat - Справочник по Flash

Примеры:

Пример:Распечатка фильма.

// Напечатать все кадры главной временной диаграммы,// задав размер каждого из них так, чтобы он занимал всю страницуprintAsBitmap("_root", "bframe");// Напечатать все кадры главной временной диаграммы,// изменив размер каждого соответственно общему размеру всех кадровprintAsBitmap("_root", "bmax");

При щелчке по кнопке со следующим кодом Flash выводит на печать все кадры на временной диаграмме кнопки, обрезанные по рамке границ кадра с меткой #b и с размером на всю страницу:

on (release) { printAsBitmap(this, "bmovie");}

Совместимость:

Используется с 5-ой версии Flash

printAsBitmapNum

( Глобальная функция )

Печать кадров уровня документа как растровых изображений

Синтаксис:

printAsBitmapNum(level, boundingBox)

Аргументы:

Функция printAsBitmapNum()почти идентична printAsBitmap(), но требует задания целевого уровня level для операции печати в виде числа, а не строки. Это означает, что printAsBitmapNum()может печатать только уровни документов, а не клипы фильмов. Обычно она используется, когда нужно динамически назначить выводимый на печать уровень фильма.

Примеры:

Пример:Распечатка уровня фильма.

var x = 3;printAsBitmapNum(x, "bmax");

Того же самого можно достичь с помощью конкатенации строк и использования обычной функции printAsBitmap():

printAsBitmap("_level" + x, "bmax");

Совместимость:

Используется с 5-ой версии Flash

removeMovieClip

( Глобальная функция )

Удалить клип фильма из Flash Player.

Синтаксис:

removeMovieClip(target);

Аргументы:

Функция removeMovieClip()удаляет указанный клип фильма из проигрывателя, не оставляя следов содержимого или оболочки клипа. Последующие ссылки на клип или его переменные и свойства возвращают undefined .

Функцию removeMovieClip()можно использовать только с экземплярами клипов, созданными первоначально посредством duplicateMovieClip() или attachMovie() . На клипы фильмов, созданные в среде разработки, влияния не оказывает.

Совместимость:

Используется с 4-ой версии Flash.

Усилена во Flash 5 возможностью применения к экземплярам, создаваемых с помощью attachMovie() .

return

Выходит из функции или возвращает ее значение

Синтаксис:

return; return expression;

Аргументы:

Описание:

При вызове функции можно передавать ей одно или более значений (параметров или аргументов), участвующих в выполнении. Аналогично, функция может передавать обратно возвращаемое значение (значение, получаемое в результате выполнения функции и пересылаемое обратно вызвавшему). Для завершения выполнения функции и, если нужно, возврата значения, в ее теле используется предложение return.

Когда интерпретатор во время выполнения функции сталкивается с предложением return, он пропускает все оставшиеся в функции предложения.

Примеры:

Пример:Пропуск предложения после return.

function myFun(msg) { return; // Эта строка никогда не выполнится trace(msg);}

Этот пример не реалистичен, потому что предложение return всегда вызывает завершение функции до того, как будет достигнуто предложение trace(). Поэтому предложение returnобычно является последним предложением функции, если только оно не используется внутри условного предложения.

Пример:Выход при неверном пароле.

var correctPass = "spravkaweb&quor;;function enterSite(pass) { if (pass != correctPass) { // Выйти, если пароль не верен return; } // Этот код достигается только при верном пароле gotoAndPlay("intro");}// Выход из функции будет досрочнымenterSite("cactus");// Выход из функции будет естественнымenterSite("spravkaweb");

Как предполагается самим именем, returnприказывает интерпретатору возвратиться в место вызова функции. Если предложение returnотсутствует, ActionScript действует так, как если бы последняя строка функции содержала предложение return:

fuction myFun(msg) { trace(msg); // В таком контексте эта строка совершенно лишняя return;}

Независимо от того, является предложение returnподразумеваемым или явным, по окончании работы функции выполнение возобновляется со строчки кода, следующей за предложением вызова функции.

// Выполняем код функции myFun()myFun("Hi!");// По завершении функции myFun() выполнение возобновляется здесьtrace("World");

Как мы видели ранее, returnвсегда завершает функцию. Но его можно также использовать для возврата значений в сценарий, который вызвал функцию.

Пример:Определим функцию, складывающую три числа.

function sum(a, b, c) { return a + b + c;}// Вызовем функциюvar total = sum(5,6,2); // Возвратит 13

Выражение или результат, возвращаемое предложением return, называется возвращаемым значением функции.

Следует обратить внимание, что функция sum()просто вычисляет и возвращает сумму трех чисел. Она не совершает явного действия. Использовать возвращаемое функцией значение можно, присвоив его переменной.

var total = sum (1,2,3); // total = 11var greet = sum ("Hello ", "world", "!"); // greet = "Hello world!"

Результатом вызова функции является обычное выражение. Поэтому его можно использовать в других выражениях.

Совместимость:

Используется с 5-ой версии Flash

setProperty

Присвоить значение свойству клипа фильма

Синтаксис:

setProperty(movieClip, property, value);

Аргументы:

Описание:

Функция setProperty()присваивает value одному из встроенных свойств movieClip . Ее нельзя использовать для установки свойств, определенных пользователем. Во Flash 4 setProperty()была единственным способом присвоения значений свойствам клипа; начиная с Flash 5 наиболее предпочтительными способами задания как встроенных, так и пользовательских свойств являются операторы и [].

Примеры:

// Повернуть главный фильм на 45 градусовsetProperty("_root", _rotation, 45);// То же самое, только без setProperty()_root._rotation = 45;

При нажатии кнопки, следующий пример присваивает свойству _alpha мувиклипа star значение равное 30 процентам:

on(release) {setProperty("star", _alpha, 30);}

Совместимость:

Используется с 4-ой версии Flash

startDrag

Заставляет фильм или клип следовать за курсором мыши

Синтаксис:

startDrag(target);startDrag(target, lockCenter);startDrag(target, lockCenter, left, top, right, bottom);

Аргументы:

Описание:

Функция startDrag()вызывает зрительное перемещение target за курсором мыши по проигрывателю (называемое также буксировкой (dragging) клипа). Перемещение буксируемого клипа можно ограничить рамкой, координаты которой передаются в качестве аргументов функции startDrag(). Координаты ограничивающей рамки задаются относительно холста, на котором расположен target. Если холстом является рабочий стол главного фильма, то точка (0,0) является левым верхним углом рабочего стола. Если холстом является клип фильма, то (0,0) обозначает точку регистрации холста клипа. Следует обратить внимание, что координатная система Flash переворачивает декартову ось Y: значения Y возрастают в направлении к нижней части экрана и убывают в направлении верхней части экрана. Отрицательные значения Y находятся выше начала координат (т.е. над осью X).