KPopupMenu Class Reference

[kdeui Index] [kdeui Hierarchy] [Headers]


Popup menu with title. More...

#include <kpopmenu.h>

Inherits: QPopupMenu (qt)

Public Members

Private Members


Detailed Description

Here's a popup menu widget for KDE apps. It differs from Qt popup menu in

that it has a title -- thus it is *not* to be used in a menu bar. Only two

new methods are added -- setTitle(char *) and title() and a new constructor,

taking the title as a first argument. The main API difference from Qt's

QPopupMenu is that you should *not* expect the first item you insert into

KPopupMenu to have index (an ID) 0! So the following is wrong:

KPopupMenu menu("Window operations");

menu->insertItem("Move");

menu->insertItem("Minimize");

menu->insertItem("Close");

menu->connectItem(0, this, SLOT(moveWindow())); // WRONG!!!

menu->connectItem(1, this, SLOT(minimizeWindow())); // WRONG!!!

menu->connectItem(2, this, SLOT(closeWindow())); // WRONG!!!

The reason is that the title and a double line (actually, two separators) are

stored as menu items too, so the first item you insert has index 3. There's

a constant KPM_FirstItem so use one of those approaches instead of the above:

[1] int move_item = menu->insertItem("Move");

...

menu->connectItem(menu_item, this, SLOT(moveWindow()));

[2] menu->insertItem("Move");

...

menu->connectItem(KPM_FirstItem+0, this, SLOT(moveWindow()));

[3] The best one!

menu->insertItem("Move", this, SLOT(moveWindow()));



  • Version: $Id: kpopmenu.h,v 1.3 1998/09/01 20:22:05 kulow Exp $
  • Documentation generated by root@darkstar.lst.de on Wed Sep 8 17:38:27 CEST 1999
Kdoc