diff options
author | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-01-20 01:29:50 +0000 |
---|---|---|
committer | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-01-20 01:29:50 +0000 |
commit | 8362bf63dea22bbf6736609b0f49c152f975eb63 (patch) | |
tree | 0eea3928e39e50fae91d4e68b21b1e6cbae25604 /kexi/main/ksplitter.h | |
download | koffice-8362bf63dea22bbf6736609b0f49c152f975eb63.tar.gz koffice-8362bf63dea22bbf6736609b0f49c152f975eb63.zip |
Added old abandoned KDE3 version of koffice
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/koffice@1077364 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kexi/main/ksplitter.h')
-rw-r--r-- | kexi/main/ksplitter.h | 256 |
1 files changed, 256 insertions, 0 deletions
diff --git a/kexi/main/ksplitter.h b/kexi/main/ksplitter.h new file mode 100644 index 00000000..db72ec88 --- /dev/null +++ b/kexi/main/ksplitter.h @@ -0,0 +1,256 @@ +/* This file is part of the KDE libraries + Copyright (C) 2000 Max Judin <novaprint@mtu-net.ru> + Copyright (C) 2005 Dominik Haumann <dhdev@gmx.de> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License version 2 as published by the Free Software Foundation. + + 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., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. +*/ + +/* + IMPORTANT Note: This file compiles also in Qt-only mode by using the NO_KDE2 precompiler definition +*/ + +#ifndef KDOCKWIDGET_PRIVATE_H +#define KDOCKWIDGET_PRIVATE_H + +#include <qwidget.h> +#include <qpushbutton.h> + +#include <kdeversion.h> + +#ifndef NO_KDE2 +#include <netwm_def.h> +#endif + +class QFrame; +class KDockContainer; +class KDockWidget; + + +/** + * Like QSplitter but specially designed for dockwidgets stuff. + * @internal + * + * @author Max Judin. + */ +class KDockSplitter : public QWidget +{ + //Q_OBJECT +public: + /** + * Constructor. + * @param parent parent widget + * @param name name + * @param orient orientation. Either @p Vertical or @p Horizontal + * @param pos procentual position of the splitter. Must be int [0...100]. + */ + KDockSplitter(QWidget *parent= 0, const char *name= 0, Orientation orient= Vertical, int pos= 50); + virtual ~KDockSplitter(){}; + + /** + * Initialize the splitter. If @p c0 or @p c1 is 0L the child will not + * be replaced. So if you want to change @p c1 and not change c0, you'd + * call @p activate(0L,new_widget); + * + * @param c0 the widget on top/left + * @param c1 the widget on borrom/right + */ + void activate(QWidget *c0, QWidget *c1 = 0L); + /** + * Disables the splitter. + */ + void deactivate(); + + /** + * Return the separator position in percent (%), so the range is [0..100] + * @return separator position in percent + */ + int separatorPosInPercent() +#if KDE_IS_VERSION(3,4,89) + ; +#else + { +// kdDebug() << "^^^^^^^^^^^^^^^^^^^^^ separatorPosInPercent() " << separatorPos() / (factor/100) << " " << separatorPos() / 100 << endl; + return separatorPos() / 100; + } +#endif + /** + * Set the separator position in percent (%), so the range must be [0..100] + * @param percent separator position in percent + */ + void setSeparatorPosInPercent(int percent) +#if KDE_IS_VERSION(3,4,89) + ; +#else + { +// kdDebug() << "^^^^^^^^^^^^^^^^^^^^^ setSeparatorPosInPercent() " << percent << " " << separatorPos() / 100 << endl; + setSeparatorPos( percent * 100, false ); + } +#endif + + /** + * Return the separator position in the range [0..100000] + * To get the separator position in procent (%), call + * @p separatorPositionInPercent()! + * + * @return high resolution separator position in range [0..100000], + * where 100000 is 100%. + */ + int separatorPos() const; + /** + * set separator position. + * @param pos the separator position in range [0..100000]. 100000 is 100%. + * @param do_resize true by default + */ + void setSeparatorPos(int pos, bool do_resize = true); + /** + * For usage from outside. + * If the splitter is in fixed position when called, + * the value of @p pos will be saved and used when the splitter + * is restored. + * If @p do_resize is true, the size will be changed unless the splitter + * is in fixed mode. + */ + // ### please come up with a nicer name + void setSeparatorPosX(int pos, bool do_resize=false); + + /** + * The eventfilter installed on the @p divider processes + * all splitter resizing events. + */ + virtual bool eventFilter(QObject *, QEvent *); + virtual bool event( QEvent * ); + + /** + * @return the top/left child widget. + */ + QWidget* getFirst() const { return child0; } + /** + * @return the bottom/right child widget. + */ + QWidget* getLast() const { return child1; } + /** + * If @p w is child0, return child1, otherwise child0. + * @return the other child widget + */ + QWidget* getAnother( QWidget* w ) const; + void updateName(); + + /** + * Set opaque flag. + * @param b if true, both child widgets are resized immediately, + * if false, the widgets only resize on MouseUpEvent. + */ + void setOpaqueResize(bool b=true); + bool opaqueResize() const; + + /** + * If @p b is true, the splitter will keep its size on resize events. + * If no @p KDockContainer is around, always the left child0 will be fixed size. + */ + void setKeepSize(bool b=true); + bool keepSize() const; + + + void setForcedFixedWidth(KDockWidget *dw,int w); + void setForcedFixedHeight(KDockWidget *dw,int h); + void restoreFromForcedFixedSize(KDockWidget *dw); + + /** + * The orientation is either @p Horizontal or @p Vertical. + */ + Orientation orientation(){return m_orientation;} + +protected: + friend class KDockContainer; + /** + * Make sure the splitter position is not out of bounds. + * @param position the current position + * @return a (new) valid splitter position. + */ + int checkValue(int position) const; + /** + * Make sure the splitter position is not out of bounds. It has + * to honor all child widgets' mimimumSize. + * @param position current divider position + * @param child the overlapping child + * @return the (new) splitter position. + */ + int checkValueOverlapped(int position, QWidget* child) const; + + /** + * The resize event resizes @p child0, @p child1 and the @p divider. + * The new sizes are dependant of + * - whether @p child0 or @p child1 is a KDockContainer + * - the current mode which may be + * - Closed + * - Overlapped (opened) + * - Nonoverlap (opened) + * . + * . + * So there are 3*2=6 different modes we have to face. + * @param ev the resize Event. If @p ev=0L the user changed + * the mode (for example from overlap to nonoverlap mode). + */ + virtual void resizeEvent(QResizeEvent *ev); + +/* +protected slots: + void delayedResize();*/ + +private: + /** + * updates the minimum and maximun sizes for the KDockSplitter. + * The sizes depend on the minimum and maximum sizes of the two child + * widgets. + */ + void setupMinMaxSize(); + /** + * child0 and child1 contain the embedded widgets. They are always valid + * so no need to make pointer checks. + * child[01]->getWidget() may be KDockContainer. + */ + QWidget *child0, *child1; + Orientation m_orientation; + /** + * If initialised is true, the divider!=0L. If false, the divider==0L! + */ + bool initialised; + /** + * The splitter controller which is between child0 and child1. + * Its size is 4 pixel. + */ + QFrame* divider; + /** + * @p xpos and @p savedXPos represent the current divider position. + * If the orientation is Horizontal @p xpos actually is "ypos". So + * do not get confused only because of the 'x'. + * + * xpos and savedXPos are internally high resolution. So *not* 0..100% + * but 0..100000=100%. This fixes rounding bugs. In fact, this should + * be a double, but due to binary compatibility we can not change this + * as we would have to change it in all kdockwidgets. + */ + int xpos, savedXPos; + bool mOpaqueResize, mKeepSize; + int fixedWidth0,fixedWidth1; + int fixedHeight0,fixedHeight1; + bool m_dontRecalc; + /** + * resolution factor, 0 = 0%, 100000=100% + */ + static const int factor = 100000; +}; + +#endif |