You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdeaddons/kate/tabbarextension/plugin_katetabbarextension.h

364 lines
10 KiB

/***************************************************************************
plugin_katetabbarextension.h
-------------------
begin : 2004-04-20
copyright : (C) 2004 by Dominik Haumann
email : dhdev@gmx.de
***************************************************************************/
/***************************************************************************
This program 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
of the License, or (at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
***************************************************************************/
#ifndef _PLUGIN_TABBAREXTENSION_H_
#define _PLUGIN_TABBAREXTENSION_H_
#include <kate/application.h>
#include <kate/documentmanager.h>
#include <kate/document.h>
#include <kate/mainwindow.h>
#include <kate/plugin.h>
#include <kate/view.h>
#include <kate/viewmanager.h>
#include <kate/pluginconfiginterface.h>
#include <kate/pluginconfiginterfaceextension.h>
#include <klibloader.h>
#include <tdelocale.h>
#include <tdetoolbar.h>
#include <tqwidget.h>
#include <tqpushbutton.h>
#include <tqptrlist.h>
class TQBoxLayout;
class TQCheckBox;
class KateTabBarButton;
/**
* Same as TQPtrList. Only difference is: overwrite compareItems() for sorting reason.
*/
class MyPtrList : public TQPtrList <KateTabBarButton>
{
public:
MyPtrList() { TQPtrList<KateTabBarButton>(); }
virtual int compareItems ( TQPtrCollection::Item item1_, TQPtrCollection::Item item2_ );
};
class KatePluginFactory : public KLibFactory
{
TQ_OBJECT
public:
KatePluginFactory() { s_instance = new TDEInstance( "kate" ); }
virtual ~KatePluginFactory() { delete s_instance; }
virtual TQObject* createObject(TQObject *parent = 0, const char *pname = 0,
const char *name = "TQObject", const TQStringList &args = TQStringList());
private:
static TDEInstance* s_instance;
};
/**
* This class implements a single tab. Every tab represents a document and shows
* the current flag (modified: true or false).
*/
class KateTabBarButton: public TQPushButton
{
TQ_OBJECT
public:
/**
* constructor
* @param pViewManager pointer to kate's the view manager
* @param pDoc pointer to the document, that the tab button represents
* @param parent parent widget
* @param name name of the tab button
*/
KateTabBarButton(Kate::ViewManager* pViewManager, Kate::Document *pDoc,
TQWidget* parent = 0, const char * name = 0);
/**
* standard destructor (emtpy)
*/
~KateTabBarButton() {}
/**
* @return the unique document ID
*/
uint documentNumber() { return myDocID; }
/**
* @return the document pointer
*/
Kate::Document* document() { return doc; }
/**
* get the document's full name (eg. main.cpp), used for comparison
* @return the document's name
*/
TQString fullName() const;
/**
* negate the modified flag and change the button color
* (usually red or black)
*/
void triggerModified();
/**
* dirty flag indicates whether the file was modified on disk
* @param d if true, a small warning icon appears
*/
void setDirty(bool d);
/**
* set text for this tab
* @param newText new text
*/
virtual void setText(const TQString& newText);
/**
* mouse release event handler to provide middle click functionality
* @param e the mouse event
*/
virtual void mouseReleaseEvent(TQMouseEvent *e);
signals:
/**
* signal that is only emitted when the toggle button toggles to state 'on'
* @param tab pointer to the button that emitted the signal
*/
void myToggled(KateTabBarButton* tab);
/**
* signal emitted when the middle button is pressed
* @param tab pointer to the button that emitted the signal
*/
void middleButtonPressed(KateTabBarButton* tab);
public slots:
/**
* control the ToggleButton
* @param on if true, the button is toggled on
*/
virtual void setOn(bool on);
private:
bool modified; ///< if true, doc is modified
uint myDocID; ///< unique document ID
Kate::Document *doc; ///< pointer to the doc
Kate::ViewManager *viewManager; ///< pointer to the view manager
};
/**
* This class handels all tabs and implements a full-featured "tabbar".
*/
class KateTabBarExtension : public TQWidget
{
TQ_OBJECT
public:
/**
* constructor
* @param pDocManager pointer to kate's document manager
* @param win pinter to the main window
* @param bHorizOrientation true, if orientation is Qt::Horizontal
* @param bSort true, if orientation is Qt::Horizontal
* @param parent parent widget
* @param name name of widget
* @param f widget flags
*/
KateTabBarExtension(Kate::DocumentManager *pDocManager,
Kate::MainWindow *win, bool bHorizOrientation, bool bSort,
bool bCloseOnMiddleClick, TQWidget *parent = 0,
const char *name = 0, WFlags f = 0);
/** standard destructor */
~KateTabBarExtension() {}
/**
* @return the tabbar's orientation
*/
Qt::Orientation orientation() const { return m_orientation; }
/**
* @return true, when sorting is alphabetically
*/
bool sortByName() const { return m_sort; }
/**
* set sorting type
* @param sbn if true, sort by filename.lower()
*/
void setSortByName(bool sbn);
/**
* sort all tabs
*/
void updateSort();
/**
* @return true when closing a document with mouse middle click is allowed
*/
bool closeOnMiddleClick() const { return m_closeOnMiddleClick; }
/**
* set flag to enable/disable "close document on mouse middle click" feature
* @param cmc true -> enabled, false -> disabled
*/
void setCloseOnMiddleClick(bool cmc) { m_closeOnMiddleClick = cmc; }
public slots:
/**
* called when a new document is created/loaded
* @param doc the new document
*/
void slotDocumentCreated (Kate::Document *doc);
/**
* called when an existing document is being deleted
* @param documentNumber ID of the document
*/
void slotDocumentDeleted (uint documentNumber);
/**
* called whenever the view changes
* @param v pointer to the button that represents the active view
*/
void slotActivateView(KateTabBarButton* v);
/**
* called when the document's modified flag changes
* @param doc the document
*/
void slotModChanged (Kate::Document *doc);
/**
* called when the document changed on disk [NOT SUPPORTED AT THE MOMENT]
* @param doc the document
* @param b modified flag
* @param reason the reason why the file changed
*/
void slotModifiedOnDisc (Kate::Document *doc, bool b, unsigned char reason);
/**
* called when the document's name changed
* @param doc the document
*/
void slotNameChanged (Kate::Document *doc);
/**
* called when the active view changes
*/
void slotViewChanged ();
/**
* called whenever the toolbar's orientation changes
* @param o new orientation [Qt::Horizontal or Qt::Vertical]
*/
void slotMoved(Qt::Orientation o);
/**
* called when we want to close the document associated with the tab
* @param tab pointer to the button that represents the active view
*/
void slotRequestDocClose(KateTabBarButton *tab);
private:
KateTabBarButton* pCurrentTab; ///< pointer to the current tab
TQBoxLayout* top; ///< layout that contains all tabs
Kate::MainWindow* m_win; ///< pointer to the main window
Kate::DocumentManager* m_docManager; ///< pointer to the document manager
// TQPtrList <KateTabBarButton> m_tabs; ///< list containing all tabs
MyPtrList m_tabs; ///< list containing all tabs
Qt::Orientation m_orientation; ///< save tabbar's orientation
bool m_sort; ///< how to sort
bool m_closeOnMiddleClick; ///< Enable/disable "close document on mouse middle click" feature
};
/**
* The tabbar's config page
*/
class KateTabBarExtensionConfigPage : public Kate::PluginConfigPage
{
TQ_OBJECT
friend class KatePluginTabBarExtension;
public:
KateTabBarExtensionConfigPage(TQObject* parent = 0L, TQWidget *parentWidget = 0L);
~KateTabBarExtensionConfigPage() {}
/**
* Reimplemented from Kate::PluginConfigPage
* just emits configPageApplyRequest( this ).
*/
virtual void apply() { emit configPageApplyRequest(this); }
virtual void reset() {}
virtual void defaults() {}
signals:
/**
* Ask the plugin to set initial values
*/
void configPageApplyRequest( KateTabBarExtensionConfigPage* );
/**
* Ask the plugin to apply changes
*/
void configPageInitRequest( KateTabBarExtensionConfigPage* );
private:
TQCheckBox* pSortAlpha;
TQCheckBox* pCloseOnMiddleClick;
};
class KatePluginTabBarExtension : public Kate::Plugin, Kate::PluginViewInterface, Kate::PluginConfigInterfaceExtension
{
TQ_OBJECT
public:
KatePluginTabBarExtension(TQObject* parent = 0, const char* name = 0);
virtual ~KatePluginTabBarExtension();
void addView (Kate::MainWindow *win);
void removeView (Kate::MainWindow *win);
uint configPages () const { return 1; }
Kate::PluginConfigPage *configPage (uint , TQWidget *w, const char *name=0);
TQString configPageName(uint) const { return i18n("Tab Bar Extension"); }
TQString configPageFullName(uint) const { return i18n("Configure Tab Bar Extension"); }
TQPixmap configPagePixmap (uint = 0, int = TDEIcon::SizeSmall) const { return 0L; }
public slots:
void applyConfig( KateTabBarExtensionConfigPage* );
private:
void initConfigPage( KateTabBarExtensionConfigPage* );
private:
TQPtrList<class PluginView> m_views;
TDEConfig* pConfig;
};
#endif // _PLUGIN_TABBAREXTENSION_H_