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