Puts a popup on the control stack with the specified priority and flags. If the popup (or its ultimate parent if it's a sub-popup) are not the highest priority popup, the control stack flags ECoeStackFlagRefusesAllKeys and ECoeStackFlagRefusesFocus will be added in. This makes the popup behave like a sleeping dialog while in the background. For correct behavior, the priority and flag parameters should be set as if the popup were in the foreground. This function analogous to CCoeAppUi::AddToStackL , and should be used in place of that for controls which may be used as global popups. When global popups are not enabled, this function forwards the call to CCoeAppUi::AddToStackL . It is still the responsibility of the calling code to remove popups from the control stack using CCoeAppUi::RemoveFromStack .

Adds a sub-popup to a parent popup. For instance a softkey control could be added to a global note popup window. The sub-popup's window and control stack positions will be changed as its parent's positions are changed. A popup may have at most one sub-popup and one parent popup.

Set whether global popups are to be shown or not. If global popups are not allowed, the app's window group will be pushed to the background. Callers will need SwEvent

Enables the Popup Priority Controller in this app. Before this function is called, all other functions in this API have no effect. It is safe to use the other APIs in all apps. They will only have effect where the system is enabled.

This allows the global priority controller to control fade such that the top global popup is unfaded, and all other windows are faded. This function is analogous to TAknPopupFader::FadeBehindPopup . When global popups are not enabled, this function forwards the call to TAknPopupFader::FadeBehindPopup .

Return whether global popups are to be shown or not.

Removes a popup from the set of shown popups and forgets the popup parameters. When a popup is set with any of the other APIs in this class, this function must be called when the popup is deleted. The common popup classes CEikDialog , CAknChoiceList, and CAknPopupList all call this from their destructors, in case their clients set a priority for them.

Modifies the control stack flags as appropriate for a sleeping popup. This function is analogous to CEikonEnv::RouseSleepingDialog . When global popups are not enabled, this function forwards the call to CEikonEnv::RouseSleepingDialog .

Sets the priority for a popup control. The priority affects two things, how the popup is displayed in relation to other popups and how the app is displayed in relation to other apps. Popups with higher priority will have their windows placed before popups with lower priority. The app's window group priority will be affected by the highest priority popup shown. If a popup does not have a priority set, it is automatically given the default value of 0. Low priority popups should be given negative priority values. High priority popups should be given positive priority values.

Sets the ordinal position for the Eikon environment's root window group, that will be used when a popup is shown.

Sets whether a popup is shown or not, which can affect the popup's window priority, the app's window group priority, the control stack and the fade stack. When a popup is shown, it is added to a list of shown popups and its window priority is set according to the position in this list. If the highest priority popup changes, the window group priority for the app is changed according to the new highest priority popup. The highest priority popup will also be activated on the control stack and placed at the top of the fade stack.