| Пакет | 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
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства