summaryrefslogtreecommitdiff
authordrw <drw>2005-02-25 21:43:00 (UTC)
committer drw <drw>2005-02-25 21:43:00 (UTC)
commitf2f2b0bc7f8fbb0ecbfd7548b7a29618cc5a9139 (patch) (side-by-side diff)
tree8dfef7af3cd038b3a27570e64234388c8c563884
parent8cddb795296ddc1f9bd3203a9441c555a565f476 (diff)
downloadopie-f2f2b0bc7f8fbb0ecbfd7548b7a29618cc5a9139.zip
opie-f2f2b0bc7f8fbb0ecbfd7548b7a29618cc5a9139.tar.gz
opie-f2f2b0bc7f8fbb0ecbfd7548b7a29618cc5a9139.tar.bz2
Reworked OTabWidget - optimized (now uses less runtime resources), fix display issue where tabbar appears to float a few pixels above where it should
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--libopie2/opieui/otabinfo.h50
-rw-r--r--libopie2/opieui/otabwidget.cpp440
-rw-r--r--libopie2/opieui/otabwidget.h69
3 files changed, 301 insertions, 258 deletions
diff --git a/libopie2/opieui/otabinfo.h b/libopie2/opieui/otabinfo.h
index d6d5abf..99ff10e 100644
--- a/libopie2/opieui/otabinfo.h
+++ b/libopie2/opieui/otabinfo.h
@@ -1,136 +1,144 @@
/*
-                This file is part of the Opie Project
+ This file is part of the Opie Project
-              Copyright (c) 2002 Dan Williams <williamsdr@acm.org>
+ Copyright (c) 2002 Dan Williams <williamsdr@acm.org>
=.
.=l.
-           .>+-=
- _;:,     .>    :=|. This program is free software; you can
-.> <`_,   >  .   <= redistribute it and/or modify it under
-:`=1 )Y*s>-.--   : the terms of the GNU Library General Public
-.="- .-=="i,     .._ License as published by the Free Software
- - .   .-<_>     .<> Foundation; either version 2 of the License,
-     ._= =}       : or (at your option) any later version.
-    .%`+i>       _;_.
-    .i_,=:_.      -<s. This program is distributed in the hope that
-     +  .  -:.       = it will be useful, but WITHOUT ANY WARRANTY;
-    : ..    .:,     . . . without even the implied warranty of
-    =_        +     =;=|` MERCHANTABILITY or FITNESS FOR A
-  _.=:.       :    :=>`: PARTICULAR PURPOSE. See the GNU
-..}^=.=       =       ; Library General Public License for more
-++=   -.     .`     .: details.
- :     =  ...= . :.=-
- -.   .:....=;==+<; You should have received a copy of the GNU
-  -_. . .   )=.  = Library General Public License along with
-    --        :-=` this library; see the file COPYING.LIB.
+ .>+-=
+_;:, .> :=|. This program is free software; you can
+.> <`_, > . <= redistribute it and/or modify it under
+:`=1 )Y*s>-.-- : the terms of the GNU Library General Public
+.="- .-=="i, .._ License as published by the Free Software
+- . .-<_> .<> Foundation; either version 2 of the License,
+ ._= =} : or (at your option) any later version.
+ .%`+i> _;_.
+ .i_,=:_. -<s. This program is distributed in the hope that
+ + . -:. = it will be useful, but WITHOUT ANY WARRANTY;
+ : .. .:, . . . without even the implied warranty of
+ =_ + =;=|` MERCHANTABILITY or FITNESS FOR A
+ _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU
+..}^=.= = ; Library General Public License for more
+++= -. .` .: details.
+: = ...= . :.=-
+-. .:....=;==+<; You should have received a copy of the GNU
+ -_. . . )=. = Library General Public License along with
+ -- :-=` this library; see the file COPYING.LIB.
If not, write to the Free Software Foundation,
Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#ifndef OTABINFO_H
#define OTABINFO_H
/* QT */
#include <qlist.h>
#include <qstring.h>
class QWidget;
namespace Opie{
namespace Ui {
/**
* @class OTabInfo
* @brief The OTabInfo class is used internally by OTabWidget to keep track
* of widgets added to the control.
*
* OTabInfo provides the following information about a widget added to an
* OTabWidget control:
*
* ID - integer tab bar ID
* Control - QWidget pointer to child widget
* Label - QString text label for OTabWidget selection control
* Icon - QString name of icon file
*/
class OTabInfo
{
public:
/**
* @fn OTabInfo()
* @brief Object constructor.
*/
OTabInfo() : i( -1 ), c( 0 ), p( 0 ), l( QString::null ) {}
/**
* @fn OTabInfo( int id, QWidget *control, const QString &icon, const QString &label )
* @brief Object constructor.
*
* @param id TabBar identifier for widget.
* @param control QWidget pointer to widget.
* @param icon QString name of icon file.
* @param label QString text label for OTabWidget selection control.
*/
OTabInfo( int id, QWidget *control, const QString &icon, const QString &label )
: i( id ), c( control ), p( icon ), l( label ) {}
/**
* @fn id()const
* @brief Returns TabBar ID.
*/
int id() const { return i; }
/**
+ * @fn setId( int id )
+ * @brief Set Id for tab.
+ *
+ * @param id integer tab identifier.
+ */
+ void setId( int id ) { i = id; }
+
+ /**
* @fn label()const
* @brief Returns text label for widget.
*/
const QString &label() const { return l; }
/**
* @fn setLabel( const QString &label )
* @brief Set label for tab.
*
* @param label QString text label for OTabWidget selection control.
*/
void setLabel( const QString &label ) { l = label; }
/**
* @fn control()const
* @brief Returns pointer to widget.
*/
QWidget *control() const { return c; }
/**
* @fn icon()const
* @brief Returns name of icon file.
*/
const QString &icon() const { return p; }
/**
* @fn setIcon( const QString &icon )
* @brief Set icon for tab.
*
* @param icon QString name of icon file.
*/
void setIcon( const QString &icon ) { p = icon; }
private:
int i;
QWidget *c;
QString p;
QString l;
class Private;
Private *d;
};
/**
* @class OTabInfoList
* @brief A list of OTabInfo objects used by OTabWidget.
*/
typedef QList<OTabInfo> OTabInfoList;
}
}
#endif
diff --git a/libopie2/opieui/otabwidget.cpp b/libopie2/opieui/otabwidget.cpp
index d23b1c9..01747e1 100644
--- a/libopie2/opieui/otabwidget.cpp
+++ b/libopie2/opieui/otabwidget.cpp
@@ -1,426 +1,466 @@
/*
-                This file is part of the Opie Project
+ This file is part of the Opie Project
-              Copyright (c) 2002 Dan Williams <williamsdr@acm.org>
+ Copyright (c) 2002, 2005 Dan Williams <drw@handhelds.org>
=.
.=l.
-           .>+-=
- _;:,     .>    :=|. This program is free software; you can
-.> <`_,   >  .   <= redistribute it and/or modify it under
-:`=1 )Y*s>-.--   : the terms of the GNU Library General Public
-.="- .-=="i,     .._ License as published by the Free Software
- - .   .-<_>     .<> Foundation; either version 2 of the License,
-     ._= =}       : or (at your option) any later version.
-    .%`+i>       _;_.
-    .i_,=:_.      -<s. This program is distributed in the hope that
-     +  .  -:.       = it will be useful, but WITHOUT ANY WARRANTY;
-    : ..    .:,     . . . without even the implied warranty of
-    =_        +     =;=|` MERCHANTABILITY or FITNESS FOR A
-  _.=:.       :    :=>`: PARTICULAR PURPOSE. See the GNU
-..}^=.=       =       ; Library General Public License for more
-++=   -.     .`     .: details.
- :     =  ...= . :.=-
- -.   .:....=;==+<; You should have received a copy of the GNU
-  -_. . .   )=.  = Library General Public License along with
-    --        :-=` this library; see the file COPYING.LIB.
+ .>+-=
+_;:, .> :=|. This program is free software; you can
+.> <`_, > . <= redistribute it and/or modify it under
+:`=1 )Y*s>-.-- : the terms of the GNU Library General Public
+.="- .-=="i, .._ License as published by the Free Software
+- . .-<_> .<> Foundation; either version 2 of the License,
+ ._= =} : or (at your option) any later version.
+ .%`+i> _;_.
+ .i_,=:_. -<s. This program is distributed in the hope that
+ + . -:. = it will be useful, but WITHOUT ANY WARRANTY;
+ : .. .:, . . . without even the implied warranty of
+ =_ + =;=|` MERCHANTABILITY or FITNESS FOR A
+ _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU
+..}^=.= = ; Library General Public License for more
+++= -. .` .: details.
+: = ...= . :.=-
+-. .:....=;==+<; You should have received a copy of the GNU
+ -_. . . )=. = Library General Public License along with
+ -- :-=` this library; see the file COPYING.LIB.
If not, write to the Free Software Foundation,
Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#include <opie2/otabwidget.h>
/* OPIE */
#include <qpe/applnk.h>
#include <qpe/config.h>
#include <qpe/resource.h>
#include <opie2/otabbar.h>
/* QT */
#include <qcombobox.h>
#include <qwidgetstack.h>
using namespace Opie::Ui;
OTabWidget::OTabWidget( QWidget *parent, const char *name, TabStyle s, TabPosition p )
: QWidget( parent, name )
+ , m_currTab( 0l )
+ , m_usingTabs( true )
+ , m_tabBar( 0l )
+ , m_tabList( 0l )
{
if ( s == Global )
{
+ // Read Opie global settings for style and position
Config config( "qpe" );
config.setGroup( "Appearance" );
+
+ // Style
s = ( TabStyle ) config.readNumEntry( "TabStyle", (int) IconTab );
if ( s <= Global || s > IconList)
- {
s = IconTab;
- }
- QString pos = config.readEntry( "TabPosition", "Top");
- if ( pos == "Bottom" )
- {
- p = Bottom;
- }
- else
- {
- p = Top;
- }
- }
-
- widgetStack = new QWidgetStack( this, "widgetstack" );
- widgetStack->setFrameStyle( QFrame::NoFrame );
- widgetStack->setLineWidth( style().defaultFrameWidth() );
-
- tabBarStack = new QWidgetStack( this, "tabbarstack" );
- tabBar = new OTabBar( tabBarStack, "tabbar" );
- tabBarStack->addWidget( tabBar, 0 );
- connect( tabBar, SIGNAL( selected(int) ), this, SLOT( slotTabBarSelected(int) ) );
+ // Position
+ ( config.readEntry( "TabPosition", "Top" ) == "Bottom" ) ? p = Bottom
+ : p = Top;
+ }
- tabList = new QComboBox( false, tabBarStack, "tablist" );
- tabBarStack->addWidget( tabList, 1 );
- connect( tabList, SIGNAL( activated(int) ), this, SLOT( slotTabListSelected(int) ) );
+ // Initialize widget stack for tab widgets
+ m_widgetStack = new QWidgetStack( this );
+ m_widgetStack->setFrameStyle( QFrame::NoFrame );
+ m_widgetStack->setLineWidth( style().defaultFrameWidth() );
- tabBarPosition = p;
+ // Set initial selector control style and position
setTabStyle( s );
setTabPosition( p );
-
- currTab= 0x0;
}
OTabWidget::~OTabWidget()
{
- tabs.setAutoDelete( true );
- tabs.clear();
+ m_tabs.setAutoDelete( true );
+ m_tabs.clear();
}
void OTabWidget::addTab( QWidget *child, const QString &icon, const QString &label )
{
- QPixmap iconset = loadSmooth( icon );
+ int tabid = -1;
- QTab *tab = new QTab();
- if ( tabBarStyle == IconTab )
- {
- tab->label = QString::null;
- }
- else
- {
- tab->label = label;
- }
- if ( tabBarStyle == IconTab || tabBarStyle == IconList )
+ if ( m_usingTabs )
{
- tab->iconset = new QIconSet( iconset );
- }
- int tabid = tabBar->addTab( tab );
+ // Create new tab in tab bar
+ QTab *tab = new QTab();
- if ( tabBarStyle == IconTab || tabBarStyle == IconList )
- {
- tabList->insertItem( iconset, label, -1 );
+ // Set label (and icon if necessary)
+ if ( m_tabBarStyle == IconTab )
+ {
+ tab->label = QString::null;
+ tab->iconset = new QIconSet( loadSmooth( icon ) );
+ }
+ else
+ tab->label = label;
+
+ tabid = m_tabBar->addTab( tab );
}
else
{
- tabList->insertItem( label );
+ // Insert entry (with icon if necessary) into drop down list
+ if ( m_tabBarStyle == IconList )
+ m_tabList->insertItem( loadSmooth( icon ), label, -1 );
+ else
+ m_tabList->insertItem( label );
}
- widgetStack->addWidget( child, tabid );
- widgetStack->raiseWidget( child );
- widgetStack->setFrameStyle( QFrame::StyledPanel | QFrame::Raised );
+ // Add widget to stack
+ m_widgetStack->addWidget( child, tabid );
+ m_widgetStack->raiseWidget( child );
+ m_widgetStack->setFrameStyle( QFrame::StyledPanel | QFrame::Raised );
+ // Keep track of tab information
OTabInfo *tabinfo = new OTabInfo( tabid, child, icon, label );
- tabs.append( tabinfo );
+ m_tabs.append( tabinfo );
+
+ // Make newly added tab the current one displayed
selectTab( tabinfo );
}
void OTabWidget::removePage( QWidget *childwidget )
{
if ( childwidget )
{
- OTabInfo *tab = tabs.first();
+ // Find tab information for desired widget
+ OTabInfo *tab = m_tabs.first();
while ( tab && tab->control() != childwidget )
- {
- tab = tabs.next();
- }
+ tab = m_tabs.next();
+
if ( tab && tab->control() == childwidget )
{
- tabBar->setTabEnabled( tab->id(), FALSE );
- tabBar->removeTab( tabBar->tab( tab->id() ) );
- int i = 0;
- while ( i < tabList->count() && tabList->text( i ) != tab->label() )
+ if ( m_usingTabs )
{
- i++;
+ // Remove tab from tab bar
+ m_tabBar->setTabEnabled( tab->id(), false );
+ m_tabBar->removeTab( m_tabBar->tab( tab->id() ) );
}
- if ( tabList->text( i ) == tab->label() )
+ else
{
- tabList->removeItem( i );
+ // Remove entry from drop down list
+ int i = 0;
+ while ( i < m_tabList->count() && m_tabList->text( i ) != tab->label() )
+ i++;
+ if ( m_tabList->text( i ) == tab->label() )
+ m_tabList->removeItem( i );
}
- widgetStack->removeWidget( childwidget );
- tabs.remove( tab );
+
+ // Remove widget from stack
+ m_widgetStack->removeWidget( childwidget );
+
+ // Get rid of tab information
+ m_tabs.remove( tab );
delete tab;
- currTab = tabs.current();
- if ( !currTab )
- {
- widgetStack->setFrameStyle( QFrame::NoFrame );
- }
+ // Reset current tab
+ m_currTab = m_tabs.current();
+ if ( !m_currTab )
+ m_widgetStack->setFrameStyle( QFrame::NoFrame );
+
+ // Redraw widget
setUpLayout();
}
}
}
void OTabWidget::changeTab( QWidget *widget, const QString &iconset, const QString &label)
{
- OTabInfo *currtab = tabs.first();
+ // Find tab information for desired widget
+ OTabInfo *currtab = m_tabs.first();
while ( currtab && currtab->control() != widget )
- {
- currtab = tabs.next();
- }
+ currtab = m_tabs.next();
+
if ( currtab && currtab->control() == widget )
{
- QTab *tab = tabBar->tab( currtab->id() );
QPixmap icon( loadSmooth( iconset ) );
- tab->setText( label );
- if ( tabBarStyle == IconTab )
- tab->setIconSet( icon );
- int i = 0;
- while ( i < tabList->count() && tabList->text( i ) != currtab->label() )
+
+ if ( m_usingTabs )
{
- i++;
+ // Update tab label and icon (if necessary)
+ QTab *tab = m_tabBar->tab( currtab->id() );
+ tab->setText( label );
+ if ( m_tabBarStyle == IconTab )
+ tab->setIconSet( icon );
}
- if ( i < tabList->count() && tabList->text( i ) == currtab->label() )
+ else
{
- if ( tabBarStyle == IconTab || tabBarStyle == IconList )
- {
- tabList->changeItem( icon, label, i );
- }
- else
+ // Update entry label and icon (if necessary)
+ int i = 0;
+ while ( i < m_tabList->count() && m_tabList->text( i ) != currtab->label() )
+ i++;
+ if ( i < m_tabList->count() && m_tabList->text( i ) == currtab->label() )
{
- tabList->changeItem( label, i );
+ if ( m_tabBarStyle == IconList )
+ m_tabList->changeItem( icon, label, i );
+ else
+ m_tabList->changeItem( label, i );
}
}
+
+ // Update tab information
currtab->setLabel( label );
currtab->setIcon( iconset );
+
+ // Redraw widget
+ setUpLayout();
}
- setUpLayout();
}
void OTabWidget::setCurrentTab( QWidget *childwidget )
{
- OTabInfo *currtab = tabs.first();
+ OTabInfo *currtab = m_tabs.first();
while ( currtab && currtab->control() != childwidget )
{
- currtab = tabs.next();
+ currtab = m_tabs.next();
}
if ( currtab && currtab->control() == childwidget )
{
selectTab( currtab );
}
}
void OTabWidget::setCurrentTab( const QString &tabname )
{
- OTabInfo *newtab = tabs.first();
+ OTabInfo *newtab = m_tabs.first();
while ( newtab && newtab->label() != tabname )
{
- newtab = tabs.next();
+ newtab = m_tabs.next();
}
if ( newtab && newtab->label() == tabname )
{
selectTab( newtab );
}
}
void OTabWidget::setCurrentTab(int tabindex)
{
- OTabInfo *newtab = tabs.first();
+ OTabInfo *newtab = m_tabs.first();
while ( newtab && newtab->id() != tabindex )
{
- newtab = tabs.next();
+ newtab = m_tabs.next();
}
if ( newtab && newtab->id() == tabindex )
{
selectTab( newtab );
}
}
OTabWidget::TabStyle OTabWidget::tabStyle() const
{
- return tabBarStyle;
+ return m_tabBarStyle;
}
void OTabWidget::setTabStyle( TabStyle s )
{
- tabBarStyle = s;
- if ( tabBarStyle == TextTab || tabBarStyle == IconTab )
+ // Get out if new and current styles are the same
+ if ( s == m_tabBarStyle )
+ return;
+
+ // Delete current selector control
+ if ( m_usingTabs )
+ {
+ delete m_tabBar;
+ m_tabBar = 0l;
+ }
+ else
{
- QTab *currtab;
- for ( OTabInfo *tabinfo = tabs.first(); tabinfo; tabinfo = tabs.next() )
+ delete m_tabList;
+ m_tabList = 0l;
+ }
+
+ // Set new style information
+ m_tabBarStyle = s;
+ m_usingTabs = ( m_tabBarStyle == TextTab || m_tabBarStyle == IconTab );
+
+ // Create new selector control and populate with tab information
+ if ( m_usingTabs )
+ {
+ // Create new tab bar selector
+ m_tabBar = new OTabBar( this );
+ connect( m_tabBar, SIGNAL(selected(int)), this, SLOT(slotTabBarSelected(int)) );
+
+ // Add all current tabs to tab bar
+ for ( OTabInfo *tabinfo = m_tabs.first(); tabinfo; tabinfo = m_tabs.next() )
{
- currtab = tabBar->tab( tabinfo->id() );
- if ( tabBarStyle == IconTab )
+ // Create new tab in tab bar
+ QTab *tab = new QTab();
+
+ // Set label (and icon if necessary)
+ if ( m_tabBarStyle == IconTab )
{
- currtab->iconset = new QIconSet( loadSmooth( tabinfo->icon() ) );
- if ( tabinfo == currTab )
- currtab->setText( tabinfo->label() );
- else
- currtab->setText( QString::null );
+ tab->label = QString::null;
+ tab->iconset = new QIconSet( loadSmooth( tabinfo->icon() ) );
}
else
- {
- currtab->iconset = 0x0;
- currtab->setText( tabinfo->label() );
- }
+ tab->label = tabinfo->label();
+
+ // Add tab and save its Id
+ int tabid = m_tabBar->addTab( tab );
+ tabinfo->setId( tabid );
}
- tabBarStack->raiseWidget( tabBar );
}
- else if ( tabBarStyle == TextList || tabBarStyle == IconList )
+ else
{
- tabList->clear();
- for ( OTabInfo *tabinfo = tabs.first(); tabinfo; tabinfo = tabs.next() )
+ // Create new drop down list selector
+ m_tabList = new QComboBox( false, this );
+ connect( m_tabList, SIGNAL(activated(int)), this, SLOT(slotTabListSelected(int)) );
+
+ // Add all current tabs to drop down list
+ for ( OTabInfo *tabinfo = m_tabs.first(); tabinfo; tabinfo = m_tabs.next() )
{
- if ( tabBarStyle == IconList )
- {
- tabList->insertItem( loadSmooth( tabinfo->icon() ), tabinfo->label() );
- }
+ if ( m_tabBarStyle == IconList )
+ m_tabList->insertItem( loadSmooth( tabinfo->icon() ), tabinfo->label() );
else
- {
- tabList->insertItem( tabinfo->label() );
- }
+ m_tabList->insertItem( tabinfo->label() );
}
- tabBarStack->raiseWidget( tabList );
}
+
+ // Redraw widget
setUpLayout();
}
OTabWidget::TabPosition OTabWidget::tabPosition() const
{
- return tabBarPosition;
+ return m_tabBarPosition;
}
void OTabWidget::setTabPosition( TabPosition p )
{
- tabBarPosition = p;
- if ( tabBarPosition == Top )
- {
- tabBar->setShape( QTabBar::RoundedAbove );
- }
- else
+ m_tabBarPosition = p;
+
+ // If using the tab bar selector, set its shape
+ if ( m_usingTabs )
{
- tabBar->setShape( QTabBar::RoundedBelow );
+ ( m_tabBarPosition == Top ) ? m_tabBar->setShape( QTabBar::RoundedAbove )
+ : m_tabBar->setShape( QTabBar::RoundedBelow );
}
+
+ // Redraw widget
setUpLayout();
}
void OTabWidget::slotTabBarSelected( int id )
{
- OTabInfo *newtab = tabs.first();
+ OTabInfo *newtab = m_tabs.first();
while ( newtab && newtab->id() != id )
- {
- newtab = tabs.next();
- }
+ newtab = m_tabs.next();
+
if ( newtab && newtab->id() == id )
- {
selectTab( newtab );
- }
}
void OTabWidget::slotTabListSelected( int index )
{
- OTabInfo *newtab = tabs.at( index );
+ OTabInfo *newtab = m_tabs.at( index );
if ( newtab )
- {
selectTab( newtab );
- }
}
QPixmap OTabWidget::loadSmooth( const QString &name )
{
QPixmap p;
p.convertFromImage( Resource::loadImage( name ).smoothScale( AppLnk::smallIconSize(), AppLnk::smallIconSize() ) );
return p;
}
void OTabWidget::selectTab( OTabInfo *tab )
{
- if ( tabBarStyle == IconTab )
+ if ( m_tabBarStyle == IconTab )
{
- if ( currTab )
+ // Remove text label from currently selected tab
+ if ( m_currTab )
{
- tabBar->tab( currTab->id() )->setText( QString::null );
- setUpLayout();
+ m_tabBar->tab( m_currTab->id() )->setText( QString::null );
+ //setUpLayout();
}
- tabBar->tab( tab->id() )->setText( tab->label() );
- tabBar->setCurrentTab( tab->id() );
+
+ // Set text label for newly selected tab
+ m_tabBar->tab( tab->id() )->setText( tab->label() );
+ m_tabBar->setCurrentTab( tab->id() );
+
setUpLayout();
- tabBar->update();
}
- else
+ else if ( m_tabBarStyle == TextTab )
{
- tabBar->setCurrentTab( tab->id() );
+ m_tabBar->setCurrentTab( tab->id() );
}
- widgetStack->raiseWidget( tab->control() );
+ m_widgetStack->raiseWidget( tab->control() );
emit currentChanged( tab->control() );
- currTab = tab;
+ m_currTab = tab;
}
void OTabWidget::setUpLayout()
{
- tabBar->layoutTabs();
- QSize t( tabBarStack->sizeHint() );
- if ( tabBarStyle == IconTab )
+ if ( m_usingTabs )
{
- if ( t.width() > width() )
- t.setWidth( width() );
+ m_tabBar->update();
+ m_tabBar->layoutTabs();
}
- else
+}
+
+void OTabWidget::resizeEvent( QResizeEvent * )
+{
+ QSize t;
+
+ if ( m_usingTabs )
{
- t.setWidth( width() );
+ m_tabBar->layoutTabs();
+ t = m_tabBar->sizeHint();
}
- int lw = widgetStack->lineWidth();
- if ( tabBarPosition == Bottom )
+ else
+ t = m_tabList->sizeHint();
+
+ t.setWidth( width() );
+
+ int lw = m_widgetStack->lineWidth();
+ if ( m_tabBarPosition == Bottom )
{
- tabBarStack->setGeometry( QMAX(0, lw-2), height() - t.height() - lw, t.width(), t.height() );
- widgetStack->setGeometry( 0, 0, width(), height()-t.height()+QMAX(0, lw-2) );
+ if ( m_usingTabs )
+ m_tabBar->setGeometry( QMAX(0, lw-2), height() - t.height() - lw, t.width(), t.height() );
+ else
+ m_tabList->setGeometry( QMAX(0, lw-2), height() - t.height() - lw, t.width(), t.height() );
+
+ m_widgetStack->setGeometry( 0, 0, width(), height()-t.height()+QMAX(0, lw-2) );
}
else
{
- tabBarStack->setGeometry( QMAX(0, lw-2), 0, t.width(), t.height() );
- widgetStack->setGeometry( 0, t.height()-lw, width(), height()-t.height()+QMAX( 0, lw-2 ) );
+ if ( m_usingTabs )
+ m_tabBar->setGeometry( QMAX(0, lw-2), 0, t.width(), t.height() );
+ else
+ m_tabList->setGeometry( QMAX(0, lw-2), 0, t.width(), t.height() );
+
+ m_widgetStack->setGeometry( 0, t.height()-lw, width(), height()-t.height()+QMAX( 0, lw-2 ) );
}
if ( autoMask() )
updateMask();
}
-QSize OTabWidget::sizeHint() const
-{
- QSize s( widgetStack->sizeHint() );
- QSize t( tabBarStack->sizeHint() );
- return QSize( QMAX( s.width(), t.width() ), s.height() + t.height() );
-}
-
-void OTabWidget::resizeEvent( QResizeEvent * )
-{
- setUpLayout();
-}
-
int OTabWidget::currentTab()
{
- if ( currTab )
+ if ( m_currTab )
{
- return currTab->id();
+ return m_currTab->id();
}
return -1;
}
QWidget* OTabWidget::currentWidget()const
{
- if ( currTab )
+ if ( m_currTab )
{
- return currTab->control();
+ return m_currTab->control();
}
return 0;
}
diff --git a/libopie2/opieui/otabwidget.h b/libopie2/opieui/otabwidget.h
index b3423e8..e925592 100644
--- a/libopie2/opieui/otabwidget.h
+++ b/libopie2/opieui/otabwidget.h
@@ -1,292 +1,287 @@
/*
-                 This file is part of the Opie Project
-              Copyright (C) 2002 Dan Williams <williamsdr@acm.org>
+ This file is part of the Opie Project
+ Copyright (C) 2002, 2005 Dan Williams <drw@handhelds.org>
=.
.=l.
-           .>+-=
- _;:,     .>    :=|. This program is free software; you can
-.> <`_,   >  .   <= redistribute it and/or modify it under
-:`=1 )Y*s>-.--   : the terms of the GNU Library General Public
-.="- .-=="i,     .._ License as published by the Free Software
- - .   .-<_>     .<> Foundation; either version 2 of the License,
-     ._= =}       : or (at your option) any later version.
-    .%`+i>       _;_.
-    .i_,=:_.      -<s. This program is distributed in the hope that
-     +  .  -:.       = it will be useful, but WITHOUT ANY WARRANTY;
-    : ..    .:,     . . . without even the implied warranty of
-    =_        +     =;=|` MERCHANTABILITY or FITNESS FOR A
-  _.=:.       :    :=>`: PARTICULAR PURPOSE. See the GNU
-..}^=.=       =       ; Library General Public License for more
-++=   -.     .`     .: details.
- :     =  ...= . :.=-
- -.   .:....=;==+<; You should have received a copy of the GNU
-  -_. . .   )=.  = Library General Public License along with
-    --        :-=` this library; see the file COPYING.LIB.
+ .>+-=
+_;:, .> :=|. This program is free software; you can
+.> <`_, > . <= redistribute it and/or modify it under
+:`=1 )Y*s>-.-- : the terms of the GNU Library General Public
+.="- .-=="i, .._ License as published by the Free Software
+- . .-<_> .<> Foundation; either version 2 of the License,
+ ._= =} : or (at your option) any later version.
+ .%`+i> _;_.
+ .i_,=:_. -<s. This program is distributed in the hope that
+ + . -:. = it will be useful, but WITHOUT ANY WARRANTY;
+ : .. .:, . . . without even the implied warranty of
+ =_ + =;=|` MERCHANTABILITY or FITNESS FOR A
+ _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU
+..}^=.= = ; Library General Public License for more
+++= -. .` .: details.
+: = ...= . :.=-
+-. .:....=;==+<; You should have received a copy of the GNU
+ -_. . . )=. = Library General Public License along with
+ -- :-=` this library; see the file COPYING.LIB.
If not, write to the Free Software Foundation,
Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#ifndef OTABWIDGET_H
#define OTABWIDGET_H
/* OPIE */
#include <opie2/otabinfo.h>
/* QT */
#include <qwidget.h>
#include <qlist.h>
class QComboBox;
class QPixmap;
class QTabBar;
class QWidgetStack;
namespace Opie {
namespace Ui {
class OTabBar;
/**
* @class OTabWidget
* @brief The OTabWidget class provides a stack of widgets.
*
* OTabWidget is a derivation of TrollTech's QTabWidget which provides
* a stack of widgets. Widgets can be selected using either a tab bar or
* drop down list box.
*
* The normal way to use OTabWidget is to do the following in the
* constructor:
* - Create a OTabWidget.
* - Create a QWidget for each of the pages in the control, insert
* children into it, set up geometry management for it, and use addTab()
* to add the widget.
*/
class OTabWidget : public QWidget
{
Q_OBJECT
public:
/**
* @enum TabStyle
* @brief Defines how the widget selection control is displayed.
*
* Valid values:
* - Global: use globally selected options (qpe.conf - TabStyle & TabPosition)
* - TextTab: Tabbed widget selection with text labels
* - IconTab: Tabbed widget selection with icon labels, text label for active widget
* (similar to Opie launcher)
* - TextList: Drop down list widget selection with text labels
* - IconList: Drop down list widget selection with icon & text labels
*/
enum TabStyle { Global, TextTab, IconTab, TextList, IconList };
/**
* @enum TabPosition
* @brief Defines where the widget selection control is drawn.
*
* Valid values:
* - Top: Widget selection control is drawn above widgets
* - Bottom: Widget selection control is drawn below widgets
*/
enum TabPosition { Top, Bottom };
/**
* @fn OTabWidget( QWidget *parent = 0, const char *name = 0, TabStyle s = Global, TabPosition p = Top )
* @brief Object constructor.
*
* @param parent Pointer to parent of this control.
* @param name Name of control.
* @param s Style of widget selection control.
* @param p Position of the widget selection control.
*
* Constructs a new OTabWidget control with parent and name. The style and position parameters
* determine how the widget selection control will be displayed.
*/
OTabWidget( QWidget * = 0, const char * = 0, TabStyle = Global, TabPosition = Top );
/**
* @fn ~OTabWidget()
* @brief Object destructor.
*/
~OTabWidget();
/**
* @fn addTab( QWidget *child, const QString &icon, const QString &label )
* @brief Add new widget to control.
*
* @param child Widget control.
* @param icon Path to icon.
* @param label Text label.
*/
void addTab( QWidget *, const QString &, const QString & );
/**
* @fn removePage( QWidget *widget )
* @brief Remove widget from control. Does not delete widget.
*
* @param widget Widget control to be removed.
*/
void removePage( QWidget * );
/**
* @fn changeTab( QWidget *widget, const QString &icon, const QString &label )
* @brief Change text and/or icon for existing tab
*
* @param child Widget control.
* @param icon Path to icon.
* @param label Text label.
*/
void changeTab( QWidget *, const QString &, const QString & );
/**
* @fn tabStyle()const
* @brief Returns current widget selection control style.
*/
TabStyle tabStyle() const;
/**
* @fn setTabStyle( TabStyle s )
* @brief Set the current widget selection control style.
*
* @param s New style to be used.
*/
void setTabStyle( TabStyle );
/**
* @fn tabPosition()const
* @brief Returns current widget selection control position.
*/
TabPosition tabPosition() const;
/**
* @fn setTabPosition( TabPosition p )
* @brief Set the current widget selection control position.
*
* @param p New position of widget selection control.
*/
void setTabPosition( TabPosition );
/**
* @fn setCurrentTab( QWidget *childwidget )
* @brief Selects and brings to top the desired widget by using widget pointer.
*
* @param childwidget Widget to select.
*/
void setCurrentTab( QWidget * );
/**
* @fn setCurrentTab( const QString &tabname )
* @brief Selects and brings to top the desired widget, by using label.
*
* @param tabname Text label for widget to select.
*/
void setCurrentTab( const QString & );
/**
* @fn setCurrentTab( int )
* @brief Selects and brings to top the desired widget, by using id.
*
* @param tab id for widget to select.
*/
void setCurrentTab(int);
/**
- * @fn sizeHint()const
- * @brief Reimplemented for internal purposes.
- */
- QSize sizeHint() const;
-
-/**
* @fn currentTab( )
* @brief returns current tab id.
*/
// ### make const
int currentTab()/* const */;
/**
* @brief returns the current page of the active tab
*
* @since 1.2
*/
QWidget* currentWidget()const;
protected:
/**
* @fn resizeEvent( QResizeEvent * )
* @brief Reimplemented for internal purposes.
*/
void resizeEvent( QResizeEvent * );
private:
- OTabInfoList tabs;
- OTabInfo *currTab;
-
- TabStyle tabBarStyle;
- TabPosition tabBarPosition;
-
- QWidgetStack *tabBarStack;
- OTabBar *tabBar;
- QComboBox *tabList;
+ OTabInfoList m_tabs; // List of information for tabs
+ OTabInfo *m_currTab; // Current tab displayed
+ TabStyle m_tabBarStyle; // Current style of control
+ TabPosition m_tabBarPosition; // Position of selector control
+ bool m_usingTabs; // Indicates whether style is either TextTab or IconTab
+ // (saves from having to always check for these 2 values)
+
+ // UI components
+ OTabBar *m_tabBar;
+ QComboBox *m_tabList;
+ QWidgetStack *m_widgetStack;
- QWidgetStack *widgetStack;
class Private;
Private* d;
/**
* @fn loadSmooth( const QString &name )
* @brief Loads icon for widget.
*
* @param name Name of icon image file.
*/
QPixmap loadSmooth( const QString & );
/**
* @fn selectTab( OTabInfo *tab )
* @brief Internal function to select desired widget.
*
* @param tab Pointer to data for widget.
*/
void selectTab( OTabInfo * );
/**
* @fn setUpLayout()
* @brief Internal function to adjust layout.
*/
void setUpLayout();
signals:
/**
* @fn currentChanged( QWidget *widget )
* @brief This signal is emitted whenever the widget has changed.
*
* @param widget Pointer to new current widget.
*/
void currentChanged( QWidget * );
private slots:
/**
* @fn slotTabBarSelected( int id )
* @brief Slot which is called when a tab is selected.
*
* @param id ID of widget selected.
*/
void slotTabBarSelected( int );
/**
* @fn slotTabListSelected( int index )
* @brief Slot which is called when a drop down selection is made.
*
* @param id Index of widget selected.
*/
void slotTabListSelected( int );
};
}
}
#endif