| メソッド | プロパティ | フレームあり | フレームなし |
Cursor Manager クラスではカーソルの優先順位リストが制御されており、リスト内で優先度が最も高いカーソルが表示されます。カーソルリストに、同じ優先度を持つカーソルが複数ある場合、最も新しく作成されたカーソルが表示されます。
たとえば、完了するまでユーザーが待つ必要があるような処理がアプリケーションで実行される場合、カーソルを変更することで、今は待ち状態であることを表すことができます。この場合は、カーソルを砂時計などのイメージに変更します。
また、ユーザーが実行できるアクションを示すために、カーソルを変更してユーザーにフィードバックする場合もあります。たとえば、入力が有効な場合を示すカーソルイメージと、入力が無効な場合を示すカーソルイメージを変えることができます。カーソルイメージには、JPEG、GIF、PNG、または SVG イメージや、SWF ファイルを使用できます。
CursorManager のメソッドとプロパティはすべて静的なので、そのインスタンスを作成する必要はありません。
| メソッド | |
static | hideCursor( )
カーソルを非表示にします。 |
static | removeAllCursors( )
: Voidカーソルリストからすべてのカーソルを削除して、システムカーソルを復元します。 |
static | removeBusyCursor( )
: Voidカーソルリストからビジーカーソルを削除します。 |
static | removeCursor( cursorID:Number)
: Voidカーソルリストから 1 つのカーソルを削除します。 |
static | setBusyCursor( )
: Voidビジーカーソルを表示します。 |
static | setCursor( cursorSymbol:String, priorityLevel:Number, xOffset:Number, yOffset:Number)
: Number新しいカーソルを作成し、必要に応じてカーソルに優先度を設定します。 |
static | showCursor( )
カーソルを表示します。 |
| プロパティ | |
static | BUSYCURSORSYMBOL:Stringビジーカーソルシンボルのシンボル名です。 |
static | currentCursorID:Number現在のカーソルの ID です。システムカーソルが表示されている場合は 0 です。 |
static | HIGHPRIORITY:Numberカーソルの最も高い優先度を指定する読み取り専用の定数です。 |
static | LOWPRIORITY:Numberカーソルの最も低い優先度を指定する読み取り専用の定数です。 |
static | MEDIUMPRIORITY:Numberカーソルの中程度の優先度を指定する読み取り専用の定数です。 |
| メソッドの詳細 |
static hideCursor( )
hideCursor() メソッドが何回呼び出されていても、showCursor() メソッドを 1 回呼び出すと必ずカーソルが表示されます。
static removeAllCursors( )
: Void
static removeBusyCursor( )
: Void
static removeCursor( cursorID:Number)
: Void
パラメータ
cursorID:Number - 削除するカーソルの ID です。
static setBusyCursor( )
: Void
static setCursor( cursorSymbol:String, priorityLevel:Number, xOffset:Number, yOffset:Number)
: Number
パラメータ
cursorSymbol:String - 表示するカーソルのシンボル名を示すストリングです。
priorityLevel:Number - カーソルの優先度レベルを示す数値です。有効な値は、CursorManager.HIGHPRIORITY、CursorManager.MEDIUMPRIORITY、および CursorManager.LOWPRIORITY です。デフォルト値は CursorManager.MEDIUMPRIORITY です。
xOffset:Number - マウスポインタに対する cursorSymbol の x オフセットを示す数値です。デフォルト値は 0 です。
yOffset:Number - マウスポインタに対する cursorSymbol の y オフセットを示す数値です。デフォルト値は 0 です。
戻り値
カーソルの ID です。
static showCursor( )
hideCursor() メソッドが何回呼び出されていても、showCursor() メソッドを 1 回呼び出すと必ずカーソルが表示されます。
| プロパティの詳細 |
static BUSYCURSORSYMBOL:String
static currentCursorID:Number
static HIGHPRIORITY:Number
static LOWPRIORITY:Number
static MEDIUMPRIORITY:Number