summaryrefslogtreecommitdiffstats
path: root/tdeui/kactionclasses.h
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-02-01 17:25:43 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-02-01 17:25:43 -0600
commitd888cfa39e8b38abe17f3d425d19cb8235136a79 (patch)
tree7ae5487b84106036fdb781beec26fab10678a595 /tdeui/kactionclasses.h
parentdeac2ca49faed824fe83066080714eb6d653615b (diff)
downloadtdelibs-d888cfa39e8b38abe17f3d425d19cb8235136a79.tar.gz
tdelibs-d888cfa39e8b38abe17f3d425d19cb8235136a79.zip
Fix FTBFS
Diffstat (limited to 'tdeui/kactionclasses.h')
-rw-r--r--tdeui/kactionclasses.h1436
1 files changed, 0 insertions, 1436 deletions
diff --git a/tdeui/kactionclasses.h b/tdeui/kactionclasses.h
deleted file mode 100644
index 07078a722..000000000
--- a/tdeui/kactionclasses.h
+++ /dev/null
@@ -1,1436 +0,0 @@
-/* This file is part of the KDE libraries
- Copyright (C) 1999 Reginald Stadlbauer <reggie@kde.org>
- (C) 1999 Simon Hausmann <hausmann@kde.org>
- (C) 2000 Nicolas Hadacek <haadcek@kde.org>
- (C) 2000 Kurt Granroth <granroth@kde.org>
- (C) 2000 Michael Koch <koch@kde.org>
- (C) 2001 Holger Freyther <freyther@kde.org>
- (C) 2002 Ellis Whitehead <ellis@kde.org>
- (C) 2003 Andras Mantia <amantia@kde.org>
-
- 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.
-*/
-//$Id$
-
-#ifndef __kactionclasses_h__
-#define __kactionclasses_h__
-
-#include <kaction.h>
-
-#include <tqkeysequence.h>
-#include <tqobject.h>
-#include <tqvaluelist.h>
-#include <tqguardedptr.h>
-#include <kguiitem.h>
-#include <kshortcut.h>
-#include <kstdaction.h>
-#include <kicontheme.h>
-
-class TQMenuBar;
-class TQPopupMenu;
-class TQComboBox;
-class TQPoint;
-class TQIconSet;
-class TQString;
-class TDEToolBar;
-
-class TDEAccel;
-class TDEAccelActions;
-class TDEConfig;
-class TDEConfigBase;
-class KURL;
-class TDEInstance;
-class TDEToolBar;
-class TDEActionCollection;
-class TDEPopupMenu;
-class TDEMainWindow;
-
-/**
- * @short Checkbox like action.
- *
- * Checkbox like action.
- *
- * This action provides two states: checked or not.
- *
- */
-class TDEUI_EXPORT TDEToggleAction : public TDEAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( bool checked READ isChecked WRITE setChecked )
- TQ_PROPERTY( TQString exclusiveGroup READ exclusiveGroup WRITE setExclusiveGroup )
-public:
-
- /**
- * Constructs a toggle action with text and potential keyboard
- * accelerator but nothing else. Use this only if you really
- * know what you are doing.
- *
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( const TQString& text, const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( const TQString& text, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( const TQString& text, const TQString& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0 );
-
- /**
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToggleAction( TQObject* parent = 0, const char* name = 0 );
-
- /**
- * Destructor
- */
- virtual ~TDEToggleAction();
-
- /**
- * "Plug" or insert this action into a given widget.
- *
- * This will typically be a menu or a toolbar. From this point
- * on, you will never need to directly manipulate the item in the
- * menu or toolbar. You do all enabling/disabling/manipulation
- * directly with your TDEToggleAction object.
- *
- * @param widget The GUI element to display this action.
- * @param index The index of the item.
- */
- virtual int plug( TQWidget* widget, int index = -1 );
-
- /**
- * Returns the actual state of the action.
- */
- bool isChecked() const;
-
- /**
- * @return which "exclusive group" this action is part of.
- * @see setExclusiveGroup
- */
- TQString exclusiveGroup() const;
-
- /**
- * Defines which "exclusive group" this action is part of.
- * In a given exclusive group, only one toggle action can be checked
- * at a any moment. Checking an action unchecks the other actions
- * of the group.
- */
- virtual void setExclusiveGroup( const TQString& name );
-
- /**
- * Defines the text (and icon, tooltip, whatsthis) that should be displayed
- * instead of the normal text, when the action is checked.
- * This feature replaces the checkmark that usually appears in front of the text, in menus.
- * It is useful when the text is mainly a verb: e.g. "Show <foo>"
- * should turn into "Hide <foo>" when activated.
- *
- * If hasIcon(), the icon is kept for the 'checked state', unless
- * @p checkedItem defines an icon explicitely. Same thing for tooltip and whatsthis.
- * @since 3.3
- */
- void setCheckedState( const KGuiItem& checkedItem );
-
- /// Reimplemented for internal reasons
- virtual TQString toolTip() const;
-
-public slots:
- /**
- * Sets the state of the action.
- */
- virtual void setChecked( bool );
-
-protected slots:
- virtual void slotActivated();
-
-protected:
- virtual void updateChecked( int id );
-
-signals:
- void toggled( bool );
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEToggleActionPrivate;
- TDEToggleActionPrivate *d;
-};
-
-/**
- * @short Radiobox like action.
- *
- * An action that operates like a radio button. At any given time
- * only a single action from the group will be active.
- */
-class TDEUI_EXPORT TDERadioAction : public TDEToggleAction
-{
- Q_OBJECT
-
-public:
- /**
- * Constructs a radio action with text and potential keyboard
- * accelerator but nothing else. Use this only if you really
- * know what you are doing.
- *
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( const TQString& text, const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( const TQString& text, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( const TQString& text, const TQString& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0 );
-
- /**
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDERadioAction( TQObject* parent = 0, const char* name = 0 );
-
-protected:
- virtual void slotActivated();
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDERadioActionPrivate;
- TDERadioActionPrivate *d;
-};
-
-/**
- * @short Action for selecting one of several items
- *
- * Action for selecting one of several items.
- *
- * This action shows up a submenu with a list of items.
- * One of them can be checked. If the user clicks on an item
- * this item will automatically be checked,
- * the formerly checked item becomes unchecked.
- * There can be only one item checked at a time.
- */
-class TDEUI_EXPORT TDESelectAction : public TDEAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( int currentItem READ currentItem WRITE setCurrentItem )
- TQ_PROPERTY( TQStringList items READ items WRITE setItems )
- TQ_PROPERTY( bool editable READ isEditable WRITE setEditable )
- TQ_PROPERTY( int comboWidth READ comboWidth WRITE setComboWidth )
- TQ_PROPERTY( TQString currentText READ currentText )
- TQ_PROPERTY( bool menuAccelsEnabled READ menuAccelsEnabled WRITE setMenuAccelsEnabled )
-public:
-
- /**
- * Constructs a select action with text and potential keyboard
- * accelerator but nothing else. Use this only if you really
- * know what you are doing.
- *
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( const TQString& text, const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( const TQString& text, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( const TQString& text, const TQString& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0 );
-
- /**
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDESelectAction( TQObject* parent = 0, const char* name = 0 );
-
- /**
- * Destructor
- */
- virtual ~TDESelectAction();
-
- /**
- * "Plug" or insert this action into a given widget.
- *
- * This will typically be a menu or a toolbar.
- * From this point on, you will never need to directly
- * manipulate the item in the menu or toolbar.
- * You do all enabling/disabling/manipulation directly with your TDESelectAction object.
- *
- * @param widget The GUI element to display this action.
- * @param index The index of the item.
- */
- virtual int plug( TQWidget* widget, int index = -1 );
-
- /**
- * When this action is plugged into a toolbar, it creates a combobox.
- * @return true if the combo editable.
- */
- virtual bool isEditable() const;
-
- /**
- * @return the items that can be selected with this action.
- * Use setItems to set them.
- */
- virtual TQStringList items() const;
-
- /**
- * Changes the text of item @param index to @param text .
- */
- virtual void changeItem( int index, const TQString& text );
-
- /**
- * Returns the text of the currently selected item.
- */
- virtual TQString currentText() const;
-
- /**
- * Returns the index of the current item.
- * @see setCurrentItem
- */
- virtual int currentItem() const;
-
- /**
- * When this action is plugged into a toolbar, it creates a combobox.
- * This returns the maximum width set by setComboWidth
- */
- virtual int comboWidth() const;
-
- /**
- * Sets the maximum items that are visible at once if the action
- * is a combobox, that is the number of items in the combobox's viewport
- * Only works before the action is plugged
- * @since 3.5
- */
- void setMaxComboViewCount( int n );
-
- /**
- * Returns a pointer to the popup menu used by this action.
- */
- TQPopupMenu* popupMenu() const;
-
- /**
- * @deprecated See setMenuAccelsEnabled .
- * @since 3.1
- */
- void setRemoveAmpersandsInCombo( bool b ) KDE_DEPRECATED;
- /// @since 3.1
- bool removeAmpersandsInCombo() const;
-
- /**
- * Sets whether any occurrence of the ampersand character ( &amp; ) in items
- * should be interpreted as keyboard accelerator for items displayed in a
- * menu or not.
- * @since 3.1
- */
- void setMenuAccelsEnabled( bool b );
- /// @since 3.1
- bool menuAccelsEnabled() const;
-
- virtual bool isShortcutConfigurable() const { return false; }
-
-public slots:
- /**
- * Sets the currently checked item.
- *
- * @param index Index of the item (remember the first item is zero).
- */
- virtual void setCurrentItem( int index );
-
- /**
- * Sets the items to be displayed in this action
- * You need to call this.
- */
- virtual void setItems( const TQStringList &lst );
-
- /**
- * Clears up all the items in this action
- */
- virtual void clear();
-
- /**
- * When this action is plugged into a toolbar, it creates a combobox.
- * This makes the combo editable or read-only.
- */
- virtual void setEditable( bool );
-
- /**
- * When this action is plugged into a toolbar, it creates a combobox.
- * This gives a _maximum_ size to the combobox.
- * The minimum size is automatically given by the contents (the items).
- */
- virtual void setComboWidth( int width );
-
-protected:
- virtual void changeItem( int id, int index, const TQString& text );
-
- /**
- * Depending on the menuAccelsEnabled property this method will return the
- * actions items in a way for inclusion in a combobox with the ampersand
- * character removed from all items or not.
- * @since 3.1
- */
- TQStringList comboItems() const;
-
-protected slots:
- virtual void slotActivated( int id );
- virtual void slotActivated( const TQString &text );
- virtual void slotActivated();
-
-signals:
- /**
- * This signal is emitted when an item is selected; @param index indicated
- * the item selected.
- */
- void activated( int index );
- /**
- * This signal is emitted when an item is selected; @param text indicates
- * the item selected.
- */
- void activated( const TQString& text );
-
-protected:
- virtual void updateCurrentItem( int id );
-
- virtual void updateComboWidth( int id );
-
- virtual void updateItems( int id );
-
- virtual void updateClear( int id );
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- void setupMenu() const;
- class TDESelectActionPrivate;
- TDESelectActionPrivate *d;
-
-};
-
-/// Remove this class in KDE-4.0. It doesn't add _anything_ to TDESelectAction
-/**
- * @deprecated Use TDESelectAction instead.
- */
-class TDEUI_EXPORT_DEPRECATED TDEListAction : public TDESelectAction
-{
- Q_OBJECT
-
-public:
- /**
- * Constructs a list action with text and potential keyboard
- * accelerator but nothing else. Use this only if you really
- * know what you are doing.
- *
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( const TQString& text, const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0,
- const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( const TQString& text, const TDEShortcut& cut, const TQObject* receiver,
- const char* slot, TQObject* parent, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( const TQString& text, const TQString& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent,
- const char* name = 0 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent,
- const char* name = 0 );
-
- /**
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEListAction( TQObject* parent = 0, const char* name = 0 );
-
- /**
- * Destructor
- */
- virtual ~TDEListAction();
-
-
- virtual TQString currentText() const;
- virtual int currentItem() const;
-
-
-public slots:
- /**
- * Sets the currently checked item.
- *
- * @param index Index of the item (remember the first item is zero).
- */
- virtual void setCurrentItem( int index );
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEListActionPrivate;
- TDEListActionPrivate *d;
-};
-
-/**
- * @short Recent files action
- *
- * This class is an action to handle a recent files submenu.
- * The best way to create the action is to use KStdAction::openRecent.
- * Then you simply need to call loadEntries on startup, saveEntries
- * on shutdown, addURL when your application loads/saves a file.
- *
- * @author Michael Koch
- */
-class TDEUI_EXPORT TDERecentFilesAction : public TDEListAction // TODO public TDESelectAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( uint maxItems READ maxItems WRITE setMaxItems )
-public:
- /**
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( const TQString& text, const TDEShortcut& cut,
- TQObject* parent, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * @param text The text that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke when a URL is selected.
- * Its signature is of the form slotURLSelected( const KURL & ).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( const TQString& text, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- TQObject* parent, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- TQObject* parent, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The icons that go with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke when a URL is selected.
- * Its signature is of the form slotURLSelected( const KURL & ).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * @param text The text that will be displayed.
- * @param pix The dynamically loaded icon that goes with this action.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke when a URL is selected.
- * Its signature is of the form slotURLSelected( const KURL & ).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * @param parent This action's parent.
- * @param name An internal name for this action.
- * @param maxItems The maximum number of files to display
- */
- TDERecentFilesAction( TQObject* parent = 0, const char* name = 0,
- uint maxItems = 10 );
-
- /**
- * Destructor.
- */
- virtual ~TDERecentFilesAction();
-
- virtual int plug( TQWidget *widget, int index = -1 );
-
- /**
- * Returns the maximum of items in the recent files list.
- */
- uint maxItems() const;
-
-//KDE4: remove completeItems() and rename items() to urls(), to get the list of URLs added to
-// the action.
- /**
- * @return the items that can be selected with this action.
- * The returned items do not contain the pretty name that can be set by addURL,
- * matching the pre-3.5 behavior.
- */
-
- virtual TQStringList items() const;
-
- /**
- * @return the items that can be selected with this action.
- * The returned items contain the pretty name that can be set by addURL.
- * @since 3.5
- */
- TQStringList completeItems() const;
-
-public slots:
- /**
- * Sets the maximum of items in the recent files list.
- * The default for this value is 10 set in the constructor.
- *
- * If this value is lesser than the number of items currently
- * in the recent files list the last items are deleted until
- * the number of items are equal to the new maximum.
- */
- void setMaxItems( uint maxItems );
-
- /**
- * Loads the recent files entries from a given TDEConfig object.
- * You can provide the name of the group used to load the entries.
- * If the groupname is empty, entries are load from a group called 'RecentFiles'
- *
- * This method does not effect the active group of TDEConfig.
- */
- void loadEntries( TDEConfig* config, TQString groupname=TQString::null );
-
- /**
- * Saves the current recent files entries to a given TDEConfig object.
- * You can provide the name of the group used to load the entries.
- * If the groupname is empty, entries are saved to a group called 'RecentFiles'
- *
- * This method does not effect the active group of TDEConfig.
- */
- void saveEntries( TDEConfig* config, TQString groupname=TQString::null );
-
- /**
- * Add URL to recent files list.
- *
- * @param url The URL of the file
- */
- void addURL( const KURL& url );
-
- /**
- * Add URL to recent files list.
- *
- * @param url The URL of the file
- * @param name The user visible pretty name that appears before the URL
- * @since 3.5
- */
- void addURL( const KURL& url, const TQString& name ); //KDE4: Combine the above two methods
-
- /**
- * Remove an URL from the recent files list.
- *
- * @param url The URL of the file
- */
- void removeURL( const KURL& url );
-
- /**
- * Removes all entries from the recent files list.
- */
- void clearURLList();
-
-signals:
-
- /**
- * This signal gets emited when the user selects an URL.
- *
- * @param url The URL thats the user selected.
- */
- void urlSelected( const KURL& url );
-
-protected slots:
- void itemSelected( const TQString& string );
- void menuAboutToShow();
- void menuItemActivated( int id );
- void slotClicked();
- virtual void slotActivated(int);
- virtual void slotActivated(const TQString& );
- virtual void slotActivated();
-
-protected:
- virtual void virtual_hook( int id, void* data );
-
-private:
- void init();
-
- class TDERecentFilesActionPrivate;
- TDERecentFilesActionPrivate *d;
-};
-
-class TDEUI_EXPORT TDEFontAction : public TDESelectAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( TQString font READ font WRITE setFont )
-public:
- TDEFontAction( const TQString& text, const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0,
- const char* name = 0 );
- TDEFontAction( const TQString& text, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent,
- const char* name = 0 );
- TDEFontAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
- TDEFontAction( const TQString& text, const TQString& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
- TDEFontAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent,
- const char* name = 0 );
- TDEFontAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot, TQObject* parent,
- const char* name = 0 );
-
-// The ctors with fontListCriteria were added after 3.3-beta1.
-// This define is used in koffice. Remove when koffice has a dependency on tdelibs-3.3 or more.
-#define KFONTACTION_HAS_CRITERIA_ARG
- TDEFontAction( uint fontListCriteria, const TQString& text,
- const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0,
- const char* name = 0 );
- TDEFontAction( uint fontListCriteria, const TQString& text, const TQString& pix,
- const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- TDEFontAction( TQObject* parent = 0, const char* name = 0 );
- ~TDEFontAction();
-
- TQString font() const {
- return currentText();
- }
-
- int plug( TQWidget*widget, int index = -1 );
-
-public slots:
- void setFont( const TQString &family );
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEFontActionPrivate;
- TDEFontActionPrivate *d;
-};
-
-class TDEUI_EXPORT TDEFontSizeAction : public TDESelectAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( int fontSize READ fontSize WRITE setFontSize )
-public:
- TDEFontSizeAction( const TQString& text, const TDEShortcut& cut = TDEShortcut(), TQObject* parent = 0,
- const char* name = 0 );
- TDEFontSizeAction( const TQString& text, const TDEShortcut& cut, const TQObject* receiver,
- const char* slot, TQObject* parent, const char* name = 0 );
- TDEFontSizeAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
- TDEFontSizeAction( const TQString& text, const TQString& pix, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
- TDEFontSizeAction( const TQString& text, const TQIconSet& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0 );
- TDEFontSizeAction( const TQString& text, const TQString& pix, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, const char* name = 0 );
- TDEFontSizeAction( TQObject* parent = 0, const char* name = 0 );
-
- virtual ~TDEFontSizeAction();
-
- virtual int fontSize() const;
-
-public slots:
- virtual void setFontSize( int size );
-
-protected slots:
- virtual void slotActivated( int );
- virtual void slotActivated( const TQString& );
- virtual void slotActivated() { TDEAction::slotActivated(); }
-
-signals:
- void fontSizeChanged( int );
-
-private:
- void init();
-
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEFontSizeActionPrivate;
- TDEFontSizeActionPrivate *d;
-};
-
-
-/**
- * A TDEActionMenu is an action that holds a sub-menu of other actions.
- * insert() and remove() allow to insert and remove actions into this action-menu.
- * Plugged in a popupmenu, it will create a submenu.
- * Plugged in a toolbar, it will create a button with a popup menu.
- *
- * This is the action used by the XMLGUI since it holds other actions.
- * If you want a submenu for selecting one tool among many (without icons), see TDESelectAction.
- * See also setDelayed about the main action.
- */
-class TDEUI_EXPORT TDEActionMenu : public TDEAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( bool delayed READ delayed WRITE setDelayed )
- TQ_PROPERTY( bool stickyMenu READ stickyMenu WRITE setStickyMenu )
-
-public:
- TDEActionMenu( const TQString& text, TQObject* parent = 0,
- const char* name = 0 );
- TDEActionMenu( const TQString& text, const TQIconSet& icon,
- TQObject* parent = 0, const char* name = 0 );
- TDEActionMenu( const TQString& text, const TQString& icon,
- TQObject* parent = 0, const char* name = 0 );
- TDEActionMenu( TQObject* parent = 0, const char* name = 0 );
- virtual ~TDEActionMenu();
-
- virtual void insert( TDEAction*, int index = -1 );
- virtual void remove( TDEAction* );
-
- TDEPopupMenu* popupMenu() const;
- void popup( const TQPoint& global );
-
- /**
- * Returns true if this action creates a delayed popup menu
- * when plugged in a TDEToolbar.
- */
- bool delayed() const;
- /**
- * If set to true, this action will create a delayed popup menu
- * when plugged in a TDEToolbar. Otherwise it creates a normal popup.
- * Default: delayed
- *
- * Remember that if the "main" action (the toolbar button itself)
- * cannot be clicked, then you should call setDelayed(false).
- *
- * On the opposite, if the main action can be clicked, it can only happen
- * in a toolbar: in a menu, the parent of a submenu can't be activated.
- * To get a "normal" menu item when plugged a menu (and no submenu)
- * use TDEToolBarPopupAction.
- */
- void setDelayed(bool _delayed);
-
- /**
- * Returns true if this action creates a sticky popup menu.
- * See setStickyMenu().
- */
- bool stickyMenu() const;
- /**
- * If set to true, this action will create a sticky popup menu
- * when plugged in a TDEToolbar.
- * "Sticky", means it's visible until a selection is made or the mouse is
- * clicked elsewhere. This feature allows you to make a selection without
- * having to press and hold down the mouse while making a selection.
- * Default: sticky.
- */
- void setStickyMenu(bool sticky);
-
- virtual int plug( TQWidget* widget, int index = -1 );
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEActionMenuPrivate;
- TDEActionMenuPrivate *d;
-};
-
-/**
- * This action is a normal action everywhere, except in a toolbar
- * where it also has a popupmenu (optionnally delayed). This action is designed
- * for history actions (back/forward, undo/redo) and for any other action
- * that has more detail in a toolbar than in a menu (e.g. tool chooser
- * with "Other" leading to a dialog...).
- */
-class TDEUI_EXPORT TDEToolBarPopupAction : public TDEAction
-{
- Q_OBJECT
-
- TQ_PROPERTY( bool delayed READ delayed WRITE setDelayed )
- TQ_PROPERTY( bool stickyMenu READ stickyMenu WRITE setStickyMenu )
-
-public:
- //Not all constructors - because we need an icon, since this action only makes
- // sense when being plugged at least in a toolbar.
- /**
- * Create a TDEToolBarPopupAction, with a text, an icon, an optional accelerator,
- * parent and name.
- *
- * @param text The text that will be displayed.
- * @param icon The icon to display.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToolBarPopupAction( const TQString& text, const TQString& icon, const TDEShortcut& cut = TDEShortcut(),
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * Create a TDEToolBarPopupAction, with a text, an icon, an accelerator,
- * a slot connected to the action, parent and name.
- *
- * If you do not want or have a keyboard accelerator, set the
- * @p cut param to 0.
- *
- * @param text The text that will be displayed.
- * @param icon The icon to display.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's owner.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToolBarPopupAction( const TQString& text, const TQString& icon, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent = 0, const char* name = 0 );
-
- /**
- * Create a TDEToolBarPopupAction, with a KGuiItem, an accelerator,
- * a slot connected to the action, parent and name. The text and the
- * icon are taken from the KGuiItem.
- *
- * If you do not want or have a keyboard accelerator, set the
- * @p cut param to 0.
- *
- * @param item The text and icon that will be displayed.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's owner.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEToolBarPopupAction( const KGuiItem& item, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TDEActionCollection* parent, const char* name );
-
- virtual ~TDEToolBarPopupAction();
-
- virtual int plug( TQWidget *widget, int index = -1 );
-
- /**
- * The popup menu that is shown when clicking (some time) on the toolbar
- * button. You may want to plug items into it on creation, or connect to
- * aboutToShow for a more dynamic menu.
- */
- TDEPopupMenu *popupMenu() const;
-
- /**
- * Returns true if this action creates a delayed popup menu
- * when plugged in a TDEToolbar.
- */
- bool delayed() const;
- /**
- * If set to true, this action will create a delayed popup menu
- * when plugged in a TDEToolbar. Otherwise it creates a normal popup.
- * Default: delayed.
- */
- void setDelayed(bool delayed);
- /**
- * Returns true if this action creates a sticky popup menu.
- * See setStickyMenu().
- */
- bool stickyMenu() const;
- /**
- * If set to true, this action will create a sticky popup menu
- * when plugged in a TDEToolbar.
- * "Sticky", means it's visible until a selection is made or the mouse is
- * clicked elsewhere. This feature allows you to make a selection without
- * having to press and hold down the mouse while making a selection.
- * Only available if delayed() is true.
- * Default: sticky.
- */
- void setStickyMenu(bool sticky);
-
-private:
- TDEPopupMenu *m_popup;
- bool m_delayed:1;
- bool m_stickyMenu:1;
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEToolBarPopupActionPrivate;
- TDEToolBarPopupActionPrivate *d;
-};
-
-/**
- * An action that takes care of everything associated with
- * showing or hiding a toolbar by a menu action. It will
- * show or hide the toolbar with the given name when
- * activated, and check or uncheck itself if the toolbar
- * is manually shown or hidden.
- *
- * If you need to perfom some additional action when the
- * toolbar is shown or hidden, connect to the toggled(bool)
- * signal. It will be emitted after the toolbar's
- * visibility has changed, whenever it changes.
- * @since 3.1
- */
-class TDEUI_EXPORT TDEToggleToolBarAction : public TDEToggleAction
-{
- Q_OBJECT
-
-public:
- /**
- * Create a TDEToggleToolbarAction that manages the toolbar
- * named toolBarName. This can be either the name of a
- * toolbar in an xml ui file, or a toolbar programmatically
- * created with that name.
- */
- TDEToggleToolBarAction( const char* toolBarName, const TQString& text,
- TDEActionCollection* parent, const char* name );
- TDEToggleToolBarAction( TDEToolBar *toolBar, const TQString &text,
- TDEActionCollection *parent, const char *name );
- virtual ~TDEToggleToolBarAction();
-
- virtual int plug( TQWidget * widget, int index = -1 );
-
- TDEToolBar *toolBar() { return m_toolBar; }
-
-public slots:
- virtual void setChecked( bool );
-
-private:
- TQCString m_toolBarName;
- TQGuardedPtr<TDEToolBar> m_toolBar;
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEToggleToolBarActionPrivate;
- TDEToggleToolBarActionPrivate *d;
-};
-
-/**
- * An action for switching between to/from full screen mode. Note that
- * TQWidget::isFullScreen() may reflect the new or the old state
- * depending on how the action was triggered (by the application or
- * from the window manager). Also don't try to track the window state
- * yourself. Rely on this action's state (isChecked()) instead.
- *
- * Important: If you need to set/change the fullscreen state manually,
- * use the relevant TQWidget function (showFullScreen etc.), do not
- * call directly the slot connected to the toggled() signal. The slot
- * still needs to explicitly set the window state though.
- * @since 3.2
- */
-class TDEUI_EXPORT TDEToggleFullScreenAction : public TDEToggleAction
-{
- Q_OBJECT
-
-public:
- /**
- * Create a TDEToggleFullScreenAction
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's parent.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param window the window that will switch to/from full screen mode
- * @param name An internal name for this action.
- */
- TDEToggleFullScreenAction( const TDEShortcut &cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent, TQWidget* window,
- const char* name );
- virtual ~TDEToggleFullScreenAction();
-
- /**
- * Sets the window that will be related to this action.
- */
- void setWindow( TQWidget* window );
-public slots:
- virtual void setChecked( bool );
-protected:
- /**
- * @internal
- */
- virtual bool eventFilter( TQObject* o, TQEvent* e );
-private:
- TQWidget* window;
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEToggleFullScreenActionPrivate;
- TDEToggleFullScreenActionPrivate *d;
-};
-
-
-/**
- * An action that automatically embeds a widget into a
- * toolbar.
- */
-class TDEUI_EXPORT KWidgetAction : public TDEAction
-{
- Q_OBJECT
-
-public:
- /**
- * Create an action that will embed widget into a toolbar
- * when plugged. This action may only be plugged into
- * a toolbar.
- */
- KWidgetAction( TQWidget* widget, const TQString& text,
- const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TDEActionCollection* parent, const char* name );
- virtual ~KWidgetAction();
-
- /**
- * Returns the widget associated with this action.
- */
- TQWidget* widget() { return m_widget; }
-
- void setAutoSized( bool );
-
- /**
- * Plug the action. The widget passed to the constructor
- * will be reparented to w, which must inherit TDEToolBar.
- */
- virtual int plug( TQWidget* widget, int index = -1 );
- /**
- * Unplug the action. Ensures that the action is not
- * destroyed. It will be hidden and reparented to 0L instead.
- */
- virtual void unplug( TQWidget *w );
-protected slots:
- void slotToolbarDestroyed();
-private:
- TQGuardedPtr<TQWidget> m_widget;
- bool m_autoSized;
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class KWidgetActionPrivate;
- KWidgetActionPrivate *d;
-};
-
-class TDEUI_EXPORT TDEActionSeparator : public TDEAction
-{
- Q_OBJECT
-
-public:
- TDEActionSeparator( TQObject* parent = 0, const char* name = 0 );
- virtual ~TDEActionSeparator();
-
- virtual int plug( TQWidget *widget, int index = -1 );
-
-protected:
- virtual void virtual_hook( int id, void* data );
-private:
- class TDEActionSeparatorPrivate;
- TDEActionSeparatorPrivate *d;
-};
-
-/**
- * An action for pasting text from the clipboard.
- * It's useful for text handling applications as
- * when plugged into a toolbar it provides a menu
- * with the clipboard history if klipper is running.
- * If klipper is not running, the menu has only one
- * item: the current clipboard content.
- *
- * @since 3.2
- */
-class TDEUI_EXPORT TDEPasteTextAction: public TDEAction
-{
- Q_OBJECT
-
-public:
- /**
- * Create a TDEPasteTextAction, with a text, an icon, an accelerator,
- * a slot connected to the action, parent and name.
- *
- * If you do not want or have a keyboard accelerator, set the
- * @p cut param to 0.
- *
- * @param text The text that will be displayed.
- * @param icon The icon to display.
- * @param cut The corresponding keyboard accelerator (shortcut).
- * @param receiver The SLOT's owner.
- * @param slot The TQT_SLOT to invoke to execute this action.
- * @param parent This action's parent.
- * @param name An internal name for this action.
- */
- TDEPasteTextAction( const TQString& text, const TQString& icon, const TDEShortcut& cut,
- const TQObject* receiver, const char* slot,
- TQObject* parent = 0, const char* name = 0 );
-
- virtual ~TDEPasteTextAction();
-
- /**
- * Controls the behavior of the clipboard history menu popup.
- *
- * @param mode If false and the clipboard contains a non-text object
- * the popup menu with the clipboard history will appear
- * immediately as the user clicks the toolbar action; if
- * true, the action works like the standard paste action
- * even if the current clipboard object is not text.
- * Default value is true.
- */
- void setMixedMode(bool mode);
-
- virtual int plug( TQWidget *widget, int index = -1 );
-
-protected slots:
- void menuAboutToShow();
- void menuItemActivated( int id);
- virtual void slotActivated();
-
-protected:
- virtual void virtual_hook( int id, void* data );
-
-private:
- TDEPopupMenu *m_popup;
- bool m_mixedMode;
- class TDEPasteTextActionPrivate;
- TDEPasteTextActionPrivate *d;
-};
-
-#endif