|
|
|
Location:
QUiConfigClient.h
class MQUiConfigChangedObserver;
The Ui config observer is notified about Ui config changes. Depending on the type of observer the appropriate TNotificationPreference should be used. Servers that never goes to foreground must use EAlways while applications should use ESendDelayedNotificationsWhenGainingForeground for most cases. The TNotificationPreference can be set on each observer individually as well.
CQikViewBase implements this interface by default and adds itself as an ESendDelayedNotificationsWhenGainingForeground oserver. It is possible to change this by setting the views observer notification preference. Views should only use the EAlways preference very good reasons since it will have a high impact on the performance.
Observers will get the ui config change notification immediately if the application is in foreground or if they use the EAlways preference. If not the observers will received a delayed notification when the application is activated if the ui config is different from when it was last active.
If this function leaves the error will be ignored to allow the notificaiton schedule to complete. In the case of a QikView leaving, a delayed notification will be queued to enable the view to be updated when it is next activated again.
Note that it is very important that all implementations of this interface returns immediately, if the notification schedule is not allowed to complete the config client may fail to unlock the screen device which can cause the UI to be hidded for the foreground application.
Defined in MQUiConfigChangedObserver:
HandleUiConfigChangedL()
TNotificationPreferenceSetClientNotificationPreference(TNotificationPreference aPref, const MQUiConfigChangedObserver* aObserver);virtual void HandleUiConfigChangedL()=0;
Called when the client is notified about a ui config change.