File indexing completed on 2024-04-21 14:55:56

0001 /*  This file is part of the KDE libraries
0002     Copyright (C) 1999 Waldo Bastian (bastian@kde.org)
0003 
0004     This library is free software; you can redistribute it and/or
0005     modify it under the terms of the GNU Library General Public
0006     License as published by the Free Software Foundation; version 2
0007     of the License.
0008 
0009     This library is distributed in the hope that it will be useful,
0010     but WITHOUT ANY WARRANTY; without even the implied warranty of
0011     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0012     Library General Public License for more details.
0013 
0014     You should have received a copy of the GNU Library General Public License
0015     along with this library; see the file COPYING.LIB.  If not, write to
0016     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
0017     Boston, MA 02110-1301, USA.
0018 */
0019 
0020 class QWidget;
0021 
0022 #include <QString>
0023 #include <qwindowdefs.h>
0024 
0025 #include <kmessagebox.h>
0026 
0027 #include <kdelibs4support_export.h>
0028 
0029 namespace KMessageBox
0030 {
0031 
0032 /**
0033  * Like detailedError
0034  *
0035  * This function will return immediately, the messagebox will be shown
0036  * once the application enters an event loop and no other messagebox
0037  * is being shown.
0038  *
0039  * Note that if the parent gets deleted, the messagebox will not be
0040  * shown.
0041  */
0042 KDELIBS4SUPPORT_DEPRECATED_EXPORT void queuedDetailedError(QWidget *parent,
0043         const QString &text,
0044         const QString &details,
0045         const QString &caption = QString());
0046 
0047 /**
0048  * This function accepts the window id of the parent window, instead
0049  * of QWidget*. It should be used only when necessary.
0050  */
0051 KDELIBS4SUPPORT_DEPRECATED_EXPORT void queuedDetailedErrorWId(WId parent_id,
0052         const QString &text,
0053         const QString &details,
0054         const QString &caption = QString());
0055 
0056 /**
0057  * Like messageBox
0058  *
0059  * Only for message boxes of type Information, Sorry or Error.
0060  *
0061  * This function will return immediately, the messagebox will be shown
0062  * once the application enters an event loop and no other messagebox
0063  * is being shown.
0064  *
0065  * Note that if the parent gets deleted, the messagebox will not be
0066  * shown.
0067  */
0068 KDELIBS4SUPPORT_DEPRECATED_EXPORT void queuedMessageBox(QWidget *parent,
0069         DialogType type, const QString &text,
0070         const QString &caption,
0071         Options options);
0072 
0073 /**
0074  * This function accepts the window id of the parent window, instead
0075  * of QWidget*. It should be used only when necessary.
0076  */
0077 KDELIBS4SUPPORT_DEPRECATED_EXPORT void queuedMessageBoxWId(WId parent_id,
0078         DialogType type, const QString &text,
0079         const QString &caption,
0080         Options options);
0081 
0082 /**
0083  * @overload
0084  *
0085  * This is an overloaded member function, provided for convenience.
0086  * It behaves essentially like the above function.
0087  */
0088 KDELIBS4SUPPORT_DEPRECATED_EXPORT void queuedMessageBox(QWidget *parent,
0089         DialogType type, const QString &text,
0090         const QString &caption = QString());
0091 
0092 /**
0093  * This function accepts the window id of the parent window, instead
0094  * of QWidget*. It should be used only when necessary.
0095  */
0096 KDELIBS4SUPPORT_DEPRECATED_EXPORT void queuedMessageBoxWId(WId parent_id,
0097         DialogType type, const QString &text,
0098         const QString &caption = QString());
0099 
0100 } // namespace