Packagejp.progression.casts.mx
Classpublic class CastUIButton
InheritanceCastUIButton Inheritance mx.controls.Button
Implementsjp.progression.core.impls.ICastButton, jp.progression.core.impls.IManageable

CastUIButton クラスは、Container クラスの基本機能を拡張し、イベントフローとの連携機能を実装した jp.progression パッケージで使用される基本的な表示オブジェクトクラスです。


Example
  // CastUIButton インスタンスを作成する
  var cast:CastUIButton = new CastUIButton();
  



Public Properties
 PropertyDefined by
  accessKey : String
ボタンの機能をキーボードから使用するためのアクセスキーを取得または設定します。 設定できるキーはアルファベットの A ~ Z までの値です。
CastUIButton
  activatedButtons : Array
[static][read-only] 現在、ステージ上に設置されているボタンを含む配列を取得します。
CastUIButton
  contextMenu : ContextMenu
CastUIButton
  executor : ExecutorObject
[read-only] 関連付けられている ExecutorObject インスタンスを取得します。
CastUIButton
  group : String
インスタンスのグループ名を取得または設定します。 Indicates the instance group of the IExDisplayObject.
CastUIButton
  href : String
ボタンがクリックされた時の移動先の URL を取得または設定します。 sceneId プロパティと href プロパティが両方とも設定されている場合には、href プロパティの設定が優先されます。
CastUIButton
  id : String
インスタンスの識別子を取得または設定します。 Indicates the instance id of the IExDisplayObject.
CastUIButton
  isMouseDown : Boolean
[read-only] CastUIButton インスタンスでポインティングデバイスのボタンを押されているかどうかを取得します。
CastUIButton
  isRollOver : Boolean
[read-only] CastUIButton インスタンスにポインティングデバイスが合わされているかどうかを取得します。
CastUIButton
  manager : Progression
[read-only] 関連付けられている Progression インスタンスを取得します。
CastUIButton
  mouseEventEnabled : Boolean
マウス状態に応じて Executor を使用した処理を行うかどうかを取得または設定します。
CastUIButton
  onCastAdded : Function
キャストオブジェクトが CastEvent.CAST_ADDED イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  onCastMouseDown : Function
キャストオブジェクトが CastMouseEvent.CAST_MOUSE_DOWN イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  onCastMouseUp : Function
キャストオブジェクトが CastMouseEvent.CAST_MOUSE_UP イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  onCastRemoved : Function
キャストオブジェクトが CastEvent.CAST_REMOVED イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  onCastRollOut : Function
キャストオブジェクトが CastMouseEvent.CAST_ROLL_OUT イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  onCastRollOver : Function
キャストオブジェクトが CastMouseEvent.CAST_ROLL_OVER イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  sceneId : SceneId
ボタンがクリックされた時の移動先を示すシーン識別子を取得または設定します。 sceneId プロパティと href プロパティが両方とも設定されている場合には、href プロパティの設定が優先されます。
CastUIButton
  self : CastUIButton
[read-only] 自身の参照を取得します。
CastUIButton
  state : int
[read-only] ボタンの状態を取得します。
CastUIButton
  windowTarget : String
ボタンがクリックされた時の移動先を開くウィンドウ名を取得または設定します。
CastUIButton
Public Methods
 MethodDefined by
  
新しい CastUIButton インスタンスを作成します。 Creates a new CastUIButton object.
CastUIButton
  
addCommand(... commands):void
特定のイベントが送出された際に、自動実行させたい Command インスタンスをリストの最後尾に追加します。 追加された Command インスタンスは、イベントが送出される直前に自動的に初期化されます。 このメソッドを使用するためには executor プロパティに CommandExecutor が実装されている必要があります。
CastUIButton
  
clearCommand(completely:Boolean = false):void
登録されている Command インスタンスを削除します。 このメソッドを使用するためには executor プロパティに CommandExecutor が実装されている必要があります。
CastUIButton
  
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。 Dispatches an event into the event flow.
CastUIButton
  
dispose():void
保持しているデータを解放します。
CastUIButton
  
insertCommand(... commands):void
特定のイベントが送出された際に、自動実行させたい Command インスタンスをすでにリストに登録され、実行中の Command インスタンスの次の位置に追加します。 追加された Command インスタンスは、イベントが送出される直前に自動的に初期化されます。 このメソッドを使用するためには executor プロパティに CommandExecutor が実装されている必要があります。
CastUIButton
  
navigateTo(location:*, window:String = null):void
指定されたシーン識別子、または URL の示す先に移動します。 引数が省略された場合には、あらかじめ CastUIButton インスタンスに指定されている sceneId プロパティ、 href プロパティが示す先に移動します。
CastUIButton
  
setProperties(parameters:Object):DisplayObject
インスタンスに対して、複数のプロパティを一括設定します。 Setup the several instance properties.
CastUIButton
  
toString():String
指定されたオブジェクトのストリング表現を返します。 Returns the string representation of the specified object.
CastUIButton
  
updateManager():Boolean
マネージャーオブジェクトとの関連付けを更新します。
CastUIButton
Protected Methods
 MethodDefined by
  
atCastAdded():void
キャストオブジェクトが CastEvent.CAST_ADDED イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  
キャストオブジェクトが CastMouseEvent.CAST_MOUSE_DOWN イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドで。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  
キャストオブジェクトが CastMouseEvent.CAST_MOUSE_UP イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  
キャストオブジェクトが CastEvent.CAST_REMOVED イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  
キャストオブジェクトが CastMouseEvent.CAST_ROLL_OUT イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
  
キャストオブジェクトが CastMouseEvent.CAST_ROLL_OVER イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。
CastUIButton
Events
 EventSummaryDefined by
   IExecutable オブジェクトが AddChild コマンド、または AddChildAt コマンド経由で表示リストに追加された場合に送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。 CastUIButton
   CastEvent.CAST_ADDED イベント中に実行された非同期処理が完了した場合に送出されます。 CastUIButton
   Flash Player ウィンドウの CastUIButton インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。 CastUIButton
   CastMouseEvent.CAST_MOUSE_DOWN イベント中に実行された非同期処理が完了した場合に送出されます。 CastUIButton
   ユーザーが CastUIButton インスタンスからポインティングデバイスを離したときに送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。 CastUIButton
   CastMouseEvent.CAST_MOUSE_UP イベント中に実行された非同期処理が完了した場合に送出されます。 CastUIButton
   ボタンが移動処理を開始する直前に送出されます。 CastUIButton
   IExecutable オブジェクトが RemoveChild コマンド、または RemoveAllChild コマンド経由で表示リストから削除された場合に送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。 CastUIButton
   CastEvent.CAST_REMOVED イベント中に実行された非同期処理が完了した場合に送出されます。 CastUIButton
   ユーザーが CastUIButton インスタンスからポインティングデバイスを離したときに送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。 CastUIButton
   CastMouseEvent.CAST_ROLL_OUT イベント中に実行された非同期処理が完了した場合に送出されます。 CastUIButton
   ユーザーが CastUIButton インスタンスにポインティングデバイスを合わせたときに送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。 CastUIButton
   CastMouseEvent.CAST_ROLL_OVER イベント中に実行された非同期処理が完了した場合に送出されます。 CastUIButton
   ボタンの状態が変更された場合に送出されます。 CastUIButton
   非同期処理中にエラーが発生した場合に送出されます。 CastUIButton
   Progression インスタンスとの関連付けがアクティブになったときに送出されます。 CastUIButton
   Progression インスタンスとの関連付けが非アクティブになったときに送出されます。 CastUIButton
Property detail
accessKeyproperty
accessKey:String  [read-write]

ボタンの機能をキーボードから使用するためのアクセスキーを取得または設定します。 設定できるキーはアルファベットの A ~ Z までの値です。

Implementation
    public function get accessKey():String
    public function set accessKey(value:String):void

See also

activatedButtonsproperty 
activatedButtons:Array  [read-only]

現在、ステージ上に設置されているボタンを含む配列を取得します。

Implementation
    public static function get activatedButtons():Array
contextMenuproperty 
contextMenu:ContextMenu  [read-write]Implementation
    public function get contextMenu():ContextMenu
    public function set contextMenu(value:ContextMenu):void
executorproperty 
executor:ExecutorObject  [read-only]

関連付けられている ExecutorObject インスタンスを取得します。

Implementation
    public function get executor():ExecutorObject

See also

groupproperty 
group:String  [read-write]

インスタンスのグループ名を取得または設定します。 Indicates the instance group of the IExDisplayObject.

Implementation
    public function get group():String
    public function set group(value:String):void

See also

hrefproperty 
href:String  [read-write]

ボタンがクリックされた時の移動先の URL を取得または設定します。 sceneId プロパティと href プロパティが両方とも設定されている場合には、href プロパティの設定が優先されます。

Implementation
    public function get href():String
    public function set href(value:String):void

See also

idproperty 
id:String  [read-write]

インスタンスの識別子を取得または設定します。 Indicates the instance id of the IExDisplayObject.

Implementation
    public function get id():String
    public function set id(value:String):void

See also

isMouseDownproperty 
isMouseDown:Boolean  [read-only]

CastUIButton インスタンスでポインティングデバイスのボタンを押されているかどうかを取得します。

Implementation
    public function get isMouseDown():Boolean
isRollOverproperty 
isRollOver:Boolean  [read-only]

CastUIButton インスタンスにポインティングデバイスが合わされているかどうかを取得します。

Implementation
    public function get isRollOver():Boolean
managerproperty 
manager:Progression  [read-only]

関連付けられている Progression インスタンスを取得します。

Implementation
    public function get manager():Progression

See also

mouseEventEnabledproperty 
mouseEventEnabled:Boolean  [read-write]

マウス状態に応じて Executor を使用した処理を行うかどうかを取得または設定します。

Implementation
    public function get mouseEventEnabled():Boolean
    public function set mouseEventEnabled(value:Boolean):void
onCastAddedproperty 
onCastAdded:Function  [read-write]

キャストオブジェクトが CastEvent.CAST_ADDED イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

Implementation
    public function get onCastAdded():Function
    public function set onCastAdded(value:Function):void

See also

onCastMouseDownproperty 
onCastMouseDown:Function  [read-write]

キャストオブジェクトが CastMouseEvent.CAST_MOUSE_DOWN イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

Implementation
    public function get onCastMouseDown():Function
    public function set onCastMouseDown(value:Function):void

See also

onCastMouseUpproperty 
onCastMouseUp:Function  [read-write]

キャストオブジェクトが CastMouseEvent.CAST_MOUSE_UP イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

Implementation
    public function get onCastMouseUp():Function
    public function set onCastMouseUp(value:Function):void

See also

onCastRemovedproperty 
onCastRemoved:Function  [read-write]

キャストオブジェクトが CastEvent.CAST_REMOVED イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

Implementation
    public function get onCastRemoved():Function
    public function set onCastRemoved(value:Function):void

See also

onCastRollOutproperty 
onCastRollOut:Function  [read-write]

キャストオブジェクトが CastMouseEvent.CAST_ROLL_OUT イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

Implementation
    public function get onCastRollOut():Function
    public function set onCastRollOut(value:Function):void

See also

onCastRollOverproperty 
onCastRollOver:Function  [read-write]

キャストオブジェクトが CastMouseEvent.CAST_ROLL_OVER イベントを受け取った場合に呼び出されるイベントハンドラメソッドを取得または設定します。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

Implementation
    public function get onCastRollOver():Function
    public function set onCastRollOver(value:Function):void

See also

sceneIdproperty 
sceneId:SceneId  [read-write]

ボタンがクリックされた時の移動先を示すシーン識別子を取得または設定します。 sceneId プロパティと href プロパティが両方とも設定されている場合には、href プロパティの設定が優先されます。

Implementation
    public function get sceneId():SceneId
    public function set sceneId(value:SceneId):void

See also

selfproperty 
self:CastUIButton  [read-only]

自身の参照を取得します。

Implementation
    public function get self():CastUIButton
stateproperty 
state:int  [read-only]

ボタンの状態を取得します。

Implementation
    public function get state():int

See also

sceneId
jp.progression.casts.CastUIButtonState
windowTargetproperty 
windowTarget:String  [read-write]

ボタンがクリックされた時の移動先を開くウィンドウ名を取得または設定します。

Implementation
    public function get windowTarget():String
    public function set windowTarget(value:String):void

See also

sceneId
href
navigateTo()
jp.progression.casts.CastUIButtonWindowTarget
Constructor detail
CastUIButton()constructor
public function CastUIButton()

新しい CastUIButton インスタンスを作成します。 Creates a new CastUIButton object.

Method detail
addCommand()method
public function addCommand(... commands):void

特定のイベントが送出された際に、自動実行させたい Command インスタンスをリストの最後尾に追加します。 追加された Command インスタンスは、イベントが送出される直前に自動的に初期化されます。 このメソッドを使用するためには executor プロパティに CommandExecutor が実装されている必要があります。

Parameters
... commands登録したいコマンドを含む配列です。

See also

atCastAdded()method 
protected function atCastAdded():void

キャストオブジェクトが CastEvent.CAST_ADDED イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

See also

atCastMouseDown()method 
protected function atCastMouseDown():void

キャストオブジェクトが CastMouseEvent.CAST_MOUSE_DOWN イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドで。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

See also

atCastMouseUp()method 
protected function atCastMouseUp():void

キャストオブジェクトが CastMouseEvent.CAST_MOUSE_UP イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

See also

atCastRemoved()method 
protected function atCastRemoved():void

キャストオブジェクトが CastEvent.CAST_REMOVED イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

See also

atCastRollOut()method 
protected function atCastRollOut():void

キャストオブジェクトが CastMouseEvent.CAST_ROLL_OUT イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

See also

atCastRollOver()method 
protected function atCastRollOver():void

キャストオブジェクトが CastMouseEvent.CAST_ROLL_OVER イベントを受け取った場合に呼び出されるオーバーライド・イベントハンドラメソッドです。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

See also

clearCommand()method 
public function clearCommand(completely:Boolean = false):void

登録されている Command インスタンスを削除します。 このメソッドを使用するためには executor プロパティに CommandExecutor が実装されている必要があります。

Parameters
completely:Boolean (default = false)true が設定されている場合は登録されている全てのコマンド登録を解除し、false の場合には現在処理中のコマンド以降の登録を解除します。

See also

dispatchEvent()method 
public override function dispatchEvent(event:Event):Boolean

イベントをイベントフローに送出します。 Dispatches an event into the event flow.

Parameters
event:Eventイベントフローに送出されるイベントオブジェクトです。イベントが再度送出されると、イベントのクローンが自動的に作成されます。イベントが送出された後にそのイベントの target プロパティは変更できないため、再送出処理のためにはイベントの新しいコピーを作成する必要があります。 The Event object that is dispatched into the event flow. If the event is being redispatched, a clone of the event is created automatically. After an event is dispatched, its target property cannot be changed, so you must create a new copy of the event for redispatching to work.

Returns
Boolean値が true の場合、イベントは正常に送出されました。値が false の場合、イベントの送出に失敗したか、イベントで preventDefault() が呼び出されたことを示しています。 A value of true if the event was successfully dispatched. A value of false indicates failure or that preventDefault() was called on the event.
dispose()method 
public function dispose():void

保持しているデータを解放します。

insertCommand()method 
public function insertCommand(... commands):void

特定のイベントが送出された際に、自動実行させたい Command インスタンスをすでにリストに登録され、実行中の Command インスタンスの次の位置に追加します。 追加された Command インスタンスは、イベントが送出される直前に自動的に初期化されます。 このメソッドを使用するためには executor プロパティに CommandExecutor が実装されている必要があります。

Parameters
... commands登録したいコマンドを含む配列です。

See also

navigateTo()method 
public function navigateTo(location:*, window:String = null):void

指定されたシーン識別子、または URL の示す先に移動します。 引数が省略された場合には、あらかじめ CastUIButton インスタンスに指定されている sceneId プロパティ、 href プロパティが示す先に移動します。

Parameters
location:*移動先を示すシーン識別子、または URL です。
 
window:String (default = null)location パラメータで指定されたドキュメントを表示するブラウザウィンドウまたは HTML フレームです。

See also

setProperties()method 
public function setProperties(parameters:Object):DisplayObject

インスタンスに対して、複数のプロパティを一括設定します。 Setup the several instance properties.

Parameters
parameters:Object設定したいプロパティを含んだオブジェクトです。 The object that contains the property to setup.

Returns
DisplayObject自身の参照です。
toString()method 
public override function toString():String

指定されたオブジェクトのストリング表現を返します。 Returns the string representation of the specified object.

Returns
Stringオブジェクトのストリング表現です。 A string representation of the object.
updateManager()method 
public function updateManager():Boolean

マネージャーオブジェクトとの関連付けを更新します。

Returns
Boolean関連付けが成功したら true を、それ以外は false を返します。

See also

Event detail
castAddedevent 
Event object type: jp.progression.events.CastEvent

IExecutable オブジェクトが AddChild コマンド、または AddChildAt コマンド経由で表示リストに追加された場合に送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

castAddedCompleteevent  
Event object type: jp.progression.events.CastEvent

CastEvent.CAST_ADDED イベント中に実行された非同期処理が完了した場合に送出されます。

castMouseDownevent  
Event object type: jp.progression.events.CastMouseEvent

Flash Player ウィンドウの CastUIButton インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

castMouseDownCompleteevent  
Event object type: jp.progression.events.CastMouseEvent

CastMouseEvent.CAST_MOUSE_DOWN イベント中に実行された非同期処理が完了した場合に送出されます。

castMouseUpevent  
Event object type: jp.progression.events.CastMouseEvent

ユーザーが CastUIButton インスタンスからポインティングデバイスを離したときに送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

castMouseUpCompleteevent  
Event object type: jp.progression.events.CastMouseEvent

CastMouseEvent.CAST_MOUSE_UP イベント中に実行された非同期処理が完了した場合に送出されます。

castNavigateBeforeevent  
Event object type: jp.progression.events.CastMouseEvent

ボタンが移動処理を開始する直前に送出されます。

castRemovedevent  
Event object type: jp.progression.events.CastEvent

IExecutable オブジェクトが RemoveChild コマンド、または RemoveAllChild コマンド経由で表示リストから削除された場合に送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

castRemovedCompleteevent  
Event object type: jp.progression.events.CastEvent

CastEvent.CAST_REMOVED イベント中に実行された非同期処理が完了した場合に送出されます。

castRollOutevent  
Event object type: jp.progression.events.CastMouseEvent

ユーザーが CastUIButton インスタンスからポインティングデバイスを離したときに送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

castRollOutCompleteevent  
Event object type: jp.progression.events.CastMouseEvent

CastMouseEvent.CAST_ROLL_OUT イベント中に実行された非同期処理が完了した場合に送出されます。

castRollOverevent  
Event object type: jp.progression.events.CastMouseEvent

ユーザーが CastUIButton インスタンスにポインティングデバイスを合わせたときに送出されます。 このイベント処理の実行中には、ExecutorObject を使用した非同期処理が行えます。

castRollOverCompleteevent  
Event object type: jp.progression.events.CastMouseEvent

CastMouseEvent.CAST_ROLL_OVER イベント中に実行された非同期処理が完了した場合に送出されます。

castStateChangeevent  
Event object type: jp.progression.events.CastMouseEvent

ボタンの状態が変更された場合に送出されます。

executeErrorevent  
Event object type: jp.progression.events.ExecuteErrorEvent

非同期処理中にエラーが発生した場合に送出されます。

managerActivateevent  
Event object type: jp.progression.events.ManagerEvent

Progression インスタンスとの関連付けがアクティブになったときに送出されます。

managerDeactivateevent  
Event object type: jp.progression.events.ManagerEvent

Progression インスタンスとの関連付けが非アクティブになったときに送出されます。