Songbird / Development / Songbird Add-Ons API Documentation

sbIApplicationController Interface Reference

Global root controller for the Songbird application. More...

import "sbIApplicationController.idl";

List of all members.

Public Member Functions

void playDefault ()
 Begin playback using whatever UI context is available.

Public Attributes

readonly attribute nsIDOMWindow activeWindow
 The current active window. The current active window, regardless of category.
readonly attribute nsIDOMWindow activeMainWindow
 The current active Songbird window The current active window of type Songbird:Main. Usually the primary Songbird window, with playback controls, playlist display panes, etc.


Detailed Description

Global root controller for the Songbird application.

This service represents the global instance of the Songbird application.

One day the implementation of this interface will be responsible for bringing up the main window and generally managing application lifecycle.

The interface may also be exposed as a replacement for / addition to FUEL's Application object, and offer accessors for other global Songbird objects. For example, we may eventually have accessors like Application.songbird.mediacoreManager.playbackControl.

Other future functionality may include:

Definition at line 57 of file sbIApplicationController.idl.


Member Function Documentation

void sbIApplicationController::playDefault (  ) 

Begin playback using whatever UI context is available.

Used to initiate playback when what to play is not clear. Will try to delegate playback to the UI, and match user expectations. If the open windows are unable to determine what should be played, the first track in the main library will be selected.

This method should be used as a fallback when no context is available to callers.

This method may be removed once we have a standard way to broadcast application wide events.


The documentation for this interface was generated from the following file:
Generated on Tue Mar 10 14:28:56 2009 for Songbird by  doxygen 1.5.2