#include <remcondatabaseawaremedialibrarybrowseobserver.h>
| class MRemConDatabaseAwareMediaLibraryBrowseObserver |
| Public Member Functions | |
|---|---|
| pure virtual void | MrcdamlboFolderDown(const TRemConItemUid &, TUint16) |
| pure virtual void | MrcdamlboFolderUp(TUint16) |
| pure virtual void | MrcdamlboGetFolderListing(TRemConFolderScope, TUint, TUint) |
| pure virtual TInt | MrcdamlboGetItem(TRemConFolderScope, const TRemConItemUid &, TMediaAttributeIter &, TUint16) |
| pure virtual void | MrcdamlboGetPath(RPointerArray< HBufC8 > &) |
| pure virtual void | MrcdamlboSearch(const TDesC8 &) |
| void | MrcdamlboFolderDown | ( | const TRemConItemUid & | aFolder, |
| TUint16 | aMediaLibraryStateCookie | |||
| ) | [pure virtual] | |||
This requests that the current position within the folder hierarchy is moved to the child folder of the current folder specified by aFolder.
The result of this operation must be returned via a call to MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbFolderDownResult.
| Parameters | |
|---|---|
| aFolder | The child folder to change into. |
| aMediaLibraryStateCookie | The cookie which the remote device believes refers to the current state of the media library. If this does not match the current state according to the client then the client should call MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbFolderDownResult() with the error KErrInvalidMediaLibraryStateCookie. |
| void | MrcdamlboFolderUp | ( | TUint16 | aMediaLibraryStateCookie | ) | [pure virtual] |
This requests that the current position within the folder heirarchy is moved to the next folder up.
The result of this operation must be returned via a call to MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbFolderUpResult.
| Parameters | |
|---|---|
| aMediaLibraryStateCookie | The cookie which the remote device believes refers to the current state of the media library. If this does not match the current state according to the client then the client should call MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbFolderUpResult with the error KErrInvalidMediaLibraryStateCookie. |
| void | MrcdamlboGetFolderListing | ( | TRemConFolderScope | aScope, |
| TUint | aStartItem, | |||
| TUint | aEndItem | |||
| ) | [pure virtual] | |||
This requests a list of the items present in a folder. No metadata is requested, that can be retrieved separately on a per item basis.
The result should be returned via a call to MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbFolderListing(). And the ordering should be as shown locally, but should list folders before media element items.
| Parameters | |
|---|---|
| aScope | The scope in which the folder listing is made. This indicates which listing should be returned. If the scope is EBrowseFolder then the contents of the current browsed folder should be returned. If it is the ESearchResultFolder scope then the contents of the folder populated by the last search should be returned. |
| aStartItem | The offset into the folder listing of the first item to retrieve. If there is no media available at this offset the error KErrMediaBrowseInvalidOffset should be returned via the result call to MrcdamlbFolderListing(). |
| aEndItem | The offset into the folder listing of the final item to retrieve. If this is beyond the end of the folder listing then the items from the aStartItem offset to the end of the listing should be returned via the result call to MrcdamlbFolderListing(). |
| TInt | MrcdamlboGetItem | ( | TRemConFolderScope | aScope, |
| const TRemConItemUid & | aItemId, | |||
| TMediaAttributeIter & | aIter, | |||
| TUint16 | aMediaLibraryStateCookie | |||
| ) | [pure virtual] | |||
Requests a specific item which may be a folder item or a media element item.
If it returns KErrNone the client must return the metadata for the requested item through the response function either MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbFolderItemResult() or MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbMediaElementItemResult() according to the item type which is a folder item or media element item. If it is unable to process this call then it can return error but not call the response function.
| Parameters | |
|---|---|
| aScope | The scope in which the item is present. If the scope is EBrowseFolder then the item is present in the media library's virtual filesystem. If it is the ESearchResultFolder scope then the item is present in the current set of search results. |
| aItemId | The UID for the requested Item. |
| aIter | An iterator for TMediaAttributeIds containing a list of TMediaAttributeIds requested by the controller. It is intended for the media element item, so omit it if the item is a folder item. |
| aMediaLibraryStateCookie | The cookie which the remote device believes refers to the current state of the media library. If this does not match the current state according to the client then the client shall call MrcdamlbFolderItemResult() or MrcdamlbMediaElementItemResult() to return the error KErrInvalidMediaLibraryStateCookie according it is a folder item or a media element item. |
| void | MrcdamlboGetPath | ( | RPointerArray< HBufC8 > & | aPath | ) | [pure virtual] |
This requests the current path.
The client is responsible for appending items to the array then call MrcdamlbGetPathResult() when completed. Once the item is appended in the array the ownership of the item is taken so the client should keep the item valid and never destroy the item. If the client can append the items successfully then it should return a result via MrcdamlbGetPathResult(). If the client appends some items to the array but then fails to append all the items then it should return an error via MrcdamlbGetPathResult().
See also: MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbGetPathResult()
| Parameters | |
|---|---|
| aPath | The current path. Each entry in the array in one level of the path. For example the path /A/B/C would be provided as: aPath[0] 'A' aPath[1] 'B' aPath[2] 'C' All string are in UTF-8. |
| void | MrcdamlboSearch | ( | const TDesC8 & | aSearch | ) | [pure virtual] |
Perform a search in the current location for items matching the search string.
See also: MRemConDatabaseAwareMediaLibraryBrowse::MrcdamlbSearchResult()
| Parameters | |
|---|---|
| aSearch | The string to search on in UTF-8. The client can use it until the client has called MrcdamlbSearchResult(). |