class KIconDialog

An icon selection dialog. More...

Definition#include <kicondialog.h>
InheritsKDialogBase (kdeui) [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Public Static Methods

Protected Methods


Detailed Description

Dialog for interactive selection of icons. Use the function getIcon() let the user select an icon.

 KIconDialog (QWidget *parent=0L, const char *name=0L)

KIconDialog

Constructs an icon selection dialog using the global iconloader.

 KIconDialog (KIconLoader *loader, QWidget *parent=0, const char *name=0)

KIconDialog

Constructs an icon selection dialog using a specific iconloader.

 ~KIconDialog ()

~KIconDialog

Destructs the dialog.

void  setStrictIconSize (bool b)

setStrictIconSize

Sets a strict icon size policy for allowed icons. When true, only icons of the specified group's size in getIcon() are shown. When false, icons not available at the desired group's size will also be selectable.

bool  strictIconSize ()

strictIconSize

[const]

Returns true if a strict icon size policy is set.

void  setIconSize (int size)

setIconSize

Sets the size of the icons to be shown / selected.

See also: iconSize, iconSize

int  iconSize ()

iconSize

[const]

Returns the iconsize set via setIconSize() or 0, if the default iconsize will be used.

QString  selectIcon (KIcon::Group group=KIcon::Desktop, KIcon::Context context=KIcon::Application, bool user=false)

selectIcon

void  setup ( KIcon::Group group, KIcon::Context context = KIcon::Application, bool strictIconSize = false, int iconSize = 0, bool user = false )

setup

Allows you to set the same parameters as in the class method getIcon().

QString  openDialog ()

openDialog

exec()utes this modal dialog and returns the name of the selected icon, or QString::null if the dialog was aborted.

Returns: the name of the icon, suitable for loading with KIconLoader.

See also: getIcon

QString  getIcon (KIcon::Group group=KIcon::Desktop, KIcon::Context context=KIcon::Application, bool strictIconSize=false, int iconSize = 0, bool user=false, QWidget *parent=0, const QString &caption=QString::null)

getIcon

[static]

Pops up the dialog an lets the user select an icon.

Parameters:
groupThe icon group this icon is intended for. Providing the group shows the icons in the dialog with the same appearance as when used outside the dialog.
contextThe initial icon context. Initially, the icons having this context are shown in the dialog. The user can change this.
strictIconSizeWhen true, only icons of the specified group's size are shown, otherwise icon not available in the desired group's size will also be selectable.
iconSizethe size of the icons -- the default of the icongroup if set to 0
userBegin with the "user icons" instead of "system icons".

Returns: The name of the icon, suitable for loading with KIconLoader.

void  virtual_hook ( int id, void* data )

virtual_hook

[protected virtual]

Reimplemented from KDialogBase.


Generated by: dfaure on faure on Tue Apr 16 08:50:13 2002, using kdoc 2.0a53.