パッケージmx.managers
Classpublic class CursorManager
継承CursorManager Inheritance Object

CursorManager クラスではカーソルの優先順位リストが制御されており、リスト内で優先度が最も高いカーソルが表示されます。 同じ優先度を持つカーソルがカーソルリストに複数ある場合、最も新しく作成されたカーソルが表示されます。

例えば、完了するまでユーザーが待つ必要があるような処理がアプリケーションで実行される場合、カーソルを変更することで、今は待ち状態であることを表すことができます。 この場合は、カーソルを砂時計などのイメージに変更します。

また、ユーザーが実行できるアクションを示すために、カーソルを変更してユーザーにフィードバックする場合もあります。 例えば、ユーザー入力が有効な場合を示すカーソルイメージと、ユーザー入力が無効な場合を示すカーソルイメージを変えることができます。 カーソルイメージには、JPEG、GIF、PNG、または SVG イメージや、Sprite オブジェクト、SWF ファイルを使用できます。

CursorManager のメソッドとプロパティはすべて静的なので、そのインスタンスを作成する必要はありません。

AIR では、各 mx.core.Window インスタンスは CursorManager クラスの独自のインスタンスを使用します。 CursorManager クラスの静的メソッドとプロパティを直接参照するのではなく、Window.cursorManager プロパティを使用して、Window インスタンスに対する CursorManager インスタンスを参照します。

関連項目

mx.managers.CursorManagerPriority
mx.core.Window

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  currentCursorID : int
[静的] 現在のカスタムカーソルの ID です。システムカーソルが表示されている場合は NO_CURSOR になります。
CursorManager
  currentCursorXOffset : Number
[静的] マウスポインタを基準としたカスタムカーソルの x オフセット（ピクセル単位）です。
CursorManager
  currentCursorYOffset : Number
[静的] マウスポインタを基準としたカスタムカーソルの y オフセット（ピクセル単位）です。
CursorManager
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
  
getInstance():ICursorManager
[静的] AIR アプリケーション内の各 mx.core.Window インスタンスには、独自の CursorManager インスタンスがあります。
CursorManager
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
hideCursor():void
[静的] カーソルを非表示にします。
CursorManager
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
removeAllCursors():void
[静的] カーソルリストからすべてのカーソルを削除して、システムカーソルを復元します。
CursorManager
  
removeBusyCursor():void
[静的] カーソルリストからビジーカーソルを削除します。
CursorManager
  
removeCursor(cursorID:int):void
[静的] カーソルリストから 1 つのカーソルを削除します。
CursorManager
  
setBusyCursor():void
[静的] ビジーカーソルを表示します。
CursorManager
  
setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int
[静的] 新しいカーソルを作成し、必要に応じてカーソルに優先度を設定します。
CursorManager
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
showCursor():void
[静的] カーソルを表示します。
CursorManager
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
スタイル
 スタイル 説明 定義元
  
busyCursor
型: Class CSS 継承: no
ビジーカーソルのスキン デフォルト値 : mx.skins.halo.BusyCursor.		CursorManager
パブリック定数
 定数定義元
  NO_CURSOR : int = 0
[静的] CursorManager で管理されているカーソルがないため、システムカーソルが表示されている場合に、currentCursorID プロパティの値となる定数です。
CursorManager
プロパティの詳細
currentCursorIDプロパティ
currentCursorID:int  [読み取り-書き込み]

現在のカスタムカーソルの ID です。システムカーソルが表示されている場合は NO_CURSOR になります。


実装
    public static function get currentCursorID():int
    public function set currentCursorID(value:int):void
currentCursorXOffsetプロパティ 
currentCursorXOffset:Number  [読み取り-書き込み]

マウスポインタを基準としたカスタムカーソルの x オフセット（ピクセル単位）です。

デフォルト値 : 0.


実装
    public static function get currentCursorXOffset():Number
    public function set currentCursorXOffset(value:Number):void
currentCursorYOffsetプロパティ 
currentCursorYOffset:Number  [読み取り-書き込み]

マウスポインタを基準としたカスタムカーソルの y オフセット（ピクセル単位）です。

デフォルト値 : 0.


実装
    public static function get currentCursorYOffset():Number
    public function set currentCursorYOffset(value:Number):void
メソッドの詳細
getInstance()メソッド
public static function getInstance():ICursorManager

AIR アプリケーション内の各 mx.core.Window インスタンスには、独自の CursorManager インスタンスがあります。 このメソッドは、メイン Window インスタンスの CursorManager インスタンスを返します。

戻り値
ICursorManager — AIR アプリケーション内のメイン Window インスタンスの CursorManager インスタンスです。
hideCursor()メソッド 
public static function hideCursor():void

カーソルを非表示にします。 カーソルの可視性は参照カウントされません。 1 回の hideCursor() メソッドの呼び出しで、常にカーソルが非表示になります。これは、showCursor() メソッドの呼び出し回数に関係ありません。

このメソッドを呼び出しても、システムカーソルには影響がありません。 システムカーソルを直接制御するには、Mouse.show() メソッドおよび Mouse.hide() メソッドを使用します。

removeAllCursors()メソッド 
public static function removeAllCursors():void

カーソルリストからすべてのカーソルを削除して、システムカーソルを復元します。

removeBusyCursor()メソッド 
public static function removeBusyCursor():void

カーソルリストからビジーカーソルを削除します。 他のビジーカーソル要求がカーソルリスト内でまだアクティブな場合、つまり setBusyCursor() メソッドを 2 回以上呼び出していた場合には、ビジーカーソルがリストからすべて削除されるまで、ビジーカーソルは消えません。

removeCursor()メソッド 
public static function removeCursor(cursorID:int):void

カーソルリストから 1 つのカーソルを削除します。 削除対象のカーソルが現在表示されている場合、CursorManager は、リスト内に次のカーソルがあれば、そのカーソルを表示します。 リストが空になると、CursorManager はデフォルトのシステムカーソルを表示します。

パラメータ

cursorID:int — 削除するカーソルの ID です。

setBusyCursor()メソッド 
public static function setBusyCursor():void

ビジーカーソルを表示します。 ビジーカーソルの優先度は CursorManagerPriority.LOW です。このため、これより高い優先度のカーソルがカーソルリストに含まれている場合、そのカーソルが削除されるまでビジーカーソルは表示されません。 より高い優先度のビジーカーソルを作成するには、setCursor() メソッドを使用します。

setCursor()メソッド 
public static function setCursor(cursorClass:Class, priority:int = 2, xOffset:Number = 0, yOffset:Number = 0):int

新しいカーソルを作成し、必要に応じてカーソルに優先度を設定します。 新しいカーソルはカーソルリストに追加されます。

パラメータ

cursorClass:Class — 表示するカーソルのクラスです。
 
priority:int (default = 2) — カーソルの優先度レベルを指定する整数。 有効な値は、CursorManagerPriority.HIGH、CursorManagerPriority.MEDIUM および CursorManagerPriority.LOW です。
 
xOffset:Number (default = 0) — マウスポインタを基準としたカーソルの x オフセットをピクセル単位で指定する数値です。
 
yOffset:Number (default = 0) — マウスポインタを基準としたカーソルの y オフセットをピクセル単位で指定する数値です。

戻り値
int — カーソルの ID です。

関連項目

mx.managers.CursorManagerPriority
showCursor()メソッド 
public static function showCursor():void

カーソルを表示します。 カーソルの可視性は参照カウントされません。 1 回の showCursor() メソッドの呼び出しで、常にカーソルが表示されます。これは、hideCursor() メソッドの呼び出し回数に関係ありません。

このメソッドを呼び出しても、システムカーソルには影響がありません。 システムカーソルを直接制御するには、Mouse.show() メソッドおよび Mouse.hide() メソッドを使用します。

定数の詳細
NO_CURSOR定数
public static const NO_CURSOR:int = 0

CursorManager で管理されているカーソルがないため、システムカーソルが表示されている場合に、currentCursorID プロパティの値となる定数です。




© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jul 24 2008, 12:42 AM -07:00

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/managers/CursorManager.html