# class KIconDialog

###

Module | kio
Namespace |
Class | KIconDialog
Inherits | KDialog

### methods

- KIconDialog (parent)

  returns ctor
  KDE 4.1.0 and later only

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget | 0

  Constructs an icon selection dialog using the global iconloader.

  parent - The parent widget.

- KIconDialog (loader, parent)

  returns ctor
  KDE 4.1.0 and later only

  Argument | Type | Default
  --- | --- | ---
  loader | KIconLoader |
  parent | QWidget | 0

  Constructs an icon selection dialog using a specific iconloader.

  loader - The icon loader to use.

  parent - The parent widget.

- KIconDialog (a0)

  returns ctor
  Not implemented

  Argument | Type | Default
  --- | --- | ---
  a0 | KIconDialog |

- KIconDialog (a0)

  returns ctor
  before KDE 4.1.0 only

  Argument | Type | Default
  --- | --- | ---
  a0 | QWidget | 0

- KIconDialog (a0, a1)

  returns ctor
  before KDE 4.1.0 only

  Argument | Type | Default
  --- | --- | ---
  a0 | KIconLoader |
  a1 | QWidget | 0

- getIcon (group, context, strictIconSize, iconSize, user, parent, caption)

  returns QString
  Not implemented

  Argument | Type | Default
  --- | --- | ---
  group | KIconLoader.Group | KIconLoader.Desktop
  context | KIconLoader.Context | KIconLoader.Application
  strictIconSize | bool | 0
  iconSize | int | 0
  user | bool | 0
  parent | QWidget | 0
  caption | QString | QString()

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

  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".

  parent - The parent widget of the dialog.

  caption - The caption to use for the dialog. Returns The name of the icon, suitable for loading with KIconLoader.

- iconSize ( )

  returns int

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

- newIconName (a0)

  returns Nothing
  SIGNAL ("newIconName (const QString&)")

  Argument | Type | Default
  --- | --- | ---
  a0 | QString |

- openDialog ( )

  returns QString

  exec()utes this modal dialog and returns the name of the selected icon, or QString() if the dialog was aborted. Returns the name of the icon, suitable for loading with KIconLoader.

  See also getIcon

- setCustomLocation (location)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  location | QString |

  sets a custom icon directory

- setIconSize (size)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  size | int |

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

  See also KIconLoader.StdSizes

  See also iconSize

- setStrictIconSize (b)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  b | bool |

  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.

- setup (group, context, strictIconSize, iconSize, user, lockUser, lockCustomDir)

  returns Nothing
  Not implemented

  Argument | Type | Default
  --- | --- | ---
  group | KIconLoader.Group |
  context | KIconLoader.Context | KIconLoader.Application
  strictIconSize | bool | 0
  iconSize | int | 0
  user | bool | 0
  lockUser | bool | 0
  lockCustomDir | bool | 0

  Allows you to set the same parameters as in the class method getIcon(), as well as two additional parameters to lock the choice between system and user dirs and to lock the custom user dir itself.

- showDialog ( )

  returns Nothing

  show()es this dialog and emits a newIcon(const QString&) signal when successful. QString() will be emitted if the dialog was aborted.

- slotOk ( )

  returns Nothing

- strictIconSize ( )

  returns bool

  Returns true if a strict icon size policy is set.