org.kde.koala

Class StatusBarExtension

public class StatusBarExtension extends QObject

Every part can use this class to customize the statusbar as long as it is active. Add items via addStatusBarItem() and remove an item with removeStatusBarItem(). IMPORTANT: do NOT add any items immediately after constructing the extension. Give the application time to set the statusbar in the extension if necessary.

UNKNOWN: An extension for KParts that allows more sophisticated statusbar handling.

Constructor Summary
protected StatusBarExtension(Class dummy)
StatusBarExtension(ReadOnlyPart parent, String name)
StatusBarExtension(ReadOnlyPart parent)
Method Summary
voidaddStatusBarItem(QWidget widget, int stretch, boolean permanent)
This adds a widget to the statusbar for this part.
static StatusBarExtensionchildObject(QObject arg1)
Queries obj for a child object which inherits from this BrowserExtension class.
StringclassName()
booleaneventFilter(QObject watched, QEvent ev)
QMetaObjectmetaObject()
voidremoveStatusBarItem(QWidget widget)
Remove a widget from the statusbar for this part.
voidsetStatusBar(KStatusBar status)
This allows the hosting application to set a particular KStatusBar for this part.
KStatusBarstatusBar()

Constructor Detail

StatusBarExtension

protected StatusBarExtension(Class dummy)

StatusBarExtension

public StatusBarExtension(ReadOnlyPart parent, String name)

StatusBarExtension

public StatusBarExtension(ReadOnlyPart parent)

Method Detail

addStatusBarItem

public void addStatusBarItem(QWidget widget, int stretch, boolean permanent)
This adds a widget to the statusbar for this part. If you use this method instead of using statusBar() directly, this extension will take care of removing the items when the parts GUI is deactivated and will re-add them when it is reactivated. The parameters are the same as QStatusBar.addWidget(). Note that you can't use KStatusBar methods (inserting text items by id) but you can create a KStatusBarLabel with a dummy id instead, and use it directly in order to get the same look and feel.

Parameters: widget the widget to add stretch the stretch factor. 0 for a minimum size. permanent passed to QStatusBar.addWidget as the "permanent" boolean. Note that the item isn't really permanent though, it goes away when the part is unactivated. This simply controls where temporary messages hide the widget, and whether it's added to the left or to the right side. IMPORTANT: do NOT add any items immediately after constructing the extension. Give the application time to set the statusbar in the extension if necessary.

UNKNOWN: This adds a widget to the statusbar for this part.

childObject

public static StatusBarExtension childObject(QObject arg1)
Queries obj for a child object which inherits from this BrowserExtension class. Convenience method.

UNKNOWN: Queries obj for a child object which inherits from this BrowserExtension class.

className

public String className()

eventFilter

public boolean eventFilter(QObject watched, QEvent ev)

UNKNOWN: @short @internal

metaObject

public QMetaObject metaObject()

removeStatusBarItem

public void removeStatusBarItem(QWidget widget)
Remove a widget from the statusbar for this part.

UNKNOWN: Remove a widget from the statusbar for this part.

setStatusBar

public void setStatusBar(KStatusBar status)
This allows the hosting application to set a particular KStatusBar for this part. If it doesn't do this, the statusbar used will be the one of the KMainWindow in which the part is embedded. Konqueror uses this to assign a view-statusbar to the part. The part should never call this method!

UNKNOWN: This allows the hosting application to set a particular KStatusBar for this part.

statusBar

public KStatusBar statusBar()

Returns: the statusbar of the KMainWindow in which this part is currently embedded. WARNING: this could return 0L

UNKNOWN: