使用上の注意
アプリケーションがこのクラスを使用する PS 更新の通知を受けるには、 次に示すステップを実行しなければなりません。
- ECLPSListener から派生したクラスを定義します。
- ECLPSListener から派生したクラスのすべてのメソッドを実装します。
- 派生クラスのインスタンスを作成します。
- そのインスタンスを ECLPS::RegisterPSEvent() メソッドで登録します。
登録が完了した後で、表示スペースの更新によって ECLPSListener から 派生したクラスの NotifyEvent() メソッドが呼び出されます。その結果アプリケーションは、メソッド呼び出しでシステムに提供された ECLPSEvent オブジェクト を使用して、PS 更新の原因および影響された画面の領域を判別することができます。
短時間に発生する複数の PS の更新は、単一のイベント通知に集約される ことがあるので注意してください。
アプリケーションは、派生したクラス用に自身のコンストラクター およびデストラクターを任意で提供することができます。これが便利なのは、 アプリケーションが特定のインスタンス固有データをそのクラス内に保管してから、 その情報をコンストラクター上のパラメーターとして渡す必要がある場合です。
イベントの登録時にエラーが検出された場合、ECLErr オブジェクトを 使用して NotifyError() メンバー関数が呼び出されます。エラーの後で、続いて イベントが生成されることも、生成されないこともあります。イベント生成が終了した とき (エラーか、あるいはその他の理由から) には、NotifyStop() メンバー関数が 呼び出されます。