Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.ui 

MouseCursorData  - AS3

Пакетflash.ui
Классpublic final class MouseCursorData
НаследованиеMouseCursorData Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.2, AIR 2.6

Класс MouseCursorData позволяет определять внешний вид «собственного» курсора.

Для отображения курсора используйте функцию Mouse.registerCursor(). Чтобы вернуть управление изображением курсора в операционную систему, вызовите функцию Mouse.unregisterCursor(). Вызовите функцию Mouse.supportsNativeCursor, чтобы проверить, поддерживаются ли собственные курсоры на текущем компьютере.

Максимальный размер курсора равен 32x32 пикселя. Прозрачность поддерживается в большинстве операционных систем.

Встроенный курсор внедрен непосредственно через механизм курсора операционной системы и является более эффективным средством для отображения пользовательского курсора, чем использование экранного объекта. Курсор можно анимировать, предоставив несколько изображений с помощью свойства data и установив частоту кадров.

Курсор отображается в рамках рабочей области. За пределами рабочей область управление изображением курсора возвращается к операционной системе.

Посмотреть примеры

Дополнительно

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  data : Vector.<BitmapData>
Вектор объектов BitmapData, содержащий изображение курсора или несколько изображений.
MouseCursorData
  frameRate : Number
Частота кадров для анимации курсора.
MouseCursorData
  hotSpot : Point
Активная точка курсора в пикселях.
MouseCursorData
Общедоступные методы
 МетодОпределено
  
Создает объект MouseCursorData.
MouseCursorData
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

data

свойство
data:Vector.<BitmapData>

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.2, AIR 2.6

Вектор объектов BitmapData, содержащий изображение курсора или несколько изображений.

Для анимации курсора предоставьте несколько изображений и задайте значение свойства framerate.

Максимальный размер курсора равен 32x32 пикселя.



Реализация
    public function get data():Vector.<BitmapData>
    public function set data(value:Vector.<BitmapData>):void

frameRate

свойство 
frameRate:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.2, AIR 2.6

Частота кадров для анимации курсора.

Предоставьте несколько изображений в свойстве data и установите для частоты кадров значение больше 0, чтобы анимировать курсор. Частота кадров может отличаться от текущего числа кадров SWF.



Реализация
    public function get frameRate():Number
    public function set frameRate(value:Number):void

hotSpot

свойство 
hotSpot:Point

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.2, AIR 2.6

Активная точка курсора в пикселях.

Активная точка — это точка на курсоре, в которой регистрируется нажатие мыши. По умолчанию активная точка — это левый верхний угол (0,0).



Реализация
    public function get hotSpot():Point
    public function set hotSpot(value:Point):void
Сведения о конструкторе

MouseCursorData

()Конструктор
public function MouseCursorData()

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.2, AIR 2.6

Создает объект MouseCursorData.

Чтобы отобразить курсор, вызовите функцию Mouse.registerCursor().

Связанные элементы API

MouseCursorDataExample.as

В следующем примере для курсора мыши создается и отображается вращающаяся стрелка.

В примере с помощью команд рисования, доступных через класс Graphics, создается восемь повернутых изображений стрелки. Эти изображения представлены в векторном формате и назначены для свойства data объекта MouseCursorData. (Обратите внимание, что для курсоров можно также использовать предварительно отрисованные растровые изображения.)

package  {
    
    import flash.display.Sprite;
    import flash.display.Shape;
    import flash.display.BitmapData;
    import flash.display.GraphicsPath;
    import flash.ui.MouseCursorData;
    import flash.ui.Mouse;
    import flash.geom.Matrix;    
    
    public class MouseCursorDataExample extends Sprite {
        //Graphics path data for an arrow
        private var cursorPoints:Vector.<Number> = new <Number>[0,8, 16,8, 16,0, 24,12, 16,24, 16,16, 0,16, 0,8];
        private var cursorDrawCommands:Vector.<int> = new <int>[1,2,2,2,2,2,2,2];
        
        public function MouseCursorDataExample() {
            var mouseCursorData:MouseCursorData = new MouseCursorData();
            mouseCursorData.data = makeCursorImages();
            mouseCursorData.frameRate = 1;
            
            Mouse.registerCursor( "spinningArrow", mouseCursorData );
            Mouse.cursor = "spinningArrow";
        }
        
        //Returns a Vector containing 8 cursor images
        private function makeCursorImages():Vector.<BitmapData>
        {
            var cursorData:Vector.<BitmapData> = new Vector.<BitmapData>();
            
            var cursorShape:Shape = new Shape();
            cursorShape.graphics.beginFill( 0xff5555, .75 );
            cursorShape.graphics.lineStyle( 1 );
            cursorShape.graphics.drawPath( cursorDrawCommands, cursorPoints );
            cursorShape.graphics.endFill();
            var transformer:Matrix = new Matrix();
            
            //Rotate and draw the arrow shape to a BitmapData object for each of 8 frames 
            for( var i:int = 0; i < 8; i++ )
            {
                var cursorFrame:BitmapData = new BitmapData( 32, 32, true, 0 );
                cursorFrame.draw( cursorShape, transformer );
                cursorData.push( cursorFrame );
                
                transformer.translate(-15,-15);
                transformer.rotate( 0.785398163 );
                transformer.translate(15,15);
            }
            return cursorData;
        }
    }
    
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.