summaryrefslogtreecommitdiffstats
path: root/kdeui/kcmenumngr.h
diff options
context:
space:
mode:
Diffstat (limited to 'kdeui/kcmenumngr.h')
-rw-r--r--kdeui/kcmenumngr.h116
1 files changed, 0 insertions, 116 deletions
diff --git a/kdeui/kcmenumngr.h b/kdeui/kcmenumngr.h
deleted file mode 100644
index ce05f6b9d..000000000
--- a/kdeui/kcmenumngr.h
+++ /dev/null
@@ -1,116 +0,0 @@
-/* This file is part of the KDE libraries
- Copyright (C) 1999 Matthias Ettrich (ettrich@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 as published by the Free Software Foundation; either
- version 2 of the License, or (at your option) any later version.
-
- 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 KCMENUMNGR_H
-#define KCMENUMNGR_H
-
-// #include <tqt.h>
-
-#include <tqobject.h>
-#include <tqptrdict.h>
-#include <tqkeysequence.h>
-
-#include <kdelibs_export.h>
-
-class TQWidget;
-class TQPopupMenu;
-class KContextMenuManagerPrivate;
-
-/**
-@short Convenience class to mangage context menus
-@author Matthias Ettrich <ettrich@kde.org>
-
-KContextMenuManager manages configurable context popup menus. Instead
-of reimplementing TQWidget::mousePressEvent() or
- TQWidget::mouseReleaseEvent() and/or TQWidget::keyPressEvent(), simply
-create the popup menu and insert it into the context menu manager with
-the static function insert().
-
-Example:
-\code
- KContextMenuManager::insert( myWidget, myPopupMenu );
-\endcode
-
-
-Context menus are invoked with either a special shortcut key (usually
-the menu key) or the right mouse button.
-
-Menus are configurable in the [ContextMenus] group of the application's
-configuration file, usually in kdeglobals:
-\code
- [ContextMenus]
- ShowOnPress=true|false
-\endcode
-
-@p ShowOnPress defines whether the menu shall be shown on mouse
-press or on mouse release.
-
-The shortcut key to invoke the context menu is defined in the standard
-[Keys] section of the application configuration:
-\code
- [Keys]
- ...
- PopupContextMenu=Menu
- ...
-\endcode
-The key can be configured with the standard keys module in the KDE control center.
-
-If the popup menu is invoked with the keyboard shortcut, it's shown at
-the position of the micro focus hint of the widget ( TQWidget::microFocusHint() ).
-*/
-
-class KDEUI_EXPORT KContextMenuManager : public TQObject
-{
- Q_OBJECT
-public:
-
- /**
- Makes @p popup a context popup menu for widget @p widget.
-
- Ownership of the popup menu is not transferred to the context
- menu manager.
- */
- static void insert( TQWidget* widget, TQPopupMenu* popup );
-
- /**
- * Use this method to get information about when a popup menu
- * should be activated. This can be useful if the popup menu is
- * to be activated from a listview.
- *
- * @return true if the menu should be made visible on a button press
- * or false after a button press-release sequence.
- */
- static bool showOnButtonPress( void );
-
-private slots:
- void widgetDestroyed();
-private:
- KContextMenuManager( TQObject* parent = 0, const char* name = 0);
- ~KContextMenuManager();
- bool eventFilter( TQObject *, TQEvent * );
- TQPtrDict<TQPopupMenu> menus;
- bool showOnPress;
- TQKeySequence menuKey;
- static KContextMenuManager* manager;
- friend class I_really_like_this_class; // avoid warning
-
- KContextMenuManagerPrivate *d;
-};
-
-#endif