MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

SeekSlider Class Reference

(Phonon::SeekSlider)

The SeekSlider class provides a slider for seeking to positions in media streams. More...

 #include <Phonon/SeekSlider>

Inherits: QWidget.

This class was introduced in Qt 4.4.

Properties

  • 58 properties inherited from QWidget
  • 1 property inherited from QObject

Public Functions

SeekSlider ( QWidget * parent = 0 )
SeekSlider ( MediaObject * media, QWidget * parent = 0 )
~SeekSlider ()
bool hasTracking () const
QSize iconSize () const
bool isIconVisible () const
MediaObject * mediaObject () const
Qt::Orientation orientation () const
int pageStep () const
void setPageStep ( int milliseconds )
void setSingleStep ( int milliseconds )
void setTracking ( bool tracking )
int singleStep () const
  • 217 public functions inherited from QWidget
  • 29 public functions inherited from QObject
  • 13 public functions inherited from QPaintDevice

Public Slots

void setIconSize ( const QSize & size )
void setIconVisible ( bool )
void setMediaObject ( MediaObject * media )
void setOrientation ( Qt::Orientation )
  • 19 public slots inherited from QWidget
  • 1 public slot inherited from QObject

Additional Inherited Members

  • 1 signal inherited from QWidget
  • 1 signal inherited from QObject
  • 4 static public members inherited from QWidget
  • 5 static public members inherited from QObject
  • 37 protected functions inherited from QWidget
  • 7 protected functions inherited from QObject
  • 1 protected function inherited from QPaintDevice
  • 1 protected slot inherited from QWidget

Detailed Description

The SeekSlider class provides a slider for seeking to positions in media streams.

The SeekSlider connects to a MediaObject, and controls the seek position in the object's media stream.

The slider will connect to the necessary signals to keep track of the sliders maximum, minimum, and current values. It will also disable itself for non-seekable streams, and update the media object when the current value of the slider changes.

Here follows a typical example of SeekSlider usage:

     Phonon::MediaObject *moo = new Phonon::MediaObject;;
     Phonon::AudioOutput *device = new Phonon::AudioOutput;
     Phonon::createPath(moo, device);
     moo->setCurrentSource(QString("/home/gvatteka/Music/Lumme-Badloop.ogg"));

     Phonon::SeekSlider *slider = new Phonon::SeekSlider;
     slider->setMediaObject(moo);

     slider->show();
     moo->play();

See also Phonon::VolumeSlider, Phonon::VideoWidget, Music Player Example, and Phonon Module.

Property Documentation

iconSize : QSize

This property holds the icon size used for the mute button/icon.

The default size is defined by the GUI style.

Access functions:

QSize iconSize () const
void setIconSize ( const QSize & size )

iconVisible : bool

This property holds whether the icon next to the slider is visible.

By default the icon is visible if the platform provides an icon; else it's hidden.

Access functions:

bool isIconVisible () const
void setIconVisible ( bool )

orientation : Qt::Orientation

This property holds the orientation of the slider.

The orientation must be Qt::Vertical or Qt::Horizontal (the default).

Access functions:

Qt::Orientation orientation () const
void setOrientation ( Qt::Orientation )

pageStep : int

This property holds the page step interval.

The larger of two natural steps that a slider provides and typically corresponds to the user pressing PageUp or PageDown.

Defaults to 5 seconds.

Access functions:

int pageStep () const
void setPageStep ( int milliseconds )

singleStep : int

This property holds the single step interval.

The smaller of two natural steps that a slider provides and typically corresponds to the user pressing an arrow key.

Defaults to 0.5 seconds.

Access functions:

int singleStep () const
void setSingleStep ( int milliseconds )

tracking : bool

This property holds whether slider tracking is enabled.

If tracking is enabled (the default), the media seeks while the slider is being dragged. If tracking is disabled, the media seeks only when the user releases the slider.

Access functions:

bool hasTracking () const
void setTracking ( bool tracking )

Member Function Documentation

SeekSlider::SeekSlider ( QWidget * parent = 0 )

Constructs a seek slider widget with the given parent.

SeekSlider::SeekSlider ( MediaObject * media, QWidget * parent = 0 )

Constructs a seek slider widget for the specified media with the given parent.

SeekSlider::~SeekSlider ()

Destroys the seek slider.

MediaObject * SeekSlider::mediaObject () const

Return the media object this SeekSlider controls.

See also setMediaObject().

void SeekSlider::setMediaObject ( MediaObject * media ) [slot]

Sets the media object to be controlled by this slider to the media specified.

See also mediaObject().