sbIMediaPageManager Interface Reference

The medialist page manager, used to register, unregister, enumerate, set and retrieve page/medialists associations. More...

import"sbIMediaPageManager.idl";

Inheritance diagram for sbIMediaPageManager:
[legend]
Collaboration diagram for sbIMediaPageManager:
[legend]

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...
 

Detailed Description

The medialist page manager, used to register, unregister, enumerate, set and retrieve page/medialists associations.

Definition at line 39 of file sbIMediaPageManager.idl.

Member Function Documentation

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.

Parameters
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
Returns
An nsISimpleEnumerator containing a list of sbIMediaPageInfo interfaces
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.

Parameters
aListThe 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.

Parameters
aNameThe localized name of the page
aURLThe chrome URL to the page
aMatchThe interface or js function used to determine whether this page matches a particular medialist
Returns
An sbMediaListIPageInfo interface describing the page
void sbIMediaPageManager::setPage ( in sbIMediaList  aList,
in sbIMediaPageInfo  aPageInfo,
[optional] in AString  aType 
)

Set the active page for a medialist.

Parameters
aListThe medialist for which the page is being set
aPageInfoThe 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.

Parameters
aPageInfoa sbIMediaPageInfo interface as previously returned by registerPage

The documentation for this interface was generated from the following file: