Версії середовища виконання:
Flash Player 9, AIR 1.0, Flash Lite 4
Задає режим кнопки даного спрайту. При значенні true цей спрайт поводиться як кнопка, тобто запускає відображення курсора у вигляді руки, коли над ним проходить покажчик, і може отримувати подія click при натисканні клавіш Enter і «Пропуск», коли спрайт знаходиться у фокусі. Можна скасувати відображення курсора у вигляді руки, задавши властивості useHandCursor значення false. в цьому випадку буде відображатися покажчик.
Якщо властивість buttonMode використовується з класом MovieClip (подклассом класу Sprite), кнопка може отримати додаткові функції. Якщо включити кадри з підписами _up, _over і _down, програвач Flash Player передає автоматичні зміни стану (функція, подібна можливостям фрагментів роликів, які використовуються в якості кнопок, в попередніх версіях ActionScript). Ці автоматичні зміни стану недоступні для спрайтів, так як у них немає тимчасової шкали і, отже, кадрів для додавання підписів.
Реалізація
public function get buttonMode (): Boolean
public function set buttonMode (value: Boolean): void
Пов'язані елементи API
У наступному прикладі створюється два спрайту, для одного з яких властивості buttonMode задається значення true. а для іншого - false. Коли додаток компілюється і запускається, обидва спрайту реагують на події миші, але тільки той, для якого buttonMode має значення true. використовує курсор у вигляді руки і включається в послідовність переходу за допомогою клавіші Tab.
Версії середовища виконання:
Flash Player 9, AIR 1.0, Flash Lite 4
Визначає інший спрайт в якості області клацання для спрайту. Якщо властивість hitArea не існує або йому задано значення null або undefined. то в якості області клацання використовується сам спрайт. Значення властивості hitArea може бути посиланням на об'єкт Sprite.
Властивість hitArea можна змінити в будь-який момент; модифікований спрайт негайно починає використовувати нову поведінку області клацання. Спрайт, налаштований в якості області клацання не обов'язково повинен бути видимим; його графічна форма, залишаючись невидимою, все одно виявляється в якості області клацання.
Примітка. Необхідно задати значення false властивості mouseEnabled спрайту, налаштованого в якості області клацання. В іншому випадку кнопка спрайту може не працювати, так як спрайт, налаштований в якості області клацання, отримує події призначеного для користувача введення замість кнопки спрайту.
Реалізація
public function get hitArea (): Sprite
public function set hitArea (value: Sprite): void
У наступному прикладі створюється спрайт circle і спрайт square. Спрайт square є областю клацання hitArea для спрайту circle. Тому коли користувач натискає на спрайт square. спрайт circle відправляє подія click.
Версії середовища виконання:
Flash Player 9, AIR 1.0
Логічне значення, яке визначає, чи потрібно відображати курсор у вигляді руки при наведенні покажчика миші на спрайт, в якому властивість buttonMode має значення true. Властивість useHandCursor за замовчуванням має значення true. Коли useHandCursor має значення true. курсор у вигляді руки, що використовується для кнопок, з'являється при наведенні покажчика на спрайт-кнопку. Якщо ж useHandCursor має значення false. використовується покажчик «стрілка».
Властивість useHandCursor можна змінити в будь-який час; модифікований спрайт негайно приймає новий вид курсора.
Примітка. Якщо у Flex або Flash Builder спрайт має дочірні спрайт, може знадобитися завдання для властивості mouseChildren значення false. Наприклад, якщо необхідно, щоб курсор у вигляді руки відображався над елементом управління Flex
Реалізація
public function get useHandCursor (): Boolean
public function set useHandCursor (value: Boolean): void
Пов'язані елементи API
У наступному прикладі створюється два спрайту, і властивості buttonMode обох задається значення true. проте для одного з них властивість useHandCursor має значення true. а для іншого - false. При компіляції і запуску програми обидва спрайту поводяться як кнопки (включені в послідовність переходу за допомогою клавіші Tab), але тільки курсор у вигляді руки використовує спрайт з властивістю useHandCursor в значенні true.
Відомості про конструктора
Версії середовища виконання:
Flash Player 9, AIR 1.0, Flash Lite 4
Дозволяє користувачеві перетягувати заданий спрайт (растровий графічний об'єкт, легко переміщуваний по екрану). Спрайт можна перетягувати до явної зупинки через виклик методу Sprite.stopDrag () або до того, як можна буде перетягувати інший спрайт. Одночасно можна перетягувати тільки один спрайт.
Тривимірні об'єкти відображення управляються покажчиком, а метод Sprite.startDrag () надає користувачам можливість об'єкт в тривимірній площині, визначеної екранним об'єктом. Або, якщо екранний об'єкт є двовимірним об'єктом і дочірнім елементом тривимірного об'єкту, двовимірний об'єкт переміщається в тривимірній площині, визначеної тривимірним батьківським об'єктом.
lockCenter: Boolean (default = false) - Визначає, фіксується чи перетаскується спрайт в центрі положення покажчика (true) або в точці спрайту, на якій вперше клацнув мишею користувач (false).
bounds: Rectangle (default = null) - Значення щодо координат батьківського об'єкта Sprite, що задає для нього закріплений прямокутник.
Пов'язані елементи API
У наступному прикладі створюється спрайт circle і два спрайту target. Метод startDrag () викликається для спрайту circle. коли користувач поміщає курсор на спрайт і натискає кнопку миші, а метод stopDrag () викликається, коли користувач відпускає кнопку миші. Це дозволяє користувачеві перетягнути спрайт. При відпуску кнопки миші викликається метод mouseRelease (). який в свою чергу відстежує name об'єкта, dropTarget. до якого користувач перетягнув спрайт circle.
Версії середовища виконання:
Flash Player 10.1, AIR 2, Flash Lite 4
Дозволяє перетягувати вказаний спрайт на пристрої з сенсорним екраном. Спрайт можна перетягувати до явної зупинки через виклик методу Sprite.stopTouchDrag () або до того, як можна буде перетягувати інший спрайт. Одночасно можна перетягувати тільки один спрайт.
Тривимірні об'єкти відображення управляються покажчиком, а метод Sprite.stopTouchDrag () надає користувачам можливість об'єкт в тривимірній площині, визначеної екранним об'єктом. Або, якщо екранний об'єкт є двовимірним об'єктом і дочірнім елементом тривимірного об'єкту, двовимірний об'єкт переміщається в тривимірній площині, визначеної тривимірним батьківським об'єктом.
touchPointID: int - Ціле число, яке необхідно призначити точці дотику.
lockCenter: Boolean (default = false) - Визначає, фіксується чи перетаскується спрайт в центрі положення покажчика (true) або в точці спрайту, на якій вперше клацнув мишею користувач (false).
bounds: Rectangle (default = null) - Значення щодо координат батьківського об'єкта Sprite, що задає для нього закріплений прямокутник.
Пов'язані елементи API
Наступний приклад демонструє функції, що використовують властивості startTouchDrag і stopTouchDrag для обробки подій touchBegin і touchEnd. Як значення touchPointID використовується значення, задане об'єкту події. Параметр bounds є прямокутником, який визначає межі батьківського екранного об'єкта (bg є екранним об'єктом, що містить MySprite).