TaskManagerEntry Class Reference
[QtBaseModule]

Detailed Description

The TaskManagerEntry class is used to insert non-application items into the Running Applications/TaskManager window.

Normally, the TaskManager only shows Qt Extended applications. However, there may be times when you need to show other items in the TaskManager. For example, if you have a server task that displays an informational dialog about a long-running activity, you might want the dialog to be accessible via the TaskManager window so the user can return to the dialog if it is backgrounded. However, in this situation, the dialog will not automatically be displayed in the TaskManager because it is an ordinary dialog and not a Qt Extended application.

In these cases, you can use the TaskManagerEntry class. For example:

    TaskManagerEntry *cpuMonitorItem =
            new TaskManagerEntry(tr("CPU Monitor"), "cpuMonitorIcon");
    connect(cpuMonitorItem, SIGNAL(activated()),
            this, SLOT(raiseCpuMonitorDialog()));
    cpuMonitorItem->show();

The activated() signal is emitted when the user activates the item in the TaskManager window.

Member Function Documentation

TaskManagerEntry::TaskManagerEntry ( const QString & description, const QString & iconPath, QObject * parent = 0 )

Constructs a new TaskManagerEntry. description represents the string under which the entry should appear in the task task manager launcher view and iconPath describes the icon to be used. parent is the standard QObject parent parameter.

void TaskManagerEntry::activated ()   [signal]

Emitted when the user has activated this item from the TaskManager.

void TaskManagerEntry::hide ()   [slot]

Hides this item in the TaskManager. This is equivalent to deregistering the entry.

See also show().

void TaskManagerEntry::show ()   [slot]

Shows this item in the Running Applications window. This is equivalent to registering the this new entry with the task manager.

See also hide().