class KIconDialog

# class KIconDialog | An icon selection dialog. More...
Definition | `#include <kicondialog.h>`
Inherits | KDialogBase (kdeui) [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

#### Public Methods

- KIconDialog (QWidget *parent=0L, const char *name=0L)
- KIconDialog (KIconLoader *loader, QWidget *parent=0, const char *name=0)
- ~KIconDialog ()
- void setStrictIconSize (bool b)
- bool strictIconSize () const
- void setCustomLocation ( const QString& location )
- void setIconSize (int size)
- int iconSize () const
- QString selectIcon (KIcon::Group group=KIcon::Desktop, KIcon::Context context=KIcon::Application, bool user=false)
- void setup ( KIcon::Group group, KIcon::Context context = KIcon::Application, bool strictIconSize = false, int iconSize = 0, bool user = false )
- QString openDialog ()

#### Public Static Methods

- static 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)

#### Protected Methods

- virtual void virtual_hook ( int id, void* data )

## 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 setCustomLocation ( const QString& location ) | ### setCustomLocation

sets a custom icon directory

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:

group | The 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.
context | The initial icon context. Initially, the icons having this context are shown in the dialog. The user can change this.
strictIconSize | When 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.
iconSize | the size of the icons -- the default of the icongroup if set to 0
user | Begin 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: root on macppc.ports.openbsd.org on Sat Sep 6 10:37:17 2003, using kdoc 2.0a54.