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, waitForPropertyequals, 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, setPropertypublic 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.exemyApplica?ion.exemyApp*.exetechdomains - アプリケーションで読み込まれるテクノロジ ドメイン。 テクノロジ ドメインの定数は、
TechDomain で定義されています。
public void attach(String executablePattern, String commandLinePattern, TechDomain... techdomains)
*org.MyMainClass など)。
メモattach(String, String) を使用して自動的にテクノロジ ドメインを読み込むことを推奨します。 選択してテクノロジ ドメインを読み込むのは、特定の状況でのみ必要とされる上級テクニックです。
executablePattern - アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*'
を使用できます (それぞれ、1 文字、または複数文字に一致)。 例: javaw.exejava*.execommandLinePattern - このパターンはアプリケーションのコマンド ライン引数に対して照合します。 これは、アプリケーションの
複数のインスタンスが実行中で、その中のいくつかだけがテスト対象である場合に有効です(たとえば、javaw.exe)。Java アプリケーションの場合、
特徴的な jar や main クラスの名前をコマンド ライン パターンに含めることができます。例:
*org.MyMainClasstechdomains - アプリケーションで読み込まれるテクノロジ ドメイン。 テクノロジ ドメインの定数は、
TechDomain で定義されています。public void attach(String executablePattern)
executablePattern - アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*'
を使用できます (それぞれ、1 文字、または複数文字に一致)。 例: myApplication.exemyApplica?ion.exemyApp*.exepublic void attach(String executablePattern, String commandLinePattern)
*org.MyMainClass など)。executablePattern - アプリケーションの実行可能名。 パターンには、ワイルドカード '?' および '*'
を使用できます (それぞれ、1 文字、または複数文字に一致)。 例: javaw.exejava*.execommandLinePattern - このパターンはアプリケーションのコマンド ライン引数に対して照合します。
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()
AbstractTestObjectgetDesktop クラス内 AbstractTestObjectpublic String toString()
AbstractTestObjecttoString クラス内 AbstractTestObjectpublic 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 インタフェース内 IClickablepublic void click(int button)
IClickable使用例
たとえば、コントロール内のある位置をクリックする場合は、次のように入力します。
control.click (MouseButton.LEFT, new Point(244, 16));
次の例では、コントロールの中央でマウスの左ボタンがクリックされます。
control.click ();
click インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void click(int button,
Point pos)
IClickable使用例
たとえば、コントロール内のある位置をクリックする場合は、次のように入力します。
control.click (MouseButton.LEFT, new Point(244, 16));
次の例では、コントロールの中央でマウスの左ボタンがクリックされます。
control.click ();
click インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、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 インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos - クリックする座標(オブジェクトに相対)modifiers - 修飾キーpublic void doubleClick()
IClickabledoubleClick インタフェース内 IClickablepublic void doubleClick(int button)
IClickabledoubleClick インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void doubleClick(int button,
Point pos)
IClickabledoubleClick インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos - クリックする座標(オブジェクトに相対)public void doubleClick(int button,
Point pos,
ModifierKey modifiers)
IClickabledoubleClick インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos - クリックする座標(オブジェクトに相対)modifiers - 修飾キーpublic void mouseMove()
IClickablemouseMove インタフェース内 IClickablepublic void mouseMove(Point pos)
IClickablemouseMove インタフェース内 IClickablepos - 新しいロケーションの座標(ウィンドウに相対)public void pressMouse()
IClickablepressMouse インタフェース内 IClickablepublic void pressMouse(int button)
IClickablepressMouse インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void pressMouse(int button,
Point pos)
IClickablepressMouse インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos - マウスを押下する座標(オブジェクトに相対)public void pressMouse(int button,
Point pos,
ModifierKey modifiers)
IClickablepressMouse インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos - マウスを押下する座標(オブジェクトに相対)modifiers - 修飾キーpublic void releaseMouse()
IClickablereleaseMouse インタフェース内 IClickablepublic void releaseMouse(int button)
IClickablereleaseMouse インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。public void releaseMouse(int button,
Point pos)
IClickablereleaseMouse インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、1=左、2=右、3=中央,.. になります。pos - マウスを離す座標(オブジェクトに相対)public void releaseMouse(int button,
Point pos,
ModifierKey modifiers)
IClickablereleaseMouse インタフェース内 IClickablebutton - 押下するマウス ボタン。 値は、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 インタフェース内 IKeyablekeys - 離すキー、またはマウス ボタンpublic void releaseKeys(String keys, boolean ensureFocus)
IKeyable有効なキーストロークは次のとおりです。
releaseKeys インタフェース内 IKeyablekeys - 離すキー、またはマウス ボタン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 インタフェース内 IKeyablekeys - 暗号化されたパスワード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 インタフェース内 IKeyablekeys - 暗号化されたパスワード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 インタフェース内 IKeyablekeys - 暗号化されたパスワードdelay - キーストローク間の遅延(ミリ秒)ensureFocus - コントロールが実際にキーボード フォーカスを持つことを保証するかどうかを決定します。 デフォルトは true です。Copyright 2009-2012 Micro Focus. All Rights Reserved.