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

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

Буксировку можно прекратить в любой момент с помощью функции stopDrag(). В каждый конкретный момент можно буксировать только один клип или фильм, поэтому вызов функции startDrag() с новым target автоматически прекращает текущую операцию буксировки. При этом во время буксировки фильма или клипа вместе с ним перемещаются все содержащиеся в нем клипы.

Примеры:

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

on(press) { startDrag("ball", true, 0, 0, 200, 250);}on(release) { stopDrag();}

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

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

Stop

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

Производит остановку фильма на текущем кадре

Синтаксис:

Stop()

Описание:

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

Примеры:

on (release) {stop();}

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

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

stopAllSounds

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

Производит выключение всех звуков в фильме

Синтаксис:

stopAllSounds()

Описание:

Функция stopAllSounds() заглушает все звуки, воспроизводящиеся в данный момент в фильме, независимо от глубины вложенности в клипы. Она применяется ко всем звукам фильма, в том числе к программно генерируемым объектам Sound. Более точно управлять остановкой, запуском и громкостью звука можно с помощью класса Sound.Стоит отметить, что функция stopAllSounds() оказывает только временное воздействие. Любой звук, который начинается после вызова stopAllSounds(), будет воспроизводиться нормально.

Пример:

Следующий код может быть введен в кнопку, которая при нажатии выключит все звуки в клипе:

on(release) {stopAllSounds();}

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

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

stopDrag

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

Останавливает текущую операцию перетаскивания

Синтаксис:

stopDrag();

Описание:

Функция startDrag() вызывает перемещение клипа за курсором мыши по рабочему столу. Операция stopDrag() прекращает перемещение клипа вслед за курсором мыши. Поскольку в каждый конкретный момент можно буксировать только один клип или фильм, для stopDrag() не требуется аргумента target - эта функция просто прекращает любую текущую операцию буксировки.

Вместе с startDrag() функция stopDrag() используется для создания во Flash простых интерфейсов "drag-and-drop".

Примеры:

Следующие команды останавливают перетаскивание мувиклипа mc, когда пользователь отпустит кнопку мыши:

on(press) {startDrag("mc");}on(release) {stopdrag();}

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

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

tellTarget

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

Позволяет выполнить предложения, находящиеся в области видимости удаленного клипа фильма

Синтаксис:

tellTarget(target){ statements}

Аргументы:

Описание:

Во Flash 3 и Flash 4 tellTarget() была главным средством связи между двумя клипами фильмов (т.е. управления одним клипом из другого). Она использовалась для вызова таких функций, как play(), stop(), и gotoAndStop() с удаленными клипами фильмов. Во Flash 4, где в ActionScript были добавлены переменные, с помощью tellTarget() можно было также получать и задавать значения переменных удаленных клипов. Во Flash 5 такие действия лучше осуществлять с помощью оператора точки, ., и оператора обращения к массиву, []. Другой альтернативой функции tellTarget() является предложение with.

Некоторые особенности:

Функцию tellTarget() лучше было бы описать как предложение, поскольку для нее требуется блок предложений. Вопрос этот, однако, чисто академический, поскольку tellTarget() устарела.

Обычно она применяется, если нужно динамически назначить уровень удаляемого фильма.

Пример:

tellTarget("ball") {gotoAndStop("redStripes");_x +=300;}

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

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

toggleHighQuality

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

Изменяет качество вывода.

Синтаксис:

toggleHighQuality()

Описание:

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

Функция toggleHighQuality() не принимает аргументов, она просто переключает две возможные установки - "High" и "Low". Это может вызвать проблемы, т.к. качество не устанавливается явно в известное состояние, и при этом не допускается иных установок качества, кроме двух заданных.

Примечание:

Во Flash 5 эта функция устарела благодаря появлению глобального свойства _quality, которое поддерживает качество вывода Low, Medium, High и Best.

Пример:

Изменение качества изображения при нажатии на кнопку.

on(release) {toggleHighQuality();}

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

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

unloadMovie

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

Позволяет удалить фильм или клип фильма из проигрывателя

Синтаксис:

unloadMovie(target)

Аргументы:

Описание:

Функция unloadMovie() чаще всего используется для удаления фильмов с уровней документов в проигрывателе.

Например, если фильм загружен на уровень 1 проигрывателя, удалить его из проигрывателя можно так:

unloadMovie("_level1");

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

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

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

unloadMovieNum

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

Позволяет удалить фильм из проигрывателя

Синтаксис:

unloadMovieNum(level)

Аргументы:

Описание:

Функция unloadMovieNum() почти идентична функции unloadMovie(), за исключением того, что требует задания конечного уровня level как числа, а не как строки.