summaryrefslogtreecommitdiff
path: root/libopie
Unidiff
Diffstat (limited to 'libopie') (more/less context) (ignore whitespace changes)
-rw-r--r--libopie/otabwidget.cpp9
-rw-r--r--libopie/otabwidget.h11
2 files changed, 18 insertions, 2 deletions
diff --git a/libopie/otabwidget.cpp b/libopie/otabwidget.cpp
index fe2c60f..1b8c085 100644
--- a/libopie/otabwidget.cpp
+++ b/libopie/otabwidget.cpp
@@ -27,384 +27,393 @@
27 Inc., 59 Temple Place - Suite 330, 27 Inc., 59 Temple Place - Suite 330,
28 Boston, MA 02111-1307, USA. 28 Boston, MA 02111-1307, USA.
29 29
30*/ 30*/
31 31
32#include "otabwidget.h" 32#include "otabwidget.h"
33 33
34#include <qpe/config.h> 34#include <qpe/config.h>
35#include <qpe/resource.h> 35#include <qpe/resource.h>
36#include <opie/otabbar.h> 36#include <opie/otabbar.h>
37 37
38#include <qcombobox.h> 38#include <qcombobox.h>
39#include <qwidgetstack.h> 39#include <qwidgetstack.h>
40 40
41OTabWidget::OTabWidget( QWidget *parent, const char *name, TabStyle s, TabPosition p ) 41OTabWidget::OTabWidget( QWidget *parent, const char *name, TabStyle s, TabPosition p )
42 : QWidget( parent, name ) 42 : QWidget( parent, name )
43{ 43{
44 if ( s == Global ) 44 if ( s == Global )
45 { 45 {
46 Config config( "qpe" ); 46 Config config( "qpe" );
47 config.setGroup( "Appearance" ); 47 config.setGroup( "Appearance" );
48 s = ( TabStyle ) config.readNumEntry( "TabStyle", (int) IconTab ); 48 s = ( TabStyle ) config.readNumEntry( "TabStyle", (int) IconTab );
49 if ( s <= Global || s > IconList) 49 if ( s <= Global || s > IconList)
50 { 50 {
51 s = IconTab; 51 s = IconTab;
52 } 52 }
53 QString pos = config.readEntry( "TabPosition", "Top"); 53 QString pos = config.readEntry( "TabPosition", "Top");
54 if ( pos == "Bottom" ) 54 if ( pos == "Bottom" )
55 { 55 {
56 p = Bottom; 56 p = Bottom;
57 } 57 }
58 else 58 else
59 { 59 {
60 p = Top; 60 p = Top;
61 } 61 }
62 } 62 }
63 63
64 widgetStack = new QWidgetStack( this, "widgetstack" ); 64 widgetStack = new QWidgetStack( this, "widgetstack" );
65 widgetStack->setFrameStyle( QFrame::NoFrame ); 65 widgetStack->setFrameStyle( QFrame::NoFrame );
66 widgetStack->setLineWidth( style().defaultFrameWidth() ); 66 widgetStack->setLineWidth( style().defaultFrameWidth() );
67 67
68 tabBarStack = new QWidgetStack( this, "tabbarstack" ); 68 tabBarStack = new QWidgetStack( this, "tabbarstack" );
69 69
70 tabBar = new OTabBar( tabBarStack, "tabbar" ); 70 tabBar = new OTabBar( tabBarStack, "tabbar" );
71 tabBarStack->addWidget( tabBar, 0 ); 71 tabBarStack->addWidget( tabBar, 0 );
72 connect( tabBar, SIGNAL( selected( int ) ), this, SLOT( slotTabBarSelected( int ) ) ); 72 connect( tabBar, SIGNAL( selected( int ) ), this, SLOT( slotTabBarSelected( int ) ) );
73 73
74 tabList = new QComboBox( false, tabBarStack, "tablist" ); 74 tabList = new QComboBox( false, tabBarStack, "tablist" );
75 tabBarStack->addWidget( tabList, 1 ); 75 tabBarStack->addWidget( tabList, 1 );
76 connect( tabList, SIGNAL( activated( int ) ), this, SLOT( slotTabListSelected( int ) ) ); 76 connect( tabList, SIGNAL( activated( int ) ), this, SLOT( slotTabListSelected( int ) ) );
77 77
78 tabBarPosition = p; 78 tabBarPosition = p;
79 setTabStyle( s ); 79 setTabStyle( s );
80 setTabPosition( p ); 80 setTabPosition( p );
81 81
82 currTab= 0x0; 82 currTab= 0x0;
83} 83}
84 84
85OTabWidget::~OTabWidget() 85OTabWidget::~OTabWidget()
86{ 86{
87} 87}
88 88
89void OTabWidget::addTab( QWidget *child, const QString &icon, const QString &label ) 89void OTabWidget::addTab( QWidget *child, const QString &icon, const QString &label )
90{ 90{
91 QPixmap iconset = loadSmooth( icon ); 91 QPixmap iconset = loadSmooth( icon );
92 92
93 QTab *tab = new QTab(); 93 QTab *tab = new QTab();
94 if ( tabBarStyle == IconTab ) 94 if ( tabBarStyle == IconTab )
95 { 95 {
96 tab->label = QString::null; 96 tab->label = QString::null;
97 } 97 }
98 else 98 else
99 { 99 {
100 tab->label = label; 100 tab->label = label;
101 } 101 }
102 if ( tabBarStyle == IconTab || tabBarStyle == IconList ) 102 if ( tabBarStyle == IconTab || tabBarStyle == IconList )
103 { 103 {
104 tab->iconset = new QIconSet( iconset ); 104 tab->iconset = new QIconSet( iconset );
105 } 105 }
106 int tabid = tabBar->addTab( tab ); 106 int tabid = tabBar->addTab( tab );
107 107
108 if ( tabBarStyle == IconTab || tabBarStyle == IconList ) 108 if ( tabBarStyle == IconTab || tabBarStyle == IconList )
109 { 109 {
110 tabList->insertItem( iconset, label, -1 ); 110 tabList->insertItem( iconset, label, -1 );
111 } 111 }
112 else 112 else
113 { 113 {
114 tabList->insertItem( label ); 114 tabList->insertItem( label );
115 } 115 }
116 116
117 widgetStack->addWidget( child, tabid ); 117 widgetStack->addWidget( child, tabid );
118 widgetStack->raiseWidget( child ); 118 widgetStack->raiseWidget( child );
119 widgetStack->setFrameStyle( QFrame::StyledPanel | QFrame::Raised ); 119 widgetStack->setFrameStyle( QFrame::StyledPanel | QFrame::Raised );
120 120
121 OTabInfo *tabinfo = new OTabInfo( tabid, child, icon, label ); 121 OTabInfo *tabinfo = new OTabInfo( tabid, child, icon, label );
122 tabs.append( tabinfo ); 122 tabs.append( tabinfo );
123 selectTab( tabinfo ); 123 selectTab( tabinfo );
124} 124}
125 125
126void OTabWidget::removePage( QWidget *childwidget ) 126void OTabWidget::removePage( QWidget *childwidget )
127{ 127{
128 if ( childwidget ) 128 if ( childwidget )
129 { 129 {
130 OTabInfo *tab = tabs.first(); 130 OTabInfo *tab = tabs.first();
131 while ( tab && tab->control() != childwidget ) 131 while ( tab && tab->control() != childwidget )
132 { 132 {
133 tab = tabs.next(); 133 tab = tabs.next();
134 } 134 }
135 if ( tab && tab->control() == childwidget ) 135 if ( tab && tab->control() == childwidget )
136 { 136 {
137 tabBar->setTabEnabled( tab->id(), FALSE ); 137 tabBar->setTabEnabled( tab->id(), FALSE );
138 tabBar->removeTab( tabBar->tab( tab->id() ) ); 138 tabBar->removeTab( tabBar->tab( tab->id() ) );
139 int i = 0; 139 int i = 0;
140 while ( i < tabList->count() && tabList->text( i ) != tab->label() ) 140 while ( i < tabList->count() && tabList->text( i ) != tab->label() )
141 { 141 {
142 i++; 142 i++;
143 } 143 }
144 if ( tabList->text( i ) == tab->label() ) 144 if ( tabList->text( i ) == tab->label() )
145 { 145 {
146 tabList->removeItem( i ); 146 tabList->removeItem( i );
147 } 147 }
148 widgetStack->removeWidget( childwidget ); 148 widgetStack->removeWidget( childwidget );
149 tabs.remove( tab ); 149 tabs.remove( tab );
150 delete tab; 150 delete tab;
151 currTab = tabs.current(); 151 currTab = tabs.current();
152 if ( !currTab ) 152 if ( !currTab )
153 { 153 {
154 widgetStack->setFrameStyle( QFrame::NoFrame ); 154 widgetStack->setFrameStyle( QFrame::NoFrame );
155 } 155 }
156 156
157 setUpLayout(); 157 setUpLayout();
158 } 158 }
159 } 159 }
160} 160}
161 161
162void OTabWidget::changeTab( QWidget *widget, const QString &iconset, const QString &label) 162void OTabWidget::changeTab( QWidget *widget, const QString &iconset, const QString &label)
163{ 163{
164 OTabInfo *currtab = tabs.first(); 164 OTabInfo *currtab = tabs.first();
165 while ( currtab && currtab->control() != widget ) 165 while ( currtab && currtab->control() != widget )
166 { 166 {
167 currtab = tabs.next(); 167 currtab = tabs.next();
168 } 168 }
169 if ( currtab && currtab->control() == widget ) 169 if ( currtab && currtab->control() == widget )
170 { 170 {
171 QTab *tab = tabBar->tab( currtab->id() ); 171 QTab *tab = tabBar->tab( currtab->id() );
172 QPixmap icon( loadSmooth( iconset ) ); 172 QPixmap icon( loadSmooth( iconset ) );
173 tab->setText( label ); 173 tab->setText( label );
174 if ( tabBarStyle == IconTab ) 174 if ( tabBarStyle == IconTab )
175 tab->setIconSet( icon ); 175 tab->setIconSet( icon );
176 int i = 0; 176 int i = 0;
177 while ( i < tabList->count() && tabList->text( i ) != currtab->label() ) 177 while ( i < tabList->count() && tabList->text( i ) != currtab->label() )
178 { 178 {
179 i++; 179 i++;
180 } 180 }
181 if ( i < tabList->count() && tabList->text( i ) == currtab->label() ) 181 if ( i < tabList->count() && tabList->text( i ) == currtab->label() )
182 { 182 {
183 if ( tabBarStyle == IconTab || tabBarStyle == IconList ) 183 if ( tabBarStyle == IconTab || tabBarStyle == IconList )
184 { 184 {
185 tabList->changeItem( icon, label, i ); 185 tabList->changeItem( icon, label, i );
186 } 186 }
187 else 187 else
188 { 188 {
189 tabList->changeItem( label, i ); 189 tabList->changeItem( label, i );
190 } 190 }
191 } 191 }
192 currtab->setLabel( label ); 192 currtab->setLabel( label );
193 currtab->setIcon( iconset ); 193 currtab->setIcon( iconset );
194 } 194 }
195 setUpLayout(); 195 setUpLayout();
196} 196}
197 197
198void OTabWidget::setCurrentTab( QWidget *childwidget ) 198void OTabWidget::setCurrentTab( QWidget *childwidget )
199{ 199{
200 OTabInfo *currtab = tabs.first(); 200 OTabInfo *currtab = tabs.first();
201 while ( currtab && currtab->control() != childwidget ) 201 while ( currtab && currtab->control() != childwidget )
202 { 202 {
203 currtab = tabs.next(); 203 currtab = tabs.next();
204 } 204 }
205 if ( currtab && currtab->control() == childwidget ) 205 if ( currtab && currtab->control() == childwidget )
206 { 206 {
207 selectTab( currtab ); 207 selectTab( currtab );
208 } 208 }
209} 209}
210 210
211void OTabWidget::setCurrentTab( const QString &tabname ) 211void OTabWidget::setCurrentTab( const QString &tabname )
212{ 212{
213 OTabInfo *newtab = tabs.first(); 213 OTabInfo *newtab = tabs.first();
214 while ( newtab && newtab->label() != tabname ) 214 while ( newtab && newtab->label() != tabname )
215 { 215 {
216 newtab = tabs.next(); 216 newtab = tabs.next();
217 } 217 }
218 if ( newtab && newtab->label() == tabname ) 218 if ( newtab && newtab->label() == tabname )
219 { 219 {
220 selectTab( newtab ); 220 selectTab( newtab );
221 } 221 }
222} 222}
223 223
224void OTabWidget::setCurrentTab(int tabindex) { 224void OTabWidget::setCurrentTab(int tabindex) {
225 OTabInfo *newtab = tabs.first(); 225 OTabInfo *newtab = tabs.first();
226 while ( newtab && newtab->id() != tabindex ) 226 while ( newtab && newtab->id() != tabindex )
227 { 227 {
228 newtab = tabs.next(); 228 newtab = tabs.next();
229 } 229 }
230 if ( newtab && newtab->id() == tabindex ) 230 if ( newtab && newtab->id() == tabindex )
231 { 231 {
232 selectTab( newtab ); 232 selectTab( newtab );
233 } 233 }
234} 234}
235 235
236 236
237OTabWidget::TabStyle OTabWidget::tabStyle() const 237OTabWidget::TabStyle OTabWidget::tabStyle() const
238{ 238{
239 return tabBarStyle; 239 return tabBarStyle;
240} 240}
241 241
242void OTabWidget::setTabStyle( TabStyle s ) 242void OTabWidget::setTabStyle( TabStyle s )
243{ 243{
244 tabBarStyle = s; 244 tabBarStyle = s;
245 if ( tabBarStyle == TextTab || tabBarStyle == IconTab ) 245 if ( tabBarStyle == TextTab || tabBarStyle == IconTab )
246 { 246 {
247 QTab *currtab; 247 QTab *currtab;
248 for ( OTabInfo *tabinfo = tabs.first(); tabinfo; tabinfo = tabs.next() ) 248 for ( OTabInfo *tabinfo = tabs.first(); tabinfo; tabinfo = tabs.next() )
249 { 249 {
250 currtab = tabBar->tab( tabinfo->id() ); 250 currtab = tabBar->tab( tabinfo->id() );
251 if ( tabBarStyle == IconTab ) 251 if ( tabBarStyle == IconTab )
252 { 252 {
253 currtab->iconset = new QIconSet( loadSmooth( tabinfo->icon() ) ); 253 currtab->iconset = new QIconSet( loadSmooth( tabinfo->icon() ) );
254 if ( tabinfo == currTab ) 254 if ( tabinfo == currTab )
255 currtab->setText( tabinfo->label() ); 255 currtab->setText( tabinfo->label() );
256 else 256 else
257 currtab->setText( QString::null ); 257 currtab->setText( QString::null );
258 } 258 }
259 else 259 else
260 { 260 {
261 currtab->iconset = 0x0; 261 currtab->iconset = 0x0;
262 currtab->setText( tabinfo->label() ); 262 currtab->setText( tabinfo->label() );
263 } 263 }
264 } 264 }
265 tabBarStack->raiseWidget( tabBar ); 265 tabBarStack->raiseWidget( tabBar );
266 } 266 }
267 else if ( tabBarStyle == TextList || tabBarStyle == IconList ) 267 else if ( tabBarStyle == TextList || tabBarStyle == IconList )
268 { 268 {
269 tabList->clear(); 269 tabList->clear();
270 for ( OTabInfo *tabinfo = tabs.first(); tabinfo; tabinfo = tabs.next() ) 270 for ( OTabInfo *tabinfo = tabs.first(); tabinfo; tabinfo = tabs.next() )
271 { 271 {
272 if ( tabBarStyle == IconList ) 272 if ( tabBarStyle == IconList )
273 { 273 {
274 tabList->insertItem( loadSmooth( tabinfo->icon() ), tabinfo->label() ); 274 tabList->insertItem( loadSmooth( tabinfo->icon() ), tabinfo->label() );
275 } 275 }
276 else 276 else
277 { 277 {
278 tabList->insertItem( tabinfo->label() ); 278 tabList->insertItem( tabinfo->label() );
279 } 279 }
280 } 280 }
281 tabBarStack->raiseWidget( tabList ); 281 tabBarStack->raiseWidget( tabList );
282 } 282 }
283 setUpLayout(); 283 setUpLayout();
284} 284}
285 285
286OTabWidget::TabPosition OTabWidget::tabPosition() const 286OTabWidget::TabPosition OTabWidget::tabPosition() const
287{ 287{
288 return tabBarPosition; 288 return tabBarPosition;
289} 289}
290 290
291void OTabWidget::setTabPosition( TabPosition p ) 291void OTabWidget::setTabPosition( TabPosition p )
292{ 292{
293 tabBarPosition = p; 293 tabBarPosition = p;
294 if ( tabBarPosition == Top ) 294 if ( tabBarPosition == Top )
295 { 295 {
296 tabBar->setShape( QTabBar::RoundedAbove ); 296 tabBar->setShape( QTabBar::RoundedAbove );
297 } 297 }
298 else 298 else
299 { 299 {
300 tabBar->setShape( QTabBar::RoundedBelow ); 300 tabBar->setShape( QTabBar::RoundedBelow );
301 } 301 }
302 setUpLayout(); 302 setUpLayout();
303} 303}
304 304
305void OTabWidget::slotTabBarSelected( int id ) 305void OTabWidget::slotTabBarSelected( int id )
306{ 306{
307 OTabInfo *newtab = tabs.first(); 307 OTabInfo *newtab = tabs.first();
308 while ( newtab && newtab->id() != id ) 308 while ( newtab && newtab->id() != id )
309 { 309 {
310 newtab = tabs.next(); 310 newtab = tabs.next();
311 } 311 }
312 if ( newtab && newtab->id() == id ) 312 if ( newtab && newtab->id() == id )
313 { 313 {
314 selectTab( newtab ); 314 selectTab( newtab );
315 } 315 }
316} 316}
317 317
318void OTabWidget::slotTabListSelected( int index ) 318void OTabWidget::slotTabListSelected( int index )
319{ 319{
320 OTabInfo *newtab = tabs.at( index ); 320 OTabInfo *newtab = tabs.at( index );
321 if ( newtab ) 321 if ( newtab )
322 { 322 {
323 selectTab( newtab ); 323 selectTab( newtab );
324 } 324 }
325} 325}
326 326
327QPixmap OTabWidget::loadSmooth( const QString &name ) 327QPixmap OTabWidget::loadSmooth( const QString &name )
328{ 328{
329 QImage image = Resource::loadImage( name ); 329 QImage image = Resource::loadImage( name );
330 QPixmap pixmap; 330 QPixmap pixmap;
331 pixmap.convertFromImage( image.smoothScale( 14, 14 ) ); 331 pixmap.convertFromImage( image.smoothScale( 14, 14 ) );
332 return pixmap; 332 return pixmap;
333} 333}
334 334
335void OTabWidget::selectTab( OTabInfo *tab ) 335void OTabWidget::selectTab( OTabInfo *tab )
336{ 336{
337 if ( tabBarStyle == IconTab ) 337 if ( tabBarStyle == IconTab )
338 { 338 {
339 if ( currTab ) 339 if ( currTab )
340 { 340 {
341 tabBar->tab( currTab->id() )->setText( QString::null ); 341 tabBar->tab( currTab->id() )->setText( QString::null );
342 setUpLayout(); 342 setUpLayout();
343 } 343 }
344 tabBar->tab( tab->id() )->setText( tab->label() ); 344 tabBar->tab( tab->id() )->setText( tab->label() );
345 tabBar->setCurrentTab( tab->id() ); 345 tabBar->setCurrentTab( tab->id() );
346 setUpLayout(); 346 setUpLayout();
347 tabBar->update(); 347 tabBar->update();
348 } 348 }
349 else 349 else
350 { 350 {
351 tabBar->setCurrentTab( tab->id() ); 351 tabBar->setCurrentTab( tab->id() );
352 } 352 }
353 353
354 widgetStack->raiseWidget( tab->control() ); 354 widgetStack->raiseWidget( tab->control() );
355 355
356 emit currentChanged( tab->control() ); 356 emit currentChanged( tab->control() );
357 357
358 currTab = tab; 358 currTab = tab;
359} 359}
360 360
361void OTabWidget::setUpLayout() 361void OTabWidget::setUpLayout()
362{ 362{
363 tabBar->layoutTabs(); 363 tabBar->layoutTabs();
364 QSize t( tabBarStack->sizeHint() ); 364 QSize t( tabBarStack->sizeHint() );
365 if ( tabBarStyle == IconTab ) 365 if ( tabBarStyle == IconTab )
366 { 366 {
367 if ( t.width() > width() ) 367 if ( t.width() > width() )
368 t.setWidth( width() ); 368 t.setWidth( width() );
369 } 369 }
370 else 370 else
371 { 371 {
372 t.setWidth( width() ); 372 t.setWidth( width() );
373 } 373 }
374 int lw = widgetStack->lineWidth(); 374 int lw = widgetStack->lineWidth();
375 if ( tabBarPosition == Bottom ) 375 if ( tabBarPosition == Bottom )
376 { 376 {
377 tabBarStack->setGeometry( QMAX(0, lw-2), height() - t.height() - lw, t.width(), t.height() ); 377 tabBarStack->setGeometry( QMAX(0, lw-2), height() - t.height() - lw, t.width(), t.height() );
378 widgetStack->setGeometry( 0, 0, width(), height()-t.height()+QMAX(0, lw-2) ); 378 widgetStack->setGeometry( 0, 0, width(), height()-t.height()+QMAX(0, lw-2) );
379 } 379 }
380 else 380 else
381 { 381 {
382 tabBarStack->setGeometry( QMAX(0, lw-2), 0, t.width(), t.height() ); 382 tabBarStack->setGeometry( QMAX(0, lw-2), 0, t.width(), t.height() );
383 widgetStack->setGeometry( 0, t.height()-lw, width(), height()-t.height()+QMAX( 0, lw-2 ) ); 383 widgetStack->setGeometry( 0, t.height()-lw, width(), height()-t.height()+QMAX( 0, lw-2 ) );
384 } 384 }
385 385
386 if ( autoMask() ) 386 if ( autoMask() )
387 updateMask(); 387 updateMask();
388} 388}
389 389
390QSize OTabWidget::sizeHint() const 390QSize OTabWidget::sizeHint() const
391{ 391{
392 QSize s( widgetStack->sizeHint() ); 392 QSize s( widgetStack->sizeHint() );
393 QSize t( tabBarStack->sizeHint() ); 393 QSize t( tabBarStack->sizeHint() );
394 return QSize( QMAX( s.width(), t.width() ), s.height() + t.height() ); 394 return QSize( QMAX( s.width(), t.width() ), s.height() + t.height() );
395} 395}
396 396
397void OTabWidget::resizeEvent( QResizeEvent * ) 397void OTabWidget::resizeEvent( QResizeEvent * )
398{ 398{
399 setUpLayout(); 399 setUpLayout();
400} 400}
401 401
402int OTabWidget::currentTab() 402int OTabWidget::currentTab()
403{ 403{
404 if ( currTab ) 404 if ( currTab )
405 { 405 {
406 return currTab->id(); 406 return currTab->id();
407 } 407 }
408 return -1; 408 return -1;
409} 409}
410 410
411QWidget* OTabWidget::currentWidget()const
412{
413 if ( currTab )
414 {
415 return currTab->control();
416 }
417
418 return 0;
419}
diff --git a/libopie/otabwidget.h b/libopie/otabwidget.h
index c140c0b..acb9223 100644
--- a/libopie/otabwidget.h
+++ b/libopie/otabwidget.h
@@ -1,278 +1,285 @@
1/* 1/*
2                This file is part of the Opie Project 2                This file is part of the Opie Project
3 3
4              Copyright (c) 2002 Dan Williams <williamsdr@acm.org> 4              Copyright (c) 2002 Dan Williams <williamsdr@acm.org>
5 =. 5 =.
6 .=l. 6 .=l.
7           .>+-= 7           .>+-=
8 _;:,     .>    :=|. This program is free software; you can 8 _;:,     .>    :=|. This program is free software; you can
9.> <`_,   >  .   <= redistribute it and/or modify it under 9.> <`_,   >  .   <= redistribute it and/or modify it under
10:`=1 )Y*s>-.--   : the terms of the GNU Library General Public 10:`=1 )Y*s>-.--   : the terms of the GNU Library General Public
11.="- .-=="i,     .._ License as published by the Free Software 11.="- .-=="i,     .._ License as published by the Free Software
12 - .   .-<_>     .<> Foundation; either version 2 of the License, 12 - .   .-<_>     .<> Foundation; either version 2 of the License,
13     ._= =}       : or (at your option) any later version. 13     ._= =}       : or (at your option) any later version.
14    .%`+i>       _;_. 14    .%`+i>       _;_.
15    .i_,=:_.      -<s. This program is distributed in the hope that 15    .i_,=:_.      -<s. This program is distributed in the hope that
16     +  .  -:.       = it will be useful, but WITHOUT ANY WARRANTY; 16     +  .  -:.       = it will be useful, but WITHOUT ANY WARRANTY;
17    : ..    .:,     . . . without even the implied warranty of 17    : ..    .:,     . . . without even the implied warranty of
18    =_        +     =;=|` MERCHANTABILITY or FITNESS FOR A 18    =_        +     =;=|` MERCHANTABILITY or FITNESS FOR A
19  _.=:.       :    :=>`: PARTICULAR PURPOSE. See the GNU 19  _.=:.       :    :=>`: PARTICULAR PURPOSE. See the GNU
20..}^=.=       =       ; Library General Public License for more 20..}^=.=       =       ; Library General Public License for more
21++=   -.     .`     .: details. 21++=   -.     .`     .: details.
22 :     =  ...= . :.=- 22 :     =  ...= . :.=-
23 -.   .:....=;==+<; You should have received a copy of the GNU 23 -.   .:....=;==+<; You should have received a copy of the GNU
24  -_. . .   )=.  = Library General Public License along with 24  -_. . .   )=.  = Library General Public License along with
25    --        :-=` this library; see the file COPYING.LIB. 25    --        :-=` this library; see the file COPYING.LIB.
26 If not, write to the Free Software Foundation, 26 If not, write to the Free Software Foundation,
27 Inc., 59 Temple Place - Suite 330, 27 Inc., 59 Temple Place - Suite 330,
28 Boston, MA 02111-1307, USA. 28 Boston, MA 02111-1307, USA.
29 29
30*/ 30*/
31 31
32#ifndef OTABWIDGET_H 32#ifndef OTABWIDGET_H
33#define OTABWIDGET_H 33#define OTABWIDGET_H
34 34
35#include "otabinfo.h" 35#include "otabinfo.h"
36 36
37#include <qwidget.h> 37#include <qwidget.h>
38#include <qlist.h> 38#include <qlist.h>
39 39
40class OTabBar; 40class OTabBar;
41class QComboBox; 41class QComboBox;
42class QPixmap; 42class QPixmap;
43class QTabBar; 43class QTabBar;
44class QWidgetStack; 44class QWidgetStack;
45 45
46/** 46/**
47 * @class OTabWidget 47 * @class OTabWidget
48 * @brief The OTabWidget class provides a stack of widgets. 48 * @brief The OTabWidget class provides a stack of widgets.
49 * 49 *
50 * OTabWidget is a derivation of TrollTech's QTabWidget which provides 50 * OTabWidget is a derivation of TrollTech's QTabWidget which provides
51 * a stack of widgets. Widgets can be selected using either a tab bar or 51 * a stack of widgets. Widgets can be selected using either a tab bar or
52 * drop down list box. 52 * drop down list box.
53 * 53 *
54 * The normal way to use OTabWidget is to do the following in the 54 * The normal way to use OTabWidget is to do the following in the
55 * constructor: 55 * constructor:
56 * - Create a OTabWidget. 56 * - Create a OTabWidget.
57 * - Create a QWidget for each of the pages in the control, insert 57 * - Create a QWidget for each of the pages in the control, insert
58 * children into it, set up geometry management for it, and use addTab() 58 * children into it, set up geometry management for it, and use addTab()
59 * to add the widget. 59 * to add the widget.
60 */ 60 */
61class OTabWidget : public QWidget 61class OTabWidget : public QWidget
62{ 62{
63 Q_OBJECT 63 Q_OBJECT
64public: 64public:
65 65
66/** 66/**
67 * @enum TabStyle 67 * @enum TabStyle
68 * @brief Defines how the widget selection control is displayed. 68 * @brief Defines how the widget selection control is displayed.
69 * 69 *
70 * Valid values: 70 * Valid values:
71 * - Global: use globally selected options (qpe.conf - TabStyle & TabPosition) 71 * - Global: use globally selected options (qpe.conf - TabStyle & TabPosition)
72 * - TextTab: Tabbed widget selection with text labels 72 * - TextTab: Tabbed widget selection with text labels
73 * - IconTab: Tabbed widget selection with icon labels, text label for active widget 73 * - IconTab: Tabbed widget selection with icon labels, text label for active widget
74 * (similar to Opie launcher) 74 * (similar to Opie launcher)
75 * - TextList: Drop down list widget selection with text labels 75 * - TextList: Drop down list widget selection with text labels
76 * - IconList: Drop down list widget selection with icon & text labels 76 * - IconList: Drop down list widget selection with icon & text labels
77 */ 77 */
78 enum TabStyle { Global, TextTab, IconTab, TextList, IconList }; 78 enum TabStyle { Global, TextTab, IconTab, TextList, IconList };
79 79
80/** 80/**
81 * @enum TabPosition 81 * @enum TabPosition
82 * @brief Defines where the widget selection control is drawn. 82 * @brief Defines where the widget selection control is drawn.
83 * 83 *
84 * Valid values: 84 * Valid values:
85 * - Top: Widget selection control is drawn above widgets 85 * - Top: Widget selection control is drawn above widgets
86 * - Bottom: Widget selection control is drawn below widgets 86 * - Bottom: Widget selection control is drawn below widgets
87 */ 87 */
88 enum TabPosition { Top, Bottom }; 88 enum TabPosition { Top, Bottom };
89 89
90/** 90/**
91 * @fn OTabWidget( QWidget *parent = 0, const char *name = 0, TabStyle s = Global, TabPosition p = Top ) 91 * @fn OTabWidget( QWidget *parent = 0, const char *name = 0, TabStyle s = Global, TabPosition p = Top )
92 * @brief Object constructor. 92 * @brief Object constructor.
93 * 93 *
94 * @param parent Pointer to parent of this control. 94 * @param parent Pointer to parent of this control.
95 * @param name Name of control. 95 * @param name Name of control.
96 * @param s Style of widget selection control. 96 * @param s Style of widget selection control.
97 * @param p Position of the widget selection control. 97 * @param p Position of the widget selection control.
98 * 98 *
99 * Constructs a new OTabWidget control with parent and name. The style and position parameters 99 * Constructs a new OTabWidget control with parent and name. The style and position parameters
100 * determine how the widget selection control will be displayed. 100 * determine how the widget selection control will be displayed.
101 */ 101 */
102 // FIXME WFlags? -zecke 102 // FIXME WFlags? -zecke
103 OTabWidget( QWidget * = 0, const char * = 0, TabStyle = Global, TabPosition = Top ); 103 OTabWidget( QWidget * = 0, const char * = 0, TabStyle = Global, TabPosition = Top );
104 104
105/** 105/**
106 * @fn ~OTabWidget() 106 * @fn ~OTabWidget()
107 * @brief Object destructor. 107 * @brief Object destructor.
108 */ 108 */
109 ~OTabWidget(); 109 ~OTabWidget();
110 110
111/** 111/**
112 * @fn addTab( QWidget *child, const QString &icon, const QString &label ) 112 * @fn addTab( QWidget *child, const QString &icon, const QString &label )
113 * @brief Add new widget to control. 113 * @brief Add new widget to control.
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 /* ### Page vs. Tab.. yes the widget is a Page but then is addTab wrong -zecke */
127 void removePage( QWidget * ); 128 void removePage( QWidget * );
128 129
129/** 130/**
130 * @fn changeTab( QWidget *widget, const QString &icon, const QString &label ) 131 * @fn changeTab( QWidget *widget, const QString &icon, const QString &label )
131 * @brief Change text and/or icon for existing tab 132 * @brief Change text and/or icon for existing tab
132 * 133 *
133 * @param child Widget control. 134 * @param child Widget control.
134 * @param icon Path to icon. 135 * @param icon Path to icon.
135 * @param label Text label. 136 * @param label Text label.
136 */ 137 */
137 void changeTab( QWidget *, const QString &, const QString & ); 138 void changeTab( QWidget *, const QString &, const QString & );
138 139
139/** 140/**
140 * @fn tabStyle()const 141 * @fn tabStyle()const
141 * @brief Returns current widget selection control style. 142 * @brief Returns current widget selection control style.
142 */ 143 */
143 TabStyle tabStyle() const; 144 TabStyle tabStyle() const;
144 145
145/** 146/**
146 * @fn setTabStyle( TabStyle s ) 147 * @fn setTabStyle( TabStyle s )
147 * @brief Set the current widget selection control style. 148 * @brief Set the current widget selection control style.
148 * 149 *
149 * @param s New style to be used. 150 * @param s New style to be used.
150 */ 151 */
151 void setTabStyle( TabStyle ); 152 void setTabStyle( TabStyle );
152 153
153/** 154/**
154 * @fn tabPosition()const 155 * @fn tabPosition()const
155 * @brief Returns current widget selection control position. 156 * @brief Returns current widget selection control position.
156 */ 157 */
157 TabPosition tabPosition() const; 158 TabPosition tabPosition() const;
158 159
159/** 160/**
160 * @fn setTabPosition( TabPosition p ) 161 * @fn setTabPosition( TabPosition p )
161 * @brief Set the current widget selection control position. 162 * @brief Set the current widget selection control position.
162 * 163 *
163 * @param p New position of widget selection control. 164 * @param p New position of widget selection control.
164 */ 165 */
165 void setTabPosition( TabPosition ); 166 void setTabPosition( TabPosition );
166 167
167/** 168/**
168 * @fn setCurrentTab( QWidget *childwidget ) 169 * @fn setCurrentTab( QWidget *childwidget )
169 * @brief Selects and brings to top the desired widget by using widget pointer. 170 * @brief Selects and brings to top the desired widget by using widget pointer.
170 * 171 *
171 * @param childwidget Widget to select. 172 * @param childwidget Widget to select.
172 */ 173 */
173 void setCurrentTab( QWidget * ); 174 void setCurrentTab( QWidget * );
174 175
175/** 176/**
176 * @fn setCurrentTab( const QString &tabname ) 177 * @fn setCurrentTab( const QString &tabname )
177 * @brief Selects and brings to top the desired widget, by using label. 178 * @brief Selects and brings to top the desired widget, by using label.
178 * 179 *
179 * @param tabname Text label for widget to select. 180 * @param tabname Text label for widget to select.
180 */ 181 */
181 void setCurrentTab( const QString & ); 182 void setCurrentTab( const QString & );
182 183
183/** 184/**
184 * @fn setCurrentTab( int ) 185 * @fn setCurrentTab( int )
185 * @brief Selects and brings to top the desired widget, by using id. 186 * @brief Selects and brings to top the desired widget, by using id.
186 * 187 *
187 * @param tab id for widget to select. 188 * @param tab id for widget to select.
188 */ 189 */
189 void setCurrentTab(int); 190 void setCurrentTab(int);
190 191
191/** 192/**
192 * @fn sizeHint()const 193 * @fn sizeHint()const
193 * @brief Reimplemented for internal purposes. 194 * @brief Reimplemented for internal purposes.
194 */ 195 */
195 QSize sizeHint() const; 196 QSize sizeHint() const;
196 197
197/** 198/**
198 * @fn currentTab( ) 199 * @fn currentTab( )
199 * @brief returns current tab id. 200 * @brief returns current tab id.
200 */ 201 */
201 int currentTab(); 202 // ### make const
202 203 int currentTab()/* const */;
204/**
205 * @brief returns the current page of the active tab
206 *
207 * @since 1.2
208 */
209 QWidget* currentWidget()const;
203 210
204protected: 211protected:
205 212
206/** 213/**
207 * @fn resizeEvent( QResizeEvent * ) 214 * @fn resizeEvent( QResizeEvent * )
208 * @brief Reimplemented for internal purposes. 215 * @brief Reimplemented for internal purposes.
209 */ 216 */
210 void resizeEvent( QResizeEvent * ); 217 void resizeEvent( QResizeEvent * );
211 218
212private: 219private:
213 OTabInfoList tabs; 220 OTabInfoList tabs;
214 OTabInfo *currTab; 221 OTabInfo *currTab;
215 222
216 TabStyle tabBarStyle; 223 TabStyle tabBarStyle;
217 TabPosition tabBarPosition; 224 TabPosition tabBarPosition;
218 225
219 QWidgetStack *tabBarStack; 226 QWidgetStack *tabBarStack;
220 OTabBar *tabBar; 227 OTabBar *tabBar;
221 QComboBox *tabList; 228 QComboBox *tabList;
222 229
223 QWidgetStack *widgetStack; 230 QWidgetStack *widgetStack;
224 class Private; 231 class Private;
225 Private* d; 232 Private* d;
226 233
227/** 234/**
228 * @fn loadSmooth( const QString &name ) 235 * @fn loadSmooth( const QString &name )
229 * @brief Loads icon for widget. 236 * @brief Loads icon for widget.
230 * 237 *
231 * @param name Name of icon image file. 238 * @param name Name of icon image file.
232 */ 239 */
233 QPixmap loadSmooth( const QString & ); 240 QPixmap loadSmooth( const QString & );
234 241
235/** 242/**
236 * @fn selectTab( OTabInfo *tab ) 243 * @fn selectTab( OTabInfo *tab )
237 * @brief Internal function to select desired widget. 244 * @brief Internal function to select desired widget.
238 * 245 *
239 * @param tab Pointer to data for widget. 246 * @param tab Pointer to data for widget.
240 */ 247 */
241 void selectTab( OTabInfo * ); 248 void selectTab( OTabInfo * );
242 249
243/** 250/**
244 * @fn setUpLayout() 251 * @fn setUpLayout()
245 * @brief Internal function to adjust layout. 252 * @brief Internal function to adjust layout.
246 */ 253 */
247 void setUpLayout(); 254 void setUpLayout();
248 255
249 256
250signals: 257signals:
251/** 258/**
252 * @fn currentChanegd( QWidget *widget ) 259 * @fn currentChanegd( QWidget *widget )
253 * @brief This signal is emitted whenever the widget has changed. 260 * @brief This signal is emitted whenever the widget has changed.
254 * 261 *
255 * @param widget Pointer to new current widget. 262 * @param widget Pointer to new current widget.
256 */ 263 */
257 void currentChanged( QWidget * ); 264 void currentChanged( QWidget * );
258 265
259private slots: 266private slots:
260 267
261/** 268/**
262 * @fn slotTabBarSelected( int id ) 269 * @fn slotTabBarSelected( int id )
263 * @brief Slot which is called when a tab is selected. 270 * @brief Slot which is called when a tab is selected.
264 * 271 *
265 * @param id ID of widget selected. 272 * @param id ID of widget selected.
266 */ 273 */
267 void slotTabBarSelected( int ); 274 void slotTabBarSelected( int );
268 275
269/** 276/**
270 * @fn slotTabListSelected( int index ) 277 * @fn slotTabListSelected( int index )
271 * @brief Slot which is called when a drop down selection is made. 278 * @brief Slot which is called when a drop down selection is made.
272 * 279 *
273 * @param id Index of widget selected. 280 * @param id Index of widget selected.
274 */ 281 */
275 void slotTabListSelected( int ); 282 void slotTabListSelected( int );
276}; 283};
277 284
278#endif 285#endif