Diffstat (limited to 'libopie2/opieui/big-screen/osplitter.cpp') (more/less context) (ignore whitespace changes)
| -rw-r--r-- | libopie2/opieui/big-screen/osplitter.cpp | 638 |
1 files changed, 638 insertions, 0 deletions
diff --git a/libopie2/opieui/big-screen/osplitter.cpp b/libopie2/opieui/big-screen/osplitter.cpp new file mode 100644 index 0000000..89f3793 --- a/dev/null +++ b/libopie2/opieui/big-screen/osplitter.cpp @@ -0,0 +1,638 @@ +/* + =. This file is part of the OPIE Project + .=l. Copyright (c) 2003 hOlgAr <zecke@handhelds.org> + .>+-= + _;:, .> :=|. This library 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 library 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 "osplitter.h" + +/* OPIE */ +#include <opie2/otabwidget.h> + +/* QT */ +#include <qvaluelist.h> +#include <qvbox.h> + +using namespace Opie; + +/** + * + * This is the constructor of OSplitter + * You might want to call setSizeChange to tell + * OSplitter to change its layout when a specefic + * mark was crossed. OSplitter sets a default value. + * + * You cann add widget with addWidget to the OSplitter. + * OSplitter supports also grouping of Splitters where they + * can share one OTabBar in small screen mode. This can be used + * for email clients like vies but see the example. + * + * @param orient The orientation wether to layout horizontal or vertical + * @param parent The parent of this widget + * @param name The name passed on to QObject + * @param fl Additional widgets flags passed to QWidget + * + * @short single c'tor of the OSplitter + */ +OSplitter::OSplitter( Orientation orient, QWidget* parent, const char* name, WFlags fl ) + : QFrame( parent, name, fl ) +{ + m_orient = orient; + m_hbox = 0; + m_size_policy = 330; + setFontPropagation( AllChildren ); + setPalettePropagation( AllChildren ); + + /* start by default with the tab widget */ + m_tabWidget = 0; + m_parentTab = 0; + changeTab(); + +} + + +/** + * Destructor destructs this object and cleans up. All child + * widgets will be deleted + * @see addWidget + */ +OSplitter::~OSplitter() +{ + qWarning("Deleted Splitter"); + m_splitter.setAutoDelete( true ); + m_splitter.clear(); + + delete m_hbox; + delete m_tabWidget; +} + + +/** + * Sets the label for the Splitter. This label will be used + * if a parent splitter is arranged as TabWidget but + * this splitter is in fullscreen mode. Then a tab with OSplitter::label() + * and iconName() gets added. + * + * @param name The name of the Label + */ +void OSplitter::setLabel( const QString& name ) +{ + m_name = name; +} + +/** + * @see setLabel but this is for the icon retrieved by Resource + * + * @param name The name of the icon in example ( "zoom" ) + */ +void OSplitter::setIconName( const QString& name ) +{ + m_icon = name; +} + + +/** + * returns the iconName + * @see setIconName + */ +QString OSplitter::iconName()const +{ + return m_icon; +} + +/** + * returns the label set with setLabel + * @see setLabel + */ +QString OSplitter::label()const +{ + return m_name; +} + +/** + * This function sets the size change policy of the splitter. + * If this size marked is crossed the splitter will relayout. + * Note: that depending on the set Orientation it'll either look + * at the width or height. + * Note: If you want to from side to side view to tabbed view you need + * to make sure that the size you supply is not smaller than the minimum + * size of your added widgets. Note that if you use widgets like QComboBoxes + * you need to teach them to accept smaller sizes as well @see QWidget::setSizePolicy + * + * @param width_height The mark that will be watched. Interpreted depending on the Orientation of the Splitter. + * @return void + */ +void OSplitter::setSizeChange( int width_height ) +{ + m_size_policy = width_height; + QSize sz(width(), height() ); + QResizeEvent ev(sz, sz ); + resizeEvent(&ev); +} + +/** + * This functions allows to add another OSplitter and to share + * the OTabBar in small screen mode. The ownerships gets transfered. + * OSplitters are always added after normal widget items + */ +void OSplitter::addWidget( OSplitter* split ) +{ + m_splitter.append( split ); + + /* + * set tab widget + */ + if (m_tabWidget ) + setTabWidget( m_parentTab ); + else + { + Opie::OSplitterContainer con; + con.widget =split; + addToBox( con ); + } +} + +/* + * If in a tab it should be removed + * and if in a hbox the reparent kills it too + */ +/** + * This removes the splitter again. You currently need to call this + * before you delete or otherwise you can get mem corruption + * or other weird behaviour. + * Owner ship gets transfered back to you it's current parent + * is 0 + */ +void OSplitter::removeWidget( OSplitter* split) +{ + split->setTabWidget( 0 ); + split->reparent( 0, 0, QPoint(0, 0) ); +} + +/** + * Adds a widget to the Splitter. The widgets gets inserted + * at the end of either the Box or TabWidget. + * Ownership gets transfered and the widgets gets reparented. + * Note: icon and label is only available on small screensizes + * if size is smaller than the mark + * Warning: No null checking of the widget is done. Only on debug + * a message will be outputtet + * + * @param wid The widget which will be added + * @param icon The icon of the possible Tab + * @param label The label of the possible Tab + */ +void OSplitter::addWidget( QWidget* wid, const QString& icon, const QString& label ) +{ +#ifdef DEBUG + if (!wid ) + { + qWarning("Widget is not valid!"); + return; + } +#endif + Opie::OSplitterContainer cont; + cont.widget = wid; + cont.icon =icon; + cont.name = label; + + m_container.append( cont ); + + /* + * + */ + if (!m_splitter.isEmpty() && (m_tabWidget || m_parentTab ) ) + setTabWidget( m_parentTab ); + else + { + if (m_hbox ) + addToBox( cont ); + else + addToTab( cont ); + } +} + + +/** + * Removes the widget from the tab widgets if necessary. + * OSplitter drops ownership of this widget and the widget + * will be reparented i tto 0. + * The widget will not be deleted. + * + * @param w The widget to be removed + */ +void OSplitter::removeWidget( QWidget* w) +{ + ContainerList::Iterator it; + for ( it = m_container.begin(); it != m_container.end(); ++it ) + if ( (*it).widget == w ) + break; + + if (it == m_container.end() ) + return; + + + /* only tab needs to be removed.. box recognizes it */ + if ( !m_hbox ) + removeFromTab( w ); + + + /* Find reparent it and remove it from our list */ + + w->reparent( 0, 0, QPoint(0, 0)); + it = m_container.remove( it ); + +} + + +/** + * This method will give focus to the widget. If in a tabwidget + * the tabbar will be changed + * + * @param w The widget which will be set the current one + */ +void OSplitter::setCurrentWidget( QWidget* w) +{ + if (m_tabWidget ) + m_tabWidget->setCurrentTab( w ); + // else + // m_hbox->setFocus( w ); + +} + +/** + * This is an overloaded member function and only differs in the + * argument it takes. + * Searches list of widgets for label. It'll pick the first label it finds + * + * @param label Label to look for. First match will be taken + */ +void OSplitter::setCurrentWidget( const QString& label ) +{ + ContainerList::Iterator it; + for (it = m_container.begin(); it != m_container.end(); ++it ) + { + if ( (*it).name == label ) + { + setCurrentWidget( (*it).widget ); + break; + } + } +} + +/** + * This will only work when the TabWidget is active + * If everything is visible this signal is kindly ignored + * @see OTabWidget::setCurrentTab(int) + * + * @param tab The tab to make current + */ +void OSplitter::setCurrentWidget( int tab ) +{ + if (m_tabWidget ) + m_tabWidget->setCurrentTab( tab ); +} + +/** + * return the currently activated widget if in tab widget mode + * or null because all widgets are visible + */ +QWidget* OSplitter::currentWidget() const +{ + if (m_tabWidget) + return m_tabWidget->currentWidget(); + else if (m_parentTab ) + return m_parentTab->currentWidget(); + + return 0l; +} +/* wrong */ +#if 0 +/** + * @reimplented for internal reasons + * returns the sizeHint of one of its sub widgets + */ +QSize OSplitter::sizeHint()const +{ + if (m_parentTab ) + return QFrame::sizeHint(); + + if (m_hbox ) + return m_hbox->sizeHint(); + else + return m_tabWidget->sizeHint(); +} + +QSize OSplitter::minimumSizeHint()const +{ + if (m_parentTab ) + return QFrame::minimumSizeHint(); + if (m_hbox) + return m_hbox->sizeHint(); + else + return m_tabWidget->sizeHint(); +} +#endif + +/** + * @reimplemented for internal reasons + */ +void OSplitter::resizeEvent( QResizeEvent* res ) +{ + QFrame::resizeEvent( res ); + /* + * + */ + // qWarning("Old size was width = %d height = %d", res->oldSize().width(), res->oldSize().height() ); + bool mode = true; + qWarning("New size is width = %d height = %d %s", res->size().width(), res->size().height(), name() ); + if ( res->size().width() > m_size_policy && + m_orient == Horizontal ) + { + changeHBox(); + mode = false; + } + else if ( (res->size().width() <= m_size_policy && + m_orient == Horizontal ) || + (res->size().height() <= m_size_policy && + m_orient == Vertical ) ) + { + changeTab(); + } + else if ( res->size().height() > m_size_policy && + m_orient == Vertical ) + { + qWarning("Changng to vbox %s", name() ); + changeVBox(); + mode = false; + } + + emit sizeChanged(mode, m_orient ); +} + +/* + * Adds a container to a tab either the parent tab + * or our own + */ +void OSplitter::addToTab( const Opie::OSplitterContainer& con ) +{ + QWidget *wid = con.widget; + // not needed widgetstack will reparent as well wid.reparent(m_tabWidget, wid->getWFlags(), QPoint(0, 0) ); + if (m_parentTab ) + m_parentTab->addTab( wid, con.icon, con.name ); + else + m_tabWidget->addTab( wid, con.icon, con.name ); +} + + +/* + * adds a container to the box + */ +void OSplitter::addToBox( const Opie::OSplitterContainer& con ) +{ + QWidget* wid = con.widget; + wid->reparent(m_hbox, 0, QPoint(0, 0) ); +} + + +/* + * Removes a widget from the tab + */ +void OSplitter::removeFromTab( QWidget* wid ) +{ + if (m_parentTab ) + m_parentTab->removePage( wid ); + else + m_tabWidget->removePage( wid ); +} + +/* + * switches over to a OTabWidget layout + * it is recursive + */ +void OSplitter::changeTab() +{ + /* if we're the owner of the tab widget */ + if (m_tabWidget ) + { + raise(); + show(); + m_tabWidget->setGeometry( frameRect() ); + return; + } + + qWarning(" New Tab Widget %s", name() ); + /* + * and add all widgets this will reparent them + * delete m_hbox set it to 0 + * + */ + OTabWidget *tab; + if ( m_parentTab ) + { + hide(); + tab = m_parentTab; + /* expensive but needed cause we're called from setTabWidget and resizeEvent*/ + if (!m_container.isEmpty() ) + { + ContainerList::Iterator it = m_container.begin(); + for (; it != m_container.end(); ++it ) + m_parentTab->removePage( (*it).widget ); + } + } + else + tab = m_tabWidget = new OTabWidget( this ); + + connect(tab, SIGNAL(currentChanged(QWidget*) ), + this, SIGNAL(currentChanged(QWidget*) ) ); + + for ( ContainerList::Iterator it = m_container.begin(); it != m_container.end(); ++it ) + { + qWarning("Widget is %s", (*it).name.latin1() ); + addToTab( (*it) ); + } + + for ( OSplitter* split = m_splitter.first(); split; split = m_splitter.next() ) + { + split->reparent(this, 0, QPoint(0, 0) ); + split->setTabWidget( tab ); + } + + + delete m_hbox; + m_hbox = 0; + if (!m_tabWidget ) + return; + + m_tabWidget->setGeometry( frameRect() ); + m_tabWidget->show(); + +} + +/* + * changes over to a box + * this is recursive as well + */ +void OSplitter::changeHBox() +{ + if (m_hbox ) + { + m_hbox->setGeometry( frameRect() ); + return; + } + + qWarning("new HBox %s", name() ); + m_hbox = new QHBox( this ); + commonChangeBox(); +} + +void OSplitter::changeVBox() +{ + if (m_hbox ) + { + m_hbox->setGeometry( frameRect() ); + return; + } + + qWarning("New VBOX %s", name() ); + m_hbox = new QVBox( this ); + + commonChangeBox(); + +} + +/* + * common box code + * first remove and add children + * the other splitters + * it is recursive as well due the call to setTabWidget + */ +void OSplitter::commonChangeBox() +{ + qWarning(" Name of Splitters is %s", name() ); + + for (ContainerList::Iterator it = m_container.begin(); it != m_container.end(); ++it ) + { + /* only if parent tab.. m_tabWidgets gets deleted and would do that as well */ + if (m_parentTab ) + removeFromTab( (*it).widget ); + qWarning("Adding to box %s", (*it).name.latin1() ); + addToBox( (*it) ); + } + for ( OSplitter* split = m_splitter.first(); split; split = m_splitter.next() ) + { + /* tell them the world had changed */ + split->setTabWidget( 0 ); + Opie::OSplitterContainer con; + con.widget = split; + // con.widget = split->m_tabWidget ? static_cast<QWidget*>(split->m_tabWidget) + // : static_cast<QWidget*>(split->m_hbox); + addToBox( con ); + } + + + + if (m_parentTab ) + m_parentTab->addTab(m_hbox, iconName(), label() ); + else + { + qWarning(" setting Box geometry for %s", name() ); + m_hbox->setGeometry( frameRect() ); + m_hbox->show(); + delete m_tabWidget; + m_tabWidget = 0; + show(); // also show this widget + } +} + +/* + * sets the tabwidget, removes tabs, and relayouts the widget + */ +void OSplitter::setTabWidget( OTabWidget* wid) +{ + /* clean up cause m_parentTab will not be available for us */ + if ( m_parentTab ) + { + if (m_hbox ) + m_parentTab->removePage( m_hbox ); + else if (!m_container.isEmpty() ) + { + ContainerList::Iterator it = m_container.begin(); + for ( ; it != m_container.end(); ++it ) + m_parentTab->removePage( (*it).widget ); + } + } + /* the parent Splitter changed so either make us indepent or dep */ + + m_parentTab = wid; + + QWidget *tab = m_tabWidget; + QWidget *box = m_hbox; + m_hbox = 0; m_tabWidget = 0; + + if ( layoutMode() ) + changeTab(); + else if (m_orient == Horizontal ) + changeHBox(); + else + changeVBox(); + + /* our own crap is added and children from change* */ + delete tab; + delete box; +} + +#if 0 +void OSplitter::reparentAll() +{ + if (m_container.isEmpty() ) + return; + + ContainerList::Iterator it = m_container.begin(); + for ( ; it != m_container.end(); ++it ) + (*it).wid->reparent(0, 0, QPoint(0, 0) ); + + +} +#endif + +/** + * @internal + */ +bool OSplitter::layoutMode()const +{ + if ( size().width() > m_size_policy && + m_orient == Horizontal ) + { + return false; + } + else if ( size().height() > m_size_policy && + m_orient == Vertical ) + { + return false; + } + + return true; +} |