public class Desktop extends TestObject implements IClickable, IKeyable
修飾子 | コンストラクタと説明 |
---|---|
|
Desktop()
デフォルトのマシン上のエージェントに RMI によって接続するデスクトップを作成します(システム
プロパティが指定されていない場合は、
localhost になります)。 |
protected |
Desktop(com.borland.silktest.jtf.internal.Agent agent) |
|
Desktop(String url)
指定したホストを使用して指定したマシンのエージェントへ RMI によって接続するデスクトップを作成します。
|
修飾子とタイプ | メソッドと説明 |
---|---|
void |
attach(String executablePattern)
指定したアプリケーションにアタッチします。
|
void |
attach(String executablePattern,
String commandLinePattern)
実行可能ファイル パターンとコマンド ライン パターンに一致する指定したアプリケーションにアタッチします。
|
void |
attach(String executablePattern,
String commandLinePattern,
TechDomain... techdomains)
実行可能ファイル パターンとコマンド ライン パターンに一致する指定したアプリケーションにアタッチします。
|
void |
attach(String executablePattern,
TechDomain... techdomains)
指定したアプリケーションにアタッチして、指定したテクノロジ ドメインを有効化しようとします。
|
void |
click()
オブジェクトをクリックします。
|
void |
click(int button)
オブジェクトをクリックします。
|
void |
click(int button,
Point pos)
オブジェクトをクリックします。
|
void |
click(int button,
Point pos,
ModifierKey modifiers)
オブジェクトをクリックします。
|
<T> T |
createAgentDllCall(Class<T> clz)
指定した DLL 呼び出しインターフェイスを実装し、インターフェイスに対するすべての呼び出しをエージェントに経由する
オブジェクトを返します。
|
<T> T |
createInProcessDllCall(Class<T> clz)
指定した DLL 呼び出しインターフェイスを実装し、インターフェイスに対するすべての呼び出しを AUT に経由する
オブジェクトを返します。
|
String |
decrypt(String toDecrypt)
指定された文字列を復号化します。
|
void |
detachAll()
現在アタッチされているすべてのアプリケーションを解除します。
|
void |
doubleClick()
マウス ボタンをオブジェクト上でダブルクリックします。
|
void |
doubleClick(int button)
マウス ボタンをオブジェクト上でダブルクリックします。
|
void |
doubleClick(int button,
Point pos)
マウス ボタンをオブジェクト上でダブルクリックします。
|
void |
doubleClick(int button,
Point pos,
ModifierKey modifiers)
マウス ボタンをオブジェクト上でダブルクリックします。
|
String |
encrypt(String toEncrypt)
指定された文字列を暗号化します。
|
<T extends TestObject> |
executeBaseState(IBaseState baseState)
テスト対象アプリケーションが実行中でテストの準備ができていることを保証します。
|
String |
getClipboardText()
システム クリップボードの現在のテキストを返します。
|
Desktop |
getDesktop()
このオブジェクトのデスクトップを返します。
|
Object |
getOption(String optionName)
エージェント オプションの値を取得します。
|
Object |
getOption(String optionName,
TechDomain techDomain)
テクノロジ ドメインに固有のオプションの値を取得します。
|
void |
logError(String message)
テスト実行中に書き出される TrueLog ファイルにエラー メッセージと完全なデスクトップのスクリーンショットを出力します。
|
void |
logError(String message,
TruelogScreenshotMode screenshotMode)
テスト実行中に書き出される TrueLog ファイルにエラー メッセージとスクリーンショットを出力します。
|
void |
logInfo(String message)
テスト実行中に書き出される TrueLog ファイルに情報メッセージを出力します。
|
void |
logInfo(String message,
TruelogScreenshotMode screenshotMode)
テスト実行中に書き出される TrueLog ファイルに情報メッセージとスクリーンショットを出力します。
|
void |
logWarning(String message)
テスト実行中に書き出される TrueLog ファイルに警告メッセージを出力します。
|
void |
logWarning(String message,
TruelogScreenshotMode screenshotMode)
テスト実行中に書き出される TrueLog ファイルに警告メッセージとスクリーンショットを出力します。
|
void |
mouseMove()
オブジェクト上の指定した場所にポインターを移動します。
|
void |
mouseMove(Point pos)
オブジェクト上の指定した場所にポインターを移動します。
|
void |
pressKeys(String keys)
一連のキーまたはマウス ボタンを押します(離しません)。
|
void |
pressKeys(String keys,
boolean ensureFocus)
一連のキーまたはマウス ボタンを押します(離しません)。
|
void |
pressMouse()
オブジェクト上でマウス ボタンを押します(離しません)。
|
void |
pressMouse(int button)
オブジェクト上でマウス ボタンを押します(離しません)。
|
void |
pressMouse(int button,
Point pos)
オブジェクト上でマウス ボタンを押します(離しません)。
|
void |
pressMouse(int button,
Point pos,
ModifierKey modifiers)
オブジェクト上でマウス ボタンを押します(離しません)。
|
void |
releaseKeys(String keys)
一連のキーまたはマウス ボタンを離します。
|
void |
releaseKeys(String keys,
boolean ensureFocus)
一連のキーまたはマウス ボタンを離します。
|
void |
releaseMouse()
マウス ボタンを離します。
|
void |
releaseMouse(int button)
マウス ボタンを離します。
|
void |
releaseMouse(int button,
Point pos)
マウス ボタンを離します。
|
void |
releaseMouse(int button,
Point pos,
ModifierKey modifiers)
マウス ボタンを離します。
|
void |
resetAllOptions()
エージェントのすべてのオプションをデフォルト値に戻します。
|
void |
setClipboardText(String text)
システム クリップボードに新しいテキストを書き出します。
|
void |
setOption(String optionName,
Object optionValue)
エージェント オプションを設定します。
|
void |
setOption(String optionName,
Object optionValue,
TechDomain... techDomains)
指定したテクノロジ ドメインのオプションを設定します。
|
void |
shutdownAgent()
夜間テスト実行後などのテスト実行後に Open Agent を停止する場合にこのメソッドを呼び出します。
|
String |
toString()
クラス名とテスト オブジェクトの属性を含んだ文字列を返します。
|
boolean |
tryVerifyAsset(String verificationAsset)
検証資産を実行し、検証が合格したかどうかを返します。
|
void |
typeKeys(String keys)
一連のキーストロークをオブジェクトに送信します。
|
void |
typeKeys(String keys,
int delay)
一連のキーストロークをオブジェクトに送信します。
|
void |
typeKeys(String keys,
int delay,
boolean ensureFocus)
一連のキーストロークをオブジェクトに送信します。
|
void |
typePasswordKeys(String keys)
暗号化されたパスワードをテキスト フィールドなどのオブジェクトに入力します。
|
void |
typePasswordKeys(String keys,
int delay)
暗号化されたパスワードをテキスト フィールドなどのオブジェクトに入力します。
|
void |
typePasswordKeys(String keys,
int delay,
boolean ensureFocus)
暗号化されたパスワードをテキスト フィールドなどのオブジェクトに入力します。
|
void |
unloadAllDllsFromAgent()
現在ロードされているすべての DLL をエージェントからアンロードします。
|
<T> boolean |
unloadDllFromAgent(Class<T> dll)
指定した DLL をエージェントからアンロードします。
|
void |
verifyAsset(String verificationAsset)
検証資産を実行します。
|
captureBitmap, captureBitmap, exists, exists, generateLocator, getChildren, getDynamicMethodList, getParent, getPropertyList, getRect, getRect, getText, getValue, highlightObject, highlightObject, highlightObject, invokeMethods, textCapture, textCapture, textClick, textClick, textClick, textClick, textClick, textClick, textExists, textExists, textExists, textExists, textExists, textRectangle, textRectangle, textRectangle, textRectangle, textRectangle, waitForChildDisappearance, waitForChildDisappearance, waitForDisappearance, waitForDisappearance, waitForObject, waitForObject, waitForProperty, waitForProperty
equals, exists, find, find, findAll, findAll, getCustomTypeName, getHandle, getLocator, getProperty, getTypeName, hashCode, imageClick, imageClick, imageClick, imageClick, imageClick, imageClick, imageClickFile, imageClickFile, imageClickFile, imageClickFile, imageClickFile, imageClickFile, imageExists, imageExists, imageExists, imageExistsFile, imageExistsFile, imageExistsFile, imageRectangle, imageRectangle, imageRectangle, imageRectangleFile, imageRectangleFile, imageRectangleFile, invoke, preventFinalLocator, setProperty
public Desktop()
localhost
になります)。 ローカル マシンのシナリオでは、エージェントは、
実行されていない場合には自動的に起動します。resetAllOptions()
を呼び出すことでこれを行うこともできます)。agentRmiHost
を指定します。 これによって、スクリプトを変更する必要なく、
他のマシン上でスクリプトを再生することができます。-DagentRmiHost=10.5.2.3
がコマンド ラインで渡されると、このメソッドは
指定したホストのエージェントに接続します。AgentConnectionException
- エージェントへの接続が失敗した場合。 エージェントが実行していない場合や、エージェントのポートが
ブロックされている場合に発生します。
public Desktop(String url)
resetAllOptions()
を呼び出して行うこともできます)。url
- Open Agent の URL。AgentConnectionException
- エージェントへの接続が失敗した場合。 ホストが無効な場合や、指定したホスト上でエージェントが
実行されていない場合や、エージェントのマシンがポートをブロックしている場合に発生します。
protected Desktop(com.borland.silktest.jtf.internal.Agent agent)
public <T extends TestObject> T executeBaseState(IBaseState baseState)
T
- ロケーターによって指定したテスト オブジェクトの型baseState
- 基本状態を実行するために必要なすべての情報を含みますTestObject
。BrowserBaseState
,
public void attach(String executablePattern, TechDomain... techdomains)
メモattach(String)
を使用して自動的にテクノロジ ドメインを読み込むことを推奨します。 選択してテクノロジ ドメインを読み込むのは、特定の状況でのみ必要とされる上級テクニックです。
executablePattern
- アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*' を使用できます
(それぞれ、1 文字、または複数文字に一致)。 例: myApplication.exe
myApplica?ion.exe
myApp*.exe
techdomains
- アプリケーションで読み込まれるテクノロジ ドメイン。 テクノロジ ドメインの定数は、
TechDomain
で定義されています。
public void attach(String executablePattern, String commandLinePattern, TechDomain... techdomains)
*org.MyMainClass
など)。
メモattach(String, String)
を使用して自動的にテクノロジ ドメインを読み込むことを推奨します。 選択してテクノロジ ドメインを読み込むのは、特定の状況でのみ必要とされる上級テクニックです。
executablePattern
- アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*'
を使用できます (それぞれ、1 文字、または複数文字に一致)。 例: javaw.exe
java*.exe
commandLinePattern
- このパターンはアプリケーションのコマンド ライン引数に対して照合します。 これは、アプリケーションの
複数のインスタンスが実行中で、その中のいくつかだけがテスト対象である場合に有効です(たとえば、javaw.exe)。Java アプリケーションの場合、
特徴的な jar や main クラスの名前をコマンド ライン パターンに含めることができます。例:
*org.MyMainClass
techdomains
- アプリケーションで読み込まれるテクノロジ ドメイン。 テクノロジ ドメインの定数は、
TechDomain
で定義されています。
public void attach(String executablePattern)
executablePattern
- アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*'
を使用できます (それぞれ、1 文字、または複数文字に一致)。 例: myApplication.exe
myApplica?ion.exe
myApp*.exe
public void attach(String executablePattern, String commandLinePattern)
*org.MyMainClass
など)。executablePattern
- アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*'
を使用できます (それぞれ、1 文字、または複数文字に一致)。 例: javaw.exe
java*.exe
commandLinePattern
- このパターンはアプリケーションのコマンド ライン引数に対して照合します。
public void detachAll()
public Object getOption(String optionName)
desktop.getOption(CommonOptions.OPT_WAIT_RESOLVE_OBJDEF)
optionName
- オプションの名前。 利用可能なオプションのリストについては、CommonOptions
を参照してください。public Object getOption(String optionName, TechDomain techDomain)
optionName
- 利用可能なオプションのリストについては、CommonOptions
を参照してください。techDomain
- テクノロジ ドメイン。public void setOption(String optionName, Object optionValue, TechDomain... techDomains)
desktop.setOption(CommonOptions.OPT_CUSTOM_ATTRIBUTES, Arrays.asList("automationId"), TechDomain.SWT, TechDomain.WIN32)
optionName
- オプションの名前。 利用可能なオプションのリストについては、CommonOptions
を参照してください。techDomains
- テクノロジ ドメインの名前。optionValue
- オプションの値。
public void setOption(String optionName, Object optionValue)
desktop.setOption(CommonOptions.OPT_WAIT_RESOLVE_OBJDEF, true)
optionName
- オプションの名前。 利用可能なオプションのリストについては、CommonOptions
を参照してください。optionValue
- オプションの値。
public void resetAllOptions()
public String encrypt(String toEncrypt)
toEncrypt
- 暗号化する文字列public String decrypt(String toDecrypt)
encrypt
メソッドで暗号化された
文字列のみ復号化することができます。toDecrypt
- 復号化する文字列public String getClipboardText()
public void setClipboardText(String text)
text
- クリップボードの新しいテキスト
public <T> T createInProcessDllCall(Class<T> clz)
DllCall.createInProcessDllCall(Class, Desktop)
を使用するのと同じ結果になります。T
- サポートする DLL 呼び出しインターフェイスclz
- サポートする DLL 呼び出しインターフェイスのクラスpublic <T> T createAgentDllCall(Class<T> clz)
DllCall.createAgentDllCall(Class, Desktop)
を使用するのと同じ結果になります。T
- サポートする DLL 呼び出しインターフェイスclz
- サポートする DLL 呼び出しインターフェイスのクラスpublic <T> boolean unloadDllFromAgent(Class<T> dll)
T
- アンロードする DLL の型dll
- アンロードする DLL オブジェクトpublic void unloadAllDllsFromAgent()
public Desktop getDesktop()
AbstractTestObject
getDesktop
クラス内 AbstractTestObject
public String toString()
AbstractTestObject
toString
クラス内 AbstractTestObject
public void logInfo(String message)
message
- ログに出力するメッセージ
public void logInfo(String message, TruelogScreenshotMode screenshotMode)
message
- ログに出力するメッセージscreenshotMode
- 出力するスクリーンショットが完全なデスクトップか、アクティブなアプリケーションか、アクティブなウィンドウかを定義します。
public void logWarning(String message)
message
- ログに出力する警告
public void logWarning(String message, TruelogScreenshotMode screenshotMode)
message
- ログに出力する警告screenshotMode
- 出力するスクリーンショットが完全なデスクトップか、アクティブなアプリケーションか、アクティブなウィンドウかを定義します。
public void logError(String message)
message
- ログに出力するエラー
public void logError(String message, TruelogScreenshotMode screenshotMode)
message
- ログに出力するエラーscreenshotMode
- 出力するスクリーンショットが完全なデスクトップか、アクティブなアプリケーションか、アクティブなウィンドウかを定義します。
public void verifyAsset(String verificationAsset)
verificationAsset
- .verification ファイルの名前。ファイル拡張子は省略可能です。VerificationFailedException
- 検証が合格しなかった場合。ObjectNotFoundException
- 検証する UI オブジェクトが見つからなかった場合。
public boolean tryVerifyAsset(String verificationAsset)
verificationAsset
- .verification ファイルの名前。 ファイル拡張子は省略可能です。ObjectNotFoundException
- 検証する UI オブジェクトが見つからなかった場合。
public void shutdownAgent()
Runtime.getRuntime().addShutdownHook(new Thread(new Runnable() { public void run() { desktop.shutdownAgent(); } }));
public void click()
IClickable
使用例
たとえば、コントロール内のある位置をクリックする場合は、次のように入力します。
control.click (MouseButton.LEFT, new Point(244, 16));
次の例では、コントロールの中央でマウスの左ボタンがクリックされます。
control.click ();
click
インタフェース内 IClickable
public void click(int button)
IClickable
使用例
たとえば、コントロール内のある位置をクリックする場合は、次のように入力します。
control.click (MouseButton.LEFT, new Point(244, 16));
次の例では、コントロールの中央でマウスの左ボタンがクリックされます。
control.click ();
click
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void click(int button, Point pos)
IClickable
使用例
たとえば、コントロール内のある位置をクリックする場合は、次のように入力します。
control.click (MouseButton.LEFT, new Point(244, 16));
次の例では、コントロールの中央でマウスの左ボタンがクリックされます。
control.click ();
click
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- クリックする座標(オブジェクトに相対)public void click(int button, Point pos, ModifierKey modifiers)
IClickable
使用例
たとえば、コントロール内のある位置をクリックする場合は、次のように入力します。
control.click (MouseButton.LEFT, new Point(244, 16));
次の例では、コントロールの中央でマウスの左ボタンがクリックされます。
control.click ();
click
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- クリックする座標(オブジェクトに相対)modifiers
- 修飾キーpublic void doubleClick()
IClickable
doubleClick
インタフェース内 IClickable
public void doubleClick(int button)
IClickable
doubleClick
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void doubleClick(int button, Point pos)
IClickable
doubleClick
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- クリックする座標(オブジェクトに相対)public void doubleClick(int button, Point pos, ModifierKey modifiers)
IClickable
doubleClick
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- クリックする座標(オブジェクトに相対)modifiers
- 修飾キーpublic void mouseMove()
IClickable
mouseMove
インタフェース内 IClickable
public void mouseMove(Point pos)
IClickable
mouseMove
インタフェース内 IClickable
pos
- 新しいロケーションの座標(ウィンドウに相対)public void pressMouse()
IClickable
pressMouse
インタフェース内 IClickable
public void pressMouse(int button)
IClickable
pressMouse
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void pressMouse(int button, Point pos)
IClickable
pressMouse
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- マウスを押下する座標(オブジェクトに相対)public void pressMouse(int button, Point pos, ModifierKey modifiers)
IClickable
pressMouse
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- マウスを押下する座標(オブジェクトに相対)modifiers
- 修飾キーpublic void releaseMouse()
IClickable
releaseMouse
インタフェース内 IClickable
public void releaseMouse(int button)
IClickable
releaseMouse
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void releaseMouse(int button, Point pos)
IClickable
releaseMouse
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- マウスを離す座標(オブジェクトに相対)public void releaseMouse(int button, Point pos, ModifierKey modifiers)
IClickable
releaseMouse
インタフェース内 IClickable
button
- 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos
- マウスを離す座標(オブジェクトに相対)modifiers
- 修飾キーpublic void pressKeys(String keys)
IKeyable
有効なキーストロークは次のとおりです。
public void pressKeys(String keys, boolean ensureFocus)
IKeyable
有効なキーストロークは次のとおりです。
public void releaseKeys(String keys)
IKeyable
有効なキーストロークは次のとおりです。
releaseKeys
インタフェース内 IKeyable
keys
- 離すキー、またはマウス ボタンpublic void releaseKeys(String keys, boolean ensureFocus)
IKeyable
有効なキーストロークは次のとおりです。
releaseKeys
インタフェース内 IKeyable
keys
- 離すキー、またはマウス ボタンensureFocus
- コントロールが実際にキーボード フォーカスを持つことを保証するかどうかを決定します。 デフォルトは true
です。public void typeKeys(String keys)
IKeyable
有効なキーストロークは次のとおりです。
使用例たとえば、現在選択されているテキストを Ctrl+C を押してクリップボードにコピーするコードは次のようになります。
window.typeKeys ("<Left Ctrl+C>");
public void typeKeys(String keys, int delay)
IKeyable
有効なキーストロークは次のとおりです。
使用例たとえば、現在選択されているテキストを Ctrl+C を押してクリップボードにコピーするコードは次のようになります。
window.typeKeys ("<Left Ctrl+C>");
public void typeKeys(String keys, int delay, boolean ensureFocus)
IKeyable
有効なキーストロークは次のとおりです。
使用例たとえば、現在選択されているテキストを Ctrl+C を押してクリップボードにコピーするコードは次のようになります。
window.typeKeys ("<Left Ctrl+C>");
public void typePasswordKeys(String keys)
IKeyable
オブジェクトが SetText メソッドをサポートする場合、暗号化されたパスワードを入力する前に、既存のテキストはクリアされます。
使用例
使用例
たとえば、文字列を暗号化し、コンソールに出力する場合は、次のコードを使用できます。
String encryptedPassword = desktop.encrypt("my password"); System.out.println(encryptedPassword);
そして、コンソールから暗号化したパスワード (この場合は、6Fk+Bcm+GoXe3X0=
) をコピーし、次のように使用できます。
textField.typePasswordKeys("6Fk+Bcm+GoXe3X0=");
typePasswordKeys
インタフェース内 IKeyable
keys
- 暗号化されたパスワードpublic void typePasswordKeys(String keys, int delay)
IKeyable
オブジェクトが SetText メソッドをサポートする場合、暗号化されたパスワードを入力する前に、既存のテキストはクリアされます。
使用例
使用例
たとえば、文字列を暗号化し、コンソールに出力する場合は、次のコードを使用できます。
String encryptedPassword = desktop.encrypt("my password"); System.out.println(encryptedPassword);
そして、コンソールから暗号化したパスワード (この場合は、6Fk+Bcm+GoXe3X0=
) をコピーし、次のように使用できます。
textField.typePasswordKeys("6Fk+Bcm+GoXe3X0=");
typePasswordKeys
インタフェース内 IKeyable
keys
- 暗号化されたパスワードdelay
- キーストローク間の遅延(ミリ秒)public void typePasswordKeys(String keys, int delay, boolean ensureFocus)
IKeyable
オブジェクトが SetText メソッドをサポートする場合、暗号化されたパスワードを入力する前に、既存のテキストはクリアされます。
使用例
使用例
たとえば、文字列を暗号化し、コンソールに出力する場合は、次のコードを使用できます。
String encryptedPassword = desktop.encrypt("my password"); System.out.println(encryptedPassword);
そして、コンソールから暗号化したパスワード (この場合は、6Fk+Bcm+GoXe3X0=
) をコピーし、次のように使用できます。
textField.typePasswordKeys("6Fk+Bcm+GoXe3X0=");
typePasswordKeys
インタフェース内 IKeyable
keys
- 暗号化されたパスワードdelay
- キーストローク間の遅延(ミリ秒)ensureFocus
- コントロールが実際にキーボード フォーカスを持つことを保証するかどうかを決定します。 デフォルトは true
です。Copyright 2009-2012 Micro Focus. All Rights Reserved.