summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--libopie/colordialog.cpp2
-rw-r--r--libopie/colordialog.h4
-rw-r--r--libopie/colorpopupmenu.h6
-rw-r--r--libopie/ocheckitem.h9
-rw-r--r--libopie/oclickablelabel.h11
-rw-r--r--libopie/ocolorbutton.h6
-rw-r--r--libopie/odevicebutton.cpp14
-rw-r--r--libopie/ofileselector.h17
-rw-r--r--libopie/ofontselector.h3
-rw-r--r--libopie/oprocess.h24
-rw-r--r--libopie/orecurrancewidget.h6
-rw-r--r--libopie/otabbar.h2
-rw-r--r--libopie/otabinfo.h8
-rw-r--r--libopie/otabwidget.h10
-rw-r--r--libopie/oticker.h3
-rw-r--r--libopie/otimepicker.h8
-rw-r--r--libopie/todayconfigwidget.h2
-rw-r--r--libopie/todayplugininterface.h3
18 files changed, 93 insertions, 45 deletions
diff --git a/libopie/colordialog.cpp b/libopie/colordialog.cpp
index 35f15d6..c7421ec 100644
--- a/libopie/colordialog.cpp
+++ b/libopie/colordialog.cpp
@@ -679,33 +679,33 @@ OColorDialogPrivate::OColorDialogPrivate( OColorDialog *dialog ) :
679 pickLay->addWidget( lp ); 679 pickLay->addWidget( lp );
680 680
681 connect( cp, SIGNAL(newCol(int,int)), lp, SLOT(setCol(int,int)) ); 681 connect( cp, SIGNAL(newCol(int,int)), lp, SLOT(setCol(int,int)) );
682 connect( lp, SIGNAL(newHsv(int,int,int)), this, SLOT(newHsv(int,int,int)) ); 682 connect( lp, SIGNAL(newHsv(int,int,int)), this, SLOT(newHsv(int,int,int)) );
683 683
684 topLay->addStretch(); 684 topLay->addStretch();
685 685
686 cs = new QColorShower( dialog ); 686 cs = new QColorShower( dialog );
687 connect( cs, SIGNAL(newCol(QRgb)), this, SLOT(newColorTypedIn(QRgb))); 687 connect( cs, SIGNAL(newCol(QRgb)), this, SLOT(newColorTypedIn(QRgb)));
688 topLay->addWidget( cs ); 688 topLay->addWidget( cs );
689 689
690} 690}
691 691
692 692
693// BEING REVISED: jo 693// BEING REVISED: jo
694/*! 694/*!
695 \class OColorDialog OColorDialog.h 695 \class ColorDialog ColorDialog.h
696 \brief The OColorDialog class provides a dialog widget for specifying colors. 696 \brief The OColorDialog class provides a dialog widget for specifying colors.
697 \ingroup dialogs 697 \ingroup dialogs
698 698
699 The color dialog's function is to allow users to choose colors - 699 The color dialog's function is to allow users to choose colors -
700 for instance, you might use this in a drawing program to allow the 700 for instance, you might use this in a drawing program to allow the
701 user to set the brush color. 701 user to set the brush color.
702 702
703 This version of Qt only provides modal color dialogs. The static 703 This version of Qt only provides modal color dialogs. The static
704 getColor() function shows the dialog and allows the user to specify a color, 704 getColor() function shows the dialog and allows the user to specify a color,
705 while getRgba() does the same but allows the user to specify a color with an 705 while getRgba() does the same but allows the user to specify a color with an
706 alpha channel (transparency) value. 706 alpha channel (transparency) value.
707 707
708 The user can store customCount() different custom colors. The custom 708 The user can store customCount() different custom colors. The custom
709 colors are shared by all color dialogs, and remembered during the 709 colors are shared by all color dialogs, and remembered during the
710 execution of the program. Use setCustomColor() to set the 710 execution of the program. Use setCustomColor() to set the
711 custom colors, and customColor() to get them. 711 custom colors, and customColor() to get them.
diff --git a/libopie/colordialog.h b/libopie/colordialog.h
index e9bb7ed..1a6a3fd 100644
--- a/libopie/colordialog.h
+++ b/libopie/colordialog.h
@@ -31,50 +31,50 @@
31** See http://www.trolltech.com/gpl/ for GPL licensing information. 31** See http://www.trolltech.com/gpl/ for GPL licensing information.
32** 32**
33** Contact info@trolltech.com if any conditions of this licensing are 33** Contact info@trolltech.com if any conditions of this licensing are
34** not clear to you. 34** not clear to you.
35** 35**
36**********************************************************************/ 36**********************************************************************/
37 37
38#ifndef OColorDialog_H 38#ifndef OColorDialog_H
39#define OColorDialog_H 39#define OColorDialog_H
40 40
41#ifndef QT_H 41#ifndef QT_H
42#include <qdialog.h> 42#include <qdialog.h>
43#endif // QT_H 43#endif // QT_H
44 44
45class OColorDialogPrivate; 45class OColorDialogPrivate;
46 46
47/** 47/*
48 * @class OColorDialog 48 * @class OColorDialog
49 * @brief The OColorDialog class is a copy of QColorDialog for use in Opie. 49 * @brief The OColorDialog class is a copy of QColorDialog for use in Opie.
50 * 50 *
51 * OColorDialog is a copy of TrollTech's QColorDialog for use in Opie. The default 51 * OColorDialog is a copy of TrollTech's QColorDialog for use in Opie. The default
52 * build of QT/Embedded used by Opie does not include QColorDialog, so it is provided 52 * build of QT/Embedded used by Opie does not include QColorDialog, so it is provided
53 * here. It is renamed to prevent conflicts in the event the QColorDialog is included 53 * here. It is renamed to prevent conflicts in the event the QColorDialog is included
54 * at a later date in QP/E. 54 * at a later date in QP/E.
55 * 55 *
56 * See http://doc.trolltech.com/2.3/qcolordialog.html for complete documentation of 56 * See http://doc.trolltech.com/2.3/qcolordialog.html for complete documentation of
57 * QColorDialog. 57 * QColorDialog.
58 */ 58 */
59class Q_EXPORT OColorDialog : public QDialog 59class Q_EXPORT OColorDialog : public QDialog
60{ 60{
61 Q_OBJECT 61 Q_OBJECT
62 62
63public: 63public:
64 static QColor getColor( const QColor&, QWidget *parent=0, const char* name=0 ); 64 static QColor getColor( const QColor&, QWidget *parent=0, const char* name=0 );
65 static QRgb getRgba( const QRgb&, bool* ok = 0, 65 static QRgb getRgba( const QRgb&, bool* ok = 0,
66 QWidget *parent=0, const char* name=0 ); 66 QWidget *parent=0, const char* name=0 );
67 67
68private: 68private:
69 ~OColorDialog(); 69 ~OColorDialog();
70 70
71 OColorDialog( QWidget* parent=0, const char* name=0, bool modal=FALSE ); 71 OColorDialog( QWidget* parent=0, const char* name=0, bool modal=FALSE );
72 void setColor( const QColor& ); 72 void setColor( const QColor& );
73 QColor color() const; 73 QColor color() const;
74 74
75private: 75private:
76 void setSelectedAlpha( int ); 76 void setSelectedAlpha( int );
77 int selectedAlpha() const; 77 int selectedAlpha() const;
78private: 78private:
79 OColorDialogPrivate *d; 79 OColorDialogPrivate *d;
80 friend class OColorDialogPrivate; 80 friend class OColorDialogPrivate;
diff --git a/libopie/colorpopupmenu.h b/libopie/colorpopupmenu.h
index 184b132..3e90c5e 100644
--- a/libopie/colorpopupmenu.h
+++ b/libopie/colorpopupmenu.h
@@ -55,33 +55,33 @@ class OColorPanelButton : public QFrame
55 55
56public: 56public:
57 57
58/** 58/**
59 * @fn OColorPanelButton( const QColor& color, QWidget* parent = 0, const char* name = 0 ) 59 * @fn OColorPanelButton( const QColor& color, QWidget* parent = 0, const char* name = 0 )
60 * @brief Object constructor. 60 * @brief Object constructor.
61 * 61 *
62 * @param color Desired color. 62 * @param color Desired color.
63 * @param parent Pointer to parent of this control. 63 * @param parent Pointer to parent of this control.
64 * @param name Name of control. 64 * @param name Name of control.
65 * 65 *
66 * Constructs a new ColorPanelButton control with parent, name and desired color. 66 * Constructs a new ColorPanelButton control with parent, name and desired color.
67 */ 67 */
68 OColorPanelButton(const QColor& color, QWidget* parent = 0, const char* name = 0); 68 OColorPanelButton(const QColor& color, QWidget* parent = 0, const char* name = 0);
69 69
70/** 70/**
71 * @fn ~ColorPanelButton() 71 * @fn ~OColorPanelButton()
72 * @brief Object destructor. 72 * @brief Object destructor.
73 */ 73 */
74 ~OColorPanelButton(); 74 ~OColorPanelButton();
75 75
76/** 76/**
77 * @fn setActive( bool active ) 77 * @fn setActive( bool active )
78 * @brief Sets button selection state. 78 * @brief Sets button selection state.
79 * 79 *
80 * @param active Boolean indicator of new button state. 80 * @param active Boolean indicator of new button state.
81 * 81 *
82 * Changes button selection state. If button is selected, a highlighted border 82 * Changes button selection state. If button is selected, a highlighted border
83 * is drawn. 83 * is drawn.
84 */ 84 */
85 void setActive(bool active); 85 void setActive(bool active);
86 86
87/** 87/**
@@ -94,37 +94,37 @@ public:
94 * active or not. 94 * active or not.
95 */ 95 */
96 void enterEvent(QEvent* e); 96 void enterEvent(QEvent* e);
97 97
98/** 98/**
99 * @fn leaveEvent( QEvent* e ) 99 * @fn leaveEvent( QEvent* e )
100 * @brief Reimplemented for internal reasons. 100 * @brief Reimplemented for internal reasons.
101 * 101 *
102 * @param e Event currently being processed. 102 * @param e Event currently being processed.
103 * 103 *
104 * Reimplemented to ensure correct display of button based on whether it is 104 * Reimplemented to ensure correct display of button based on whether it is
105 * active or not. 105 * active or not.
106 */ 106 */
107 void leaveEvent(QEvent* e); 107 void leaveEvent(QEvent* e);
108 108
109/** 109/**
110 * @fn paintEvent( QEvent* e ) 110 * @fn paintEvent( QPaintEvent* e )
111 * @brief Reimplemented for internal reasons. 111 * @brief Reimplemented for internal reasons.
112 * 112 *
113 * @param e Event currently being processed. 113 * @param e Event currently being processed.
114 * 114 * @reimp
115 * Reimplemented to ensure correct display of button. 115 * Reimplemented to ensure correct display of button.
116 */ 116 */
117 void paintEvent(QPaintEvent* e); 117 void paintEvent(QPaintEvent* e);
118 118
119/** 119/**
120 * @fn mouseReleaseEvent( QMouseEvent* e ) 120 * @fn mouseReleaseEvent( QMouseEvent* e )
121 * @brief Slot executed when button is pressed. 121 * @brief Slot executed when button is pressed.
122 * 122 *
123 * @param e Mouse event currently being processed. 123 * @param e Mouse event currently being processed.
124 * 124 *
125 * @see selected() 125 * @see selected()
126 * 126 *
127 * This slot executes when the button has been pressed. It emits the selected 127 * This slot executes when the button has been pressed. It emits the selected
128 * signal as notification that it has been pressed. 128 * signal as notification that it has been pressed.
129 */ 129 */
130 void mouseReleaseEvent(QMouseEvent* e); 130 void mouseReleaseEvent(QMouseEvent* e);
diff --git a/libopie/ocheckitem.h b/libopie/ocheckitem.h
index 2387134..82ee3d0 100644
--- a/libopie/ocheckitem.h
+++ b/libopie/ocheckitem.h
@@ -16,38 +16,47 @@
16 16
17/** 17/**
18 * This class represents a checkable QTableItem. This can 18 * This class represents a checkable QTableItem. This can
19 * be added to any QTable. 19 * be added to any QTable.
20 * 20 *
21 * 21 *
22 * @see QTable 22 * @see QTable
23 * @see QTableItem 23 * @see QTableItem
24 * @short An checkable QTableItem 24 * @short An checkable QTableItem
25 * @version 1.0 25 * @version 1.0
26 * @author Stefan Eilers ( eilers@handhelds.org ) 26 * @author Stefan Eilers ( eilers@handhelds.org )
27 */ 27 */
28 28
29class OCheckItem : public QTableItem 29class OCheckItem : public QTableItem
30{ 30{
31public: 31public:
32 /** The size of a box currently unused */
32 enum Size { BoxSize = 10 }; 33 enum Size { BoxSize = 10 };
33 OCheckItem( QTable *t, const QString &sortkey ); 34 OCheckItem( QTable *t, const QString &sortkey );
34 35
35 virtual void setChecked( bool b ); 36 virtual void setChecked( bool b );
36 virtual void toggle(); 37 virtual void toggle();
37 bool isChecked() const; 38 bool isChecked() const;
39 /**
40 * @short Set the sort key
41 * @reimp
42 */
38 void setKey( const QString &key ) { m_sortKey = key; } 43 void setKey( const QString &key ) { m_sortKey = key; }
39 virtual QString key() const; 44 virtual QString key() const;
40 45
46 /**
47 * foo
48 * @internal
49 */
41 void paint( QPainter *p, const QColorGroup &cg, const QRect &cr, bool selected ); 50 void paint( QPainter *p, const QColorGroup &cg, const QRect &cr, bool selected );
42 51
43 //static const int BoxSize = 10; 52 //static const int BoxSize = 10;
44 53
45private: 54private:
46 class OCheckItemPrivate; 55 class OCheckItemPrivate;
47 OCheckItemPrivate *d; 56 OCheckItemPrivate *d;
48 bool m_checked: 1; 57 bool m_checked: 1;
49 QString m_sortKey; 58 QString m_sortKey;
50 59
51}; 60};
52 61
53#endif 62#endif
diff --git a/libopie/oclickablelabel.h b/libopie/oclickablelabel.h
index 4b6dcbc..6e7a123 100644
--- a/libopie/oclickablelabel.h
+++ b/libopie/oclickablelabel.h
@@ -19,35 +19,46 @@
19 * @author Hakan Ardo, Maximillian Reiß ( harlekin@handhelds.org ) 19 * @author Hakan Ardo, Maximillian Reiß ( harlekin@handhelds.org )
20 * @see QLabel 20 * @see QLabel
21 * @see QPushButton 21 * @see QPushButton
22 * @see QToggleButton 22 * @see QToggleButton
23 * @version 1.0 23 * @version 1.0
24 */ 24 */
25 25
26class OClickableLabel: public QLabel 26class OClickableLabel: public QLabel
27{ 27{
28 Q_OBJECT 28 Q_OBJECT
29public: 29public:
30 OClickableLabel(QWidget* parent = 0, const char* name = 0, 30 OClickableLabel(QWidget* parent = 0, const char* name = 0,
31 WFlags fl = 0); 31 WFlags fl = 0);
32 void setToggleButton(bool t); 32 void setToggleButton(bool t);
33 33
34 protected: 34 protected:
35 /** @internal */
35 void mousePressEvent( QMouseEvent *e ); 36 void mousePressEvent( QMouseEvent *e );
37 /** @internal */
36 void mouseReleaseEvent( QMouseEvent *e ); 38 void mouseReleaseEvent( QMouseEvent *e );
39 /** @internal */
37 void mouseMoveEvent( QMouseEvent *e ); 40 void mouseMoveEvent( QMouseEvent *e );
38 41
39 public slots: 42 public slots:
40 void setOn(bool on); 43 void setOn(bool on);
41 signals: 44 signals:
45 /**
46 * emitted when the labels gets clicked
47 */
42 void clicked(); 48 void clicked();
49
50 /**
51 * emitted when the labels gets toggled
52 * @param the new new state of the label
53 */
43 void toggled(bool on); 54 void toggled(bool on);
44 private: 55 private:
45 bool isToggle : 1; 56 bool isToggle : 1;
46 bool isDown : 1; 57 bool isDown : 1;
47 bool textInverted : 1; 58 bool textInverted : 1;
48 59
49 void showState(bool on); 60 void showState(bool on);
50 void setInverted(bool on); 61 void setInverted(bool on);
51}; 62};
52 63
53#endif 64#endif
diff --git a/libopie/ocolorbutton.h b/libopie/ocolorbutton.h
index 338e654..7ff9cd2 100644
--- a/libopie/ocolorbutton.h
+++ b/libopie/ocolorbutton.h
@@ -37,30 +37,36 @@ class QColor;
37/** 37/**
38 * 38 *
39 * @short A Button which will show a OColorPopupMenu 39 * @short A Button which will show a OColorPopupMenu
40 * @author Robert Griebl ( sandman@handhelds.org ) 40 * @author Robert Griebl ( sandman@handhelds.org )
41 * @version 1.0 41 * @version 1.0
42 * @see QPushButton 42 * @see QPushButton
43 */ 43 */
44class OColorButton : public QPushButton { 44class OColorButton : public QPushButton {
45 Q_OBJECT 45 Q_OBJECT
46public: 46public:
47 OColorButton ( QWidget *parent = 0, const QColor & = black, const char *name = 0 ); 47 OColorButton ( QWidget *parent = 0, const QColor & = black, const char *name = 0 );
48 virtual ~OColorButton ( ); 48 virtual ~OColorButton ( );
49 49
50 QColor color ( ) const; 50 QColor color ( ) const;
51 51
52signals: 52signals:
53 /**
54 * emitted when a color gets selected
55 */
53 void colorSelected ( const QColor & ); 56 void colorSelected ( const QColor & );
54 57
55public slots: 58public slots:
56 virtual void setColor ( const QColor & ); 59 virtual void setColor ( const QColor & );
57 60
58protected slots: 61protected slots:
62 /**
63 * @internal
64 */
59 virtual void updateColor ( const QColor & ); 65 virtual void updateColor ( const QColor & );
60 66
61private: 67private:
62 OColorButtonPrivate *d; 68 OColorButtonPrivate *d;
63}; 69};
64 70
65#endif 71#endif
66 72
diff --git a/libopie/odevicebutton.cpp b/libopie/odevicebutton.cpp
index 4b22358..eccb57c 100644
--- a/libopie/odevicebutton.cpp
+++ b/libopie/odevicebutton.cpp
@@ -15,79 +15,79 @@
15** 15**
16** Contact info@trolltech.com if any conditions of this licensing are 16** Contact info@trolltech.com if any conditions of this licensing are
17** not clear to you. 17** not clear to you.
18** 18**
19**********************************************************************/ 19**********************************************************************/
20 20
21#include <qpixmap.h> 21#include <qpixmap.h>
22#include <qstring.h> 22#include <qstring.h>
23 23
24#include <qpe/qcopenvelope_qws.h> 24#include <qpe/qcopenvelope_qws.h>
25#include <opie/odevicebutton.h> 25#include <opie/odevicebutton.h>
26 26
27using namespace Opie; 27using namespace Opie;
28 28
29 29
30class OQCopMessageData { 30class OQCopMessageData {
31 public: 31public:
32 QCString m_channel; 32 QCString m_channel;
33 QCString m_message; 33 QCString m_message;
34 QByteArray m_data; 34 QByteArray m_data;
35}; 35};
36 36
37 37
38OQCopMessage::OQCopMessage ( ) 38OQCopMessage::OQCopMessage ( )
39 : d ( 0 ) 39 : d ( 0 )
40{ 40{
41 init ( QCString ( ), QCString ( ), QByteArray ( )); 41 init ( QCString ( ), QCString ( ), QByteArray ( ));
42} 42}
43 43
44OQCopMessage::OQCopMessage ( const OQCopMessage &copy ) 44OQCopMessage::OQCopMessage ( const OQCopMessage &copy )
45 : d ( 0 ) 45 : d ( 0 )
46{ 46{
47 init ( copy. channel ( ), copy. message ( ), copy. data ( )); 47 init ( copy. channel ( ), copy. message ( ), copy. data ( ));
48} 48}
49 49
50OQCopMessage &OQCopMessage::operator = ( const OQCopMessage &assign ) 50OQCopMessage &OQCopMessage::operator = ( const OQCopMessage &assign )
51{ 51{
52 init ( assign. channel ( ), assign. message ( ), assign. data ( )); 52 init ( assign. channel ( ), assign. message ( ), assign. data ( ));
53 return *this; 53 return *this;
54} 54}
55 55
56OQCopMessage::OQCopMessage ( const QCString &ch, const QCString &m, const QByteArray &arg ) 56OQCopMessage::OQCopMessage ( const QCString &ch, const QCString &m, const QByteArray &arg )
57 : d ( 0 ) 57 : d ( 0 )
58{ 58{
59 init ( ch, m, arg ); 59 init ( ch, m, arg );
60} 60}
61 61
62void OQCopMessage::init ( const QCString &ch, const QCString &m, const QByteArray &arg ) 62void OQCopMessage::init ( const QCString &ch, const QCString &m, const QByteArray &arg )
63{ 63{
64 if ( !d ) 64 if ( !d )
65 d = new OQCopMessageData ( ); 65 d = new OQCopMessageData ( );
66 d-> m_channel = ch; 66 d-> m_channel = ch;
67 d-> m_message = m; 67 d-> m_message = m;
68 d-> m_data = arg; 68 d-> m_data = arg;
69} 69}
70 70
71bool OQCopMessage::send ( ) 71bool OQCopMessage::send ( )
72{ 72{
73 if ( d-> m_channel. isEmpty ( ) || d-> m_message. isEmpty ( ) ) 73 if ( d-> m_channel. isEmpty ( ) || d-> m_message. isEmpty ( ) )
74 return false; 74 return false;
75 75
76 QCopEnvelope e ( d-> m_channel, d-> m_message ); 76 QCopEnvelope e ( d-> m_channel, d-> m_message );
77 77
78 if ( d-> m_data. size ( )) 78 if ( d-> m_data. size ( ))
79 e. writeRawBytes ( d-> m_data. data ( ), d-> m_data. size ( )); 79 e. writeRawBytes ( d-> m_data. data ( ), d-> m_data. size ( ));
80 80
81 return true; 81 return true;
82} 82}
83 83
84QCString OQCopMessage::channel ( ) const 84QCString OQCopMessage::channel ( ) const
85{ 85{
86 return d-> m_channel; 86 return d-> m_channel;
87} 87}
88 88
89QCString OQCopMessage::message ( ) const 89QCString OQCopMessage::message ( ) const
90{ 90{
91 return d-> m_message; 91 return d-> m_message;
92} 92}
93 93
@@ -98,34 +98,34 @@ QByteArray OQCopMessage::data ( ) const
98 98
99void OQCopMessage::setChannel ( const QCString &ch ) 99void OQCopMessage::setChannel ( const QCString &ch )
100{ 100{
101 d-> m_channel = ch; 101 d-> m_channel = ch;
102} 102}
103 103
104void OQCopMessage::setMessage ( const QCString &m ) 104void OQCopMessage::setMessage ( const QCString &m )
105{ 105{
106 d-> m_message = m; 106 d-> m_message = m;
107} 107}
108 108
109void OQCopMessage::setData ( const QByteArray &data ) 109void OQCopMessage::setData ( const QByteArray &data )
110{ 110{
111 d-> m_data = data; 111 d-> m_data = data;
112} 112}
113 113
114/*! \class ODeviceButton 114/*! \class Opie::ODeviceButton
115 \brief The ODeviceButton class represents a physical user mappable button on a Qtopia device. 115 \brief The Opie::ODeviceButton class represents a physical user mappable button on a Qtopia device.
116 116
117 This class represents a physical button on a Qtopia device. A 117 This class represents a physical button on a Qtopia device. A
118 device may have "user programmable" buttons. 118 device may have "user programmable" buttons.
119 The location and number of buttons will vary from device to 119 The location and number of buttons will vary from device to
120 device. userText() and pixmap() may be used to describe this button 120 device. userText() and pixmap() may be used to describe this button
121 to the user in help documentation. 121 to the user in help documentation.
122 122
123 \ingroup qtopiaemb 123 \ingroup qtopiaemb
124 \internal 124 \internal
125*/ 125*/
126 126
127ODeviceButton::ODeviceButton() 127ODeviceButton::ODeviceButton()
128{ 128{
129} 129}
130 130
131ODeviceButton::~ODeviceButton() 131ODeviceButton::~ODeviceButton()
diff --git a/libopie/ofileselector.h b/libopie/ofileselector.h
index 06ac806..d06aa0a 100644
--- a/libopie/ofileselector.h
+++ b/libopie/ofileselector.h
@@ -31,57 +31,60 @@
31 31
32*/ 32*/
33 33
34#ifndef opiefileselector_h 34#ifndef opiefileselector_h
35#define opiefileselector_h 35#define opiefileselector_h
36 36
37#include <qwidget.h> 37#include <qwidget.h>
38#include <qstring.h> 38#include <qstring.h>
39#include <qpixmap.h> 39#include <qpixmap.h>
40#include <qstringlist.h> 40#include <qstringlist.h>
41#include <qmap.h> 41#include <qmap.h>
42#include <qvaluelist.h> 42#include <qvaluelist.h>
43 43
44#include <qpe/applnk.h> 44#include <qpe/applnk.h>
45#include <qlistview.h> 45#include <qlistview.h>
46 46
47/** This is OPIEs FileDialog Widget. You can use it 47
48 * as a dropin replacement of the fileselector and
49 * or use any of the new features.
50 * This is also a complete FileSave and FileLoad widget
51 * If you look for a Dialog check OFileDialog
52 *
53 */
54class DocLnk; 48class DocLnk;
55class QCheckBox; 49class QCheckBox;
56class QComboBox; 50class QComboBox;
57class QPushButton; 51class QPushButton;
58class FileSelector; 52class FileSelector;
59class QGridLayout; 53class QGridLayout;
60class QLineEdit; 54class QLineEdit;
61class QLabel; 55class QLabel;
62class QWidgetStack; 56class QWidgetStack;
63class QHBoxLayout; 57class QHBoxLayout;
64class QVBoxLayout; 58class QVBoxLayout;
65class QPopupMenu; 59class QPopupMenu;
66class QFileInfo; 60class QFileInfo;
67class QHBox; 61class QHBox;
68// 62//
69 63
70typedef QMap< QString, QStringList> MimeTypes; 64typedef QMap< QString, QStringList> MimeTypes;
71 65
66/**
67 * This is OPIEs FileDialog Widget. You can use it
68 * as a dropin replacement of the fileselector and
69 * or use any of the new features.
70 * This is also a complete FileSave and FileLoad widget
71 * If you look for a Dialog check OFileDialog
72 *
73 * NOTE THAT the API will change to be more extendable!
74 */
72class OFileSelector : public QWidget { 75class OFileSelector : public QWidget {
73 Q_OBJECT 76 Q_OBJECT
74 public: 77 public:
75 /** 78 /**
76 * The mode of the file selector 79 * The mode of the file selector
77 * Either open, save, fileselector or dir browsing mode 80 * Either open, save, fileselector or dir browsing mode
78 * 81 *
79 */ 82 */
80 enum Mode {OPEN=1, SAVE=2, FILESELECTOR=4, DIR=8 }; 83 enum Mode {OPEN=1, SAVE=2, FILESELECTOR=4, DIR=8 };
81 84
82 /** 85 /**
83 * Selector. Either NORMAL for the one shipped with 86 * Selector. Either NORMAL for the one shipped with
84 * libqpe or EXTENDED. for the EXTENDED 87 * libqpe or EXTENDED. for the EXTENDED
85 * EXTENDED_ALL also shows 'hidden' files 88 * EXTENDED_ALL also shows 'hidden' files
86 */ 89 */
87 enum Selector{NORMAL=0, EXTENDED = 1, EXTENDED_ALL =2 }; 90 enum Selector{NORMAL=0, EXTENDED = 1, EXTENDED_ALL =2 };
diff --git a/libopie/ofontselector.h b/libopie/ofontselector.h
index 95ffd04..b819c45 100644
--- a/libopie/ofontselector.h
+++ b/libopie/ofontselector.h
@@ -60,34 +60,37 @@ public:
60 60
61 bool setSelectedFont ( const QFont & ); 61 bool setSelectedFont ( const QFont & );
62 bool setSelectedFont ( const QString &family, const QString &style, int size, const QString &charset = 0 ); 62 bool setSelectedFont ( const QString &family, const QString &style, int size, const QString &charset = 0 );
63 63
64 QString fontFamily ( ) const; 64 QString fontFamily ( ) const;
65 QString fontStyle ( ) const; 65 QString fontStyle ( ) const;
66 int fontSize ( ) const; 66 int fontSize ( ) const;
67 QString fontCharSet ( ) const; 67 QString fontCharSet ( ) const;
68 68
69signals: 69signals:
70 /** 70 /**
71 * This signal gets emitted when a font got chosen 71 * This signal gets emitted when a font got chosen
72 */ 72 */
73 void fontSelected ( const QFont & ); 73 void fontSelected ( const QFont & );
74 74
75protected slots: 75protected slots:
76 /** @internal */
76 virtual void fontFamilyClicked ( int ); 77 virtual void fontFamilyClicked ( int );
78 /** @internal */
77 virtual void fontStyleClicked ( int ); 79 virtual void fontStyleClicked ( int );
80 /** @internal */
78 virtual void fontSizeClicked ( int ); 81 virtual void fontSizeClicked ( int );
79 82
80protected: 83protected:
81 virtual void resizeEvent ( QResizeEvent *re ); 84 virtual void resizeEvent ( QResizeEvent *re );
82 85
83private: 86private:
84 void loadFonts ( QListBox * ); 87 void loadFonts ( QListBox * );
85 88
86 void changeFont ( ); 89 void changeFont ( );
87 90
88private: 91private:
89 OFontSelectorPrivate *d; 92 OFontSelectorPrivate *d;
90}; 93};
91 94
92#endif 95#endif
93 96
diff --git a/libopie/oprocess.h b/libopie/oprocess.h
index bf5fe0e..f2853b0 100644
--- a/libopie/oprocess.h
+++ b/libopie/oprocess.h
@@ -33,33 +33,33 @@
33#include <sys/types.h> // for pid_t 33#include <sys/types.h> // for pid_t
34#include <sys/wait.h> 34#include <sys/wait.h>
35#include <signal.h> 35#include <signal.h>
36#include <unistd.h> 36#include <unistd.h>
37#include <qvaluelist.h> 37#include <qvaluelist.h>
38#include <qcstring.h> 38#include <qcstring.h>
39#include <qobject.h> 39#include <qobject.h>
40 40
41class QSocketNotifier; 41class QSocketNotifier;
42class OProcessPrivate; 42class OProcessPrivate;
43 43
44/** 44/**
45 * Child process invocation, monitoring and control. 45 * Child process invocation, monitoring and control.
46 * 46 *
47 * @sect General usage and features 47 * @sect General usage and features
48 * 48 *
49 *This class allows a KDE application to start child processes without having 49 *This class allows a KDE and OPIE application to start child processes without having
50 *to worry about UN*X signal handling issues and zombie process reaping. 50 *to worry about UN*X signal handling issues and zombie process reaping.
51 * 51 *
52 *@see KProcIO 52 *@see KProcIO
53 * 53 *
54 *Basically, this class distinguishes three different ways of running 54 *Basically, this class distinguishes three different ways of running
55 *child processes: 55 *child processes:
56 * 56 *
57 *@li OProcess::DontCare -- The child process is invoked and both the child 57 *@li OProcess::DontCare -- The child process is invoked and both the child
58 *process and the parent process continue concurrently. 58 *process and the parent process continue concurrently.
59 * 59 *
60 *Starting a DontCare child process means that the application is 60 *Starting a DontCare child process means that the application is
61 *not interested in any notification to determine whether the 61 *not interested in any notification to determine whether the
62 *child process has already exited or not. 62 *child process has already exited or not.
63 * 63 *
64 *@li OProcess::NotifyOnExit -- The child process is invoked and both the 64 *@li OProcess::NotifyOnExit -- The child process is invoked and both the
65 *child and the parent process run concurrently. 65 *child and the parent process run concurrently.
@@ -175,33 +175,39 @@ public:
175 * it is finished or aborted. 175 * it is finished or aborted.
176 */ 176 */
177 DontCare, 177 DontCare,
178 /** 178 /**
179 * The application is notified when the subprocess dies. 179 * The application is notified when the subprocess dies.
180 */ 180 */
181 NotifyOnExit, 181 NotifyOnExit,
182 /** 182 /**
183 * The application is suspended until the started process is finished. 183 * The application is suspended until the started process is finished.
184 */ 184 */
185 Block }; 185 Block };
186 186
187 /** 187 /**
188 * Constructor 188 * Constructor
189 */ 189 */
190 OProcess(QObject *parent = 0, const char *name = 0); 190 OProcess(QObject *parent = 0, const char *name = 0);
191 /**
192 * Constructor
193 */
191 OProcess(const QString &arg0, QObject *parent = 0, const char *name = 0); 194 OProcess(const QString &arg0, QObject *parent = 0, const char *name = 0);
195 /**
196 * Constructor
197 */
192 OProcess(const QStringList &args, QObject *parent = 0, const char *name = 0); 198 OProcess(const QStringList &args, QObject *parent = 0, const char *name = 0);
193 199
194 /** 200 /**
195 *Destructor: 201 *Destructor:
196 * 202 *
197 * If the process is running when the destructor for this class 203 * If the process is running when the destructor for this class
198 * is called, the child process is killed with a SIGKILL, but 204 * is called, the child process is killed with a SIGKILL, but
199 * only if the run mode is not of type @p DontCare. 205 * only if the run mode is not of type @p DontCare.
200 * Processes started as @p DontCare keep running anyway. 206 * Processes started as @p DontCare keep running anyway.
201 */ 207 */
202 virtual ~OProcess(); 208 virtual ~OProcess();
203 209
204 /** 210 /**
205 @deprecated 211 @deprecated
206 212
207 The use of this function is now deprecated. -- Please use the 213 The use of this function is now deprecated. -- Please use the
@@ -397,41 +403,41 @@ public:
397 403
398 const QValueList<QCString> &args() { return arguments; } 404 const QValueList<QCString> &args() { return arguments; }
399 405
400 /** 406 /**
401 * Controls whether the started process should drop any 407 * Controls whether the started process should drop any
402 * setuid/segid privileges or whether it should keep them 408 * setuid/segid privileges or whether it should keep them
403 * 409 *
404 * The default is @p false : drop privileges 410 * The default is @p false : drop privileges
405 */ 411 */
406 void setRunPrivileged(bool keepPrivileges); 412 void setRunPrivileged(bool keepPrivileges);
407 413
408 /** 414 /**
409 * Returns whether the started process will drop any 415 * Returns whether the started process will drop any
410 * setuid/segid privileges or whether it will keep them 416 * setuid/segid privileges or whether it will keep them
411 */ 417 */
412 bool runPrivileged() const; 418 bool runPrivileged() const;
413 419
414 /** 420 /**
415 * Modifies the environment of the process to be started. 421 * Modifies the environment of the process to be started.
416 * This function must be called before starting the process. 422 * This function must be called before starting the process.
417 */ 423 */
418 void setEnvironment(const QString &name, const QString &value); 424 void setEnvironment(const QString &name, const QString &value);
419 425
420 /** 426 /**
421 * Changes the current working directory (CWD) of the process 427 * Changes the current working directory (CWD) of the process
422 * to be started. 428 * to be started.
423 * This function must be called before starting the process. 429 * This function must be called before starting the process.
424 */ 430 */
425 void setWorkingDirectory(const QString &dir); 431 void setWorkingDirectory(const QString &dir);
426 432
427 /** 433 /**
428 * Specify whether to start the command via a shell or directly. 434 * Specify whether to start the command via a shell or directly.
429 * The default is to start the command directly. 435 * The default is to start the command directly.
430 * If @p useShell is true @p shell will be used as shell, or 436 * If @p useShell is true @p shell will be used as shell, or
431 * if shell is empty, the standard shell is used. 437 * if shell is empty, the standard shell is used.
432 * @p quote A flag indicating whether to quote the arguments. 438 * @p quote A flag indicating whether to quote the arguments.
433 * 439 *
434 * When using a shell, the caller should make sure that all filenames etc. 440 * When using a shell, the caller should make sure that all filenames etc.
435 * are properly quoted when passed as argument. 441 * are properly quoted when passed as argument.
436 * @see quote() 442 * @see quote()
437 */ 443 */
@@ -439,33 +445,33 @@ public:
439 445
440 /** 446 /**
441 * This function can be used to quote an argument string such that 447 * This function can be used to quote an argument string such that
442 * the shell processes it properly. This is e. g. necessary for 448 * the shell processes it properly. This is e. g. necessary for
443 * user-provided file names which may contain spaces or quotes. 449 * user-provided file names which may contain spaces or quotes.
444 * It also prevents expansion of wild cards and environment variables. 450 * It also prevents expansion of wild cards and environment variables.
445 */ 451 */
446 static QString quote(const QString &arg); 452 static QString quote(const QString &arg);
447 453
448 /** 454 /**
449 * Detaches OProcess from child process. All communication is closed. 455 * Detaches OProcess from child process. All communication is closed.
450 * No exit notification is emitted any more for the child process. 456 * No exit notification is emitted any more for the child process.
451 * Deleting the OProcess will no longer kill the child process. 457 * Deleting the OProcess will no longer kill the child process.
452 * Note that the current process remains the parent process of the 458 * Note that the current process remains the parent process of the
453 * child process. 459 * child process.
454 */ 460 */
455 void detach(); 461 void detach();
456 462
457 463
458 464
459signals: 465signals:
460 466
461 /** 467 /**
462 * Emitted after the process has terminated when 468 * Emitted after the process has terminated when
463 * the process was run in the @p NotifyOnExit (==default option to 469 * the process was run in the @p NotifyOnExit (==default option to
464 * @ref start()) or the @ref Block mode. 470 * @ref start()) or the @ref Block mode.
465 **/ 471 **/
466 void processExited(OProcess *proc); 472 void processExited(OProcess *proc);
467 473
468 474
469 /** 475 /**
470 * Emitted, when output from the child process has 476 * Emitted, when output from the child process has
471 * been received on stdout. 477 * been received on stdout.
@@ -473,41 +479,41 @@ signals:
473 * To actually get 479 * To actually get
474 * these signals, the respective communication link (stdout/stderr) 480 * these signals, the respective communication link (stdout/stderr)
475 * has to be turned on in @ref start(). 481 * has to be turned on in @ref start().
476 * 482 *
477 * @param buffer The data received. 483 * @param buffer The data received.
478 * @param buflen The number of bytes that are available. 484 * @param buflen The number of bytes that are available.
479 * 485 *
480 * You should copy the information contained in @p buffer to your private 486 * You should copy the information contained in @p buffer to your private
481 * data structures before returning from this slot. 487 * data structures before returning from this slot.
482 **/ 488 **/
483 void receivedStdout(OProcess *proc, char *buffer, int buflen); 489 void receivedStdout(OProcess *proc, char *buffer, int buflen);
484 490
485 /** 491 /**
486 * Emitted when output from the child process has 492 * Emitted when output from the child process has
487 * been received on stdout. 493 * been received on stdout.
488 * 494 *
489 * To actually get these signals, the respective communications link 495 * To actually get these signals, the respective communications link
490 * (stdout/stderr) has to be turned on in @ref start() and the 496 * (stdout/stderr) has to be turned on in @ref start() and the
491 * @p NoRead flag should have been passed. 497 * @p NoRead flag should have been passed.
492 * 498 *
493 * You will need to explicitly call resume() after your call to start() 499 * You will need to explicitly call resume() after your call to start()
494 * to begin processing data from the child process's stdout. This is 500 * to begin processing data from the child process's stdout. This is
495 * to ensure that this signal is not emitted when no one is connected 501 * to ensure that this signal is not emitted when no one is connected
496 * to it, otherwise this signal will not be emitted. 502 * to it, otherwise this signal will not be emitted.
497 * 503 *
498 * The data still has to be read from file descriptor @p fd. 504 * The data still has to be read from file descriptor @p fd.
499 **/ 505 **/
500 void receivedStdout(int fd, int &len); 506 void receivedStdout(int fd, int &len);
501 507
502 508
503 /** 509 /**
504 * Emitted, when output from the child process has 510 * Emitted, when output from the child process has
505 * been received on stderr. 511 * been received on stderr.
506 * To actually get 512 * To actually get
507 * these signals, the respective communication link (stdout/stderr) 513 * these signals, the respective communication link (stdout/stderr)
508 * has to be turned on in @ref start(). 514 * has to be turned on in @ref start().
509 * 515 *
510 * @param buffer The data received. 516 * @param buffer The data received.
511 * @param buflen The number of bytes that are available. 517 * @param buflen The number of bytes that are available.
512 * 518 *
513 * You should copy the information contained in @p buffer to your private 519 * You should copy the information contained in @p buffer to your private
@@ -537,33 +543,33 @@ protected slots:
537 */ 543 */
538 void slotChildError(int fdno); 544 void slotChildError(int fdno);
539 /* 545 /*
540 Slot functions for capturing stdout and stderr of the child 546 Slot functions for capturing stdout and stderr of the child
541 */ 547 */
542 548
543 /** 549 /**
544 * Called when another bulk of data can be sent to the child's 550 * Called when another bulk of data can be sent to the child's
545 * stdin. If there is no more data to be sent to stdin currently 551 * stdin. If there is no more data to be sent to stdin currently
546 * available, this function must disable the QSocketNotifier "innot". 552 * available, this function must disable the QSocketNotifier "innot".
547 */ 553 */
548 void slotSendData(int dummy); 554 void slotSendData(int dummy);
549 555
550protected: 556protected:
551 557
552 /** 558 /**
553 * Sets up the environment according to the data passed via 559 * Sets up the environment according to the data passed via
554 * setEnvironment(...) 560 * setEnvironment(...)
555 */ 561 */
556 void setupEnvironment(); 562 void setupEnvironment();
557 563
558 /** 564 /**
559 * The list of the process' command line arguments. The first entry 565 * The list of the process' command line arguments. The first entry
560 * in this list is the executable itself. 566 * in this list is the executable itself.
561 */ 567 */
562 QValueList<QCString> arguments; 568 QValueList<QCString> arguments;
563 /** 569 /**
564 * How to run the process (Block, NotifyOnExit, DontCare). You should 570 * How to run the process (Block, NotifyOnExit, DontCare). You should
565 * not modify this data member directly from derived classes. 571 * not modify this data member directly from derived classes.
566 */ 572 */
567 RunMode run_mode; 573 RunMode run_mode;
568 /** 574 /**
569 * true if the process is currently running. You should not 575 * true if the process is currently running. You should not
@@ -699,33 +705,33 @@ protected:
699 705
700 // information about the data that has to be sent to the child: 706 // information about the data that has to be sent to the child:
701 707
702 const char *input_data; // the buffer holding the data 708 const char *input_data; // the buffer holding the data
703 int input_sent; // # of bytes already transmitted 709 int input_sent; // # of bytes already transmitted
704 int input_total; // total length of input_data 710 int input_total; // total length of input_data
705 711
706 /** 712 /**
707 * @ref OProcessController is a friend of OProcess because it has to have 713 * @ref OProcessController is a friend of OProcess because it has to have
708 * access to various data members. 714 * access to various data members.
709 */ 715 */
710 friend class OProcessController; 716 friend class OProcessController;
711 717
712 718
713private: 719private:
714 /** 720 /**
715 * Searches for a valid shell. 721 * Searches for a valid shell.
716 * Here is the algorithm used for finding an executable shell: 722 * Here is the algorithm used for finding an executable shell:
717 * 723 *
718 * @li Try the executable pointed to by the "SHELL" environment 724 * @li Try the executable pointed to by the "SHELL" environment
719 * variable with white spaces stripped off 725 * variable with white spaces stripped off
720 * 726 *
721 * @li If your process runs with uid != euid or gid != egid, a shell 727 * @li If your process runs with uid != euid or gid != egid, a shell
722 * not listed in /etc/shells will not used. 728 * not listed in /etc/shells will not used.
723 * 729 *
724 * @li If no valid shell could be found, "/bin/sh" is used as a last resort. 730 * @li If no valid shell could be found, "/bin/sh" is used as a last resort.
725 */ 731 */
726 QCString searchShell(); 732 QCString searchShell();
727 733
728 /** 734 /**
729 * Used by @ref searchShell in order to find out whether the shell found 735 * Used by @ref searchShell in order to find out whether the shell found
730 * is actually executable at all. 736 * is actually executable at all.
731 */ 737 */
diff --git a/libopie/orecurrancewidget.h b/libopie/orecurrancewidget.h
index af87ce9..a5d6489 100644
--- a/libopie/orecurrancewidget.h
+++ b/libopie/orecurrancewidget.h
@@ -33,33 +33,39 @@ class ORecurranceWidget : public ORecurranceBase {
33 Q_OBJECT 33 Q_OBJECT
34public: 34public:
35 ORecurranceWidget( bool startOnMonday, 35 ORecurranceWidget( bool startOnMonday,
36 const QDate& start, QWidget* parent = 0, 36 const QDate& start, QWidget* parent = 0,
37 const char* name = 0, bool modal = TRUE, 37 const char* name = 0, bool modal = TRUE,
38 WFlags fl = 0 ); 38 WFlags fl = 0 );
39 ORecurranceWidget( bool startOnMonday, 39 ORecurranceWidget( bool startOnMonday,
40 const ORecur& rp, const QDate& start, 40 const ORecur& rp, const QDate& start,
41 QWidget* parent = 0, const char* name =0, 41 QWidget* parent = 0, const char* name =0,
42 bool modal = TRUE, WFlags = 0 ); 42 bool modal = TRUE, WFlags = 0 );
43 ~ORecurranceWidget(); 43 ~ORecurranceWidget();
44 ORecur recurrence()const; 44 ORecur recurrence()const;
45 QDate endDate()const; 45 QDate endDate()const;
46 46
47public slots: 47public slots:
48 void slotSetRType( int ); 48 void slotSetRType( int );
49 /**
50 * set the new end date
51 */
49 void endDateChanged( int, int, int ); 52 void endDateChanged( int, int, int );
53 /**
54 * enable/disable end date
55 */
50 void slotNoEnd( bool unused ); 56 void slotNoEnd( bool unused );
51 void setStartDate( const QDate& ); 57 void setStartDate( const QDate& );
52 void setRecurrence( const ORecur& recur, const QDate& start ); 58 void setRecurrence( const ORecur& recur, const QDate& start );
53 void setRecurrence( const ORecur& recur ); 59 void setRecurrence( const ORecur& recur );
54 60
55private slots: 61private slots:
56 void setupRepeatLabel( const QString& ); 62 void setupRepeatLabel( const QString& );
57 void setupRepeatLabel( int ); 63 void setupRepeatLabel( int );
58 void slotWeekLabel(); 64 void slotWeekLabel();
59 void slotMonthLabel( int ); 65 void slotMonthLabel( int );
60 void slotChangeStartOfWeek( bool onMonday ); 66 void slotChangeStartOfWeek( bool onMonday );
61 67
62private: 68private:
63 void setupNone(); 69 void setupNone();
64 void setupDaily(); 70 void setupDaily();
65 void setupWeekly(); 71 void setupWeekly();
diff --git a/libopie/otabbar.h b/libopie/otabbar.h
index c413611..0b353e2 100644
--- a/libopie/otabbar.h
+++ b/libopie/otabbar.h
@@ -49,28 +49,28 @@ class OTabBar : public QTabBar
49 49
50public: 50public:
51/** 51/**
52 * @fn OTabBar( QWidget *parent = 0, const char *name = 0 ) 52 * @fn OTabBar( QWidget *parent = 0, const char *name = 0 )
53 * @brief Object constructor. 53 * @brief Object constructor.
54 * 54 *
55 * @param parent Pointer to parent of this control. 55 * @param parent Pointer to parent of this control.
56 * @param name Name of control. 56 * @param name Name of control.
57 * 57 *
58 * Constructs a new OTabBar control with parent and name. 58 * Constructs a new OTabBar control with parent and name.
59 */ 59 */
60 // FIXME Allow WFlags? -zecke 60 // FIXME Allow WFlags? -zecke
61 OTabBar( QWidget * = 0, const char * = 0 ); 61 OTabBar( QWidget * = 0, const char * = 0 );
62 62
63protected: 63protected:
64/** 64/**
65 * @fn paintLabel( QPainter* p, const QRect& br, QTab* t, bool has_focus ) 65 * @fn paintLabel( QPainter* p, const QRect& br , QTab* t, bool has_focus)const
66 * @brief Internal function to draw a tab's label. 66 * @brief Internal function to draw a tab's label.
67 * 67 *
68 * @param p Pointer to QPainter used for drawing. 68 * @param p Pointer to QPainter used for drawing.
69 * @param br QRect providing region to draw label in. 69 * @param br QRect providing region to draw label in.
70 * @param t Tab to draw label for. 70 * @param t Tab to draw label for.
71 * @param has_focus Boolean value not used, retained for compatibility reasons. 71 * @param has_focus Boolean value not used, retained for compatibility reasons.
72 */ 72 */
73 void paintLabel( QPainter *, const QRect &, QTab *, bool ) const; 73 void paintLabel( QPainter *, const QRect &, QTab *, bool ) const;
74}; 74};
75 75
76#endif 76#endif
diff --git a/libopie/otabinfo.h b/libopie/otabinfo.h
index 6589638..eebaf8e 100644
--- a/libopie/otabinfo.h
+++ b/libopie/otabinfo.h
@@ -64,59 +64,59 @@ public:
64 */ 64 */
65 OTabInfo() : i( -1 ), c( 0 ), p( 0 ), l( QString::null ) {} 65 OTabInfo() : i( -1 ), c( 0 ), p( 0 ), l( QString::null ) {}
66 66
67/** 67/**
68 * @fn OTabInfo( int id, QWidget *control, const QString &icon, const QString &label ) 68 * @fn OTabInfo( int id, QWidget *control, const QString &icon, const QString &label )
69 * @brief Object constructor. 69 * @brief Object constructor.
70 * 70 *
71 * @param id TabBar identifier for widget. 71 * @param id TabBar identifier for widget.
72 * @param control QWidget pointer to widget. 72 * @param control QWidget pointer to widget.
73 * @param icon QString name of icon file. 73 * @param icon QString name of icon file.
74 * @param label QString text label for OTabWidget selection control. 74 * @param label QString text label for OTabWidget selection control.
75 */ 75 */
76 OTabInfo( int id, QWidget *control, const QString &icon, const QString &label ) 76 OTabInfo( int id, QWidget *control, const QString &icon, const QString &label )
77 : i( id ), c( control ), p( icon ), l( label ) {} 77 : i( id ), c( control ), p( icon ), l( label ) {}
78 78
79/** 79/**
80 * @fn id() 80 * @fn id()const
81 * @brief Returns TabBar ID. 81 * @brief Returns TabBar ID.
82 */ 82 */
83 int id() const { return i; } 83 int id() const { return i; }
84 84
85/** 85/**
86 * @fn label() 86 * @fn label()const
87 * @brief Returns text label for widget. 87 * @brief Returns text label for widget.
88 */ 88 */
89 const QString &label() const { return l; } 89 const QString &label() const { return l; }
90 90
91/** 91/**
92 * @fn setLabel( const QString &label ) 92 * @fn setLabel( const QString &label )
93 * @brief Set label for tab. 93 * @brief Set label for tab.
94 * 94 *
95 * @param label QString text label for OTabWidget selection control. 95 * @param label QString text label for OTabWidget selection control.
96 */ 96 */
97 void setLabel( const QString &label ) { l = label; } 97 void setLabel( const QString &label ) { l = label; }
98 98
99/** 99/**
100 * @fn control() 100 * @fn control()const
101 * @brief Returns pointer to widget. 101 * @brief Returns pointer to widget.
102 */ 102 */
103 QWidget *control() const { return c; } 103 QWidget *control() const { return c; }
104 104
105/** 105/**
106 * @fn icon() 106 * @fn icon()const
107 * @brief Returns name of icon file. 107 * @brief Returns name of icon file.
108 */ 108 */
109 const QString &icon() const { return p; } 109 const QString &icon() const { return p; }
110 110
111/** 111/**
112 * @fn setIcon( const QString &icon ) 112 * @fn setIcon( const QString &icon )
113 * @brief Set icon for tab. 113 * @brief Set icon for tab.
114 * 114 *
115 * @param icon QString name of icon file. 115 * @param icon QString name of icon file.
116 */ 116 */
117 void setIcon( const QString &icon ) { p = icon; } 117 void setIcon( const QString &icon ) { p = icon; }
118 118
119private: 119private:
120 int i; 120 int i;
121 QWidget *c; 121 QWidget *c;
122 QString p; 122 QString p;
diff --git a/libopie/otabwidget.h b/libopie/otabwidget.h
index bcd9a85..a67fe06 100644
--- a/libopie/otabwidget.h
+++ b/libopie/otabwidget.h
@@ -114,57 +114,57 @@ public:
114 * 114 *
115 * @param child Widget control. 115 * @param child Widget control.
116 * @param icon Path to icon. 116 * @param icon Path to icon.
117 * @param label Text label. 117 * @param label Text label.
118 */ 118 */
119 void addTab( QWidget *, const QString &, const QString & ); 119 void addTab( QWidget *, const QString &, const QString & );
120 120
121/** 121/**
122 * @fn removePage( QWidget *widget ) 122 * @fn removePage( QWidget *widget )
123 * @brief Remove widget from control. Does not delete widget. 123 * @brief Remove widget from control. Does not delete widget.
124 * 124 *
125 * @param widget Widget control to be removed. 125 * @param widget Widget control to be removed.
126 */ 126 */
127 void removePage( QWidget * ); 127 void removePage( QWidget * );
128 128
129/** 129/**
130 * @fn changeTab( QWidget *widget, const QIconSet &icon, const QString &label ) 130 * @fn changeTab( QWidget *widget, const QString &icon, const QString &label )
131 * @brief Change text and/or icon for existing tab 131 * @brief Change text and/or icon for existing tab
132 * 132 *
133 * @param child Widget control. 133 * @param child Widget control.
134 * @param icon Path to icon. 134 * @param icon Path to icon.
135 * @param label Text label. 135 * @param label Text label.
136 */ 136 */
137 void changeTab( QWidget *, const QString &, const QString & ); 137 void changeTab( QWidget *, const QString &, const QString & );
138 138
139/** 139/**
140 * @fn tabStyle() 140 * @fn tabStyle()const
141 * @brief Returns current widget selection control style. 141 * @brief Returns current widget selection control style.
142 */ 142 */
143 TabStyle tabStyle() const; 143 TabStyle tabStyle() const;
144 144
145/** 145/**
146 * @fn setTabStyle( TabStyle s ) 146 * @fn setTabStyle( TabStyle s )
147 * @brief Set the current widget selection control style. 147 * @brief Set the current widget selection control style.
148 * 148 *
149 * @param s New style to be used. 149 * @param s New style to be used.
150 */ 150 */
151 void setTabStyle( TabStyle ); 151 void setTabStyle( TabStyle );
152 152
153/** 153/**
154 * @fn tabPosition() 154 * @fn tabPosition()const
155 * @brief Returns current widget selection control position. 155 * @brief Returns current widget selection control position.
156 */ 156 */
157 TabPosition tabPosition() const; 157 TabPosition tabPosition() const;
158 158
159/** 159/**
160 * @fn setTabPosition( TabPosition p ) 160 * @fn setTabPosition( TabPosition p )
161 * @brief Set the current widget selection control position. 161 * @brief Set the current widget selection control position.
162 * 162 *
163 * @param p New position of widget selection control. 163 * @param p New position of widget selection control.
164 */ 164 */
165 void setTabPosition( TabPosition ); 165 void setTabPosition( TabPosition );
166 166
167/** 167/**
168 * @fn setCurrentTab( QWidget *childwidget ) 168 * @fn setCurrentTab( QWidget *childwidget )
169 * @brief Selects and brings to top the desired widget by using widget pointer. 169 * @brief Selects and brings to top the desired widget by using widget pointer.
170 * 170 *
@@ -176,33 +176,33 @@ public:
176 * @fn setCurrentTab( const QString &tabname ) 176 * @fn setCurrentTab( const QString &tabname )
177 * @brief Selects and brings to top the desired widget, by using label. 177 * @brief Selects and brings to top the desired widget, by using label.
178 * 178 *
179 * @param tabname Text label for widget to select. 179 * @param tabname Text label for widget to select.
180 */ 180 */
181 void setCurrentTab( const QString & ); 181 void setCurrentTab( const QString & );
182 182
183/** 183/**
184 * @fn setCurrentTab( int ) 184 * @fn setCurrentTab( int )
185 * @brief Selects and brings to top the desired widget, by using id. 185 * @brief Selects and brings to top the desired widget, by using id.
186 * 186 *
187 * @param tab id for widget to select. 187 * @param tab id for widget to select.
188 */ 188 */
189 void setCurrentTab(int); 189 void setCurrentTab(int);
190 190
191/** 191/**
192 * @fn sizeHint() 192 * @fn sizeHint()const
193 * @brief Reimplemented for internal purposes. 193 * @brief Reimplemented for internal purposes.
194 */ 194 */
195 QSize sizeHint() const; 195 QSize sizeHint() const;
196 196
197/** 197/**
198 * @fn currentTab( ) 198 * @fn currentTab( )
199 * @brief returns current tab id. 199 * @brief returns current tab id.
200 */ 200 */
201 int currentTab(); 201 int currentTab();
202 202
203 203
204protected: 204protected:
205 205
206/** 206/**
207 * @fn resizeEvent( QResizeEvent * ) 207 * @fn resizeEvent( QResizeEvent * )
208 * @brief Reimplemented for internal purposes. 208 * @brief Reimplemented for internal purposes.
@@ -231,33 +231,33 @@ private:
231 QPixmap loadSmooth( const QString & ); 231 QPixmap loadSmooth( const QString & );
232 232
233/** 233/**
234 * @fn selectTab( OTabInfo *tab ) 234 * @fn selectTab( OTabInfo *tab )
235 * @brief Internal function to select desired widget. 235 * @brief Internal function to select desired widget.
236 * 236 *
237 * @param tab Pointer to data for widget. 237 * @param tab Pointer to data for widget.
238 */ 238 */
239 void selectTab( OTabInfo * ); 239 void selectTab( OTabInfo * );
240 240
241/** 241/**
242 * @fn setUpLayout() 242 * @fn setUpLayout()
243 * @brief Internal function to adjust layout. 243 * @brief Internal function to adjust layout.
244 */ 244 */
245 void setUpLayout(); 245 void setUpLayout();
246 246
247 247
248signals: 248signals:
249/** 249/**
250 * @fn currentChanegd( QWidget *widget ) 250 * @fn currentChanegd( QWidget *widget )
251 * @brief This signal is emitted whenever the widget has changed. 251 * @brief This signal is emitted whenever the widget has changed.
252 * 252 *
253 * @param widget Pointer to new current widget. 253 * @param widget Pointer to new current widget.
254 */ 254 */
255 void currentChanged( QWidget * ); 255 void currentChanged( QWidget * );
256 256
257private slots: 257private slots:
258 258
259/** 259/**
260 * @fn slotTabBarSelected( int id ) 260 * @fn slotTabBarSelected( int id )
261 * @brief Slot which is called when a tab is selected. 261 * @brief Slot which is called when a tab is selected.
262 * 262 *
263 * @param id ID of widget selected. 263 * @param id ID of widget selected.
diff --git a/libopie/oticker.h b/libopie/oticker.h
index 30b7517..c848654 100644
--- a/libopie/oticker.h
+++ b/libopie/oticker.h
@@ -53,44 +53,45 @@ public:
53 53
54/*! 54/*!
55 * @fn OTicker( QWidget* parent = 0 ) 55 * @fn OTicker( QWidget* parent = 0 )
56 * @brief Object constructor. 56 * @brief Object constructor.
57 * 57 *
58 * @param parent Pointer to parent of this control. 58 * @param parent Pointer to parent of this control.
59 59
60 * Constructs a new OTicker control with parent 60 * Constructs a new OTicker control with parent
61 */ 61 */
62 OTicker( QWidget* parent=0 ); 62 OTicker( QWidget* parent=0 );
63/*! 63/*!
64 * @fn ~OTicker() 64 * @fn ~OTicker()
65 * @brief Object destructor. 65 * @brief Object destructor.
66 */ 66 */
67 ~OTicker(); 67 ~OTicker();
68/*! 68/*!
69 * @fn setText() 69 * @fn setText(const QString& )
70 * @brief sets text to be displayed 70 * @brief sets text to be displayed
71 * @param text QString text to be displayed. 71 * @param text QString text to be displayed.
72 * 72 *
73 */ 73 */
74 void setText( const QString& text ) ; 74 void setText( const QString& text ) ;
75/*! 75/*!
76 * @fn setBackgroundColor(QColor color) 76 * @fn setBackgroundColor(QColor color)
77 * @brief sets color of the ticker's background 77 * @brief sets color of the ticker's background
78 * @param color QColor color to be set. 78 * @param color QColor color to be set.
79 * 79 *
80 */ 80 */
81 //FIXME const QColor& please -zecke
81 void setBackgroundColor(QColor color); 82 void setBackgroundColor(QColor color);
82/*! 83/*!
83 * @fn setForegroundColor(QColor color) 84 * @fn setForegroundColor(QColor color)
84 * @brief sets color of text 85 * @brief sets color of text
85 * @param color QColor color of text 86 * @param color QColor color of text
86 * 87 *
87 */ 88 */
88 void setForegroundColor(QColor color); 89 void setForegroundColor(QColor color);
89/*! 90/*!
90 * @fn setFrame(int style) 91 * @fn setFrame(int style)
91 * @brief sets frame style 92 * @brief sets frame style
92 * @param style int Frame style to be see. See Qt::WidgetFlags. 93 * @param style int Frame style to be see. See Qt::WidgetFlags.
93 * 94 *
94 */ 95 */
95 void setFrame(int style); 96 void setFrame(int style);
96/*! 97/*!
diff --git a/libopie/otimepicker.h b/libopie/otimepicker.h
index 495c806..d501a95 100644
--- a/libopie/otimepicker.h
+++ b/libopie/otimepicker.h
@@ -13,63 +13,63 @@
13 * A class to pick time. It uses clickable labels 13 * A class to pick time. It uses clickable labels
14 * internally to allow a quick selection of a time. 14 * internally to allow a quick selection of a time.
15 * A time can be selected by two clicks of a user 15 * A time can be selected by two clicks of a user
16 * 16 *
17 * @short A widget to quickly pick a QTime 17 * @short A widget to quickly pick a QTime
18 * @version 1.0 18 * @version 1.0
19 * @see QWidget 19 * @see QWidget
20 * @see QTime 20 * @see QTime
21 * @author Hakan Ardo, Stefan Eilers 21 * @author Hakan Ardo, Stefan Eilers
22 */ 22 */
23class OTimePicker: public QWidget { 23class OTimePicker: public QWidget {
24 Q_OBJECT 24 Q_OBJECT
25 25
26 public: 26 public:
27 OTimePicker(QWidget* parent = 0, const char* name = 0, 27 OTimePicker(QWidget* parent = 0, const char* name = 0,
28 WFlags fl = 0); 28 WFlags fl = 0);
29 29
30 public slots: 30 public slots:
31 void setHour(int h); 31 void setHour(int h);
32 void setMinute(int m); 32 void setMinute(int m);
33 void setTime( const QTime& ); 33 void setTime( const QTime& );
34 void setTime( int h, int m ); 34 void setTime( int h, int m );
35 35
36 public: 36 public:
37 QTime time()const; 37 QTime time()const;
38 38
39 private: 39 private:
40 QValueList<OClickableLabel *> hourLst; 40 QValueList<OClickableLabel *> hourLst;
41 QValueList<OClickableLabel *> minuteLst; 41 QValueList<OClickableLabel *> minuteLst;
42 QTime tm; 42 QTime tm;
43 struct Private; 43 struct Private;
44 Private *d; 44 Private *d;
45 45
46 private slots: 46 private slots:
47 void slotHour(bool b); 47 void slotHour(bool b);
48 void slotMinute(bool b); 48 void slotMinute(bool b);
49 49
50 signals: 50 signals:
51 /** 51 /**
52 * gets emitted when the time got changed by the user 52 * gets emitted when the time got changed by the user
53 */ 53 */
54 void timeChanged(const QTime &); 54 void timeChanged(const QTime &);
55}; 55};
56 56
57/** 57/**
58 * 58 *
59 * @short 59 * @short A small dialog to pick a time
60 * @version 1.0 60 * @version 1.0
61 * @author Stefan Eilers 61 * @author Stefan Eilers
62 */ 62 */
63 63
64class OTimePickerDialog: public OTimePickerDialogBase { 64class OTimePickerDialog: public OTimePickerDialogBase {
65 Q_OBJECT 65 Q_OBJECT
66 66
67 public: 67 public:
68 OTimePickerDialog ( QWidget* parent = 0, const char* name = NULL, WFlags fl = 0 ); 68 OTimePickerDialog ( QWidget* parent = 0, const char* name = NULL, WFlags fl = 0 );
69 ~OTimePickerDialog() { }; 69 ~OTimePickerDialog() { };
70 70
71 QTime time()const; 71 QTime time()const;
72 72
73 public slots: 73 public slots:
74 void setTime( const QTime& time ); 74 void setTime( const QTime& time );
75 void setHour( const QString& hour ); 75 void setHour( const QString& hour );
diff --git a/libopie/todayconfigwidget.h b/libopie/todayconfigwidget.h
index 6b49efc..f3501a1 100644
--- a/libopie/todayconfigwidget.h
+++ b/libopie/todayconfigwidget.h
@@ -11,29 +11,29 @@
11 * The Plugin should read its configuration during creation of the Widget 11 * The Plugin should read its configuration during creation of the Widget
12 * 12 *
13 * 13 *
14 * @author Maximilian Reiß 14 * @author Maximilian Reiß
15 * @short base class of all today config widgets 15 * @short base class of all today config widgets
16 */ 16 */
17class TodayConfigWidget : public QWidget { 17class TodayConfigWidget : public QWidget {
18 18
19 19
20public: 20public:
21 21
22 /** 22 /**
23 * This will construct the widget. The widget gets deleted once the parent 23 * This will construct the widget. The widget gets deleted once the parent
24 * gets deleted as in any Qt application 24 * gets deleted as in any Qt application
25 * 25 *
26 * @param parent The parent of the widget 26 * @param parent The parent of the widget
27 * @paran name The name of the object 27 * @param name The name of the object
28 */ 28 */
29 TodayConfigWidget( QWidget *parent, const char *name ) : QWidget( parent, name ) {} ; 29 TodayConfigWidget( QWidget *parent, const char *name ) : QWidget( parent, name ) {} ;
30 virtual ~TodayConfigWidget() {}; 30 virtual ~TodayConfigWidget() {};
31 31
32 /** 32 /**
33 * Plugins need to reimplement this in the config widget 33 * Plugins need to reimplement this in the config widget
34 * Used when the config dialog is closed to write config stuff 34 * Used when the config dialog is closed to write config stuff
35 */ 35 */
36 virtual void writeConfig() = 0; 36 virtual void writeConfig() = 0;
37}; 37};
38 38
39#endif 39#endif
diff --git a/libopie/todayplugininterface.h b/libopie/todayplugininterface.h
index 29a12bc..532f492 100644
--- a/libopie/todayplugininterface.h
+++ b/libopie/todayplugininterface.h
@@ -87,20 +87,23 @@ public:
87 /** 87 /**
88 * minimum height the plugin at least should have 88 * minimum height the plugin at least should have
89 */ 89 */
90 // virtual int minHeight() const = 0; 90 // virtual int minHeight() const = 0;
91 91
92 /** 92 /**
93 * maximum height that should be used before starting scrolling 93 * maximum height that should be used before starting scrolling
94 */ 94 */
95 // virtual int maxHeight() const = 0; 95 // virtual int maxHeight() const = 0;
96 96
97}; 97};
98 98
99/** 99/**
100 * This is part of the QCOM works. See example plugins how to do it right 100 * This is part of the QCOM works. See example plugins how to do it right
101 */ 101 */
102struct TodayPluginInterface : public QUnknownInterface { 102struct TodayPluginInterface : public QUnknownInterface {
103 /**
104 * return the TodayPluginObject implementation
105 */
103 virtual TodayPluginObject *guiPart() = 0; 106 virtual TodayPluginObject *guiPart() = 0;
104}; 107};
105 108
106#endif 109#endif