pytqt/sip/qt/qlistview.sip

// This is the SIP interface definition for TQListView, TQListViewItem,
// TQCheckListItem and TQListViewItemIterator.
//
// 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>TQListView</Title>
<Para>
<Literal>TQListView</Literal> is fully implemented.
</Para>
<Para>
Note that to remove a child <Literal>TQListViewItem</Literal> you must first
call <Literal>takeItem()</Literal> and then <Literal>del()</Literal>.
</Para>
</Sect2>

<Sect2><Title>TQListViewItem</Title>
<Para>
<Literal>TQListViewItem</Literal> is fully implemented.
</Para>
<Para>
Note that to remove a child <Literal>TQListViewItem</Literal> you must first
call <Literal>takeItem()</Literal> and then <Literal>del()</Literal>.
</Para>
</Sect2>

<Sect2><Title>TQCheckListItem</Title>
<Para>
<Literal>TQCheckListItem</Literal> is fully implemented.
</Para>
</Sect2>

<Sect2><Title>TQListViewItemIterator (TQt v2+)</Title>
<Para>
<Literal>TQListViewItemIterator</Literal> is fully implemented.
</Para>
</Sect2>
%End


%If (- TQt_2_00)

class TQListViewItem
{
%TypeHeaderCode
#include <qlistview.h>
%End

public:
	TQListViewItem(TQListView * /TransferThis/);
	TQListViewItem(TQListViewItem * /TransferThis/);
	TQListViewItem(TQListView * /TransferThis/,TQListViewItem *);
	TQListViewItem(TQListViewItem * /TransferThis/,TQListViewItem *);

	TQListViewItem(TQListView * /TransferThis/,
		const char *,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0);

	TQListViewItem(TQListViewItem * /TransferThis/,
		const char *,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0);

	TQListViewItem(TQListView * /TransferThis/,TQListViewItem *,
		const char *,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0);

	TQListViewItem(TQListViewItem * /TransferThis/,TQListViewItem *,
		const char *,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0,
		const char * = 0,const char * = 0);

	virtual void insertItem(TQListViewItem * /Transfer/);
	virtual void removeItem(TQListViewItem * /TransferBack/);
	int height() const;
	virtual void invalidateHeight();
	int totalHeight() const;
	virtual int width(const TQFontMetrics &,const TQListView *,int) const;
	void widthChanged(int = -1) const;
	int depth() const;
	virtual void setText(int,const char *);
	virtual const char *text(int) const;
	virtual void setPixmap(int,const TQPixmap &);
	virtual const TQPixmap *pixmap(int) const;
	virtual const char *key(int,bool) const;
	virtual void sortChildItems(int,bool);
	int childCount() const;
	bool isOpen() const;
	virtual void setOpen(bool);
	virtual void setup();
	virtual void setSelected(bool);
	bool isSelected() const;
	virtual void paintCell(TQPainter *,const TQColorGroup &,int,int,int);
	virtual void paintBranches(TQPainter *,const TQColorGroup &,int,int,int,
				   GUIStyle);
	virtual void paintFocus(TQPainter *,const TQColorGroup &,const TQRect &);
	TQListViewItem *firstChild() const;
	TQListViewItem *nextSibling() const;
	TQListViewItem *parent() const;
	TQListViewItem *itemAbove();
	TQListViewItem *itemBelow();
	int itemPos() const;
	TQListView *listView() const;
	virtual void setSelectable(bool);
	bool isSelectable() const;
	virtual void setExpandable(bool);
	bool isExpandable();
	void repaint() const;

protected:
	virtual void enforceSortOrder() const;
	virtual void setHeight(int);
	virtual void activate();
};

%End

%If (TQt_2_00 -)

class TQListViewItem : TQt
{
%TypeHeaderCode
#include <qlistview.h>
%End

public:
	TQListViewItem(TQListView * /TransferThis/);
	TQListViewItem(TQListViewItem * /TransferThis/);
	TQListViewItem(TQListView * /TransferThis/,TQListViewItem *);
	TQListViewItem(TQListViewItem * /TransferThis/,TQListViewItem *);

	TQListViewItem(TQListView * /TransferThis/,
		TQString,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null);

	TQListViewItem(TQListViewItem * /TransferThis/,
		TQString,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null);

	TQListViewItem(TQListView * /TransferThis/,TQListViewItem *,
		TQString,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null);

	TQListViewItem(TQListViewItem * /TransferThis/,TQListViewItem *,
		TQString,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null,
		TQString = TQString::null,TQString = TQString::null);

	virtual void insertItem(TQListViewItem * /Transfer/);
	virtual void takeItem(TQListViewItem * /TransferBack/);

	int height() const;
	virtual void invalidateHeight();
	int totalHeight() const;
	virtual int width(const TQFontMetrics &,const TQListView *,int) const;
	void widthChanged(int = -1) const;
	int depth() const;

	virtual void setText(int,const TQString &);
	virtual TQString text(int) const;

	virtual void setPixmap(int,const TQPixmap &);
	virtual const TQPixmap *pixmap(int) const;

	virtual TQString key(int,bool) const;
%If (TQt_3_0_0 -)
	virtual int compare(TQListViewItem *,int,bool) const;
%End
	virtual void sortChildItems(int,bool);

	int childCount() const;

	bool isOpen() const;
	virtual void setOpen(bool);
	virtual void setup();

	virtual void setSelected(bool);
	bool isSelected() const;

	virtual void paintCell(TQPainter *,const TQColorGroup &,int,int,int);
%If (- TQt_3_0_0)
	virtual void paintBranches(TQPainter *,const TQColorGroup &,int,int,int,
				   GUIStyle);
%End
%If (TQt_3_0_0 -)
	virtual void paintBranches(TQPainter *,const TQColorGroup &,int,int,int);
%End
	virtual void paintFocus(TQPainter *,const TQColorGroup &,const TQRect &);

	TQListViewItem *firstChild() const;
	TQListViewItem *nextSibling() const;
	TQListViewItem *parent() const;

	TQListViewItem *itemAbove();
	TQListViewItem *itemBelow();

	int itemPos() const;

	TQListView *listView() const;

	virtual void setSelectable(bool);
	bool isSelectable() const;

	virtual void setExpandable(bool);
	bool isExpandable();

	void repaint() const;

%If (TQt_2_1_0 - TQt_3_0_0)
	void sort();
%End
%If (TQt_3_0_0 -)
	virtual void sort();
%End
%If (TQt_2_2_0 -)
	void moveItem(TQListViewItem *);
%End

%If (TQt_3_0_0 -)
	virtual void setDragEnabled(bool);
	virtual void setDropEnabled(bool);
	bool dragEnabled() const;
	bool dropEnabled() const;
	virtual bool acceptDrop(const TQMimeSource *) const;
 
	void setVisible(bool);
	bool isVisible() const;
 
	virtual void setRenameEnabled(int,bool);
	bool renameEnabled(int) const;
	virtual void startRename(int);
 
	virtual void setEnabled(bool);
	bool isEnabled() const;
 
	virtual int rtti() const;
 
	virtual void setMultiLinesEnabled(bool);
	bool multiLinesEnabled() const;
%End

protected:
	virtual void enforceSortOrder() const;
	virtual void setHeight(int);
	virtual void activate();

%If (TQt_2_1_0 -)
	bool activatedPos(TQPoint &);
%End
%If (TQt_3_0_0 -)
	virtual void dropped(TQDropEvent *);
	virtual void dragEntered();
	virtual void dragLeft();
	virtual void okRename(int);
	virtual void cancelRename(int);

	void ignoreDoubleClick();
%End
};

%End


class TQListView : TQScrollView
{
%TypeHeaderCode
#include <qlistview.h>
%End

public:
%If (TQt_2_2_0 - TQt_3_0_0)
	TQListView(TQWidget * /TransferThis/,const char *,WFlags);
%End
%If (- TQt_3_0_0)
	TQListView(TQWidget * /TransferThis/ = 0,const char * = 0);
%End
%If (TQt_3_0_0 -)
	TQListView(TQWidget * /TransferThis/ = 0,const char * = 0,WFlags = 0);
%End

	int treeStepSize() const;
	virtual void setTreeStepSize(int);

	virtual void insertItem(TQListViewItem * /Transfer/);
%If (TQt_2_00 -)
	virtual void takeItem(TQListViewItem * /TransferBack/);
%End

%If (- TQt_3_0_0)
	virtual void clear();
%End
	TQHeader *header() const;

%If (- TQt_2_00)
	virtual int addColumn(const char *,int = -1);
	virtual void setColumnText(int,const char *);
	const char *columnText(int) const;
%End
%If (TQt_2_00 -)
	virtual int addColumn(const TQString &,int = -1);
	virtual int addColumn(const TQIconSet &,const TQString &,int = -1);
%If (TQt_2_1_0 -)
	void removeColumn(int);
%End
	virtual void setColumnText(int,const TQString &);
	virtual void setColumnText(int,const TQIconSet &,const TQString &);
	TQString columnText(int) const;
%End
	virtual void setColumnWidth(int,int);
	int columnWidth(int) const;

	enum WidthMode
	{
		Manual,
		Maximum
	};

	virtual void setColumnWidthMode(int,WidthMode);
	WidthMode columnWidthMode(int) const;
%If (TQt_2_1_0 -)
	int columns() const;
%End

	virtual void setColumnAlignment(int,int);
	int columnAlignment(int) const;

	void show();

	TQListViewItem *itemAt(const TQPoint &) const;
	TQRect itemRect(const TQListViewItem *) const;
	int itemPos(const TQListViewItem *);

	void ensureItemVisible(const TQListViewItem *);

	void repaintItem(const TQListViewItem *) const;

	virtual void setMultiSelection(bool);
	bool isMultiSelection() const;

%If (TQt_2_1_0 -)
	enum SelectionMode {
		Single,
		Multi,
		Extended,
		NoSelection
	};

	void setSelectionMode(SelectionMode);
	SelectionMode selectionMode() const;
%End

%If (TQt_2_1_0 -)
	virtual void clearSelection();
%End
	virtual void setSelected(TQListViewItem *,bool);
%If (TQt_3_2_0 -)
	void setSelectionAnchor(TQListViewItem *);
%End
	bool isSelected(TQListViewItem *) const;
%If (TQt_2_1_0 -)
	TQListViewItem *selectedItem() const;
%End
	virtual void setOpen(TQListViewItem *,bool);
	bool isOpen(TQListViewItem *) const;

	virtual void setCurrentItem(TQListViewItem *);
	TQListViewItem *currentItem() const;

	TQListViewItem *firstChild() const;
%If (TQt_3_0_0 -)
	TQListViewItem *lastItem() const;
%End

	int childCount() const;

	virtual void setAllColumnsShowFocus(bool);
	bool allColumnsShowFocus() const;

	virtual void setItemMargin(int);
	int itemMargin() const;

	virtual void setRootIsDecorated(bool);
	bool rootIsDecorated() const;

	virtual void setSorting(int,bool = 1);
%If (TQt_3_1_0 -)
	int sortColumn() const;
%End
%If (TQt_3_2_0 -)
	void setSortColumn(int);
	SortOrder sortOrder() const;
	void setSortOrder(SortOrder);
%End
%If (TQt_3_0_0 -)
	virtual void sort();
%End
%If (TQt_2_1_0 - TQt_3_0_0)
	void sort();
%End

%If (- TQt_2_00)
	void setStyle(GUIStyle);
	void setFont(const TQFont &);
	void setPalette(const TQPalette &);
%End
%If (TQt_2_00 -)
	virtual void setFont(const TQFont &);
	virtual void setPalette(const TQPalette &);
%End

	bool eventFilter(TQObject *,TQEvent *);

	TQSize sizeHint() const;
%If (TQt_2_00 -)
	TQSize minimumSizeHint() const;
%End

%If (TQt_2_1_0 -)
	void setShowSortIndicator(bool);
	bool showSortIndicator() const;
%End
%If (TQt_3_0_0 -)
	virtual void setShowToolTips(bool);
	bool showToolTips() const;
 
	enum ResizeMode {
		NoColumn,
		AllColumns,
		LastColumn
	};

	virtual void setResizeMode(ResizeMode);
	ResizeMode resizeMode() const;
 
	TQListViewItem *findItem(const TQString &,int,
				ComparisonFlags = ExactMatch | CaseSensitive) const;
 
	enum RenameAction {
		Accept,
		Reject
	};

	virtual void setDefaultRenameAction(RenameAction);
	RenameAction defaultRenameAction() const;
	bool isRenaming() const;
%End

%If (TQt_3_2_0 -)
	void hideColumn(int);
%End

public slots:
%If (TQt_3_0_0 -)
	virtual void clear();
%End
%If (TQt_2_1_0 -)
	void invertSelection();
	void selectAll(bool);
	void setContentsPos(int,int);
%End
	void triggerUpdate();
%If (TQt_3_2_0 -)
	void adjustColumn(int);
%End

signals:
	void selectionChanged();
	void selectionChanged(TQListViewItem *);
	void currentChanged(TQListViewItem *);
%If (TQt_2_1_0 -)
	void clicked(TQListViewItem *);
	void clicked(TQListViewItem *,const TQPoint &,int);
	void pressed(TQListViewItem *);
	void pressed(TQListViewItem *,const TQPoint &,int);
%End

	void doubleClicked(TQListViewItem *);
%If (TQt_3_2_0 -)
	void doubleClicked(TQListViewItem *,const TQPoint &,int);
%End
	void returnPressed(TQListViewItem *);
%If (TQt_3_0_0 -)
	void spacePressed(TQListViewItem *);
%End
	void rightButtonClicked(TQListViewItem *,const TQPoint &,int);
	void rightButtonPressed(TQListViewItem *,const TQPoint &,int);
%If (TQt_2_1_0 -)
	void mouseButtonPressed(int,TQListViewItem *,const TQPoint &,int);
	void mouseButtonClicked(int,TQListViewItem *,const TQPoint &,int);
%End

%If (TQt_3_0_0 -)
	void contextMenuRequested(TQListViewItem *,const TQPoint &,int);
%End

%If (TQt_2_1_0 -)
	void onItem(TQListViewItem *);
	void onViewport();

	void expanded(TQListViewItem *);
	void collapsed(TQListViewItem *);
%End
%If (TQt_3_0_0 -)
	void dropped(TQDropEvent *);
	void itemRenamed(TQListViewItem *,int,const TQString &);
	void itemRenamed(TQListViewItem *,int);
%End

protected:
%If (- TQt_2_00)
	void mousePressEvent(TQMouseEvent *);
	void mouseReleaseEvent(TQMouseEvent *);
	void mouseMoveEvent(TQMouseEvent *);
	void mouseDoubleClickEvent(TQMouseEvent *);
%End
%If (TQt_2_00 -)
	void contentsMousePressEvent(TQMouseEvent *);
	void contentsMouseReleaseEvent(TQMouseEvent *);
	void contentsMouseMoveEvent(TQMouseEvent *);
	void contentsMouseDoubleClickEvent(TQMouseEvent *);
%End
%If (TQt_3_0_0 -)
	void contentsContextMenuEvent(TQContextMenuEvent *);
	void contentsDragEnterEvent(TQDragEnterEvent *);
	void contentsDragMoveEvent(TQDragMoveEvent *);
	void contentsDragLeaveEvent(TQDragLeaveEvent *);
	void contentsDropEvent(TQDropEvent *);
	virtual TQDragObject *dragObject();
	virtual void startDrag();
%End

	void focusInEvent(TQFocusEvent *);
	void focusOutEvent(TQFocusEvent *);

	void keyPressEvent(TQKeyEvent *);

	void resizeEvent(TQResizeEvent *);
%If (TQt_3_0_0 -)
	void viewportResizeEvent(TQResizeEvent *);
%End

%If (TQt_2_00 -)
	void showEvent(TQShowEvent *);
%End

	void drawContentsOffset(TQPainter *,int,int,int,int,int,int);

	virtual void paintEmptyArea(TQPainter *,const TQRect &);
%If (TQt_2_00 -)
	void styleChange(TQStyle &);
%End
%If (- TQt_3_0_0)
	void enabledChange(bool);
%End
%If (TQt_3_0_0 -)
	void windowActivationChange(bool);
%End

protected slots:
	void updateContents();
%If (TQt_2_00 -)
	void doAutoScroll();
%End

private:
%If (TQt_2_1_0 -)
	TQListView(const TQWidget &);
%End
};


class TQCheckListItem : TQListViewItem
{
%TypeHeaderCode
#include <qlistview.h>
%End

public:
	enum Type {
		RadioButton,
		CheckBox,
		Controller,
%If (TQt_3_2_0 -)
		RadioButtonController,
		CheckBoxController,
%End
	};

%If (TQt_3_2_0 -)
	enum ToggleState {
		Off,
		NoChange,
		On
	};
%End

%If (TQt_3_2_0 -)
	TQCheckListItem(TQCheckListItem * /TransferThis/,const TQString &,
		       Type = RadioButtonController);
	TQCheckListItem(TQCheckListItem * /TransferThis/,TQListViewItem *,
		       const TQString &,Type = RadioButtonController);
	TQCheckListItem(TQListViewItem * /TransferThis/,const TQString &,
		       Type = RadioButtonController);
	TQCheckListItem(TQListViewItem * /TransferThis/,TQListViewItem *,
		       const TQString &,Type = RadioButtonController);
	TQCheckListItem(TQListView * /TransferThis/,const TQString &,
		       Type = RadioButtonController);
	TQCheckListItem(TQListView * /TransferThis/,TQListViewItem *,
		       const TQString &,Type = RadioButtonController);
%End
%If (TQt_2_00 - TQt_3_2_0)
	TQCheckListItem(TQCheckListItem * /TransferThis/,const TQString &,
		       Type = Controller);
%If (TQt_3_1_0 -)
	TQCheckListItem(TQCheckListItem * /TransferThis/,TQListViewItem *,
		       const TQString &,Type = Controller);
%End
	TQCheckListItem(TQListViewItem * /TransferThis/,const TQString &,
		       Type = Controller);
%If (TQt_3_1_0 -)
	TQCheckListItem(TQListViewItem * /TransferThis/,TQListViewItem *,
		       const TQString &,Type = Controller);
%End
	TQCheckListItem(TQListView * /TransferThis/,const TQString &,
		       Type = Controller);
%If (TQt_3_1_0 -)
	TQCheckListItem(TQListView * /TransferThis/,TQListViewItem *,
		       const TQString &,Type = Controller);
%End
%End
%If (TQt_2_00 -)
	TQCheckListItem(TQListViewItem * /TransferThis/,const TQString &,
		       const TQPixmap &);
	TQCheckListItem(TQListView * /TransferThis/,const TQString &,
		       const TQPixmap &);
%End
%If (- TQt_2_00)
	TQCheckListItem(TQCheckListItem * /TransferThis/,const char *,
		       Type = Controller);
	TQCheckListItem(TQListView * /TransferThis/,const char *,
		       Type = Controller);
	TQCheckListItem(TQListViewItem * /TransferThis/,const char *,
		       const TQPixmap &);
	TQCheckListItem(TQListView * /TransferThis/,const char *,
		       const TQPixmap &);
%End

	void paintCell(TQPainter *,const TQColorGroup &,int,int,int);
%If (TQt_2_00 -)
	virtual void paintFocus(TQPainter *,const TQColorGroup &,const TQRect &);
%End
	int width(const TQFontMetrics &,const TQListView *,int) const;
	void setup();

%If (- TQt_2_00)
	void setOn(bool);
%End
%If (TQt_2_00 -)
	virtual void setOn(bool);
%End
	bool isOn() const;
	Type type() const;
%If (- TQt_2_00)
	const char *text() const;
	const char *text(int) const;
%End
%If (TQt_2_00 -)
	TQString text() const;
	TQString text(int) const;
%End

%If (TQt_3_2_0 -)
	void setTristate(bool);
	bool isTristate() const;
	ToggleState state() const;
	void setState(ToggleState);
%End

%If (TQt_3_0_0 -)
	int rtti() const;
%End

protected:
%If (- TQt_3_0_0)
	void paintBranches(TQPainter *,const TQColorGroup &,int,int,int,GUIStyle);
%End
	void activate();
	void turnOffChild();
	virtual void stateChange(bool);
};


%If (TQt_2_00 -)

class TQListViewItemIterator
{
%TypeHeaderCode
#include <qlistview.h>
%End

public:
%If (TQt_3_2_0 -)
	enum IteratorFlag {
		Visible,
		Invisible,
		Selected,
		Unselected,
		Selectable,
		NotSelectable,
		DragEnabled,
		DragDisabled,
		DropEnabled,
		DropDisabled,
		Expandable,
		NotExpandable,
		Checked,
		NotChecked
	};
%End

	TQListViewItemIterator();
	TQListViewItemIterator(TQListViewItem *);
%If (TQt_3_2_0 -)
	TQListViewItemIterator(TQListViewItem *,int);
%End

	TQListViewItemIterator(const TQListViewItemIterator &);
	TQListViewItemIterator(TQListView *);
%If (TQt_3_2_0 -)
	TQListViewItemIterator(TQListView *,int);
%End

	TQListViewItemIterator &operator+=(int);
	TQListViewItemIterator &operator-=(int);

	TQListViewItem *current() const;
};

%End