okular/core/audioplayer.h
Albert Astals Cid 19d98d6a74 Run clang-format
find . \( -name "*.cpp" -or -name "*.h"  -or -name "*.c"  -or -name "*.cc" \) -exec clang-format -i {} \;

If you reached this file doing a git blame, please see README.clang-format (added 2 commits in the future of this one)
2020-07-11 09:17:33 +02:00

87 lines
2 KiB
C++

/***************************************************************************
* Copyright (C) 2007 by Pino Toscano <pino@kde.org> *
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
***************************************************************************/
#ifndef _OKULAR_AUDIOPLAYER_H_
#define _OKULAR_AUDIOPLAYER_H_
#include "okularcore_export.h"
#include <QObject>
namespace Okular
{
class AudioPlayerPrivate;
class Document;
class Sound;
class SoundAction;
/**
* @short An audio player.
*
* Singleton utility class to play sounds in documents using the KDE sound
* system.
*/
class OKULARCORE_EXPORT AudioPlayer : public QObject
{
Q_OBJECT
public:
/**
* The state of AudioPlayer
* @since 0.19 (KDE 4.13)
*/
enum State {
/**
* The AudioPlayer is playing a audio file.
*/
PlayingState,
/**
* The AudioPlayer isn't playing a audio file.
*/
StoppedState
};
~AudioPlayer() override;
/**
* Gets the instance of the audio player.
*/
static AudioPlayer *instance();
/**
* Enqueue the specified @p sound for playing, optionally taking more
* information about the playing from the @p soundlink .
*/
void playSound(const Sound *sound, const SoundAction *linksound = nullptr);
/**
* Tell the AudioPlayer to stop all the playbacks.
*/
void stopPlaybacks();
/**
* Return state of sound (playing/stopped)
* @since 0.19 (KDE 4.13)
*/
State state() const;
private:
AudioPlayer();
friend class AudioPlayerPrivate;
AudioPlayerPrivate *const d;
friend class Document;
Q_DISABLE_COPY(AudioPlayer)
};
}
#endif