The medialist page manager, used to register, unregister, enumerate, set and retrieve page/medialists associations. More...
import"sbIMediaPageManager.idl";
Public Member Functions | |
| sbIMediaPageInfo | registerPage (in AString aName, in AString aURL, in AString aIcon, in sbIMediaListMatch aMatch) |
| Register a medialist page. More... | |
| void | unregisterPage (in sbIMediaPageInfo aPageInfo) |
| Unregister a medialist page. More... | |
| nsISimpleEnumerator | getAvailablePages ([optional] in sbIMediaList aList, [optional] in sbILibraryConstraint aConstraint) |
| Get the list of available pages. The list parameter is optional, if not specified, the entire list of registered pages is returned. More... | |
| sbIMediaPageInfo | getPage (in sbIMediaList aList, [optional] in sbILibraryConstraint aConstraint, [optional] in AString aType) |
| Get the active page for a medialist. More... | |
| void | setPage (in sbIMediaList aList, in sbIMediaPageInfo aPageInfo, [optional] in AString aType) |
| Set the active page for a medialist. More... | |
The medialist page manager, used to register, unregister, enumerate, set and retrieve page/medialists associations.
Definition at line 39 of file sbIMediaPageManager.idl.
| nsISimpleEnumerator sbIMediaPageManager::getAvailablePages | ( | [optional] in sbIMediaList | aList, |
| [optional] in sbILibraryConstraint | aConstraint | ||
| ) |
Get the list of available pages. The list parameter is optional, if not specified, the entire list of registered pages is returned.
| aList | (optional) The medialist for which the list of available matching pages is being requested |
| aConstraint | (optional) A library constrain used as an additional matching criteria |
| sbIMediaPageInfo sbIMediaPageManager::getPage | ( | in sbIMediaList | aList, |
| [optional] in sbILibraryConstraint | aConstraint, | ||
| [optional] in AString | aType | ||
| ) |
Get the active page for a medialist.
Pages are matched in the order of registration, that is, if several pages match a particular medialist, the first one to have been registered is returned.
If a page has been set to a medialist via the setPage method, the search for a matching list is bypassed, and that page is returned again, unless it no longer exists or no longer matches the medialist.
If a medialist has a defaultMediaPageURL property set to a particular page, and has not been set to a different one via the setPage method, the search is also bypassed, and that page is returned, unless it no longer exists or no longer matches the medialist.
| aList | The medialist for which the active page is being requested |
| aConstraint | (optional) A library constraint used as an additional matching criteria |
| aType | (optional) The content type of the service pane node |
| sbIMediaPageInfo sbIMediaPageManager::registerPage | ( | in AString | aName, |
| in AString | aURL, | ||
| in AString | aIcon, | ||
| in sbIMediaListMatch | aMatch | ||
| ) |
Register a medialist page.
| aName | The localized name of the page |
| aURL | The chrome URL to the page |
| aMatch | The interface or js function used to determine whether this page matches a particular medialist |
| void sbIMediaPageManager::setPage | ( | in sbIMediaList | aList, |
| in sbIMediaPageInfo | aPageInfo, | ||
| [optional] in AString | aType | ||
| ) |
Set the active page for a medialist.
| aList | The medialist for which the page is being set |
| aPageInfo | The page that is being set to the medialist |
| aType | (optional) The content type of the service pane node |
| void sbIMediaPageManager::unregisterPage | ( | in sbIMediaPageInfo | aPageInfo | ) |
Unregister a medialist page.
| aPageInfo | a sbIMediaPageInfo interface as previously returned by registerPage |