kalarm/lib

TimeEdit Class Reference

#include <timeedit.h>

List of all members.


Detailed Description

Widget to enter a time of day.

The TimeEdit class provides a widget to enter a time of day in hours and minutes, using a 12- or 24-hour clock according to the user's locale settings.

It displays a TimeSpinBox widget to enter hours and minutes. If a 12-hour clock is being used, it also displays a combo box to select am or pm.

TimeSpinBox displays a spin box with two pairs of spin buttons, one for hours and one for minutes. It provides accelerated stepping using the spin buttons, when the shift key is held down (inherited from SpinBox2). The default shift steps are 5 minutes and 6 hours.

The widget may be set as read-only. This has the same effect as disabling it, except that its appearance is unchanged.

Author:
David Jarvie <software@astrojar.org.uk>

Definition at line 50 of file timeedit.h.


Public Slots

virtual void setValue (int minutes)
void setValue (const QTime &t)

Signals

void valueChanged (int minutes)

Public Member Functions

 TimeEdit (QWidget *parent=0, const char *name=0)
bool isReadOnly () const
virtual void setReadOnly (bool readOnly)
bool isValid () const
void setValid (bool valid)
int value () const
QTime time () const
bool wrapping () const
void setWrapping (bool on)
int minValue () const
int maxValue () const
QTime maxTime () const
void setMinValue (int minutes)
void setMaxValue (int minutes)
void setMaxValue (const QTime &time)

Constructor & Destructor Documentation

TimeEdit::TimeEdit ( QWidget *  parent = 0,
const char *  name = 0 
) [explicit]

Constructor.

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

Definition at line 31 of file timeedit.cpp.


Member Function Documentation

bool TimeEdit::isReadOnly (  )  const [inline]

Returns true if the widget is read only.

Definition at line 60 of file timeedit.h.

void TimeEdit::setReadOnly ( bool  readOnly  )  [virtual]

Sets whether the widget is read-only for the user.

If read-only, the time cannot be edited and the spin buttons and am/pm combo box are inactive.

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

Definition at line 51 of file timeedit.cpp.

bool TimeEdit::isValid (  )  const

Returns true if the widget contains a valid value.

Definition at line 67 of file timeedit.cpp.

void TimeEdit::setValid ( bool  valid  ) 

Sets whether the edit value is valid.

If newly invalid, the value is displayed as asterisks. If newly valid, the value is set to the minimum value.

Parameters:
valid True to set the value valid, false to set it invalid.

Definition at line 77 of file timeedit.cpp.

int TimeEdit::value (  )  const

Returns the entered time as a value in minutes.

Definition at line 62 of file timeedit.cpp.

QTime TimeEdit::time (  )  const [inline]

Returns the entered time as a QTime value.

Definition at line 78 of file timeedit.h.

bool TimeEdit::wrapping (  )  const

Returns true if it is possible to step the value from the highest value to the lowest value and vice versa.

Definition at line 102 of file timeedit.cpp.

void TimeEdit::setWrapping ( bool  on  ) 

Sets whether it is possible to step the value from the highest value to the lowest value and vice versa.

Parameters:
on True to enable wrapping, else false.

Definition at line 107 of file timeedit.cpp.

int TimeEdit::minValue (  )  const

Returns the minimum value of the widget in minutes.

Definition at line 112 of file timeedit.cpp.

int TimeEdit::maxValue (  )  const

Returns the maximum value of the widget in minutes.

Definition at line 117 of file timeedit.cpp.

QTime TimeEdit::maxTime (  )  const [inline]

Returns the maximum value of the widget as a QTime value.

Definition at line 90 of file timeedit.h.

void TimeEdit::setMinValue ( int  minutes  ) 

Sets the minimum value of the widget.

Definition at line 122 of file timeedit.cpp.

void TimeEdit::setMaxValue ( int  minutes  ) 

Sets the maximum value of the widget.

Definition at line 129 of file timeedit.cpp.

void TimeEdit::setMaxValue ( const QTime &  time  )  [inline]

Sets the maximum value of the widget.

Definition at line 96 of file timeedit.h.

void TimeEdit::setValue ( int  minutes  )  [virtual, slot]

Sets the value of the widget.

Definition at line 92 of file timeedit.cpp.

void TimeEdit::setValue ( const QTime &  t  )  [inline, slot]

Sets the value of the widget.

Definition at line 101 of file timeedit.h.

void TimeEdit::valueChanged ( int  minutes  )  [signal]

This signal is emitted every time the value of the widget changes (for whatever reason).

Parameters:
minutes The new value.


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