Constructor, not exported because used via CAppMngr2AppInfo and CAppMngr2PackageInfo

Cancels the current asynchronous command.

This method may be called at any time when an asynchronous command is started using HandleCommandL() method. It must cancel the running command as quickly as possible.

Details (size) of this item.

Items are displayed in a list in the UI. The list uses two labels (name and details) for each item. Descriptor that the Details() method returns is displayed as the second label (the 2nd line of the item).

Plug-ins can use SizeStringWithUnitsL() method to create details string to display the item size in UI.

Optional specific menu items for this item.

If the item supports specific menu commands, return the menu pane data. Plug-in can use ReadMenuItemDataFromResourceL() method to read menu pane data from resources. Menu commands are run via HandleCommandL() method.

The caller of this method is responsible to delete the returned CEikMenuPaneItem::SData data structs.

Default implementation is empty.

Optional specific middle softkey command for this item.

If the item supports specific middle softkey command, return TBUF resource id (for the command label) and command id. Item specific command is run via HandleCommandL() method when user presses the middle softkey.

Default middle softkey command is used, if plug-in does not override it.

Starts asynchronously a user invoked command.

The command can be a generic one or specific to the plug-in. The ids for the generic commands are defined in AppMngr2Common.hrh (see the enumeration TAppMngr2GenericCommand). The plug-in specific commands are defined via GetMenuItemsL() and GetMiddleSoftkeyCommandL() methods.

The caller of this method must call HandleCommandResultL() after the asynchronous request has been completed.

This asynchronous request must be completed properly using the method User::RequestComplete() even if the command itself has been implemented in synchronous manner.

Handles the completion result of an asynchronous command.

This method is provided so that the plug-in may decide upon handling possible errors encountered during the command processing (note that the completion status is received directly by the caller of the method HandleCommandL() and not by this plug-in). These actions may include for example closing open sessions and deleting objects.

This function should leave if an error note should be displayed in the UI (e.g. KErrNoMemory). Note that the result may be KErrCancel or SwiUI::KSWInstErrUserCancel if the user cancelled the operation.

Icon index of this item (installed application or installation package).

Items are displayed in a list in the UI. Each item has an icon image, two labels (name and details) and an optional small indicator icon. IconIndex() method provides index for the icon image.

If item has a specific icon that no other items use, return value EAppMngr2UseSpecificIcon and load the specific icon via SpecificIconL() .

There are no default icons, each plug-in must provide implementation for IconIndex() method.

Indicator icon index of this item.

Default implementation returns the default icon indexes based on the value of iLocation member variable, so plug-ins usually does not need to override this method.

If EAppMngr2UseSpecificIcon value is returned, SpecificIndicatorIconL() method is called to get the indicator icon.

ShowOnTop highlight status of this item.

Returns ETrue if this item should be highlighted (e.g. displayed separately on top of other items in installation files/installed applications list). All items are displayed in alphabetical order. If ShowOnTop flag is set, then the item is displayed before other items (or in completely separate list of highligted items). All separately displayed items are listed in alphabetical order too.

Returns the location of installation file or installed application.

Remote drives are not supported. Derived class must fill in the iLocation member variable to provide data for this function.

Returns the drive where installation file is located, or where installed application is installed.

Derived class must fill in the iLocationDrive member variable to provide data for this function.

Name of this item.

Items are displayed in a list in the UI. The list uses two labels (name and details) for each item. Descriptor that the Name() method returns is displayed as the first label (the 1st line of the item).

Utility function to construct CEikMenuPaneItem from MENU_ITEM resource.

Reference to the CAppMngr2Runtime object of this plugin.

Utility function to create displayable string that contains size followed by kilobyte (kB), megabyte (MB) or gigabyte (GB) units.

Size is rounded and formatted using the relevant unit, for example SizeStringWithUnitsL( 5120 ) returns "5 kB".

The caller of this method is responsible to delete the returned string.

Optional specific icon for this item.

Returns new icon specific for the item. Note that this method is not used unless IconIndex() method returns EAppMngr2UseSpecificIcon value.

The caller of this method is responsible to delete the returned icon object.

Default implementation leaves with KErrNotSupported. Plug-in must override it if IconIndex() returns EAppMngr2UseSpecificIcon value.

If the same icon bitmap is used in many items, it is more efficient to load it once in CAppMngr2Runtime::LoadIconsL() and return icon indexes form IconIndex() method.

Optional specific indicator icon for this item.

Returns new indicator icon specific for the item. Note that this method is not used unless IndicatorIconIndex() method returns special EAppMngr2UseSpecificIcon value.

The caller of this method is responsible to delete the returned icon object.

Default implementation leaves with KErrNotSupported. Plug-in must override it if IndicatorIconIndex() returns EAppMngr2UseSpecificIcon.

If the same icon bitmap is used in many items, it is more efficient to load it once in CAppMngr2Runtime::LoadIconsL() and return icon indexes form IconIndex() method.

Enable generic menu commands for this item.

Generic menu commands are defined in TAppMngr2GenericCommands enum in AppMngr2Common.hrh. Generic commands are hidden from the menu if the currently selected item does not support them. Return ETrue for those command ids that are supported by this item. Generic commands are run via HandleCommandL() method.

File server session, provided by framework when item is created.

Location of this item.

Default implementation of IndicatorIconIndex() function uses this value to return the default indicator icon index. See also the Location() function defined above.

Drive of this item.

Location drive defines the drive where this item resides (either installation package is stored, or application is installed). CAppMngr2InfoIterator uses this value to display the drive in "Details" dialog. See also the LocationDrive() function defined above.

Reference to CAppMngr2Runtime class for this item. See also the Runtime() function defined above.

ShowOnTop (highlight) flag.

If ShowOnTop flag is ETrue, the item is highlighted in UI. It may be displayed on top of other items in installed application or installation files list, or it may be displayed in separate list of highlighted items.

For example, new or untrusted installed applications can be highlighted. When set, the item needs to show the reason why iShowOnTop is enabled (e.g. by using "new" or "untrusted" icon). See also the IsShowOnTop() function defined above.