path: root/sip/qt/qpopupmenu.sip

// This is the SIP interface definition for TQPopupMenu.
//
// 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.


%ExportedDoc
<Sect2><Title>TQPopupMenu</Title>
<FuncSynopsis>
        <FuncDef>int <Function>exec</Function></FuncDef>
        <ParamDef></ParamDef>
</FuncSynopsis>
<Para>
This has been renamed <Literal>exec_loop</Literal> in Python.
</Para>
<Para>
This method also causes ownership of the underlying C++ menu to be transfered
to Python.  This means that the C++ menu will be deleted when the Python
wrapper is garbage collected.  Although this is a little inconsistent, it
ensures that the menu is deleted without having to explicity code it using
<Literal>TQObject.deleteLater()</Literal> or other techniques.
</Para>

<FuncSynopsis>
        <FuncDef>int <Function>exec</Function></FuncDef>
        <ParamDef>const TQPoint &<Parameter>pos</Parameter></ParamDef>
        <ParamDef>int <Parameter>indexAtPoint</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This has been renamed <Literal>exec_loop</Literal> in Python.
</Para>
<Para>
This method also causes ownership of the underlying C++ menu to be transfered
to Python.  This means that the C++ menu will be deleted when the Python
wrapper is garbage collected.  Although this is a little inconsistent, it
ensures that the menu is deleted without having to explicity code it using
<Literal>TQObject.deleteLater()</Literal> or other techniques.
</Para>
</Sect2>
%End


%If (- TQt_2_00)

class TQPopupMenu : TQTableView, TQMenuData
{
%TypeHeaderCode
#include <tqpopupmenu.h>
%End

public:
	TQPopupMenu(TQWidget * /TransferThis/ = 0,const char * = 0);

	void popup(const TQPoint &,int = 0);
	void updateItem(int);
	void setCheckable(bool);
	bool isCheckable() const;
	void setFont(const TQFont &);
	void show();
	void hide();

	int exec() /PyName=exec_loop, ReleaseGIL,
		    PreHook=__pyTQtPreEventLoopHook__,
		    PostHook=__pyTQtPostEventLoopHook__/;
%MethodCode
		// Transfer ownership back to Python (a modal menu will
		// probably have the main window as it's parent).  This means
		// the TQt menu will be deleted when the Python wrapper is
		// garbage collected.  Although this is a little inconsistent,
		// it saves having to code it explicitly to avoid the memory
		// leak.
		sipTransferBack(sipSelf);

		Py_BEGIN_ALLOW_THREADS
		sipRes = sipCpp->TQPopupMenu::exec();
		Py_END_ALLOW_THREADS
%End

	int exec(const TQPoint &,int = 0) /PyName=exec_loop, ReleaseGIL,
					  PreHook=__pyTQtPreEventLoopHook__,
					  PostHook=__pyTQtPostEventLoopHook__/;
%MethodCode
		// Transfer ownership back to Python (a modal menu will
		// probably have the main window as it's parent).  This means
		// the TQt menu will be deleted when the Python wrapper is
		// garbage collected.  Although this is a little inconsistent,
		// it saves having to code it explicitly to avoid the memory
		// leak.
		sipTransferBack(sipSelf);

		Py_BEGIN_ALLOW_THREADS
		sipRes = sipCpp->TQPopupMenu::exec(*a0,a1);
		Py_END_ALLOW_THREADS
%End

	void setActiveItem(int);
	int idAt(int) const;
%If (TQt_1_43 -)
	int idAt(const TQPoint &) const;
%End

signals:
	void activated(int);
	void highlighted(int);
	void activatedRedirect(int);
	void highlightedRedirect(int);
	void aboutToShow();

protected:
	int cellHeight(int);
	int cellWidth(int);
	void paintCell(TQPainter *,int,int);
	void paintEvent(TQPaintEvent *);
	void mousePressEvent(TQMouseEvent *);
	void mouseReleaseEvent(TQMouseEvent *);
	void mouseMoveEvent(TQMouseEvent *);
	void keyPressEvent(TQKeyEvent *);
	void timerEvent(TQTimerEvent *);

private:
	TQPopupMenu(const TQPopupMenu &);
	void menuContentsChanged();
	void menuStateChanged();
	void menuInsPopup(TQPopupMenu *);
	void menuDelPopup(TQPopupMenu *);
	void frameChanged();
};

%End


%If (TQt_2_00 -)

class TQPopupMenu : TQFrame, TQMenuData
{
%TypeHeaderCode
#include <tqpopupmenu.h>
%End

public:
	TQPopupMenu(TQWidget * /TransferThis/ = 0,const char * = 0);

%If (- TQt_3_0_5)
	void popup(const TQPoint &,int = 0);
%End
%If (TQt_3_0_5 -)
	void popup(const TQPoint &,int = -1);
%End
	void updateItem(int);

	virtual void setCheckable(bool);
	bool isCheckable() const;

	void setFont(const TQFont &);
	void show();
	void hide();

	int exec() /PyName=exec_loop, ReleaseGIL,
		    PreHook=__pyTQtPreEventLoopHook__,
		    PostHook=__pyTQtPostEventLoopHook__/;
%MethodCode
		// Transfer ownership back to Python (a modal menu will
		// probably have the main window as it's parent).  This means
		// the TQt menu will be deleted when the Python wrapper is
		// garbage collected.  Although this is a little inconsistent,
		// it saves having to code it explicitly to avoid the memory
		// leak.
		sipTransferBack(sipSelf);

		Py_BEGIN_ALLOW_THREADS
		sipRes = sipCpp->TQPopupMenu::exec();
		Py_END_ALLOW_THREADS
%End

	int exec(const TQPoint &,int = 0) /PyName=exec_loop, ReleaseGIL,
					  PreHook=__pyTQtPreEventLoopHook__,
					  PostHook=__pyTQtPostEventLoopHook__/;
%MethodCode
		// Transfer ownership back to Python (a modal menu will
		// probably have the main window as it's parent).  This means
		// the TQt menu will be deleted when the Python wrapper is
		// garbage collected.  Although this is a little inconsistent,
		// it saves having to code it explicitly to avoid the memory
		// leak.
		sipTransferBack(sipSelf);

		Py_BEGIN_ALLOW_THREADS
		sipRes = sipCpp->TQPopupMenu::exec(*a0,a1);
		Py_END_ALLOW_THREADS
%End

	virtual void setActiveItem(int);
	TQSize sizeHint() const;

	int idAt(int) const;
	int idAt(const TQPoint &) const;

	bool customWhatsThis() const;

%If (TQt_2_1_0 -)
	int insertTearOffHandle(int = -1,int = -1);
%End

%If (TQt_2_2_0 -)
	void activateItemAt(int);
%End
%If (TQt_3_0_0 -)
	TQRect itemGeometry(int);
%End

signals:
	void activated(int);
	void highlighted(int);
	void activatedRedirect(int);
	void highlightedRedirect(int);
	void aboutToShow();
%If (TQt_2_2_0 -)
	void aboutToHide();
%End

protected:
	int itemHeight(int) const;
	int itemHeight(TQMenuItem *) const;
	void drawItem(TQPainter *,int,TQMenuItem *,bool,int,int,int,int);

	void drawContents(TQPainter *);

	void closeEvent(TQCloseEvent *);
	void paintEvent(TQPaintEvent *);
	void mousePressEvent(TQMouseEvent *);
	void mouseReleaseEvent(TQMouseEvent *);
	void mouseMoveEvent(TQMouseEvent *);
	void keyPressEvent(TQKeyEvent *);
%If (TQt_2_1_0 -)
	void focusInEvent(TQFocusEvent *);
	void focusOutEvent(TQFocusEvent *);
%End
	void timerEvent(TQTimerEvent *);
%If (TQt_3_0_0 -)
	void leaveEvent(TQEvent *);
%End
	void styleChange(TQStyle &);
%If (TQt_3_1_0 -)
	void enabledChange(bool);
%End
%If (TQt_2_1_0 -)
	int columns() const;

	bool focusNextPrevChild(bool);
%End

%If (TQt_3_0_0 -)
	int itemAtPos(const TQPoint &,bool = 1) const;
%End

private:
	TQPopupMenu(const TQPopupMenu &);

	void menuContentsChanged();
	void menuStateChanged();
	void menuInsPopup(TQPopupMenu *);
	void menuDelPopup(TQPopupMenu *);
	void frameChanged();
};

%End