// This is the SIP interface definition for AppLnk, AppLnkSet, DocLnk and
// DocLnkSet.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyQt.
// 
// This copy of PyQt 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.
// 
// PyQt 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
// PyQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.


// The documentation is in the main documentation file because SIP isn't clever
// enough to handle the resulting %Timeline complexity.


%If (WS_QWS)

class AppLnk
{
%TypeHeaderCode
#include <qpe/applnk.h>
%End

public:
	AppLnk();
	AppLnk(const QString &);
	AppLnk(const AppLnk &);

	bool isValid() const;

	static void setSmallIconSize(int);
	static void setBigIconSize(int);
	static int smallIconSize();
	static int bigIconSize();

	QString name() const;
	const QPixmap& pixmap() const;
	const QPixmap& bigPixmap() const;
	virtual QString exec() const /PyName=exec_property/;
	QString type() const;
	QString rotation() const;
	QString comment() const;
	QString file() const;
	QString linkFile() const;
	QStringList mimeTypes() const;
	QStringList mimeTypeIcons() const;
	const QArray<int> &categories() const;
	int id() const;

	bool fileKnown() const;
	bool linkFileKnown() const;

	void execute() const /ReleaseGIL/;
	void execute(const QStringList &) const /ReleaseGIL/;
	void removeFiles();
	void removeLinkFile();

	void setName(const QString &);
	void setExec(const QString &);
	void setFile(const QString &);
	void setLinkFile(const QString &);
	void setComment(const QString &);
	void setType(const QString &);
	void setIcon(const QString &);
	void setCategories(const QArray<int> &);
	bool writeLink() const;

	void setProperty(const QString &,const QString &);
	QString property(const QString &) const;

protected:
	virtual void invoke(const QStringList &) const;
	bool ensureLinkExists() const;
// Undocumented and missing on the Zaurus.
//	void storeLink() const;
};


class DocLnk : AppLnk
{
%TypeHeaderCode
#include <qpe/applnk.h>
%End

public:
	DocLnk();
	DocLnk(const DocLnk &);
	DocLnk(const QString &);
	DocLnk(const QString &,bool);

	QString exec() const /PyName=exec_property/;

protected:
	void invoke(const QStringList &) const;
};


class AppLnkSet
{
%TypeHeaderCode
#include <qpe/applnk.h>
%End

public:
	AppLnkSet();
	AppLnkSet(const QString &);

	const AppLnk *find(int) const;
	const AppLnk *findExec(const QString &) const;

	QStringList types() const;
	QString typeName(const QString &) const;
	QPixmap typePixmap(const QString &) const;
	QPixmap typeBigPixmap(const QString &) const;

	void add(AppLnk *);
	bool remove(AppLnk *);

	const QList<AppLnk> &children() const;
	void detachChildren();

private:
	AppLnkSet(const AppLnkSet &);
};


class DocLnkSet : AppLnkSet
{
%TypeHeaderCode
#include <qpe/applnk.h>
%End

public:
	DocLnkSet();
	DocLnkSet(const QString &,const QString & = QString::null);

	const QList<DocLnk> &children() const;

	void appendFrom(DocLnkSet &);

private:
	DocLnkSet(const DocLnkSet &);
};

%End