You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdewebdev/lib/compatibility/kmdi/qextmdi/kmdichildarea.h

308 lines
8.7 KiB

//----------------------------------------------------------------------------
// filename : kmdichildarea.h
//----------------------------------------------------------------------------
// Project : KDE MDI extension
//
// begin : 07/1999 by Szymon Stefanek as part of kvirc
// (an IRC application)
// changes : 09/1999 by Falk Brettschneider to create an
// - 06/2000 stand-alone TQt extension set of
// classes and a TQt-based library
// 2000-2003 maintained by the KDevelop project
//
// copyright : (C) 1999-2003 by Falk Brettschneider
// and
// Szymon Stefanek (stefanek@tin.it)
// email : falkbr@tdevelop.org (Falk Brettschneider)
//----------------------------------------------------------------------------
//
//----------------------------------------------------------------------------
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU Library General Public License as
// published by the Free Software Foundation; either version 2 of the
// License, or (at your option) any later version.
//
//----------------------------------------------------------------------------
#ifndef _KMDI_CHILD_AREA_H_
#define _KMDI_CHILD_AREA_H_
#include <tqframe.h>
#include <tqptrlist.h>
#include "kmdichildfrm.h"
#include "kmdichildview.h"
class KMdiChildAreaPrivate;
/**
* @short Internal class.
*
* The main frame widget KMdiMainFrm consists of 2 child widgets. One is this class.
* It's the widget where the child frames (emulated toplevel MDI views) live in.
* This class is the manager for the child frame widgets because it controls the
* Z-order widget stack of KMdiChildFrm's.
* It provides all placing and positioning algorithms for docked (attached) MDI views.
*
* KMdiChildArea doesn't know anything about the actual MDI views. It only knows
* and manages the frame widgets of attached MDI views.
* All actions and stuff concerning only to childframes are handled here.
*/
class KMDI_EXPORT KMdiChildArea : public TQFrame
{
friend class KMdiChildFrmCaption;
friend class KMdiChildFrm;
Q_OBJECT
TQ_OBJECT
// attributes
public:
/**
* Z Order stack of KMdiChildFrm childframe windows (top=last)
*/
TQPtrList<KMdiChildFrm> *m_pZ; //Auto delete enabled
/**
* the default size of an newly created childframe
*/
TQSize m_defaultChildFrmSize;
protected:
/**
* The MDI childframe window caption font
*/
TQFont m_captionFont;
/**
* The foreground color of the active MDI childframe window caption
*/
TQColor m_captionActiveBackColor;
/**
* The background color of the active MDI childframe window captions
*/
TQColor m_captionActiveForeColor;
/**
* The foreground color of inactive MDI childframe window captions
*/
TQColor m_captionInactiveBackColor;
/**
* The background color of inactive MDI childframe window captions
*/
TQColor m_captionInactiveForeColor;
int m_captionFontLineSpacing;
// methods
public:
/**
* Consruction. Note: This class needn't to know about KMdiMainFrm .
*/
KMdiChildArea( TQWidget *parent );
/**
* Destructor : THERE should be no child windows anymore...
* Howewer it simply deletes all the child widgets :)
*/
~KMdiChildArea();
/**
* Appends a new KMdiChildFrm to this manager.
* The child is shown,raised and gets focus if this window has it.
*/
void manageChild( KMdiChildFrm *lpC, bool bShow = true, bool bCascade = true );
/**
* Destroys a managed KMdiChildFrm
* Also deletes the client attached to this child.
*/
void destroyChild( KMdiChildFrm* child, bool focusTopChild = true );
/**
* Destroys a managed KMdiChildFrm
* Clients attached to the KMdiChildFrm are not deleted.
* @param child
*/
void destroyChildButNotItsView( KMdiChildFrm *lpC, bool bFocusTopChild = true );
/**
* Brings the child @p child to the top of the stack
* The child is focused if @p setFocus is true. If setFocus is false, the
* child is just raised.
* @param child
*/
void setTopChild( KMdiChildFrm* child, bool setFocus = false );
/**
* Returns the topmost child (the active one) or 0 if there are no children.
* Note that the topmost child may be also hidded , if ALL the windows are minimized.
*/
inline KMdiChildFrm * topChild() const { return m_pZ->last(); }
/**
* Returns the number of visible children
*/
int getVisibleChildCount() const;
/**
* Calculates the cascade point for the given index. If index is -1
* the cascade point is calculated for the window following the last window
* @param indexOfWindow the index of the window in relation the z-ordered window list
*/
TQPoint getCascadePoint( int indexOfWindow = -1 );
/**
* Sets the MDI childframe window caption font
* A relayout does not occur when using this function
*/
void setMdiCaptionFont( const TQFont &fnt );
/**
* Sets the foreground color of the active MDI childframe window caption
* A relayout does not occur when using this function
*/
void setMdiCaptionActiveForeColor( const TQColor &clr );
/**
* Sets the background color of the active MDI childframe window captions
* A relayout does not occur when using this function
*/
void setMdiCaptionActiveBackColor( const TQColor &clr );
/**
* Sets the foreground color of inactive MDI childframe window captions
* A relayout does not occur when using this function
*/
void setMdiCaptionInactiveForeColor( const TQColor &clr );
/**
* Sets the background color of inactive MDI childframe window captions
* A relayout does not occur when using this function
*/
void setMdiCaptionInactiveBackColor( const TQColor &clr );
/**
* Gets all caption colors, consistent with current WM settings
* (or other Desktop settings e.g. system settings for win32)
* This method is useful not only for KMDI child windows.
* Colors are returned via activeBG, activeFG, inactiveBG, inactiveFG references.
*
* @deprecated Use KGlobalSettings::activeTitleColor(), KGlobalSettings::activeTextColor(),
* KGlobalSettings::inactiveTitleColor() and KGlobalSettings::inactiveTextColor() instead.
*/
static void getCaptionColors( const TQPalette &pal, TQColor &activeBG, TQColor &activeFG,
TQColor &inactiveBG, TQColor &inactiveFG ) KDE_DEPRECATED;
public slots:
/**
* Cascades all windows resizing them to the minimum size.
*/
void cascadeWindows();
/**
* Cascades all windows resizing them to the maximum available size.
*/
void cascadeMaximized();
/**
* Maximize all windows but only in vertical direction
*/
void expandVertical();
/**
* Maximize all windows but only in horizontal direction
*/
void expandHorizontal();
/**
* Gives focus to the topmost child if it doesn't get focus
* automatically or you want to wait to give it focus
*/
void focusTopChild();
/**
* Tile Pragma
*/
void tilePragma();
/**
* Tile Anodine
*/
void tileAnodine();
/**
* Tile all the windows in the child area vertically
*/
void tileVertically();
/**
* Position and layout the minimized child frames
*/
void layoutMinimizedChildren();
protected:
/**
* Internally used for the tile algorithm
*/
void tileAllInternal( int maxWnds );
/**
* Automatically resizes a maximized MDI view and layouts the positions of minimized MDI views.
*/
virtual void resizeEvent( TQResizeEvent * );
/**
* Shows the 'Window' popup menu on right mouse button click
*/
void mousePressEvent( TQMouseEvent *e );
/**
* Internally used. Actions that are necessary when an MDI view gets minimized
*/
void childMinimized( KMdiChildFrm *lpC, bool bWasMaximized );
signals:
/**
* Signals that there aren't maximized child frames any more
*/
void noMaximizedChildFrmLeft( KMdiChildFrm* );
/**
* Signals that the child frames are maximized now
*/
void nowMaximized( bool );
/**
* Signals a KMdiMainFrm that the signal/slot connections of the system buttons in the
* menubar (only in Maximize mode) must be updated to another MDI view because the focused
* MDI view has changed
* @internal
*/
void sysButtonConnectionsMustChange( KMdiChildFrm*, KMdiChildFrm* );
/**
* Signals a KMdiMainFrm that the 'Window' popup menu must be shown
* @internal
*/
void popupWindowMenu( TQPoint );
/**
* Signals that the last attached (docked) MDI view has been closed.
* Note: Detached MDI views can remain.
*/
void lastChildFrmClosed();
private:
KMdiChildAreaPrivate *d;
};
#endif // _KMDICHILDAREA_H_
// kate: indent-mode csands; tab-width 4; auto-insert-doxygen on;