#### PyKDE - Python Bindings for KDE

# class KDialogBase

Table of contents
Modules
kdeui Classes
All Classes

Module | kdeui
Class | KDialogBase
Inherits | KDialog

### enums

- ActionButtonStyle = {ActionStyle0 = 0, ActionStyle1, ActionStyle2, ActionStyle3, ActionStyle4, ActionStyleMAX }
- ButtonCode = {Help = 1, Default = 2, Ok = 4, Apply = 8, Try = 16, Cancel = 32, Close = 64, User1 = 128, User2 = 256, User3 = 512, No = 128, Yes = 256, Details = 1024, Filler = 1073741824, Stretch = -2147483648, NoDefault }
- ButtonCode = {Help = 1, Default = 2, Ok = 4, Apply = 8, Try = 16, Cancel = 32, Close = 64, User1 = 128, User2 = 256, User3 = 512, No = 128, Yes = 256, Details = 1024, Filler = 1073741824, Stretch = -2147483648 }
- DialogType = {TreeList = KJanusWidget .TreeList , Tabbed = KJanusWidget .Tabbed , Plain = KJanusWidget .Plain , Swallow = KJanusWidget .Swallow , IconList = KJanusWidget .IconList }

### methods

- KDialogBase (parent = 0, name = 0, modal = 1, caption = QString .null, buttonMask = Ok | Apply | Cancel, defaultButton = Ok, separator = 0, user1 = KGuiItem (), user2 = KGuiItem (), user3 = KGuiItem ())

  returns a KDialogBase instance

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget | 0
  name | char | 0
  modal | bool | 1
  caption | QString | QString .null
  buttonMask | int | Ok | Apply | Cancel
  defaultButton | KDialogBase.ButtonCode | Ok
  separator | bool | 0
  user1 | KGuiItem | KGuiItem ()
  user2 | KGuiItem | KGuiItem ()
  user3 | KGuiItem | KGuiItem ()

- KDialogBase (dialogFace, caption, buttonMask, defaultButton, parent = 0, name = 0, modal = 1, separator = 0, user1 = KGuiItem (), user2 = KGuiItem (), user3 = KGuiItem ())

  returns a KDialogBase instance

  Argument | Type | Default
  --- | --- | ---
  dialogFace | int |
  caption | QString |
  buttonMask | int |
  defaultButton | KDialogBase.ButtonCode |
  parent | QWidget | 0
  name | char | 0
  modal | bool | 1
  separator | bool | 0
  user1 | KGuiItem | KGuiItem ()
  user2 | KGuiItem | KGuiItem ()
  user3 | KGuiItem | KGuiItem ()

- KDialogBase (dialogFace, f, parent = 0, name = 0, modal = 1, caption = QString .null, buttonMask = Ok | Apply | Cancel, defaultButton = Ok, separator = 0, user1 = KGuiItem (), user2 = KGuiItem (), user3 = KGuiItem ())

  returns a KDialogBase instance
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  dialogFace | KDialogBase.DialogType |
  f | WFlags |
  parent | QWidget | 0
  name | char | 0
  modal | bool | 1
  caption | QString | QString .null
  buttonMask | int | Ok | Apply | Cancel
  defaultButton | KDialogBase.ButtonCode | Ok
  separator | bool | 0
  user1 | KGuiItem | KGuiItem ()
  user2 | KGuiItem | KGuiItem ()
  user3 | KGuiItem | KGuiItem ()

- KDialogBase (caption, buttonMask = Yes | No | Cancel, defaultButton = Yes, escapeButton = Cancel, parent = 0, name = 0, modal = 1, separator = 0, yes = KStdGuiItem .yes (), no = KStdGuiItem .no (), cancel = KStdGuiItem .cancel ())

  returns a KDialogBase instance

  Argument | Type | Default
  --- | --- | ---
  caption | QString |
  buttonMask | int | Yes | No | Cancel
  defaultButton | KDialogBase.ButtonCode | Yes
  escapeButton | KDialogBase.ButtonCode | Cancel
  parent | QWidget | 0
  name | char | 0
  modal | bool | 1
  separator | bool | 0
  yes | KGuiItem | KStdGuiItem .yes ()
  no | KGuiItem | KStdGuiItem .no ()
  cancel | KGuiItem | KStdGuiItem .cancel ()

- aboutToShowDetails ()

  returns nothing

- aboutToShowPage (page)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  page | QWidget |

- actionButton (id)

  returns (QPushButton)

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |

- activePageIndex ()

  returns (int)

- addButtonBelowList (text, recv, slot)

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  text | QString |
  recv | QObject |
  slot | char |

- addButtonBelowList (guiitem, recv, slot)

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  guiitem | KGuiItem |
  recv | QObject |
  slot | char |

- addGridPage (n, dir, itemName, header = QString .null, pixmap = QPixmap ())

  returns (QGrid)

  Argument | Type | Default
  --- | --- | ---
  n | int |
  dir | Qt.Orientation |
  itemName | QString |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addGridPage (n, dir, items, header = QString .null, pixmap = QPixmap ())

  returns (QGrid)

  Argument | Type | Default
  --- | --- | ---
  n | int |
  dir | Qt.Orientation |
  items | QStringList |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addHBoxPage (itemName, header = QString .null, pixmap = QPixmap ())

  returns (QHBox)

  Argument | Type | Default
  --- | --- | ---
  itemName | QString |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addHBoxPage (items, header = QString .null, pixmap = QPixmap ())

  returns (QHBox)

  Argument | Type | Default
  --- | --- | ---
  items | QStringList |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addPage (itemName, header = QString .null, pixmap = QPixmap ())

  returns (QFrame)

  Argument | Type | Default
  --- | --- | ---
  itemName | QString |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addPage (items, header = QString .null, pixmap = QPixmap ())

  returns (QFrame)

  Argument | Type | Default
  --- | --- | ---
  items | QStringList |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addVBoxPage (itemName, header = QString .null, pixmap = QPixmap ())

  returns (QVBox)

  Argument | Type | Default
  --- | --- | ---
  itemName | QString |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addVBoxPage (items, header = QString .null, pixmap = QPixmap ())

  returns (QVBox)

  Argument | Type | Default
  --- | --- | ---
  items | QStringList |
  header | QString | QString .null
  pixmap | QPixmap | QPixmap ()

- addWidgetBelowList (widget)

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  widget | QWidget |

- adjustSize ()

  returns nothing

- apply ()

  returns nothing

- applyClicked ()

  returns nothing

- applyPressed ()

  returns nothing

- backgroundChanged ()

  returns nothing

- backgroundTile ()

  returns (QPixmap)
  static

- calculateSize (w, h)

  returns (QSize)

  Argument | Type | Default
  --- | --- | ---
  w | int |
  h | int |

- cancel ()

  returns nothing
  In versions KDE 3.1.0 and above only

- cancelClicked ()

  returns nothing

- closeClicked ()

  returns nothing

- closeEvent (e)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  e | QCloseEvent |

- configDialogSize (groupName)

  returns (QSize)

  Argument | Type | Default
  --- | --- | ---
  groupName | QString |

- configDialogSize (config, groupName)

  returns (QSize)
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  config | KConfig |
  groupName | QString |

- defaultClicked ()

  returns nothing

- delayedDestruct ()

  returns nothing
  In versions KDE 3.1.0 and above only

- delayedDestruct ()

  returns nothing
  In versions less than KDE 3.1.0 only

- disableResize ()

  returns nothing

- enableButton (id, state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |
  state | bool |

- enableButtonApply (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- enableButtonCancel (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- enableButtonOK (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- enableButtonSeparator (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- enableLinkedHelp (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- finished ()

  returns nothing

- getBackgroundTile ()

  returns (QPixmap)
  static

- getBorderWidths ()

  returns ulx (int) uly (int) lrx (int) lry (int)

- getContentsRect ()

  returns (QRect)

- haveBackgroundTile ()

  returns (bool)
  static

- helpClicked ()

  returns nothing

- helpClickedSlot (a0)

  returns nothing

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

- helpLinkText ()

  returns (QString)

- hidden ()

  returns nothing

- hideEvent (a0)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  a0 | QHideEvent |

- incInitialSize (s, noResize = 0)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  s | QSize |
  noResize | bool | 0

- keyPressEvent (e)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  e | QKeyEvent |

- mainWidget ()

  returns (QWidget)

- makeGridMainWidget (n, dir)

  returns (QGrid)

  Argument | Type | Default
  --- | --- | ---
  n | int |
  dir | Qt.Orientation |

- makeHBoxMainWidget ()

  returns (QHBox)

- makeMainWidget ()

  returns (QFrame)

- makeVBoxMainWidget ()

  returns (QVBox)

- minimumSizeHint ()

  returns (QSize)

- noClicked ()

  returns nothing

- okClicked ()

  returns nothing

- pageIndex (widget)

  returns (int)

  Argument | Type | Default
  --- | --- | ---
  widget | QWidget |

- plainPage ()

  returns (QFrame)

- saveDialogSize (groupName, global = 0)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  groupName | QString |
  global | bool | 0

- saveDialogSize (config, groupName, global = 0)

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  config | KConfig |
  groupName | QString |
  global | bool | 0

- setBackgroundTile (pix)

  returns nothing
  static

  Argument | Type | Default
  --- | --- | ---
  pix | QPixmap |

- setButtonApply (item = KStdGuiItem .apply ())

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  item | KGuiItem | KStdGuiItem .apply ()

- setButtonApplyText (text = QString .null, tooltip = QString .null, quickhelp = QString .null)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  text | QString | QString .null
  tooltip | QString | QString .null
  quickhelp | QString | QString .null

- setButtonBoxOrientation (orientation)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  orientation | int |

- setButtonCancel (item = KStdGuiItem .cancel ())

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  item | KGuiItem | KStdGuiItem .cancel ()

- setButtonCancelText (text = QString .null, tooltip = QString .null, quickhelp = QString .null)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  text | QString | QString .null
  tooltip | QString | QString .null
  quickhelp | QString | QString .null

- setButtonGuiItem (id, item)

  returns nothing
  In versions KDE 3.3.0 and above only

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |
  item | KGuiItem |

- setButtonOK (item = KStdGuiItem .ok ())

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  item | KGuiItem | KStdGuiItem .ok ()

- setButtonOKText (text = QString .null, tooltip = QString .null, quickhelp = QString .null)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  text | QString | QString .null
  tooltip | QString | QString .null
  quickhelp | QString | QString .null

- setButtonText (id, text)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |
  text | QString |

- setButtonTip (id, text)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |
  text | QString |

- setButtonWhatsThis (id, text)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |
  text | QString |

- setDetails (showDetails)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  showDetails | bool |

- setDetailsWidget (detailsWidget)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  detailsWidget | QWidget |

- setEscapeButton (id)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |

- setFolderIcon (path, pixmap)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  path | QStringList |
  pixmap | QPixmap |

- setHelp (anchor, appname = QString .null)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  anchor | QString |
  appname | QString | QString .null

- setHelpLinkText (text)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  text | QString |

- setIconListAllVisible (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- setInitialSize (s, noResize = 0)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  s | QSize |
  noResize | bool | 0

- setMainWidget (widget)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  widget | QWidget |

- setRootIsDecorated (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- setShowIconsInTreeList (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- setTreeListAutoResize (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- showButton (id, state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  id | KDialogBase.ButtonCode |
  state | bool |

- showButtonApply (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- showButtonCancel (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- showButtonOK (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- showPage (index)

  returns (bool)

  Argument | Type | Default
  --- | --- | ---
  index | int |

- showTile (state)

  returns nothing

  Argument | Type | Default
  --- | --- | ---
  state | bool |

- sizeHint ()

  returns (QSize)

- slotApply ()

  returns nothing

- slotCancel ()

  returns nothing

- slotClose ()

  returns nothing

- slotDefault ()

  returns nothing

- slotDelayedDestruct ()

  returns nothing

- slotDetails ()

  returns nothing

- slotHelp ()

  returns nothing

- slotNo ()

  returns nothing

- slotOk ()

  returns nothing

- slotTry ()

  returns nothing

- slotUser1 ()

  returns nothing

- slotUser2 ()

  returns nothing

- slotUser3 ()

  returns nothing

- slotYes ()

  returns nothing

- tryClicked ()

  returns nothing

- unfoldTreeList (persist = 0)

  returns nothing
  In versions KDE 3.2.0 and above only

  Argument | Type | Default
  --- | --- | ---
  persist | bool | 0

- updateBackground ()

  returns nothing

- updateGeometry ()

  returns nothing

- user1Clicked ()

  returns nothing

- user2Clicked ()

  returns nothing

- user3Clicked ()

  returns nothing

- yesClicked ()

  returns nothing