使用注意事项

要使用此类获得 PS 更新通知，应用程序必须执行以下步骤：

  1. 定义从 ECLPSNotify 派生的类。
  2. 实现 ECLPSNotify 派生类的 NotifyEvent 方法。
  3. （可选）实现 ECLPSNotify 的其他成员函数。
  4. 创建派生类的实例。
  5. 使用 ECLPS::RegisterPSEvent() 方法注册实例。

注册完成后，对表示空间的更新将导致调用 ECLPSNotify 派生类的 NotifyEvent() 方法。

请注意，短时间内发生的多次 PS 更新可能会聚合到单个事件通知中。

应用程序可以选择为派生类提供自己的构造函数和析构函数。如果应用程序需要在类中存储某些特定于实例的数据，并将该信息作为参数传递到构造函数上，则此选项非常有用。

如果在事件注册过程中检测到错误，则使用 ECLErr 对象调用 NotifyError() 成员函数。发生错误后，可能会继续生成事件，也可能不会继续生成。当事件生成终止（由于错误或其他原因）时，调用 NotifyStop() 成员函数。NotifyError() 的缺省实现将向用户显示一个消息框，其中显示从 ECLErr 对象检索到的错误消息文本。

当事件通知出于任何原因（错误或调用 ECLPS::UnregisterPSEvent）停止时，将调用 NotifyStop() 成员函数。NotifyStop() 的缺省实现不执行任何操作。