summaryrefslogtreecommitdiffstats
path: root/kdeprint/kmmanager.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /kdeprint/kmmanager.h
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kdeprint/kmmanager.h')
-rw-r--r--kdeprint/kmmanager.h183
1 files changed, 183 insertions, 0 deletions
diff --git a/kdeprint/kmmanager.h b/kdeprint/kmmanager.h
new file mode 100644
index 000000000..17bf3347a
--- /dev/null
+++ b/kdeprint/kmmanager.h
@@ -0,0 +1,183 @@
+/*
+ * This file is part of the KDE libraries
+ * Copyright (c) 2001 Michael Goffioul <kdeprint@swing.be>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License version 2 as published by the Free Software Foundation.
+ *
+ * This library is distributed 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
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public License
+ * along with this library; see the file COPYING.LIB. If not, write to
+ * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+ **/
+
+#ifndef KMMANAGER_H
+#define KMMANAGER_H
+
+#if !defined( _KDEPRINT_COMPILE ) && defined( __GNUC__ )
+#warning internal header, do not use except if you are a KDEPrint developer
+#endif
+
+#include <kdeprint/kmprinter.h>
+
+#include <qobject.h>
+#include <qstring.h>
+#include <qptrlist.h>
+
+class DrMain;
+class KMDBEntry;
+class KMVirtualManager;
+class KMSpecialManager;
+class QWidget;
+class KActionCollection;
+class PrinterFilter;
+
+/**
+ * @internal
+ * This class is internal to KDEPrint and is not intended to be
+ * used outside it. Please do not make use of this header, except
+ * if you're a KDEPrint developer. The API might change in the
+ * future and binary compatibility might be broken.
+ */
+class KDEPRINT_EXPORT KMManager : public QObject
+{
+ Q_OBJECT
+
+friend class KMVirtualManager;
+friend class KMSpecialManager;
+friend class KMFactory;
+
+public:
+ enum PrinterOperations {
+ PrinterEnabling = 0x01,
+ PrinterCreation = 0x02,
+ PrinterDefault = 0x04,
+ PrinterTesting = 0x08,
+ PrinterConfigure = 0x10,
+ PrinterRemoval = 0x20,
+ PrinterAll = 0xFF
+ };
+ enum ServerOperations {
+ ServerRestarting = 0x1,
+ ServerConfigure = 0x2,
+ ServerAll = 0xF
+ };
+
+ KMManager(QObject *parent = 0, const char *name = 0);
+ virtual ~KMManager();
+
+ static KMManager* self();
+
+ // error management functions
+ QString errorMsg() const { return m_errormsg; }
+ void setErrorMsg(const QString& s) { m_errormsg = s; }
+
+ // support management ?
+ bool hasManagement() const { return m_hasmanagement; }
+
+ // printer management functions
+ virtual bool createPrinter(KMPrinter *p);
+ virtual bool removePrinter(KMPrinter *p);
+ virtual bool enablePrinter(KMPrinter *p, bool on);
+ virtual bool startPrinter(KMPrinter *p, bool on);
+ virtual bool completePrinter(KMPrinter *p);
+ virtual bool completePrinterShort(KMPrinter *p);
+ virtual bool setDefaultPrinter(KMPrinter *p);
+ virtual bool testPrinter(KMPrinter *p);
+ bool upPrinter(KMPrinter *p, bool state);
+ bool modifyPrinter(KMPrinter *oldp, KMPrinter *newp);
+ bool removePrinter(const QString& name);
+ bool enablePrinter(const QString& name, bool state);
+ bool startPrinter(const QString& name, bool state);
+ bool completePrinter(const QString& name);
+ bool setDefaultPrinter(const QString& name);
+ int printerOperationMask() const { return m_printeroperationmask; }
+ int addPrinterWizard(QWidget *parent = 0);
+
+ // special printer management functions
+ bool createSpecialPrinter(KMPrinter *p);
+ bool removeSpecialPrinter(KMPrinter *p);
+
+ // printer listing functions
+ KMPrinter* findPrinter(const QString& name);
+ QPtrList<KMPrinter>* printerList(bool reload = true);
+ QPtrList<KMPrinter>* printerListComplete(bool reload = true);
+ KMPrinter* defaultPrinter();
+ void enableFilter(bool on);
+ bool isFilterEnabled() const;
+
+ // driver DB functions
+ virtual QString driverDbCreationProgram();
+ virtual QString driverDirectory();
+
+ // driver functions
+ virtual DrMain* loadPrinterDriver(KMPrinter *p, bool config = false);
+ virtual DrMain* loadDbDriver(KMDBEntry *entry);
+ virtual DrMain* loadFileDriver(const QString& filename);
+ DrMain* loadDriver(KMPrinter *p, bool config = false);
+ virtual bool savePrinterDriver(KMPrinter *p, DrMain *d);
+ virtual bool validateDbDriver(KMDBEntry *entry);
+
+ // configuration functions
+ bool invokeOptionsDialog(QWidget *parent = 0);
+ virtual QString stateInformation();
+
+ // server functions
+ int serverOperationMask() const { return m_serveroperationmask; }
+ virtual bool restartServer();
+ virtual bool configureServer(QWidget *parent = 0);
+ virtual QStringList detectLocalPrinters();
+
+ // additional actions (for print manager)
+ virtual void createPluginActions(KActionCollection*);
+ virtual void validatePluginActions(KActionCollection*, KMPrinter*);
+
+ // utility function
+ void checkUpdatePossible();
+
+signals:
+ void updatePossible( bool );
+
+protected:
+ // the real printer listing job is done here
+ virtual void listPrinters();
+
+ // utility functions
+ void addPrinter(KMPrinter *p); // in any case, the pointer given MUST not be used after
+ // calling this function. Useful when listing printers.
+ void setHardDefault(KMPrinter*);
+ void setSoftDefault(KMPrinter*);
+ KMPrinter* softDefault() const;
+ KMPrinter* hardDefault() const;
+ // this function uncompress the given file (or does nothing
+ // if the file is not compressed). Returns wether the file was
+ // compressed or not.
+ bool uncompressFile(const QString& srcname, QString& destname);
+ bool notImplemented();
+ void setHasManagement(bool on) { m_hasmanagement = on; }
+ void setPrinterOperationMask(int m) { m_printeroperationmask = m; }
+ void setServerOperationMask(int m) { m_serveroperationmask = m; }
+ QString testPage();
+ void discardAllPrinters(bool);
+ void setUpdatePossible( bool );
+ virtual void checkUpdatePossibleInternal();
+
+protected:
+ QString m_errormsg;
+ KMPrinterList m_printers, m_fprinters; // filtered printers
+ bool m_hasmanagement;
+ int m_printeroperationmask;
+ int m_serveroperationmask;
+ KMSpecialManager *m_specialmgr;
+ KMVirtualManager *m_virtualmgr;
+ PrinterFilter *m_printerfilter;
+ bool m_updatepossible;
+};
+
+#endif