| Пакет | 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):voidcurrentCursorXOffset | свойство |
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):voidcurrentCursorYOffset | свойство |
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):voidgetInstance | () | метод |
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) | |
yOffset:Number (default = 0) |
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