1 /****************************************************************************
2 **
3 ** Copyright (C) 2016 The Qt Company Ltd.
4 ** Contact: https://www.qt.io/licensing/
5 **
6 ** This file is part of the documentation of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:BSD$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see https://www.qt.io/terms-conditions. For further
15 ** information use the contact form at https://www.qt.io/contact-us.
16 **
17 ** BSD License Usage
18 ** Alternatively, you may use this file under the terms of the BSD license
19 ** as follows:
20 **
21 ** "Redistribution and use in source and binary forms, with or without
22 ** modification, are permitted provided that the following conditions are
23 ** met:
24 ** * Redistributions of source code must retain the above copyright
25 ** notice, this list of conditions and the following disclaimer.
26 ** * Redistributions in binary form must reproduce the above copyright
27 ** notice, this list of conditions and the following disclaimer in
28 ** the documentation and/or other materials provided with the
29 ** distribution.
30 ** * Neither the name of The Qt Company Ltd nor the names of its
31 ** contributors may be used to endorse or promote products derived
32 ** from this software without specific prior written permission.
33 **
34 **
35 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
36 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
37 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
38 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
39 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
41 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
42 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
43 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
44 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
45 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
46 **
47 ** $QT_END_LICENSE$
48 **
49 ****************************************************************************/
50
51 //! [0]
52 int ret = QMessageBox::warning(this, tr("My Application"),
53 tr("The document has been modified.\n"
54 "Do you want to save your changes?"),
55 QMessageBox::Save | QMessageBox::Discard
56 | QMessageBox::Cancel,
57 QMessageBox::Save);
58 //! [0]
59
60
61 //! [1]
62 QMessageBox msgBox;
63 msgBox.setStandardButtons(QMessageBox::Yes | QMessageBox::No);
64 switch (msgBox.exec()) {
65 case QMessageBox::Yes:
66 // yes was clicked
67 break;
68 case QMessageBox::No:
69 // no was clicked
70 break;
71 default:
72 // should never be reached
73 break;
74 }
75 //! [1]
76
77
78 //! [2]
79 QMessageBox msgBox;
80 QPushButton *connectButton = msgBox.addButton(tr("Connect"), QMessageBox::ActionRole);
81 QPushButton *abortButton = msgBox.addButton(QMessageBox::Abort);
82
83 msgBox.exec();
84
85 if (msgBox.clickedButton() == connectButton) {
86 // connect
87 } else if (msgBox.clickedButton() == abortButton) {
88 // abort
89 }
90 //! [2]
91
92
93 //! [3]
94 QMessageBox messageBox(this);
95 QAbstractButton *disconnectButton =
96 messageBox.addButton(tr("Disconnect"), QMessageBox::ActionRole);
97 ...
98 messageBox.exec();
99 if (messageBox.clickedButton() == disconnectButton) {
100 ...
101 }
102 //! [3]
103
104
105 //! [4]
106 #include <QApplication>
107 #include <QMessageBox>
108
main(int argc,char * argv[])109 int main(int argc, char *argv[])
110 {
111 QT_REQUIRE_VERSION(argc, argv, "4.0.2")
112
113 QApplication app(argc, argv);
114 ...
115 return app.exec();
116 }
117 //! [4]
118
119 //! [5]
120 QMessageBox msgBox;
121 msgBox.setText("The document has been modified.");
122 msgBox.exec();
123 //! [5]
124
125 //! [6]
126 QMessageBox msgBox;
127 msgBox.setText("The document has been modified.");
128 msgBox.setInformativeText("Do you want to save your changes?");
129 msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
130 msgBox.setDefaultButton(QMessageBox::Save);
131 int ret = msgBox.exec();
132 //! [6]
133
134 //! [7]
135 switch (ret) {
136 case QMessageBox::Save:
137 // Save was clicked
138 break;
139 case QMessageBox::Discard:
140 // Don't Save was clicked
141 break;
142 case QMessageBox::Cancel:
143 // Cancel was clicked
144 break;
145 default:
146 // should never be reached
147 break;
148 }
149 //! [7]
150
151 //! [9]
152 QMessageBox msgBox(this);
153 msgBox.setText(tr("The document has been modified.\n"
154 "Do you want to save your changes?"));
155 msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard
156 | QMessageBox::Cancel);
157 msgBox.setDefaultButton(QMessageBox::Save);
158 //! [9]
159