org.kde.koala
public class KMessageBox extends Object implements QtSupport
UNKNOWN: Easy message dialog box.
Field Summary | |
---|---|
static int | AllowLink |
static int | Cancel |
static int | Continue |
static int | Dangerous |
static int | Error |
static int | Information |
static int | No |
static int | NoExec |
static int | Notify |
static int | Ok
Button types. |
static int | PlainCaption |
static int | QuestionYesNo |
static int | QuestionYesNoCancel |
static int | Sorry |
static int | WarningContinueCancel |
static int | WarningYesNo |
static int | WarningYesNoCancel |
static int | Yes |
Constructor Summary | |
---|---|
protected | KMessageBox(Class dummy) |
KMessageBox() |
Method Summary | |
---|---|
static void | about(QWidget parent, String text, String caption, int options)
Display an "About" dialog. |
static void | about(QWidget parent, String text, String caption) |
static void | about(QWidget parent, String text) |
static int | createKMessageBox(KDialogBase dialog, int icon, String text, String[] strlist, String ask, boolean[] checkboxReturn, int options, String details)
Create content and layout of a standard dialog |
static int | createKMessageBox(KDialogBase dialog, int icon, String text, String[] strlist, String ask, boolean[] checkboxReturn, int options) |
static int | createKMessageBox(KDialogBase dialog, QPixmap icon, String text, String[] strlist, String ask, boolean[] checkboxReturn, int options, String details, int notifyType)
Create content and layout of a standard dialog |
static int | createKMessageBox(KDialogBase dialog, QPixmap icon, String text, String[] strlist, String ask, boolean[] checkboxReturn, int options, String details) |
static int | createKMessageBox(KDialogBase dialog, QPixmap icon, String text, String[] strlist, String ask, boolean[] checkboxReturn, int options) |
static void | detailedError(QWidget parent, String text, String details, String caption, int options)
Displays an "Error" dialog with a "Details >>" button. |
static void | detailedError(QWidget parent, String text, String details, String caption) |
static void | detailedError(QWidget parent, String text, String details) |
static void | detailedErrorWId(long parent_id, String text, String details, String caption, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | detailedErrorWId(long parent_id, String text, String details, String caption) |
static void | detailedErrorWId(long parent_id, String text, String details) |
static void | detailedSorry(QWidget parent, String text, String details, String caption, int options)
Displays a "Sorry" dialog with a "Details >>" button. |
static void | detailedSorry(QWidget parent, String text, String details, String caption) |
static void | detailedSorry(QWidget parent, String text, String details) |
static void | detailedSorryWId(long parent_id, String text, String details, String caption, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | detailedSorryWId(long parent_id, String text, String details, String caption) |
static void | detailedSorryWId(long parent_id, String text, String details) |
void | dispose() Delete the wrapped C++ instance ahead of finalize() |
static void | enableAllMessages()
Enable all messages which have been turned off with the
dontShowAgainName feature. |
static void | enableMessage(String dontShowAgainName)
Re-enable a specific dontShowAgainName messages that had
previously been turned off. |
static void | error(QWidget parent, String text, String caption, int options)
Display an "Error" dialog. |
static void | error(QWidget parent, String text, String caption) |
static void | error(QWidget parent, String text) |
static void | errorList(QWidget parent, String text, String[] strlist, String caption, int options)
Display an "Error" dialog with a listbox. |
static void | errorList(QWidget parent, String text, String[] strlist, String caption) |
static void | errorList(QWidget parent, String text, String[] strlist) |
static void | errorListWId(long parent_id, String text, String[] strlist, String caption, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | errorListWId(long parent_id, String text, String[] strlist, String caption) |
static void | errorListWId(long parent_id, String text, String[] strlist) |
static void | errorWId(long parent_id, String text, String caption, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | errorWId(long parent_id, String text, String caption) |
static void | errorWId(long parent_id, String text) |
protected void | finalize() Deletes the wrapped C++ instance |
static void | information(QWidget parent, String text, String caption, String dontShowAgainName, int options)
Display an "Information" dialog. |
static void | information(QWidget parent, String text, String caption, String dontShowAgainName) |
static void | information(QWidget parent, String text, String caption) |
static void | information(QWidget parent, String text) |
static void | informationList(QWidget parent, String text, String[] strlist, String caption, String dontShowAgainName, int options)
Display an "Information" dialog with a listbox. |
static void | informationList(QWidget parent, String text, String[] strlist, String caption, String dontShowAgainName) |
static void | informationList(QWidget parent, String text, String[] strlist, String caption) |
static void | informationList(QWidget parent, String text, String[] strlist) |
static void | informationListWId(long parent_id, String text, String[] strlist, String caption, String dontShowAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | informationListWId(long parent_id, String text, String[] strlist, String caption, String dontShowAgainName) |
static void | informationListWId(long parent_id, String text, String[] strlist, String caption) |
static void | informationListWId(long parent_id, String text, String[] strlist) |
static void | informationWId(long parent_id, String text, String caption, String dontShowAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | informationWId(long parent_id, String text, String caption, String dontShowAgainName) |
static void | informationWId(long parent_id, String text, String caption) |
static void | informationWId(long parent_id, String text) |
boolean | isDisposed() Has the wrapped C++ instance been deleted? |
static int | messageBox(QWidget parent, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontShowAskAgainName, int options)
Alternate method to show a messagebox: |
static int | messageBox(QWidget parent, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontShowAskAgainName) |
static int | messageBox(QWidget parent, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, int options)
Alternate method to show a messagebox: |
static int | messageBox(QWidget parent, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | messageBox(QWidget parent, int type, String text, String caption, KGuiItem buttonYes) |
static int | messageBox(QWidget parent, int type, String text, String caption) |
static int | messageBox(QWidget parent, int type, String text) |
static int | messageBoxWId(long parent_id, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontShowAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | messageBoxWId(long parent_id, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontShowAskAgainName) |
static int | messageBoxWId(long parent_id, int type, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | messageBoxWId(long parent_id, int type, String text, String caption, KGuiItem buttonYes) |
static int | messageBoxWId(long parent_id, int type, String text, String caption) |
static int | messageBoxWId(long parent_id, int type, String text) |
static int | questionYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a simple "question" dialog. |
static int | questionYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | questionYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | questionYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes) |
static int | questionYesNo(QWidget parent, String text, String caption) |
static int | questionYesNo(QWidget parent, String text) |
static int | questionYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a simple "question" dialog. |
static int | questionYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | questionYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | questionYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes) |
static int | questionYesNoCancel(QWidget parent, String text, String caption) |
static int | questionYesNoCancel(QWidget parent, String text) |
static int | questionYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | questionYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | questionYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | questionYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes) |
static int | questionYesNoCancelWId(long parent_id, String text, String caption) |
static int | questionYesNoCancelWId(long parent_id, String text) |
static int | questionYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a "question" dialog with a listbox to show information to the user |
static int | questionYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | questionYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | questionYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes) |
static int | questionYesNoList(QWidget parent, String text, String[] strlist, String caption) |
static int | questionYesNoList(QWidget parent, String text, String[] strlist) |
static int | questionYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | questionYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | questionYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | questionYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes) |
static int | questionYesNoListWId(long parent_id, String text, String[] strlist, String caption) |
static int | questionYesNoListWId(long parent_id, String text, String[] strlist) |
static int | questionYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | questionYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | questionYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | questionYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes) |
static int | questionYesNoWId(long parent_id, String text, String caption) |
static int | questionYesNoWId(long parent_id, String text) |
static void | queuedDetailedError(QWidget parent, String text, String details, String caption)
Like detailedError
This function will return immediately, the messagebox will be shown
once the application enters an event loop and no other messagebox
is being shown.
|
static void | queuedDetailedError(QWidget parent, String text, String details) |
static void | queuedDetailedErrorWId(long parent_id, String text, String details, String caption)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | queuedDetailedErrorWId(long parent_id, String text, String details) |
static void | queuedMessageBox(QWidget parent, int type, String text, String caption, int options)
Like messageBox
Only for message boxes of type Information, Sorry or Error.
|
static void | queuedMessageBox(QWidget parent, int type, String text, String caption) |
static void | queuedMessageBox(QWidget parent, int type, String text) |
static void | queuedMessageBoxWId(long parent_id, int type, String text, String caption, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | queuedMessageBoxWId(long parent_id, int type, String text, String caption)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | queuedMessageBoxWId(long parent_id, int type, String text) |
static void | saveDontShowAgainContinue(String dontShowAgainName)
Save the fact that the continue/cancel message box should not be shown
again. |
static void | saveDontShowAgainYesNo(String dontShowAgainName, int result)
Save the fact that the yes/no message box should not be shown again. |
static void | setDontShowAskAgainConfig(KConfig cfg)
Use cfg for all settings related to the dontShowAgainName feature.
|
static boolean | shouldBeShownContinue(String dontShowAgainName) |
static boolean | shouldBeShownYesNo(String dontShowAgainName, int result) |
static void | sorry(QWidget parent, String text, String caption, int options)
Display an "Sorry" dialog. |
static void | sorry(QWidget parent, String text, String caption) |
static void | sorry(QWidget parent, String text) |
static void | sorryWId(long parent_id, String text, String caption, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static void | sorryWId(long parent_id, String text, String caption) |
static void | sorryWId(long parent_id, String text) |
static int | warningContinueCancel(QWidget parent, String text, String caption, KGuiItem buttonContinue, String dontAskAgainName, int options)
Display a "warning" dialog. |
static int | warningContinueCancel(QWidget parent, String text, String caption, KGuiItem buttonContinue, String dontAskAgainName) |
static int | warningContinueCancel(QWidget parent, String text, String caption, KGuiItem buttonContinue) |
static int | warningContinueCancel(QWidget parent, String text, String caption) |
static int | warningContinueCancel(QWidget parent, String text) |
static int | warningContinueCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonContinue, String dontAskAgainName, int options)
Display a "warning" dialog with a listbox to show information to the user. |
static int | warningContinueCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonContinue, String dontAskAgainName) |
static int | warningContinueCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonContinue) |
static int | warningContinueCancelList(QWidget parent, String text, String[] strlist, String caption) |
static int | warningContinueCancelList(QWidget parent, String text, String[] strlist) |
static int | warningContinueCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonContinue, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | warningContinueCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonContinue, String dontAskAgainName) |
static int | warningContinueCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonContinue) |
static int | warningContinueCancelListWId(long parent_id, String text, String[] strlist, String caption) |
static int | warningContinueCancelListWId(long parent_id, String text, String[] strlist) |
static int | warningContinueCancelWId(long parent_id, String text, String caption, KGuiItem buttonContinue, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | warningContinueCancelWId(long parent_id, String text, String caption, KGuiItem buttonContinue, String dontAskAgainName) |
static int | warningContinueCancelWId(long parent_id, String text, String caption, KGuiItem buttonContinue) |
static int | warningContinueCancelWId(long parent_id, String text, String caption) |
static int | warningContinueCancelWId(long parent_id, String text) |
static int | warningYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a "warning" dialog. |
static int | warningYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNo(QWidget parent, String text, String caption, KGuiItem buttonYes) |
static int | warningYesNo(QWidget parent, String text, String caption) |
static int | warningYesNo(QWidget parent, String text) |
static int | warningYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a Yes/No/Cancel "warning" dialog. |
static int | warningYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoCancel(QWidget parent, String text, String caption, KGuiItem buttonYes) |
static int | warningYesNoCancel(QWidget parent, String text, String caption) |
static int | warningYesNoCancel(QWidget parent, String text) |
static int | warningYesNoCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a Yes/No/Cancel "warning" dialog with a listbox to show information
to the user. |
static int | warningYesNoCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoCancelList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes) |
static int | warningYesNoCancelList(QWidget parent, String text, String[] strlist, String caption) |
static int | warningYesNoCancelList(QWidget parent, String text, String[] strlist) |
static int | warningYesNoCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | warningYesNoCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoCancelListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes) |
static int | warningYesNoCancelListWId(long parent_id, String text, String[] strlist, String caption) |
static int | warningYesNoCancelListWId(long parent_id, String text, String[] strlist) |
static int | warningYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | warningYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoCancelWId(long parent_id, String text, String caption, KGuiItem buttonYes) |
static int | warningYesNoCancelWId(long parent_id, String text, String caption) |
static int | warningYesNoCancelWId(long parent_id, String text) |
static int | warningYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
Display a "warning" dialog with a listbox to show information to the user |
static int | warningYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoList(QWidget parent, String text, String[] strlist, String caption, KGuiItem buttonYes) |
static int | warningYesNoList(QWidget parent, String text, String[] strlist, String caption) |
static int | warningYesNoList(QWidget parent, String text, String[] strlist) |
static int | warningYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | warningYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoListWId(long parent_id, String text, String[] strlist, String caption, KGuiItem buttonYes) |
static int | warningYesNoListWId(long parent_id, String text, String[] strlist, String caption) |
static int | warningYesNoListWId(long parent_id, String text, String[] strlist) |
static int | warningYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName, int options)
This function accepts the window id of the parent window, instead
of QWidget. |
static int | warningYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo, String dontAskAgainName) |
static int | warningYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes, KGuiItem buttonNo) |
static int | warningYesNoWId(long parent_id, String text, String caption, KGuiItem buttonYes) |
static int | warningYesNoWId(long parent_id, String text, String caption) |
static int | warningYesNoWId(long parent_id, String text) |
UNKNOWN: Button types.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("About \
UNKNOWN: Display an "About" dialog.
Parameters: dialog The parent dialog base icon Which predefined icon the message box shall show. text Message string. strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox ask The text of the checkbox. If empty none will be shown. checkboxReturn The result of the checkbox. If it's initially true then the checkbox will be checked by default. options see OptionsType details Detailed message string.
Returns: A KDialogBase button code, not a KMessageBox button code,
based on the buttonmask given to the constructor of the
dialog
(ie. will return KDialogBase.Yes [256] instead of
KMessageBox.Yes [3]). Will return KMessageBox.Cancel
if the message box is queued for display instead of
exec()ed immediately or if the option NoExec is set.
UNKNOWN: The dialog
that is passed in is deleted by this
function. Do not delete it yourself. Create content and layout of a standard dialog
Parameters: dialog The parent dialog base icon A QPixmap containing the icon to be displayed in the dialog next to the text. text Message string. strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox ask The text of the checkbox. If empty none will be shown. checkboxReturn The result of the checkbox. If it's initially true then the checkbox will be checked by default. options see OptionsType details Detailed message string. notifyType The type of notification to send when this message is presentend.
Returns: A KDialogBase button code, not a KMessageBox button code,
based on the buttonmask given to the constructor of the
dialog
(ie. will return KDialogBase.Yes [256] instead of
KMessageBox.Yes [3]). Will return KMessageBox.Cancel
if the message box is queued for display instead of
exec()ed immediately or if the option NoExec is set.
UNKNOWN: The dialog
that is passed in is deleted by this
function. Do not delete it yourself. Create content and layout of a standard dialog
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. details Detailed message string. caption Message box title. The application name is added to
the title. The default title is i18n("Error"). options see OptionsType
Your program messed up and now it's time to inform the user.
To be used for important things like "Sorry, I deleted your hard disk."
The details
message can conatin additional information about
the problem and can be shown on request to advanced/interested users.
If your program detects the action specified by the user is somehow
not allowed, this should never be reported with error(). Use sorry()
instead to explain to the user that this action is not allowed.
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The OK button will always have the i18n'ed text '&OK'.
UNKNOWN: Displays an "Error" dialog with a "Details >>" button.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. details Detailed message string. caption Message box title. The application name is added to
the title. The default title is i18n("Sorry"). options see OptionsType
Either your program messed up and asks for understanding
or your user did something stupid.
To be used for small problems like
"Sorry, I can't find the file you specified."
And then details
can contain something like
"foobar.txt was not found in any of
the following directories:
/usr/bin,/usr/local/bin,/usr/sbin"
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The ok button will always have the i18n'ed text '&OK'.
UNKNOWN: Displays a "Sorry" dialog with a "Details >>" button.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
dontShowAgainName
feature.UNKNOWN: Enable all messages which have been turned off with the dontShowAgainName
feature.
dontShowAgainName
messages that had
previously been turned off.See Also: KMessageBox KMessageBox
UNKNOWN: Re-enable a specific dontShowAgainName
messages that had previously been turned off.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Error"). options see OptionsType
Your program messed up and now it's time to inform the user.
To be used for important things like "Sorry, I deleted your hard disk."
If your program detects the action specified by the user is somehow
not allowed, this should never be reported with error(). Use sorry()
instead to explain to the user that this action is not allowed.
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The OK button will always have the i18n'ed text '&OK'.
UNKNOWN: Display an "Error" dialog.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. strlist List of strings to be written in the listbox. If the
list is empty, it doesn't show any listbox, working
as error(). caption Message box title. The application name is added to
the title. The default title is i18n("Error"). options see OptionsType
Your program messed up and now it's time to inform the user.
To be used for important things like "Sorry, I deleted your hard disk."
If your program detects the action specified by the user is somehow
not allowed, this should never be reported with error(). Use sorry()
instead to explain to the user that this action is not allowed.
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The OK button will always have the i18n'ed text '&OK'.
UNKNOWN: Display an "Error" dialog with a listbox.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Information"). dontShowAgainName If provided, a checkbox is added with which
further notifications can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group. options see OptionsType
Your program wants to tell the user something.
To be used for things like:
"Your bookmarks have been rearranged."
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The OK button will always have the i18n'ed text '&OK'.
UNKNOWN: Display an "Information" dialog.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. strlist List of strings to be written in the listbox. If the
list is empty, it doesn't show any listbox, working
as information. caption Message box title. The application name is added to
the title. The default title is i18n("Information"). dontShowAgainName If provided, a checkbox is added with which
further notifications can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group. options see OptionsType
Your program wants to tell the user something.
To be used for things like:
"The following bookmarks have been rearranged:"
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The OK button will always have the i18n'ed text '&OK'.
UNKNOWN: Display an "Information" dialog with a listbox.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. type type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel... text Message string. caption Message box title. buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontShowAskAgainName If provided, a checkbox is added with which
further questions/informations can be turned off. If turned off
all questions will be automatically answered with the
last answer (either Yes or No), if the message box needs an answer.
The string is used to lookup and store the setting
in the applications config file. options see OptionsType
Note: for ContinueCancel, buttonYes is the continue button and buttonNo is unused.
and for Information, none is used.
Returns: a button code, as defined in KMessageBox.
UNKNOWN: Alternate method to show a messagebox:
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. type type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel... text Message string. caption Message box title. buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). options see OptionsType
Note: for ContinueCancel, buttonYes is the continue button and buttonNo is unused.
and for Information, none is used.
Returns: a button code, as defined in KMessageBox.
UNKNOWN: Alternate method to show a messagebox:
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Question"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions like "Do you have a printer?"
The default button is "Yes". Pressing "Esc" selects "No".
Returns: 'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
UNKNOWN: Display a simple "question" dialog.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Question"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions like "Do you want to discard the message or save it for later?",
The default button is "Yes". Pressing "Esc" selects "Cancel".
NOTE: The cancel button will always have the i18n'ed text '&Cancel'.
Returns: 'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
UNKNOWN: Display a simple "question" dialog.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. strlist List of strings to be written in the listbox. If the list is
empty, it doesn't show any listbox, working as questionYesNo. caption Message box title. The application name is added to
the title. The default title is i18n("Question"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions like "Do you really want to delete these files?"
And show the user exactly which files are going to be deleted in case
he presses "Yes"
The default button is "Yes". Pressing "Esc" selects "No".
Returns: 'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
UNKNOWN: Display a "question" dialog with a listbox to show information to the user
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: Like detailedError
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: Like messageBox
UNKNOWN: This is an overloaded member function, provided for convenience. It behaves essentially like the above function. @overload
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: dontShowAgainName the name that identify the message box. If empty, this method does nothing.
UNKNOWN: Save the fact that the continue/cancel message box should not be shown again.
Parameters: dontShowAgainName the name that identify the message box. If empty, this method does nothing. result the value (Yes or No) that should be used as the result for the message box.
UNKNOWN: Save the fact that the yes/no message box should not be shown again.
cfg
for all settings related to the dontShowAgainName feature.
If cfg
is 0 (default) KGlobal.config() will be used.UNKNOWN: Use cfg
for all settings related to the dontShowAgainName feature.
Parameters: dontShowAgainName the name that identify the message box. If empty, true is always returned.
Returns: true if the corresponding continue/cancel message box should be shown.
UNKNOWN:
Parameters: dontShowAgainName the name that identify the message box. If empty, true is always returned. result is set to the result (Yes or No) that was chosen the last time the message box was shown. Only meaningful, if the message box should not be shown.
Returns: true if the corresponding yes/no message box should be shown.
UNKNOWN:
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Sorry"). options see OptionsType
Either your program messed up and asks for understanding
or your user did something stupid.
To be used for small problems like
"Sorry, I can't find the file you specified."
The default button is "&OK". Pressing "Esc" selects the OK-button.
NOTE: The ok button will always have the i18n'ed text '&OK'.
UNKNOWN: Display an "Sorry" dialog.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Warning"). buttonContinue The text for the first button. dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
The second button always has the text "Cancel".
To be used for questions like "You are about to Print. Are you sure?"
the continueButton should then be labeled "Print".
The default button is buttonContinue. Pressing "Esc" selects "Cancel".
Returns: Continue
is returned if the Continue-button is pressed.
Cancel
is returned if the Cancel-button is pressed.
UNKNOWN: Display a "warning" dialog.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. strlist List of strings to be written in the listbox. If the
list is empty, it doesn't show any listbox, working
as warningContinueCancel. caption Message box title. The application name is added to
the title. The default title is i18n("Warning"). buttonContinue The text for the first button. dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
The second button always has the text "Cancel".
To be used for questions like "You are about to Print. Are you sure?"
the continueButton should then be labeled "Print".
The default button is buttonContinue. Pressing "Esc" selects "Cancel".
Returns: Continue
is returned if the Continue-button is pressed.
Cancel
is returned if the Cancel-button is pressed.
UNKNOWN: Display a "warning" dialog with a listbox to show information to the user.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Warning"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions "Shall I update your configuration?"
The text should explain the implication of both options.
The default button is "No". Pressing "Esc" selects "No".
Returns: Yes
is returned if the Yes-button is pressed. No
is returned
if the No-button is pressed.
UNKNOWN: Display a "warning" dialog.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. caption Message box title. The application name is added to
the title. The default title is i18n("Warning"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further questions can be turned off. If turned off
all questions will be automatically answered with the
last answer (either Yes or No).
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions "Do you want to save your changes?"
The text should explain the implication of choosing 'No'.
The default button is "Yes". Pressing "Esc" selects "Cancel"
NOTE: The cancel button will always have the i18n'ed text '&Cancel'.
Returns: Yes
is returned if the Yes-button is pressed. No
is returned
if the No-button is pressed. Cancel
is retunred if the Cancel-
button is pressed.
UNKNOWN: Display a Yes/No/Cancel "warning" dialog.
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. strlist List of strings to be written in the listbox. If the
list is empty, it doesn't show any listbox, working
as warningYesNoCancel. caption Message box title. The application name is added to
the title. The default title is i18n("Warning"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further questions can be turned off. If turned off
all questions will be automatically answered with the
last answer (either Yes or No).
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions "Do you want to save your changes?"
The text should explain the implication of choosing 'No'.
The default button is "Yes". Pressing "Esc" selects "Cancel"
NOTE: The cancel button will always have the i18n'ed text '&Cancel'.
Returns: Yes
is returned if the Yes-button is pressed. No
is returned
if the No-button is pressed. Cancel
is retunred if the Cancel-
button is pressed.
UNKNOWN: Display a Yes/No/Cancel "warning" dialog with a listbox to show information to the user.
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
Parameters: parent If parent
is 0, then the message box becomes an
application-global modal dialog box. If parent
is a
widget, the message box becomes modal relative to parent. text Message string. strlist List of strings to be written in the listbox. If the list is
empty, it doesn't show any listbox, working as questionYesNo. caption Message box title. The application name is added to
the title. The default title is i18n("Question"). buttonYes The text for the first button.
The default is i18n("&Yes"). buttonNo The text for the second button.
The default is i18n("&No"). dontAskAgainName If provided, a checkbox is added with which
further confirmation can be turned off.
The string is used to lookup and store the setting
in the applications config file.
The setting is stored in the "Notification Messages" group.
If dontAskAgainName
starts with a ':' then the setting
is stored in the global config file. options see OptionsType
To be used for questions like "Do you really want to delete these files?"
And show the user exactly which files are going to be deleted in case
he presses "Yes"
The default button is "No". Pressing "Esc" selects "No".
Returns: 'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
UNKNOWN: Display a "warning" dialog with a listbox to show information to the user
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .
UNKNOWN: This function accepts the window id of the parent window, instead of QWidget .