pytqt/sip/tqt/tqmainwindow.sip

// This is the SIP interface definition for TQMainWindow.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyTQt.
// 
// This copy of PyTQt is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2, or (at your option) any later
// version.
// 
// PyTQt is supplied 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 General Public License for more
// details.
// 
// You should have received a copy of the GNU General Public License along with
// PyTQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

%DefaultEncoding "UTF-8"

%ExportedDoc
<Sect2><Title>TQMainWindow</Title>
<FuncSynopsis>
	<FuncDef>TQTextStream &amp;<Function>operator&lt&lt;</Function></FuncDef>
	<ParamDef>TQTextStream &amp;<Parameter></Parameter></ParamDef>
	<ParamDef>const TQMainWindow &amp;<Parameter></Parameter></ParamDef>
</FuncSynopsis>
<Para>
This operator is fully implemented.  (TQt v3+)
</Para>

<FuncSynopsis>
	<FuncDef>TQTextStream &amp;<Function>operator&gt&gt;</Function></FuncDef>
	<ParamDef>TQTextStream &amp;<Parameter></Parameter></ParamDef>
	<ParamDef>TQMainWindow &amp;<Parameter></Parameter></ParamDef>
</FuncSynopsis>
<Para>
This operator is fully implemented.  (TQt v3+)
</Para>

<FuncSynopsis>
	<FuncDef>bool <Function>getLocation</Function></FuncDef>
	<ParamDef>TQToolBar *<Parameter>tb</Parameter></ParamDef>
	<ParamDef>ToolBarDock &amp;<Parameter>dock</Parameter></ParamDef>
	<ParamDef>int &amp;<Parameter>index</Parameter></ParamDef>
	<ParamDef>bool &amp;<Parameter>nl</Parameter></ParamDef>
	<ParamDef>int &amp;<Parameter>extraOffset</Parameter></ParamDef>
</FuncSynopsis>
<Para>
This takes only the <Literal>tb</Literal> parameter and returns a tuple of the
result, <Literal>dock</Literal>, <Literal>index</Literal>,
<Literal>nl</Literal> and <Literal>extraOffset</Literal> values.  (TQt v2.1.0+)
</Para>

<FuncSynopsis>
	<FuncDef>TQPtrList&lt;TQToolBar&gt; <Function>toolBars</Function></FuncDef>
	<ParamDef>ToolBarDock <Parameter>dock</Parameter></ParamDef>
</FuncSynopsis>
<Para>
This returns a list of <Literal>TQToolBar</Literal> instances.  (TQt v2.1.0+)
</Para>
</Sect2>
%End


class TQMainWindow : TQWidget
{
%TypeHeaderCode
#include <tqmainwindow.h>
%End

public:
	TQMainWindow(TQWidget * /TransferThis/ = 0,const char * = 0,WFlags = WType_TopLevel);

	TQMenuBar *menuBar() const;
	TQStatusBar *statusBar() const;
	TQToolTipGroup *toolTipGroup() const;
	virtual void setCentralWidget(TQWidget *);
	TQWidget *centralWidget() const;

	virtual void setDockEnabled(Dock,bool);
	bool isDockEnabled(Dock) const;
	bool isDockEnabled(TQDockArea *) const;
	virtual void setDockEnabled(TQDockWindow *,Dock,bool);
	bool isDockEnabled(TQDockWindow *,Dock) const;
	bool isDockEnabled(TQDockWindow *,TQDockArea *) const;
 
	virtual void addDockWindow(TQDockWindow *,Dock = DockTop,bool = 0);
	virtual void addDockWindow(TQDockWindow *,const TQString &,
				   Dock = DockTop,bool = 0);
	virtual void moveDockWindow(TQDockWindow *,Dock = DockTop);
	virtual void moveDockWindow(TQDockWindow *,Dock,bool,int,int = -1);
	virtual void removeDockWindow(TQDockWindow *);

	void show();
	void hide();
	TQSize sizeHint() const;
	TQSize minimumSizeHint() const;

	bool rightJustification() const;
	bool usesBigPixmaps() const;
	bool usesTextLabel() const;
	bool dockWindowsMovable() const;
	bool opaqueMoving() const;

	bool eventFilter(TQObject *,TQEvent *);

	bool getLocation(TQDockWindow *,Dock &,int &,bool &,int &) const;
 
	TQPtrList<TQDockWindow> dockWindows(Dock) const;
	TQPtrList<TQDockWindow> dockWindows() const;
	void lineUpDockWindows(bool = 0);

	void lineUpToolBars(bool = 0);
	bool isDockMenuEnabled() const;

	bool hasDockWindow(TQDockWindow *);
	TQPtrList<TQToolBar> toolBars(Dock) const;

	// The following one is in TQt3 but not documented.
	//virtual TQDockArea *dockingArea(const TQPoint &);
	TQDockArea *leftDock() const;
	TQDockArea *rightDock() const;
	TQDockArea *topDock() const;
	TQDockArea *bottomDock() const;
 
	virtual bool isCustomizable() const;
 
	bool appropriate(TQDockWindow *) const;
 
	enum DockWindows {
		OnlyToolBars,
		NoToolBars,
		AllDockWindows
	};

	TQPopupMenu *createDockWindowMenu(DockWindows = AllDockWindows) const;

public slots:
	virtual void setRightJustification(bool);
	virtual void setUsesBigPixmaps(bool);
	virtual void setUsesTextLabel(bool);
	virtual void setDockWindowsMovable(bool);
	virtual void setOpaqueMoving(bool);
	virtual void setDockMenuEnabled(bool);
	virtual void whatsThis();
	virtual void setAppropriate(TQDockWindow *,bool);
	virtual void customize();

signals:
	void pixmapSizeChanged(bool);
	void usesTextLabelChanged(bool);
	void dockWindowPositionChanged(TQDockWindow *);

protected slots:
	virtual void setUpLayout();
	virtual bool showDockMenu(const TQPoint &);
	void menuAboutToShow();

protected:
	void paintEvent(TQPaintEvent *);
	void childEvent(TQChildEvent *);
	bool event(TQEvent *);
	void styleChange(TQStyle &);

private:
	TQMainWindow(const TQMainWindow &);
};