VolumeBar Class Reference

The volume-bar widget. More...

#include <volumebar.h>

Inheritance diagram for VolumeBar:

[legend]

Collaboration diagram for VolumeBar:

[legend]

List of all members.

Public Slots
void	updateVolume (int val, int max)
Signals
void	volumeChanged (int val)
void	animationsFinished ()
	this signal emitted when volume-bar runs to timeout
Public Member Functions
	VolumeBar (QGraphicsItem *parent=0)
	Constructs a VolumeBar instance.
	~VolumeBar ()
	Destructs a VolumeBar instance.
Protected Member Functions
virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)
	REIMPLEMENTATION
virtual void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)
virtual void	applyStyle ()

---

Detailed Description

The volume-bar widget.

Definition at line 35 of file volumebar.h.

---

Constructor & Destructor Documentation

VolumeBar::VolumeBar

(

QGraphicsItem *

parent = 0

)

Constructs a VolumeBar instance.

Definition at line 35 of file volumebar.cpp.

                                           :
    MStylableWidget (parent),
    slider (0),
    icon (0),
    value (0),
    valueMax (0),
    animMove (0),
    animFadeIn (0),
    animFadeOut (0)
{
    constructUi ();
    setOpacity (0.0);
}

VolumeBar::~VolumeBar

(

)

Destructs a VolumeBar instance.

Definition at line 49 of file volumebar.cpp.

{
}

---

Member Function Documentation

void VolumeBar::animationsFinished

(

)

[signal]

this signal emitted when volume-bar runs to timeout

void VolumeBar::applyStyle

(

)

[protected, virtual]

Definition at line 53 of file volumebar.cpp.

{
    MStylableWidget::applyStyle ();

    int timeout = style ()->visibleTimeout ();
    int animDuration = style ()->fadeDuration ();
    qreal opacity = style ()->volumebarOpacity ();

    if (animDuration * 2 > timeout)
    { // handle the error:
        qWarning () << "ERROR in VolumeBars CSS: animDuration * 2 > timeout!";
        animDuration = timeout / 2;
    }

    // first fade out animation started and after its finished we emit animationsFinished ()
    timer.setInterval (timeout - animDuration);

    animFadeIn->setDuration (animDuration);
    animFadeOut->setDuration (animDuration);

    animFadeIn->setEndValue (opacity);
}

void VolumeBar::mouseMoveEvent

(

QGraphicsSceneMouseEvent *

event

)

[protected, virtual]

Definition at line 115 of file volumebar.cpp.

{
  MStylableWidget::mouseMoveEvent (event);
  // just pass the event to mousePressEvent handler
  mousePressEvent (event);
}

Here is the call graph for this function:

void VolumeBar::mousePressEvent

(

QGraphicsSceneMouseEvent *

event

)

[protected, virtual]

REIMPLEMENTATION

Definition at line 122 of file volumebar.cpp.

{
    MStylableWidget::mousePressEvent (event);
    qreal percentage = 0.0;
    /*
     * increase & decrease the volume based on the tap/movement
     * coordinates...
     */
    if (sceneManager()->orientation() == M::Portrait)
        percentage = (geometry().height() - event->pos().y()) / geometry().height();
    else
        percentage = (geometry().width() - event->pos().x()) / geometry().width();

    value = valueMax * percentage;

    if (value >= valueMax)
        value = valueMax - 1;

    /* emit volumeChanged signal... */
    emit volumeChanged (value);
    /* and the update the UI */
    updateVolume (value, valueMax);
}

Here is the call graph for this function:

void VolumeBar::updateVolume	(	int	val,
		int	max
	)			[slot]

This method makes volume-bar visible, and updates its contents (with animations)

Parameters:

	val	The actual volume level (valid range: [0 - max-1])
	max	The maximal count of the volume-levels

Definition at line 193 of file volumebar.cpp.

{
    timer.stop ();

    value = val;
    valueMax = max;

    updateContents ();

    if (animFadeOut->state () != QAbstractAnimation::Stopped) {
        // stop the fade-out animation in case if it is not stopped
        animFadeOut->stop ();
        // start the fade-in animation to get the wanted opacity back
        animFadeIn->start ();
    } else if (animFadeIn->state () != QAbstractAnimation::Running && (opacity () <= 0.1)) {
        // start the fade-in animation (only if needed ^^^)
        animFadeIn->start ();
    }

    timer.start ();
}

void VolumeBar::volumeChanged

(

int

val

)

[signal]

This signal emitted when user modifies the volume level by touching the volume-bar

Parameters:

val

The new volume level

---

The documentation for this class was generated from the following files:

• src/systemui/volumecontrol/volumebar.h (795ad6db04802c20772a802e43a88ba463bc79de)
• src/systemui/volumecontrol/volumebar.cpp (795ad6db04802c20772a802e43a88ba463bc79de)