---

KDialog Class Reference

#include <kdialog.h>

Inheritance diagram for KDialog:

List of all members.

Public Slots
virtual void	setCaption (const QString &caption)
virtual void	setPlainCaption (const QString &caption)
Signals
void	layoutHintChanged ()
Public Methods
	KDialog (QWidget *parent=0, const char *name=0, bool modal=false, WFlags f=0)
Static Public Methods
int	marginHint ()
int	spacingHint ()
void	resizeLayout (QWidget *widget, int margin, int spacing)
void	resizeLayout (QLayoutItem *lay, int margin, int spacing)
void	centerOnScreen (QWidget *widget, int screen=-1)

---

Detailed Description

Dialog with extended nonmodal support and methods for KDE standard compliance.

Generally, you should not use this class directly, but KDialogBase which inherits KDialog.

If the dialog is non-modal and has a parent, the default keybindings (escape = reject(), enter = accept(), etc.) are disabled.

The marginHint() and spacingHint() sizes shall be used whenever you layout the interior of a dialog. One special note. If you make your own action buttons (OK, Cancel etc), the space beteween the buttons shall be spacingHint(), whereas the space above, below, to the right and to the left shall be marginHint(). If you add a separator line above the buttons, there shall be a marginHint() between the buttons and the separator and a marginHint() above the separator as well.

See also:

KDialogBase

Author:

Thomas Tanghus <tanghus@earthling.net>, Espen Sand <espensa@online.no>

Version:

0.1.2

Definition at line 51 of file kdialog.h.

---

Constructor & Destructor Documentation

KDialog::KDialog (  QWidget *    parent = 0, const char *    name = 0, bool    modal = false, WFlags    f = 0 )

Constructor. Takes the same arguments as QDialog.

---

Member Function Documentation

void KDialog::centerOnScreen (  QWidget *    widget, int    screen = -1 )  [static]

Centers widget on the desktop, taking multi-head setups into account. If screen is -1, widget will be centered on its current screen (if it was shown already) or on the primary screen. Since: 3.1

void KDialog::layoutHintChanged (    )  [signal]

Emitted when the margin size and/or spacing size have changed. Use marginHint() and spacingHint() in your slot to get the new values.

int KDialog::marginHint (    )  [static]

Return the number of pixels you shall use between a dialog edge and the outermost widget(s) according to the KDE standard.

void KDialog::resizeLayout (  QLayoutItem *    lay, int    margin, int    spacing )  [static]

Reszie every layout associated with lay and its children. Parameters: margin  The new layout margin margin  The new layout spacing

void KDialog::resizeLayout (  QWidget *    widget, int    margin, int    spacing )  [static]

Resize every layout manager used in widget and its nested children. Parameters: margin  The new layout margin. margin  The new layout spacing.

virtual void KDialog::setCaption (  const QString &    caption )  [virtual, slot]

Make a KDE compliant caption. Parameters: caption  Your caption. Do not include the application name in this string. It will be added automatically according to the KDE standard.

virtual void KDialog::setPlainCaption (  const QString &    caption )  [virtual, slot]

Make a plain caption without any modifications. Parameters: caption  Your caption. This is the string that will be displayed in the window title.

int KDialog::spacingHint (    )  [static]

Return the number of pixels you shall use between widgets inside a dialog according to the KDE standard.

---

The documentation for this class was generated from the following file:

• kdialog.h

---