QMediaSeekWidget Class Reference
[QtMediaModule]

Detailed Description

The QMediaSeekWidget class allows the user to seek within a media content object.

The QMediaSeekWidget class can be used in conjunction with the QMediaContent class to enable the user to seek within a media content object.

    QMediaSeekWidget *seek = new QMediaSeekWidget( this );

    QMediaContent *content = new QMediaContent( url, this );
    seek->setMediaContent( content );

The user can seek within a media content object by holding down the left and right arrow keys. A hold of Qt::Key_Left seeks backward while a hold of Qt::Key_Right seeks forward. The actual seek within the media content object is deferred until the user releases the arrow keys.

During the seek the positionChanged() signal will be emitted continually with the current seek position. While the user is not seeking the positionChanged() and lengthChanged() signals will be emitted when position and length have changed in the media content object.

QMediaSeekWidget is a player object.

Member Function Documentation

QMediaSeekWidget::QMediaSeekWidget ( QWidget * parent = 0 )

Constructs a seek widget.

The parent argument is passed to the QWidget constructor.

QMediaSeekWidget::~QMediaSeekWidget ()

Destroys the widget.

QMediaContent * QMediaSeekWidget::content () const

Returns the media content object currently being used.

void QMediaSeekWidget::lengthChanged ( quint32 ms )   [signal]

This signal is emitted when the total time of the playing media content has changed. The time is given by ms in milliseconds.

void QMediaSeekWidget::positionChanged ( quint32 ms )   [signal]

This signal is emitted when the seek position has changed. While the user is not seeking this signal will be emitted when the position has changed in the media content object. The position is given by ms in milliseconds.

void QMediaSeekWidget::setMediaContent ( QMediaContent * content )   [slot]

Sets content as the media content object to use.