Collapse all Symbian^3 Application Developer Library

MAlfControlGroupOrderChangedObserver Class Reference

class MAlfControlGroupOrderChangedObserver

Observer class that can be used to notify users about changes in the relative order of control groups in the roster.

The NotifyControlGroupOrderChanged() method will be called when control groups are shown or hidden and as a result the relative order the control groups are in is modified. The notification is also called when the first control group is shown or when the last control group is hidden.

It is on the user's responsibility to remove the callback object from the CAlfRoster objects it has been added into before destroying the callback object. Usage:

        // Create a control group.
  CAlfControlGroup& group = iEnv->NewControlGroupL( KPrimaryGroup );

  // Add a control to the group.
  AnchorControl* hello = AnchorControl::ConstructL(*iEnv);
  group.AppendL(*hello);
 
  // Show the control group on the display.
 display.Roster().ShowL(group);

CAlfRoster::AddControlGroupOrderChangedObserverL() CAlfRoster::RemoveControlGroupOrderChangedObserver()alfclient.lib

Since: S60 v5.0

Public Member Functions
void	NotifyControlGroupOrderChanged ()

Member Functions Documentation

NotifyControlGroupOrderChanged()

void

NotifyControlGroupOrderChanged

(

)

[pure virtual]

Callback method that is called whenever relative order of the control groups is modified. This is a result of calls to CAlfRoster::ShowL() or CAlfRoster::Hide(). Notification is called after relative order of control groups has changed. User can analyze the observed CAlfRoster object for more information about the changes. This observer has to be registered to a CAlfRoster object to acquire notifications through this method.