Contents

• Properties
• Public Functions
• Public Slots
• Detailed Description

Detailed Description

TheVolumeSlider widget provides a slider that is used to control the volume of an audio output device.

The slider also displays an icon indicating if the volume of theAudioOutput it is connected to is muted. The icon can be removed withsetMuteVisible().

It is possible to set themaximum value of the slider. By default, the minimum and maximum values of the slider are 0.0 (no sound) to 1.0 (the maximum volume the audio output can produce).

Here follows a code example:

    Phonon::AudioOutput*audioOutput=new Phonon::AudioOutput(Phonon::MusicCategory);    Phonon::createPath(mediaObject, audioOutput);    Phonon::VolumeSlider*volumeSlider=new Phonon::VolumeSlider;    volumeSlider->setAudioOutput(audioOutput);

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:

maximumVolume :qreal

This property holds the maximum volume that can be set with this slider.

By default the maximum value is 1.0 (100%).

Access functions:

muteVisible :bool

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

By default the mute button/icon is visible.

Access functions:

orientation :Qt::Orientation

This property holds the orientation of the slider.

The orientation must beQt::Vertical (the default) orQt::Horizontal.

Access functions:

pageStep :int

This property holds the page step.

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

Defaults to 5 (5% of the voltage).

Access functions:

singleStep :int

This property holds the single step.

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

Defaults to 1 (1% of the voltage).

Access functions:

tracking :bool

This property holds whether slider tracking is enabled.

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

Access functions:

Member Function Documentation

VolumeSlider::VolumeSlider(QWidget * parent = 0)

Constructs a new volume slider with the givenparent.

VolumeSlider::VolumeSlider(AudioOutput * output,QWidget * parent = 0)

Constructs a new volume slider with the givenoutput object andparent.

VolumeSlider::~VolumeSlider()

AudioOutput * VolumeSlider::audioOutput() const

See alsosetAudioOutput().

[slot]void VolumeSlider::setAudioOutput(Phonon::AudioOutput * output)

Sets the audio output object to be controlled by this slider to the specifiedoutput object.

See alsoaudioOutput().