kalarm

SoundPicker Class Reference

List of all members.

Detailed Description

Definition at line 33 of file soundpicker.h.


Public Types

enum  Type { NONE = 0, BEEP, PLAY_FILE, SPEAK }

Public Member Functions

 SoundPicker (QWidget *parent, const char *name=0)
void set (Type type, const QString &filename, float volume, float fadeVolume, int fadeSeconds, bool repeat)
bool isReadOnly () const
void setReadOnly (bool readOnly)
void showSpeak (bool show)
Type sound () const
QString file () const
float volume (float &fadeVolume, int &fadeSeconds) const
bool repeat () const
QString fileSetting () const
bool repeatSetting () const

Static Public Member Functions

static QString browseFile (QString &initialDir, const QString &initialFile=QString::null)
static QString i18n_Sound ()
static QString i18n_None ()
static QString i18n_Beep ()
static QString i18n_Speak ()
static QString i18n_File ()

Member Enumeration Documentation

Sound options which can be selected for when the alarm is displayed.

  • NONE - silence.
  • BEEP - a beep will be sounded.
  • PLAY_FILE - a sound file will be played.
  • SPEAK - the message text will be spoken.

Definition at line 43 of file soundpicker.h.


Constructor & Destructor Documentation

SoundPicker::SoundPicker ( QWidget *  parent,
const char *  name = 0 
)

Constructor.

Parameters:
parent The parent object of this widget.
name The name of this widget.

Definition at line 58 of file soundpicker.cpp.


Member Function Documentation

void SoundPicker::set ( Type  type,
const QString &  filename,
float  volume,
float  fadeVolume,
int  fadeSeconds,
bool  repeat 
)

Initialises the widget's state.

Parameters:
type The option to select.
filename The full path or URL of the sound file to select. If the 'file' option is not initially selected, filename provides the default should 'file' later be selected by the user.
volume The volume to play a sound file, or < 0 for no volume setting. If the 'file' option is not initially selected, volume provides the default should 'file' later be selected by the user.
fadeVolume The initial volume to play a sound file if fading is to be used, or < 0 for no fading. If the 'file' option is not initially selected, fadeVolume provides the default should 'file' later be selected by the user.
fadeSeconds The number of seconds over which the sound file volume should be faded, or 0 for no fading. If the 'file' option is not initially selected, fadeSeconds provides the default should 'file' later be selected by the user.
repeat True to play the sound file repeatedly. If the 'file' option is not initially selected, repeat provides the default should 'file' later be selected by the user.

Definition at line 181 of file soundpicker.cpp.

bool SoundPicker::isReadOnly (  )  const [inline]

Returns true if the widget is read only for the user.

Definition at line 69 of file soundpicker.h.

void SoundPicker::setReadOnly ( bool  readOnly  ) 

Sets whether the widget can be changed the user.

Parameters:
readOnly True to set the widget read-only, false to set it read-write.

Definition at line 97 of file soundpicker.cpp.

void SoundPicker::showSpeak ( bool  show  ) 

Show or hide the 'speak' option.

If it is to be hidden and it is currently selected, sound is turned off.

Definition at line 109 of file soundpicker.cpp.

SoundPicker::Type SoundPicker::sound (  )  const

Returns the selected option.

Definition at line 135 of file soundpicker.cpp.

QString SoundPicker::file (  )  const

If the 'file' option is selected, returns the URL of the chosen file.

Otherwise returns a null string.

Definition at line 144 of file soundpicker.cpp.

float SoundPicker::volume ( float &  fadeVolume,
int &  fadeSeconds 
) const

Returns the volume and fade characteristics for playing a sound file.

Parameters:
fadeVolume Receives the initial volume if the volume is to be faded, else -1.
fadeSeconds Receives the number of seconds over which the volume is to be faded, else 0.
Returns:
Volume to play the sound file, or < 0 if the 'file' option is not selected.

Definition at line 153 of file soundpicker.cpp.

bool SoundPicker::repeat (  )  const

Returns true if a sound file is to be played repeatedly.

If the 'file' option is not selected, returns false.

Definition at line 173 of file soundpicker.cpp.

QString SoundPicker::fileSetting (  )  const [inline]

Returns the current file URL regardless of whether the 'file' option is selected.

Definition at line 95 of file soundpicker.h.

bool SoundPicker::repeatSetting (  )  const [inline]

Returns the current file repetition setting regardless of whether the 'file' option is selected.

Definition at line 97 of file soundpicker.h.

QString SoundPicker::browseFile ( QString &  initialDir,
const QString &  initialFile = QString::null 
) [static]

Display a dialogue to choose a sound file, initially highlighting initialFile if non-null.

Parameters:
initialDir Initial directory to display if initialFile is null. If a file is chosen, this is updated to the directory containing the chosen file.
initialFile Full path name or URL of file to be highlighted initially. If null, no file will be highlighted.
Returns:
URL selected, in human readable format. If none is selected, URL.isEmpty() is true.

Definition at line 265 of file soundpicker.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys