すべてのパッケージ  クラス階層  このパッケージ  前へ  次へ  索引

クラス com.ibm.eNetwork.ECL.ECLScreenReco

java.lang.Object
   |
   +----com.ibm.eNetwork.ECL.ECLScreenReco

public class ECLScreenReco
extends Object
ECLScreenReco オブジェクトは、画面認識システムのエンジンです。これには、画面の記述を追加したり除去したりするためのメソッドが含まれています。また、それらの画面を認識したり、画面用のハンドラー・コードに非同期にコールバックしたりするための論理も含まれています。

ECLScreenReco クラスのオブジェクトは、固有の「認識セット」として考えてください。オブジェクトは、画面を監視する複数の ECLPS オブジェクト、検索する複数の画面、および任意の ECLPS オブジェクトの中に画面を表示するときに呼び出す複数のコールバック・ポイントを持つことができます。

ユーザーはアプリケーションの開始時に ECLScreenReco オブジェクトを設定するだけでよく、モニターしたい画面が ECLPS に現れるときに、使用するコードが ECLScreenReco によって呼び出されます。

ECLScreenReco は、ECLScreenDesc オブジェクト (ECLScreenDescriptor から派生したオブジェクトを含む) の認識、または ECLPS オブジェクトにあるデータとの突き合わせを行うために、次のような論理を使用します。

  1. ECLScreenReco オブジェクトに登録された ECLScreenDesc オブジェクトに含まれている ECLScreenDescriptor から派生したオブジェクトのうち、オプションでないものはすべて渡されなければなりません。
  2. オプションでないディスクリプターがない場合、一致するオプションのディスクリプターが最低でも 1 つはなければなりません。

以下に示すのは、ECLScreenReco と ECLScreenDesc で共通に使用するコード・フラグメントです。

    // Set up a screen description object. In this example, the
    // screen is identified by a cursor position, a key word, and
    // the number of fields.
    myScreenDesc = new ECLScreenDesc();
    myScreenDesc.AddCursorPos(23,1);
    myScreenDesc.AddString("LOGON");
    myScreenDesc.AddNumFields(15);
 

// Set up screen reco object myScreenReco = new ECLScreenReco(); // myECLPS is an instance of ECLPS obtained from an instance of ECLSession myScreenReco.AddPS(myECLPS); // myCallback is a class that implements ECLRecoNotify. // myCallback will be notified if the screen defined by our // screen description object is recognized. myScreenReco.RegisterScreen(myScreenDesc, myCallback);


コンストラクター索引

 o ECLScreenReco()
ECLScreenReco のインスタンスを作成します。
 o ECLScreenReco(boolean)
最初にモニターをオフまたはオンにして ECLScreenReco のインスタンスを作成します。

メソッド索引

 o AddECLRecoDebugListener(ECLRecoDebugListener)
指定の ECLRecoDebugListener をリスナーのリストに追加します。
 o AddPS(ECLPS)
ECLPS オブジェクト (表示スペース) を画面認識システムに追加します。
 o AddPS(ECLPS, int)
ECLPS オブジェクト (表示スペース) を画面認識システムに追加します。
 o dispose()
オブジェクトの内部環境をクリーンアップします。
 o DoReco()
現在登録されているすべての画面の認識分析を実行します。
 o IsActive()
ECLScreenReco モニター・プロセスの状態を戻します。
 o IsMatch(ECLPS, ECLScreenDesc)
PS で画面を比較します。
 o RegisterScreen(ECLScreenDesc, ECLRecoNotify)
ECLScreenDesc オブジェクトを画面認識システムに登録します。
 o RegisterScreen(ECLScreenDesc, ECLRecoNotify, boolean)
ECLScreenDesc オブジェクトを画面認識システムに登録します。
 o RemoveECLRecoDebugListener(ECLRecoDebugListener)
指定の ECLRecoDebugListener をリスナーのリストから除去します。
 o RemovePS(ECLPS)
ECLPS オブジェクト (表示スペース) を画面認識システムから除去します。
 o SetActive(boolean)
ECLScreenReco モニター・プロセスを開始または停止します。
 o UnregisterAllScreens()
登録したすべての画面を画面認識オブジェクトから除去します。
 o UnregisterScreen(ECLScreenDesc, ECLRecoNotify)
ECLScreenDesc オブジェクトとそれに対応する ECLRecoNotify オブジェクトを画面認識システムから除去します。

コンストラクター

 o ECLScreenReco
 public ECLScreenReco()
ECLScreenReco のインスタンスを作成します。

 o ECLScreenReco
 public ECLScreenReco(boolean active)
最初にモニターをオフまたはオンにして ECLScreenReco のインスタンスを作成します。

パラメーター :
active - false の場合、ECLScreenReco は ECLScreenReco.SetActive が呼び出されるまでモニターを開始しません。 true の場合、ECLScreenReco.RegisterScreen を最初に呼び出した時点でモニターが始まります。

メソッド

 o dispose
 public void dispose()
オブジェクトの内部環境をクリーンアップします。

 o RegisterScreen
 public void RegisterScreen(ECLScreenDesc sd,
                            ECLRecoNotify notify)
ECLScreenDesc オブジェクトを画面認識システムに登録します。システムが画面を認識すると、指定された通知オブジェクトで NotifyEvent メソッドを呼び出します。通知オブジェクトは、ユーザーが定義した ECLRecoNotify 派生クラスのオブジェクトです。これには、認識イベントのためのハンドラーまたは「コールバック」コードが含まれています。使用する画面処理コードも含まれています。

パラメーター :
sd - 登録する ECLScreenDesc オブジェクト。
notify - ユーザーが定義する ECLRecoNotify オブジェクト。
関連項目:
ECLRecoNotifyECLScreenDesc
 o RegisterScreen
 public void RegisterScreen(ECLScreenDesc sd,
                            ECLRecoNotify notify,
                            boolean initEvent)
ECLScreenDesc オブジェクトを画面認識システムに登録します。システムが画面を認識すると、指定された通知オブジェクトで NotifyEvent メソッドを呼び出します。通知オブジェクトは、ユーザーが定義した ECLRecoNotify 派生クラスのオブジェクトです。これには、認識イベントのためのハンドラーまたは「コールバック」コードが含まれています。使用する画面処理コードも含まれています。

パラメーター :
sd - 登録する ECLScreenDesc オブジェクト。
notify - ユーザーが定義する ECLRecoNotify オブジェクト。
initEvent - true の場合、登録された画面の比較論理が実行されます。
関連項目:
ECLRecoNotifyECLScreenDesc
 o UnregisterScreen
 public void UnregisterScreen(ECLScreenDesc sd,
                              ECLRecoNotify notify)
ECLScreenDesc オブジェクトとそれに対応する ECLRecoNotify オブジェクトを画面認識システムから除去します。このメソッドを呼び出すと、画面認識システムの ECLRecoNotify から派生したすべてのオブジェクトに対して NotifyStop メソッドが呼び出されます。

パラメーター :
sd - 登録を解除する ECLScreenDesc オブジェクト。
notify - 登録を解除する ECLRecoNotify オブジェクト。
関連項目:
ECLScreenDesc
 o AddPS
 public void AddPS(ECLPS ps)
ECLPS オブジェクト (表示スペース) を画面認識システムに追加します。 システムは、追加されたすべての ECLPS オブジェクトをモニターして、追加されたすべての ECLScreenDesc オブジェクトを調べます。

パラメーター :
ps - 追加する ECLPS オブジェクト。
関連項目:
ECLPS
 o AddPS
 public void AddPS(ECLPS ps,
                   int eventType)
ECLPS オブジェクト (表示スペース) を画面認識システムに追加します。システムは、追加されたすべての ECLPS オブジェクトをモニターし、指定されたイベント・タイプの有無を調べます。

パラメーター :
ps - 追加する ECLPS オブジェクト。
eventType - ECLPS オブジェクトのモニター・タイプ。 ECLPS.HOST_EVENTS を指定した場合、認識イベントはホストの画面変更によってのみ起動されます。 ECLPS.USER_EVENTS を指定した場合、認識イベントはユーザー・イベント (タイプ入力、マウス・アクティビティー、その他) によってのみ起動されます。 ECLPS.ALL_EVENTS を指定した場合、認識イベントは、ユーザーが開始した画面変更とホストが開始した画面変更の両方によって起動されます。
関連項目:
ECLPS
 o RemovePS
 public void RemovePS(ECLPS ps)
ECLPS オブジェクト (表示スペース) を画面認識システムから除去します。

パラメーター :
ps - 除去する ECLPS オブジェクト。
関連項目:
ECLPS
 o AddECLRecoDebugListener
 public void AddECLRecoDebugListener(ECLRecoDebugListener listener)
指定の ECLRecoDebugListener をリスナーのリストに追加します。

パラメーター :
listener - 追加する ECLRecoDebugListener
関連項目:
removeECLRecoDebugListener
 o RemoveECLRecoDebugListener
 public void RemoveECLRecoDebugListener(ECLRecoDebugListener listener)
指定の ECLRecoDebugListener をリスナーのリストから除去します。

パラメーター :
listener - 除去する ECLRecoDebugListener
関連項目:
addECLRecoDebugListener
 o SetActive
 public void SetActive(boolean active)
ECLScreenReco モニター・プロセスを開始または停止します。

パラメーター :
active - false の場合、ECLScreenReco は ECLScreenReco.SetActive が呼び出されるまでモニターを開始しません。 true の場合、ECLScreenReco.RegisterScreen を最初に呼び出した時点でモニターが始まります。
 o IsActive
 public boolean IsActive()
ECLScreenReco モニター・プロセスの状態を戻します。

戻り値 :
モニター・プロセスの状態
 o DoReco
 public void DoReco()
現在登録されているすべての画面の認識分析を実行します。これは、分析の最中に呼び出し元のコードが停止するのを避けるため、別々のスレッドで実行されます。

 o UnregisterAllScreens
 public void UnregisterAllScreens()
登録したすべての画面を画面認識オブジェクトから除去します。

 o IsMatch
 public static boolean IsMatch(ECLPS ps,
                               ECLScreenDesc sd) throws ECLErr
PS で画面を比較します。 AddString、SetCursor などで設定された行または桁パラメーターが PS の境界を超えている場合は、このメソッドが false を戻します。

パラメーター :
ps - 画面記述と比較する表示スペース・オブジェクト。
sd - 画面を定義する画面記述オブジェクト。
戻り値 :
PS 内の画面と一致する場合は true、そうでない場合は false。
Throws : ECLErr
ECLScreenReco を PS と比較してエラーがあれば throw されます。
関連項目:
ECLScreenDescECLPS

すべてのパッケージ  クラス階層  このパッケージ  前へ  次へ  索引