Пакет | mx.managers |
Класс | public class CursorManager |
Наследование | CursorManager Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Например, если приложение выполняет обработку, в течение которой требуется ожидание пользователем ее завершения, то следует придать курсору вид, отражающий период ожидания. В этом случае, необходимо изменить курсор на изображение песочных часов или какое-либо другое изображение.
Также может потребоваться изменить курсор для предоставления обратной связи с пользователем с целью указать возможные выполняемые действия. Например, можно использовать одно изображение курсора для указания возможности пользовательского ввода и другое для указания его невозможности. В качестве изображения курсора можно использовать рисунки форматов JPEG, GIF, PNG или SVG, объект Sprite или файл SWF.
Все методы и свойства CursorManager являются статическими, таким образом создавать их экземпляр не требуется.
В AIR каждый экземпляр mx.core.Window использует собственный экземпляр класса CursorManager. Вместо непосредственной ссылки на статические методы и свойства класса CursorManager можно использовать свойство Window.cursorManager
для ссылки на экземпляр CursorManager для экземпляра окна.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
currentCursorID : int [статические]
Идентификатор текущего пользовательского курсора или NO_CURSOR, если показан курсор системы. | CursorManager | ||
currentCursorXOffset : Number [статические]
Смещение пользовательского курсора относительно указателя мыши по оси x в пикселях. | CursorManager | ||
currentCursorYOffset : Number [статические]
Смещение пользовательского курсора относительно указателя мыши по оси y в пикселях. | CursorManager |
Метод | Определено | ||
---|---|---|---|
getInstance():ICursorManager [статические]
Каждый экземпляр mx.core.Window в приложении AIR имеет собственный экземпляр CursorManager. | CursorManager | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
[статические]
Делает курсор невидимым. | CursorManager | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
[статические]
Удаляет все курсоры из списка курсоров и восстанавливает курсор системы. | CursorManager | ||
[статические]
Удаляет курсор в состоянии занятости из списка курсоров. | CursorManager | ||
[статические]
Удаляет курсор из списка курсоров. | CursorManager | ||
[статические]
Отображает курсор в состоянии занятости. | CursorManager | ||
[статические]
Создает новый курсор и устанавливает дополнительный приоритет курсора. | CursorManager | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
[статические]
Делает курсор видимым. | CursorManager | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Стиль | Описание | Определено | ||
---|---|---|---|---|
busyCursor | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Тема оформления для курсора в состоянии занятости. Значением по умолчанию является mx.skins.halo.BusyCursor . | CursorManager | ||
busyCursorBackground | Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Класс, используемый в качестве темы оформления фона курсора в состоянии занятости. Значением по умолчанию является символ cursorStretch из файла Assets.swf. | CursorManager |
Константа | Определено | ||
---|---|---|---|
NO_CURSOR : int = 0 [статические]
Константа, являющаяся значением свойства currentCursorID при отсутствии курсора, управляемого CursorManager и вследствие этого при отображении курсора системы. | CursorManager |
currentCursorID | свойство |
currentCursorID:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Идентификатор текущего пользовательского курсора или NO_CURSOR, если показан курсор системы.
Реализация
public static function get currentCursorID():int
public static function set currentCursorID(value:int):void
currentCursorXOffset | свойство |
currentCursorXOffset:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Смещение пользовательского курсора относительно указателя мыши по оси x в пикселях.
Значением по умолчанию является 0.
Реализация
public static function get currentCursorXOffset():Number
public static function set currentCursorXOffset(value:Number):void
currentCursorYOffset | свойство |
currentCursorYOffset:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Смещение пользовательского курсора относительно указателя мыши по оси y в пикселях.
Значением по умолчанию является 0.
Реализация
public static function get currentCursorYOffset():Number
public static function set currentCursorYOffset(value:Number):void
getInstance | () | метод |
public static function getInstance():ICursorManager
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Каждый экземпляр mx.core.Window в приложении AIR имеет собственный экземпляр CursorManager. Этот метод возвращает экземпляр CursorManager для экземпляра главного окна.
ВозвращаетICursorManager — Экземпляр CursorManager для экземпляра главного окна в приложении AIR.
|
hideCursor | () | метод |
public static function hideCursor():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Делает курсор невидимым. Видимость курсора не учитывается при подсчете ссылок. Одиночный вызов метода hideCursor()
всегда скрывает курсор независимо от того, сколько было произведено вызовов метода showCursor()
.
Вызов этого метода не влияет на курсор системы. Для непосредственного контроля курсора системы следует использовать методы Mouse.show()
и Mouse.hide()
.
removeAllCursors | () | метод |
public static function removeAllCursors():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет все курсоры из списка курсоров и восстанавливает курсор системы.
removeBusyCursor | () | метод |
public static function removeBusyCursor():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет курсор в состоянии занятости из списка курсоров. Если другие запросы курсоров в состоянии занятости по-прежнему активны в списке курсоров, что означает многократный вызов метода setBusyCursor()
, то курсор в состоянии занятости не исчезнет, пока не будут удалены все курсоры в состоянии занятости из списка.
removeCursor | () | метод |
public static function removeCursor(cursorID:int):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет курсор из списка курсоров. Если удаляемый курсор в настоящее время отображен, то CursorManager покажет следующий курсор в списке, если таковой существует. Если список пустой, CursorManager отображает курсор системы по умолчанию.
Параметры
cursorID:int — Идентификатор удаляемого курсора.
|
setBusyCursor | () | метод |
public static function setBusyCursor():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отображает курсор в состоянии занятости. Курсор в состоянии занятости имеет значение приоритета CursorManagerPriority.LOW. Поэтому, если список курсоров содержит курсор с более высоким приоритетом, то курсор в состоянии занятости не отображается, пока не будут удалены курсоры с более высоким приоритетом. Для создания курсора в состоянии занятости с более высоким уровнем приоритета следует использовать метод setCursor()
.
setCursor | () | метод |
public static function setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает новый курсор и устанавливает дополнительный приоритет курсора. Добавляет новый курсор к списку курсоров.
Параметры
cursorClass:Class — Класс отображаемого курсора.
| |
priority:int (default = 2 ) — Целое число, указывающее уровень приоритета курсора. Возможными значениями являются CursorManagerPriority.HIGH , CursorManagerPriority.MEDIUM и CursorManagerPriority.LOW .
| |
xOffset:Number (default = 0 ) — Число, указывающее смещение курсора относительно указателя мыши по оси x в пикселях.
| |
yOffset:Number (default = 0 ) — Число, указывающее смещение курсора относительно указателя мыши по оси y в пикселях.
|
int — Идентификатор курсора.
|
Связанные элементы API
showCursor | () | метод |
public static function showCursor():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Делает курсор видимым. Видимость курсора не учитывается при подсчете ссылок. Одиночный вызов метода showCursor()
всегда показывает курсор независимо от того, сколько было произведено вызовов метода hideCursor()
.
Вызов этого метода не влияет на курсор системы. Для непосредственного контроля курсора системы следует использовать методы Mouse.show()
и Mouse.hide()
.
NO_CURSOR | Константа |
public static const NO_CURSOR:int = 0
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа, являющаяся значением свойства currentCursorID
при отсутствии курсора, управляемого CursorManager и вследствие этого при отображении курсора системы.
Tue Jun 12 2018, 11:34 AM Z