Пакет | flash.ui |
Класс | public final class Mouse |
Наследование | Mouse Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
cursor : String [статические]
Имя собственного курсора. | Mouse | ||
supportsCursor : Boolean [статические] [только для чтения]
Обозначает, отображает ли компьютер или устройство постоянный курсор. | Mouse | ||
supportsNativeCursor : Boolean [статические] [только для чтения]
Обозначает ли текущие поддержки конфигурации встроенные курсоры. | Mouse |
Метод | Определено | ||
---|---|---|---|
Показывает, определено ли заданное свойство для объекта. | Object | ||
[статические]
Скрывает указатель мыши. | Mouse | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
[статические]
Выполняет регистрацию встроенного курсора под указанным именем, с указанными данными. | Mouse | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
[статические]
Отображает указатель мыши. | Mouse | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
[статические]
Отменяет регистрацию встроенного курсора с именем. | Mouse | ||
Возвращает элементарное значение заданного объекта. | Object |
cursor | свойство |
supportsCursor | свойство |
supportsCursor:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Обозначает, отображает ли компьютер или устройство постоянный курсор.
Свойство supportsCursor
имеет значение true
на большинстве настольных компьютеров и false
на большинстве мобильных устройств.
Примечание. События нажатия мыши могут отправляться независимо от того, имеет это свойство значение true
или нет. Однако события мыши могут вести себя по-разному в зависимости от физических характеристик указывающего устройства.
Реализация
public static function get supportsCursor():Boolean
Связанные элементы API
Пример ( Использование этого примера )
import flash.events.*; import flash.display.*; import flash.ui.Mouse; import flash.text.TextField; var supportsCursorTxt:TextField = new TextField(); supportsCursorTxt.width = 200; supportsCursorTxt.border = true; addChild(supportsCursorTxt); addEventListener (MouseEvent.CLICK, getScreenKeyboardType); function getScreenKeyboardType(e:MouseEvent):void{ supportsCursorTxt.text= "Supports Cursor is : " + String(flash.ui.Mouse.supportsCursor); }
if(Mouse.supportsCursor) { //Game acts as before } else { if(Capabilities.touchscreenType == TouchscreenType.STYLUS ){ //The Game has to change so that the character is chasing the location of the stylus as //it's dragged around. Some of the animations will have to change }else if(Capabilities.touchscreenType = TouchscreenType.FINGER){ //Same as above, except that the hit-area is larger for a finger. }else{ //There's no pointing device at all. The developer designs some sort of custom cursor to //be controlled with key presses or similar input } }
supportsNativeCursor | свойство |
hide | () | метод |
public static function hide():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Скрывает указатель мыши. По умолчанию указатель находится в видимом состоянии.
Примечание. Метод Mouse.hide()
требуется вызвать только один раз независимо от числа предшествующих вызовов Mouse.show()
.
Связанные элементы API
registerCursor | () | метод |
public static function registerCursor(name:String, cursor:MouseCursorData):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.2, AIR 1.5 |
Выполняет регистрацию встроенного курсора под указанным именем, с указанными данными.
Параметры
name:String | |
cursor:MouseCursorData |
show | () | метод |
public static function show():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Отображает указатель мыши. По умолчанию указатель находится в видимом состоянии.
Примечание. Метод Mouse.show()
требуется вызвать только один раз независимо от числа предшествующих вызовов Mouse.hide()
.
Связанные элементы API
unregisterCursor | () | метод |
- Объявите следующие свойства экземпляра
cursor
типа CustomCursor,child
типа CustomButton иgutter
типа uint. - Назначьте
child
новому экземпляру CustomButton, задайте его координатам x и y значение 10 (пикселей), а затем добавьте экземпляр в список отображения. Класс CustomButton переопределяет свойстваdownState
,upState
,overState
иhitTestState
объекта SimpleButton. Каждое из этих свойств создает экземпляр объекта ButtonDisplayState, который рисует разные квадраты в зависимости от состояния экземпляраchild
. - Затем с помощью экземпляра
child
добавляется прослушиватель событийMOUSE_OVER
и связанный с ним методmouseOverHandler()
, а также прослушиватель событийMOUSE_OUT
и связанный методmouseOutHandler()
. - Прослушиватели событий работают следующим образом.
mouseOverHandler
: скрывает обычный указатель и добавляет прослушивательMOUSE_MOVE
, который обрабатывает перемещение мыши с помощью методаmouseMoveHandler()
, описанного ниже.mouseOutHandler
: когда мышь перемещается за пределы пользовательской кнопки, показывается «обычный» указатель, прослушиватель событийMOUSE_MOVE
удаляется, а видимость пользовательского курсора получает значениеfalse
.mouseMoveHandler
: перемещает пользовательский курсор в соответствии с движениями указателя и задает для его видимости значениеtrue
.
- В конструкторе
MouseExample
свойство cursor назначается новому объекту CustomCursor и затем добавляется в список отображения с помощью методаaddChild()
. Класс CustomCursor рисует маленький практически черный квадрат вместо «обычного» указателя, когда мышь наводится наchild
. - Добавляется четвертый прослушиватель событий
MOUSE_LEAVE
и связывается с методомmouseLeaveHandler()
. В этом методе, который вызывается при выходе мыши из рабочей области, методуmouseOutHandler()
передается новый объект прослушивателяmouseMove
, убирающий указатель из рабочей области.
package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.ui.Mouse; import flash.events.*; public class MouseExample extends Sprite { private var cursor:CustomCursor; private var child:CustomButton; private var gutter:uint = 10; public function MouseExample() { child = new CustomButton(); child.x = gutter; child.y = gutter; addChild(child); child.addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler); child.addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler); cursor = new CustomCursor(); addChild(cursor); stage.addEventListener(Event.MOUSE_LEAVE, mouseLeaveHandler); } private function mouseOverHandler(event:MouseEvent):void { trace("mouseOverHandler"); Mouse.hide(); child.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); } private function mouseOutHandler(event:MouseEvent):void { trace("mouseOutHandler"); Mouse.show(); child.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); cursor.visible = false; } private function mouseMoveHandler(event:MouseEvent):void { trace("mouseMoveHandler"); cursor.x = event.localX; cursor.y = event.localY; event.updateAfterEvent(); cursor.visible = true; } private function mouseLeaveHandler(event:Event):void { trace("mouseLeaveHandler"); mouseOutHandler(new MouseEvent(MouseEvent.MOUSE_MOVE)); } } } import flash.display.Shape; import flash.display.SimpleButton; class CustomButton extends SimpleButton { var upColor:uint = 0xFFCC00; var overColor:uint = 0xCCFF00; var downColor:uint = 0x00CCFF; var size:uint = 80; public function CustomButton() { downState = new ButtonDisplayState(downColor, size+10); overState = new ButtonDisplayState(overColor, size); upState = new ButtonDisplayState(upColor, size); hitTestState = new ButtonDisplayState(upColor, size); } } class ButtonDisplayState extends Shape { var bgColor:uint; var size:uint; public function ButtonDisplayState(bgColor:uint, size:uint) { this.bgColor = bgColor; this.size = size; draw(); } private function draw():void { graphics.clear(); graphics.beginFill(bgColor); graphics.drawRect(0, 0, size, size); graphics.endFill(); } } class CustomCursor extends Shape { var bgColor:uint = 0x333333; var size:uint = 10; public function CustomCursor() { visible = false; draw(); } private function draw():void { graphics.clear(); graphics.beginFill(bgColor); graphics.drawRect(0, 0, size, size); graphics.endFill(); } }
Tue Jun 12 2018, 11:34 AM Z