org.kde.koala
public class KURLBar extends QFrame
UNKNOWN: A URL-bar widget, as used in the KFileDialog.
Constructor Summary | |
---|---|
protected | KURLBar(Class dummy) |
KURLBar(boolean useGlobalItems, QWidget parent, String name, int f)
Constructs a KURLBar. | |
KURLBar(boolean useGlobalItems, QWidget parent, String name) | |
KURLBar(boolean useGlobalItems, QWidget parent) | |
KURLBar(boolean useGlobalItems) |
Method Summary | |
---|---|
protected boolean | addNewItem()
Pops up a KURLBarItemDialog to let the user add a new item.
|
String | className() |
void | clear()
Clears the view, removes all items. |
KURLBarItem | currentItem() |
KURL | currentURL() |
void | dispose() Delete the wrapped C++ instance ahead of finalize() |
protected boolean | editItem(KURLBarItem item)
Pops up a KURLBarItemDialog to let the user edit the properties
of item. Invoked e.g. by addNewItem(), when the user drops
a url onto the bar or from the contextmenu. |
protected void | finalize() Deletes the wrapped C++ instance |
int | iconSize() |
KURLBarItem | insertDynamicItem(KURL url, String description, String icon, int group)
Inserts a new dynamic item into the KURLBar and returns the created
KURLBarItem.
|
KURLBarItem | insertDynamicItem(KURL url, String description, String icon) |
KURLBarItem | insertDynamicItem(KURL url, String description) |
KURLBarItem | insertItem(KURL url, String description, boolean applicationLocal, String icon, int group)
Inserts a new item into the KURLBar and returns the created
KURLBarItem.
|
KURLBarItem | insertItem(KURL url, String description, boolean applicationLocal, String icon) |
KURLBarItem | insertItem(KURL url, String description, boolean applicationLocal) |
KURLBarItem | insertItem(KURL url, String description) |
boolean | isDisposed() Has the wrapped C++ instance been deleted? |
boolean | isImmutable() |
boolean | isModified() |
boolean | isVertical() |
KURLBarListBox | listBox() |
QMetaObject | metaObject() |
QSize | minimumSizeHint() |
int | orientation() |
protected void | paletteChange(QPalette arg1) |
void | readConfig(KConfig config, String itemGroup)
Call this method to read a saved configuration from config ,
inside the group itemGroup. All items in there will be restored.
|
void | readItem(int i, KConfig config, boolean applicationLocal)
Called from readConfig() to read the i'th from config.
After reading a KURLBarItem is created and initialized with the read
values (as well as the given applicationLocal ). |
protected void | resizeEvent(QResizeEvent arg1) |
void | setCurrentItem(KURL url)
Makes the item with the url url the current item. |
void | setIconSize(int size)
Sets the default iconsize to be used for items inserted with
insertItem. |
void | setListBox(KURLBarListBox arg1)
Allows to set a custom KURLBarListBox.
|
void | setOrientation(int orient)
The items can be arranged either vertically in one column or
horizontally in one row. |
QSize | sizeHint() |
protected void | slotContextMenuRequested(QListBoxItem arg1, QPoint pos)
Reimplemented to show a contextmenu, allowing the user to add, edit
or remove items, or change the iconsize. |
protected void | slotDropped(QDropEvent arg1)
Called when a url was dropped onto the bar to show a
KURLBarItemDialog. |
protected void | slotSelected(QListBoxItem arg1)
Called when an item has been selected. |
void | writeConfig(KConfig config, String itemGroup)
Call this method to save the current configuration into config ,
inside the group iconGroup. The writeItem() method is used
to save each item. |
void | writeItem(KURLBarItem item, int i, KConfig arg3, boolean global)
Called from writeConfig() to save the KURLBarItem item as the
i'th entry in the config-object.
|
useGlobalItems
to true if you want to
allow global/local item separation.UNKNOWN: Constructs a KURLBar.
Returns: false if the user aborted the dialog and no item is added.
UNKNOWN: Pops up a KURLBarItemDialog to let the user add a new item.
UNKNOWN: Clears the view, removes all items.
Returns: the url of the current item or an invalid url, if there is no current item.
UNKNOWN:
item.
Invoked e.g. by addNewItem(), when the user drops
a url onto the bar or from the contextmenu.Returns: false if the user aborted the dialog and item
is not
changed.
UNKNOWN: Pops up a KURLBarItemDialog to let the user edit the properties of item.
Returns: the default iconsize used for items inserted with insertItem. By default KIcon.SizeMedium
See Also: KURLBar
UNKNOWN:
url
the url of the item
description
the description of the item (shown in the view)
icon
an icon -- if empty, the default icon for the url will be used
group
the icon-group for using icon-effectsUNKNOWN: Inserts a new dynamic item into the KURLBar and returns the created KURLBarItem.
url
the url of the item
description
the description of the item (shown in the view)
applicationLocal
whether this should be a global or a local item
icon
an icon -- if empty, the default icon for the url will be used
group
the icon-group for using icon-effectsUNKNOWN: Inserts a new item into the KURLBar and returns the created KURLBarItem.
Returns: true when the urlbar may not be modified by the user
UNKNOWN:
Returns: true when the urlbar was modified by the user (e.g. by editing/adding/removing one or more entries). Will be reset to false after calling writeConfig().
UNKNOWN:
Returns: true if the bar is in vertical mode.
UNKNOWN:
Returns: a proper minimum size (reimplemented)
UNKNOWN:
config
,
inside the group itemGroup.
All items in there will be restored.
The reading of every item is delegated to the readItem() method.UNKNOWN: Call this method to read a saved configuration from config
, inside the group itemGroup.
config.
After reading a KURLBarItem is created and initialized with the read
values (as well as the given applicationLocal
).UNKNOWN: Called from readConfig() to read the i'th from config.
url
the current item. Does nothing
if no item with that url is available.
UNKNOWN: Makes the item with the url url
the current item.
See Also: KURLBar
UNKNOWN: Sets the default iconsize to be used for items inserted with insertItem.
See Also: KURLBar
UNKNOWN: Allows to set a custom KURLBarListBox.
See Also: KURLBar
UNKNOWN: The items can be arranged either vertically in one column or horizontally in one row.
Returns: a proper sizehint, depending on the orientation and the number of items available.
UNKNOWN:
UNKNOWN: Reimplemented to show a contextmenu, allowing the user to add, edit or remove items, or change the iconsize.
UNKNOWN: Called when a url was dropped onto the bar to show a KURLBarItemDialog.
UNKNOWN: Called when an item has been selected.
config
,
inside the group iconGroup.
The writeItem() method is used
to save each item.UNKNOWN: Call this method to save the current configuration into config
, inside the group iconGroup.
item
as the
i'th entry in the config-object.
global
tell whether it should be saved in the global configuration
or not (using KConfig.writeEntry( key, value, true, global ) ).UNKNOWN: Called from writeConfig() to save the KURLBarItem item
as the i'th entry in the config-object.