Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QMediaControl Class Reference
[QtMediaModule]

The QMediaControl class is used to manipulate a media resource in the Qt Extended media system. More...

    #include <QMediaControl>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• QMediaControl ( QMediaContent * mediaContent )
• ~QMediaControl ()
• QString errorString () const
• bool isMuted () const
• quint32 length () const
• QtopiaMedia::State playerState () const
• quint32 position () const
• int volume () const

• 29 public functions inherited from QObject

Public Slots

• void pause ()
• void seek ( quint32 ms )
• void setMuted ( bool mute )
• void setVolume ( int volume )
• void start ()
• void stop ()

• 1 public slot inherited from QObject

Signals

• void invalid ()
• void lengthChanged ( quint32 ms )
• void playerStateChanged ( QtopiaMedia::State state )
• void positionChanged ( quint32 ms )
• void valid ()
• void volumeChanged ( int volume )
• void volumeMuted ( bool muted )

• 1 signal inherited from QObject

Static Public Members

• QString name ()

• 4 static public members inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The QMediaControl class is used to manipulate a media resource in the Qt Extended media system.

Member Function Documentation

QMediaControl::QMediaControl ( QMediaContent * mediaContent )

Construct a QMediaControl.

Construct a QMediaControl for controlling mediaContent. The QMediaControl can be constructed only after the mediaContent instance has signaled that it is available via the QMediaContent::controlAvailable() signal.

See also QMediaContent::controlAvailable().

QMediaControl::~QMediaControl ()

Destroy the QMediaControl object.

QString QMediaControl::errorString () const

When an error occurs, indicated by the QtopiaMedia::Error state, this function will return a QString with appropriate information regarding the error.

void QMediaControl::invalid ()   [signal]

Signal that is emitted when the control is invalid and no longer available for use.

bool QMediaControl::isMuted () const

Return the mute state of the media content.

quint32 QMediaControl::length () const

Return the length of the media content.

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

Signals a change in the length of the media. For some media content the length may not be available until after playback has started, it is advisable to hook onto this signal to ensure clients have the correct length information, The length information is available as the total number of milliseconds from the parameter ms.

QString QMediaControl::name ()   [static]

Returns the name of this control.

void QMediaControl::pause ()   [slot]

Pause the media content.

QtopiaMedia::State QMediaControl::playerState () const

Return the current state of the media content

void QMediaControl::playerStateChanged ( QtopiaMedia::State state )   [signal]

Signals a change in the state of the media content. The new state is represented by the state parameter.

quint32 QMediaControl::position () const

Return the current position in the media content.

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

Signals an update to the current position of a media content. This signal is emitted while the media is playing and represents the current milliseconds ms from the beginning of the media.

void QMediaControl::seek ( quint32 ms )   [slot]

Seek to the location in the media content. The location is specified with the ms parameter which is the number of milliseconds from the beginning of the media.

void QMediaControl::setMuted ( bool mute )   [slot]

Mute or unmute the volume for the media content.

The mute parameter enables or disable muting of the media.

See also isMuted().

void QMediaControl::setVolume ( int volume )   [slot]

Set the volume of the current media content. The acceptable volume range is 1-100.

The volume is the value of the volume to be set for this media.

See also volume().

void QMediaControl::start ()   [slot]

Start playing the media content.

void QMediaControl::stop ()   [slot]

Stop playing the media content.

void QMediaControl::valid ()   [signal]

Signal that is emitted when the control is valid and available for use.

int QMediaControl::volume () const

Return the current volume for the media content.

See also setVolume().

void QMediaControl::volumeChanged ( int volume )   [signal]

Signals a change in volume of the media content. The new volume is has the value volume, ranging from 1 - 100.

void QMediaControl::volumeMuted ( bool muted )   [signal]

Signals if the media content has been muted or not. The muted paramter is true when muted, false when not.