（Flex データ視覚化のみ）
パッケージmx.automation
インターフェイスpublic interface IAutomationManager extends IEventDispatcher

IAutomationManager インターフェイスは、オートメーションモジュールが AutomationManager オブジェクトから返すインターフェイスを定義します。


パブリックプロパティ
 プロパティ定義元
  automationEnvironment : Object
この Automation Manager のオートメーション環境です。
IAutomationManager
  recording : Boolean
[読み取り専用] 記録が実行中の場合は true、そうでない場合は false です。
IAutomationManager
  replaying : Boolean
[読み取り専用] 再生が実行中の場合は true、そうでない場合は false です。
IAutomationManager
パブリックメソッド
 メソッド定義元
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
IEventDispatcher
  
beginRecording():void
Automation Manager を記録モードに設定します。
IAutomationManager
  
createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID
resolveID() メソッドで使用できる、指定されたオブジェクトの ID を返します。
IAutomationManager
  
createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart
resolveIDPart で使用できる、指定されたオブジェクトの ID パートを返します。
IAutomationManager
  
decrementCacheCounter(clearNow:Boolean = false):int
キャッシュカウンタをデクリメントします。
IAutomationManager
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
IEventDispatcher
  
endRecording():void
Automation Manager の記録モードを解除します。
IAutomationManager
  
getAutomationClassName(obj:IAutomationObject):String
オブジェクト型として表示されるテキストを返します。
IAutomationManager
  
getAutomationName(obj:IAutomationObject):String
オブジェクトの説明として表示されるテキストを返します。
IAutomationManager
  
getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array
このオブジェクトの子のうち、テスト階層に表示されているすべての子を返します。
IAutomationManager
  
getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array
このオブジェクトの子のうち、テスト階層に表示されており、オートメーションパートの条件を満たすすべての子を返します。
IAutomationManager
  
getElementFromPoint(x:int, y:int):IAutomationObject
指定された座標のオートメーションオブジェクトを返します。
IAutomationManager
  
getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject
オートメーション階層に表示されている次の親を返します。
IAutomationManager
  
getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array
プロパティのセットの値を返します。
IAutomationManager
  
getRectangle(obj:DisplayObject):Array
DisplayObject を囲む矩形を表示します。
IAutomationManager
  
getTabularData(obj:IAutomationObject):IAutomationTabularData
IAutomationTabularData インターフェイスを実装するオブジェクトを返します。このインターフェイスによって表形式のデータを取得できます。
IAutomationManager
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
IEventDispatcher
  
incrementCacheCounter():int
キャッシュカウンタをインクリメントします。
IAutomationManager
  
isSynchronized(target:IAutomationObject):Boolean
指定されたターゲットが前の処理が完了するのを待つ必要があるかどうかをテストします。
IAutomationManager
  
isVisible(obj:DisplayObject):Boolean
オブジェクトとその親がすべて表示されている場合は、true を返します。
IAutomationManager
  
recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void
イベントを記録します。
IAutomationManager
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
IEventDispatcher
  
replayAutomatableEvent(event:AutomationReplayEvent):Boolean
指定されたイベントを再生します。
IAutomationManager
  
resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array
ID を解決してオートメーションオブジェクトにします。
IAutomationManager
  
resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array
ID パートを解決して、オートメーションオブジェクトにします。
IAutomationManager
  
resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject
ID パートを解決して、親の中にあるオートメーションオブジェクトにします。
IAutomationManager
  
resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject
ID を解決してオートメーションオブジェクトにします。
IAutomationManager
  
showInHierarchy(obj:IAutomationObject):Boolean
オートメーションオブジェクトを階層に表示するかどうかを示します。
IAutomationManager
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
IEventDispatcher
プロパティの詳細
automationEnvironmentプロパティ
automationEnvironment:Object

この Automation Manager のオートメーション環境です。 オートメーション環境は、エージェントツールとの通信に必要なテスト可能コンポーネントのオブジェクトとプロパティに関する情報を提供します。 このプロパティの値では、IAutomationEnvironment インターフェイスを実装する必要があります。



実装
    public function get automationEnvironment():Object
    public function set automationEnvironment(value:Object):void

関連項目

mx.automation.IAutomationEnvironment
recordingプロパティ 
recording:Boolean  [読み取り専用]

記録が実行中の場合は true、そうでない場合は false です。



実装
    public function get recording():Boolean
replayingプロパティ 
replaying:Boolean  [読み取り専用]

再生が実行中の場合は true、そうでない場合は false です。



実装
    public function get replaying():Boolean
メソッドの詳細
beginRecording()メソッド
public function beginRecording():void

Automation Manager を記録モードに設定します。

createID()メソッド 
public function createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID

resolveID() メソッドで使用可能な、指定されたオブジェクトの ID を返します。

パラメータ

obj:IAutomationObject — オートメーションオブジェクトです。
 
relativeToParent:IAutomationObject (default = null) — オートメーションオブジェクトの親です。

戻り値
AutomationID — オートメーションオブジェクトを表す AutomationID オブジェクトです。
createIDPart()メソッド 
public function createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart

resolveIDPart で使用できる、指定されたオブジェクトの ID パートを返します。

パラメータ

obj:IAutomationObject — オートメーションオブジェクトです。
 
parent:IAutomationObject (default = null) — オートメーションオブジェクトの親です。

戻り値
AutomationIDPart — オートメーションオブジェクトを表す AutomationIDPart オブジェクトです。
decrementCacheCounter()メソッド 
public function decrementCacheCounter(clearNow:Boolean = false):int

キャッシュカウンタをデクリメントします。 カウントがゼロになると、キャッシュはクリアされます。

パラメータ

clearNow:Boolean (default = false) — true の場合、キャッシュカウンタの値に関係なくキャッシュをクリアします。

戻り値
int — 現在のキャッシュカウンタです。
endRecording()メソッド 
public function endRecording():void

Automation Manager の記録モードを解除します。

getAutomationClassName()メソッド 
public function getAutomationClassName(obj:IAutomationObject):String

オブジェクト型として表示されるテキストを返します。

パラメータ

obj:IAutomationObject — オートメーションオブジェクトです。

戻り値
String — オブジェクト型です。
getAutomationName()メソッド 
public function getAutomationName(obj:IAutomationObject):String

オブジェクトの説明として表示されるテキストを返します。

パラメータ

obj:IAutomationObject — オートメーションオブジェクトです。

戻り値
String — オートメーションオブジェクトのテキストの説明です。
getChildren()メソッド 
public function getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array

このオブジェクトの子のうち、テスト階層に表示されているすべての子を返します。 階層に子が表示されていない場合、非表示の子の子を返します。

パラメータ

obj:IAutomationObject — 子を取得する対象オブジェクトです。
 
ignoreShowInHierarchy:Boolean (default = false)

戻り値
Array — 子の配列です。
getChildrenFromIDPart()メソッド 
public function getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array

このオブジェクトの子のうち、テスト階層に表示されており、オートメーションパートの条件を満たすすべての子を返します。 階層に子が表示されていない場合、このメソッドは非表示の子の子を返します。

パラメータ

obj:IAutomationObject — 子を取得する対象オブジェクトです。
 
part:AutomationIDPart (default = null) — 返す子を指定する条件です。
 
ignoreShowInHierarchy:Boolean (default = false) — オブジェクトがオートメーション階層で無視されたかどうか判別するブール値です。 デフォルト値は false です。

戻り値
Array — 条件と一致する子の配列です。
getElementFromPoint()メソッド 
public function getElementFromPoint(x:int, y:int):IAutomationObject

指定された座標のオートメーションオブジェクトを返します。

パラメータ

x:int — X 座標です。
 
y:int — Y 座標です。

戻り値
IAutomationObject — そのポイントにおけるオートメーションオブジェクトです。
getParent()メソッド 
public function getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject

オートメーション階層に表示されている次の親を返します。

パラメータ

obj:IAutomationObject — オートメーションオブジェクトです。
 
parentToStopAt:IAutomationObject (default = null) — 指定されたオートメーションオブジェクトの親です。
 
ignoreShowInHierarchy:Boolean (default = false) — オブジェクトがオートメーション階層で無視されたかどうか判別するブール値です。 デフォルト値は false です。

戻り値
IAutomationObject — オートメーション階層に表示されているオブジェクトに最も近い親です。
getProperties()メソッド 
public function getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array

プロパティのセットの値を返します。

パラメータ

obj:IAutomationObject — プロパティを取得する対象オブジェクトです。
 
names:Array (default = null) — オブジェクトで評価するプロパティの名前です。
 
forVerification:Boolean (default = true) — true の場合、検証プロパティのみを含みます。
 
forDescription:Boolean (default = true) — true の場合、説明プロパティのみを含みます。

戻り値
Array — 各プロパティ値と記述子を含むオブジェクトの配列です。
getRectangle()メソッド 
public function getRectangle(obj:DisplayObject):Array

DisplayObject を囲む矩形を表示します。

パラメータ

obj:DisplayObject — 必要な矩形が含まれている DisplayObject です。

戻り値
Array — 4 つの整数（上、左、幅、高さ）の配列です。
getTabularData()メソッド 
public function getTabularData(obj:IAutomationObject):IAutomationTabularData

IAutomationTabularData インターフェイスを実装するオブジェクトを返します。このインターフェイスによって表形式のデータを取得できます。

パラメータ

obj:IAutomationObject — IAutomationObject です。

戻り値
IAutomationTabularData — IAutomationTabularData インターフェイスを実装するオブジェクトです。
incrementCacheCounter()メソッド 
public function incrementCacheCounter():int

キャッシュカウンタをインクリメントします。 オートメーションメカニズムは、オブジェクトのプロパティと子をキャシュします。 キャッシュは両方のパフォーマンスのために備えてあり、記録前のオブジェクトステートをキャプチャします。 incrementCacheCounter() メソッドが呼び出されるたびにカウンタはインクリメントされ、decrementCacheCounter() メソッドが呼び出されるたびにカウンタはデクリメントされます。カウンタがゼロになると、キャッシュはクリアされます。

重要な点ですが、テストツールがキャッシュを使用するのは、Flex アプリケーションが停止状態で、ユーザーが操作できないことが確実な場合のみです。 たとえば、オートメーションイベントが記録されると、テストツールでは、テストスクリプト行を作成するために getChildren() メソッドまたは getProperties() メソッドを呼び出す必要があります。このために、テストツールは全呼び出しを開始 / 停止キャッシュ呼び出しにまとめます。

AutomationManager は、オートメーションイベントをトリガする可能性のあるエンドユーザ操作が行われる前に、内部でキャッシュをクリアします。 次に、キャッシュカウンタをインクリメントし、オートメーションイベントが送出された後、カウンタをデクリメントします。 テストツールは、カウントがゼロになるのを防止するため、レコードハンドラでカウンタをインクリメントします。

戻り値
int — 現在のキャッシュカウンタです。
isSynchronized()メソッド 
public function isSynchronized(target:IAutomationObject):Boolean

指定されたターゲットが前の処理が完了するのを待つ必要があるかどうかをテストします。

パラメータ

target:IAutomationObject — 同期化をチェックする対象のターゲットです。実行中の処理を同期化する場合は null です。

戻り値
Boolean — 同期化が完了した場合は true、完了しない場合は false です。
isVisible()メソッド 
public function isVisible(obj:DisplayObject):Boolean

オブジェクトとその親がすべて表示されている場合は、true を返します。

パラメータ

obj:DisplayObject — DisplayObject です。

戻り値
Boolean — オブジェクトとその親がすべて表示されている場合は、true を返します。
recordAutomatableEvent()メソッド 
public function recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void

イベントを記録します。

パラメータ

recorder:IAutomationObject — イベントの記録先のオートメーションオブジェクトです。
 
event:Event — 記録する必要がある実際のイベントです。
 
cacheable:Boolean (default = false) — 記録する必要があるイベントのキャッシングの制御に使用されます。 オートメーションメカニズムは、マウスを押したり離したりする間、全イベントではなく、最も重要または適切なイベントを記録しようとします。 例えば、アイテムレンダラーにボタンが含まれている List コントロールがあるとします。 ユーザーがボタンをクリックすると、オートメーションメカニズムは、ボタンの click イベントのみを記録し、List コントロールから生成された select イベントは無視します。

replayAutomatableEvent()メソッド 
public function replayAutomatableEvent(event:AutomationReplayEvent):Boolean

指定されたイベントを再生します。 デフォルトの再生動作がスーパークラスで定義されている場合、コンポーネント作成者は、super.replayAutomatableEvent() メソッドを呼び出す必要があります。

パラメータ

event:AutomationReplayEvent — 再生するイベントです。

戻り値
Boolean — 再生が正常に完了した場合は、true です。
resolveID()メソッド 
public function resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array

ID を解決してオートメーションオブジェクトにします。

パラメータ

rid:AutomationID — オートメーションオブジェクトのオートメーション ID です。
 
currentParent:IAutomationObject (default = null) — オートメーションオブジェクトの現在の親です。

戻り値
Array — rid と一致するすべてのオブジェクトを含む配列です。
resolveIDPart()メソッド 
public function resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array

ID パートを解決して、オートメーションオブジェクトにします。

パラメータ

parent:IAutomationObject — オートメーションオブジェクトの親です。
 
part:AutomationIDPart — オートメーションオブジェクトの ID パートです。

戻り値
Array — part と一致するオートメーションオブジェクトの配列です。
resolveIDPartToSingleObject()メソッド 
public function resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject

ID パートを解決して、親の中にあるオートメーションオブジェクトにします。

パラメータ

parent:IAutomationObject — オートメーションオブジェクトの親です。
 
part:AutomationIDPart — オートメーションオブジェクトの ID パートです。

戻り値
IAutomationObject — part と一致する IAutomationObject です。 オブジェクトが見つからない場合、または複数のオブジェクトが見つかった場合は、例外をスローします。
resolveIDToSingleObject()メソッド 
public function resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject

ID を解決してオートメーションオブジェクトにします。

パラメータ

rid:AutomationID — オートメーションオブジェクトのオートメーション ID です。
 
currentParent:IAutomationObject (default = null) — オートメーションオブジェクトの現在の親です。

戻り値
IAutomationObject — rid と一致する IAutomationObject です。 オブジェクトが見つからない場合、または複数のオブジェクトが見つかった場合は、例外をスローします。
showInHierarchy()メソッド 
public function showInHierarchy(obj:IAutomationObject):Boolean

オートメーションオブジェクトを階層に表示するかどうかを示します。

パラメータ

obj:IAutomationObject — オートメーションオブジェクトです。

戻り値
Boolean — オートメーション階層にオブジェクトを表示する場合は、true です。



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

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

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