Line | Source Code | Coverage |
---|
1 | /**************************************************************************** | - |
| ** | |
| ** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). | |
| ** Contact: http://www.qt-project.org/legal | |
| ** | |
| ** This file is part of the QtGui module of the Qt Toolkit. | |
| ** | |
| ** $QT_BEGIN_LICENSE:LGPL$ | |
| ** Commercial License Usage | |
| ** Licensees holding valid commercial Qt licenses may use this file in | |
| ** accordance with the commercial license agreement provided with the | |
| ** Software or, alternatively, in accordance with the terms contained in | |
| ** a written agreement between you and Digia. For licensing terms and | |
| ** conditions see http://qt.digia.com/licensing. For further information | |
| ** use the contact form at http://qt.digia.com/contact-us. | |
| ** | |
| ** GNU Lesser General Public License Usage | |
| ** Alternatively, this file may be used under the terms of the GNU Lesser | |
| ** General Public License version 2.1 as published by the Free Software | |
| ** Foundation and appearing in the file LICENSE.LGPL included in the | |
| ** packaging of this file. Please review the following information to | |
| ** ensure the GNU Lesser General Public License version 2.1 requirements | |
| ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | |
| ** | |
| ** In addition, as a special exception, Digia gives you certain additional | |
| ** rights. These rights are described in the Digia Qt LGPL Exception | |
| ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | |
| ** | |
| ** GNU General Public License Usage | |
| ** Alternatively, this file may be used under the terms of the GNU | |
| ** General Public License version 3.0 as published by the Free Software | |
| ** Foundation and appearing in the file LICENSE.GPL included in the | |
| ** packaging of this file. Please review the following information to | |
| ** ensure the GNU General Public License version 3.0 requirements will be | |
| ** met: http://www.gnu.org/copyleft/gpl.html. | |
| ** | |
| ** | |
| ** $QT_END_LICENSE$ | |
| ** | |
| ****************************************************************************/**************************************************************************** | |
2 | ** | - |
3 | ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). | - |
4 | ** Contact: http://www.qt-project.org/legal | - |
5 | ** | - |
6 | ** This file is part of the QtGui module of the Qt Toolkit. | - |
7 | ** | - |
8 | ** $QT_BEGIN_LICENSE:LGPL$ | - |
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 Digia. For licensing terms and | - |
14 | ** conditions see http://qt.digia.com/licensing. For further information | - |
15 | ** use the contact form at http://qt.digia.com/contact-us. | - |
16 | ** | - |
17 | ** GNU Lesser General Public License Usage | - |
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - |
19 | ** General Public License version 2.1 as published by the Free Software | - |
20 | ** Foundation and appearing in the file LICENSE.LGPL included in the | - |
21 | ** packaging of this file. Please review the following information to | - |
22 | ** ensure the GNU Lesser General Public License version 2.1 requirements | - |
23 | ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - |
24 | ** | - |
25 | ** In addition, as a special exception, Digia gives you certain additional | - |
26 | ** rights. These rights are described in the Digia Qt LGPL Exception | - |
27 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - |
28 | ** | - |
29 | ** GNU General Public License Usage | - |
30 | ** Alternatively, this file may be used under the terms of the GNU | - |
31 | ** General Public License version 3.0 as published by the Free Software | - |
32 | ** Foundation and appearing in the file LICENSE.GPL included in the | - |
33 | ** packaging of this file. Please review the following information to | - |
34 | ** ensure the GNU General Public License version 3.0 requirements will be | - |
35 | ** met: http://www.gnu.org/copyleft/gpl.html. | - |
36 | ** | - |
37 | ** | - |
38 | ** $QT_END_LICENSE$ | - |
39 | ** | - |
40 | ****************************************************************************/ | - |
41 | | - |
42 | #include "qcolordialog.h" | - |
43 | #include "qfontdialog.h" | - |
44 | #include "qfiledialog.h" | - |
45 | | - |
46 | #include "qevent.h" | - |
47 | #include "qdesktopwidget.h" | - |
48 | #include "qpushbutton.h" | - |
49 | #include "qapplication.h" | - |
50 | #include "qlayout.h" | - |
51 | #include "qsizegrip.h" | - |
52 | #include "qwhatsthis.h" | - |
53 | #include "qmenu.h" | - |
54 | #include "qcursor.h" | - |
55 | #include <qpa/qplatformtheme.h> | - |
56 | #include "private/qdialog_p.h" | - |
57 | #include "private/qguiapplication_p.h" | - |
58 | #ifndef QT_NO_ACCESSIBILITY | - |
59 | #include "qaccessible.h" | - |
60 | #endif | - |
61 | | - |
62 | QT_BEGIN_NAMESPACE | - |
63 | | - |
64 | static inline int themeDialogType(const QDialog *dialog) | - |
65 | { | - |
66 | #ifndef QT_NO_FILEDIALOG | - |
67 | if (qobject_cast<const QFileDialog *>(dialog)) | - |
68 | return QPlatformTheme::FileDialog; | - |
69 | #endif | - |
70 | #ifndef QT_NO_COLORDIALOG | - |
71 | if (qobject_cast<const QColorDialog *>(dialog)) | - |
72 | return QPlatformTheme::ColorDialog; | - |
73 | #endif | - |
74 | #ifndef QT_NO_FONTDIALOG | - |
75 | if (qobject_cast<const QFontDialog *>(dialog)) | - |
76 | return QPlatformTheme::FontDialog; | - |
77 | #endif | - |
78 | return -1; | - |
79 | } | - |
80 | | - |
81 | QPlatformDialogHelper *QDialogPrivate::platformHelper() const | - |
82 | { | - |
83 | // Delayed creation of the platform, ensuring that | - |
84 | // that qobject_cast<> on the dialog works in the plugin. | - |
85 | if (!m_platformHelperCreated) { | - |
86 | m_platformHelperCreated = true; | - |
87 | QDialogPrivate *ncThis = const_cast<QDialogPrivate *>(this); | - |
88 | QDialog *dialog = ncThis->q_func(); | - |
89 | const int type = themeDialogType(dialog); | - |
90 | if (type >= 0) { | - |
91 | m_platformHelper = QGuiApplicationPrivate::platformTheme() | - |
92 | ->createPlatformDialogHelper(static_cast<QPlatformTheme::DialogType>(type)); | - |
93 | if (m_platformHelper) { | - |
94 | QObject::connect(m_platformHelper, SIGNAL(accept()), dialog, SLOT(accept())); | - |
95 | QObject::connect(m_platformHelper, SIGNAL(reject()), dialog, SLOT(reject())); | - |
96 | ncThis->initHelper(m_platformHelper); | - |
97 | } | - |
98 | } | - |
99 | } | - |
100 | return m_platformHelper; | - |
101 | } | - |
102 | | - |
103 | QWindow *QDialogPrivate::parentWindow() const | - |
104 | { | - |
105 | if (const QWidget *parent = q_func()->nativeParentWidget()) | - |
106 | return parent->windowHandle(); | - |
107 | return 0; | - |
108 | } | - |
109 | | - |
110 | bool QDialogPrivate::setNativeDialogVisible(bool visible) | - |
111 | { | - |
112 | if (QPlatformDialogHelper *helper = platformHelper()) { | - |
113 | if (visible) { | - |
114 | Q_Q(QDialog); | - |
115 | helperPrepareShow(helper); | - |
116 | nativeDialogInUse = helper->show(q->windowFlags(), q->windowModality(), parentWindow()); | - |
117 | } else { | - |
118 | helper->hide(); | - |
119 | } | - |
120 | } | - |
121 | return nativeDialogInUse; | - |
122 | } | - |
123 | | - |
124 | QVariant QDialogPrivate::styleHint(QPlatformDialogHelper::StyleHint hint) const | - |
125 | { | - |
126 | if (const QPlatformDialogHelper *helper = platformHelper()) | - |
127 | return helper->styleHint(hint); | - |
128 | return QPlatformDialogHelper::defaultStyleHint(hint); | - |
129 | } | - |
130 | | - |
131 | void QDialogPrivate::deletePlatformHelper() | - |
132 | { | - |
133 | delete m_platformHelper; | - |
134 | m_platformHelper = 0; | - |
135 | m_platformHelperCreated = false; | - |
136 | nativeDialogInUse = false; | - |
137 | } | - |
138 | | - |
139 | /*! | - |
140 | \class QDialog | - |
141 | \brief The QDialog class is the base class of dialog windows. | - |
142 | | - |
143 | \ingroup dialog-classes | - |
144 | \ingroup abstractwidgets | - |
145 | \inmodule QtWidgets | - |
146 | | - |
147 | A dialog window is a top-level window mostly used for short-term | - |
148 | tasks and brief communications with the user. QDialogs may be | - |
149 | modal or modeless. QDialogs can | - |
150 | provide a \l{#return}{return value}, and they can have \l{#default}{default buttons}. QDialogs can also have a QSizeGrip in their | - |
151 | lower-right corner, using setSizeGripEnabled(). | - |
152 | | - |
153 | Note that QDialog (an any other widget that has type Qt::Dialog) uses | - |
154 | the parent widget slightly differently from other classes in Qt. A | - |
155 | dialog is always a top-level widget, but if it has a parent, its | - |
156 | default location is centered on top of the parent's top-level widget | - |
157 | (if it is not top-level itself). It will also share the parent's | - |
158 | taskbar entry. | - |
159 | | - |
160 | Use the overload of the QWidget::setParent() function to change | - |
161 | the ownership of a QDialog widget. This function allows you to | - |
162 | explicitly set the window flags of the reparented widget; using | - |
163 | the overloaded function will clear the window flags specifying the | - |
164 | window-system properties for the widget (in particular it will | - |
165 | reset the Qt::Dialog flag). | - |
166 | | - |
167 | \section1 Modal Dialogs | - |
168 | | - |
169 | A \b{modal} dialog is a dialog that blocks input to other | - |
170 | visible windows in the same application. Dialogs that are used to | - |
171 | request a file name from the user or that are used to set | - |
172 | application preferences are usually modal. Dialogs can be | - |
173 | \l{Qt::ApplicationModal}{application modal} (the default) or | - |
174 | \l{Qt::WindowModal}{window modal}. | - |
175 | | - |
176 | When an application modal dialog is opened, the user must finish | - |
177 | interacting with the dialog and close it before they can access | - |
178 | any other window in the application. Window modal dialogs only | - |
179 | block access to the window associated with the dialog, allowing | - |
180 | the user to continue to use other windows in an application. | - |
181 | | - |
182 | The most common way to display a modal dialog is to call its | - |
183 | exec() function. When the user closes the dialog, exec() will | - |
184 | provide a useful \l{#return}{return value}. Typically, | - |
185 | to get the dialog to close and return the appropriate value, we | - |
186 | connect a default button, e.g. \uicontrol OK, to the accept() slot and a | - |
187 | \uicontrol Cancel button to the reject() slot. | - |
188 | Alternatively you can call the done() slot with \c Accepted or | - |
189 | \c Rejected. | - |
190 | | - |
191 | An alternative is to call setModal(true) or setWindowModality(), | - |
192 | then show(). Unlike exec(), show() returns control to the caller | - |
193 | immediately. Calling setModal(true) is especially useful for | - |
194 | progress dialogs, where the user must have the ability to interact | - |
195 | with the dialog, e.g. to cancel a long running operation. If you | - |
196 | use show() and setModal(true) together to perform a long operation, | - |
197 | you must call QApplication::processEvents() periodically during | - |
198 | processing to enable the user to interact with the dialog. (See | - |
199 | QProgressDialog.) | - |
200 | | - |
201 | \section1 Modeless Dialogs | - |
202 | | - |
203 | A \b{modeless} dialog is a dialog that operates | - |
204 | independently of other windows in the same application. Find and | - |
205 | replace dialogs in word-processors are often modeless to allow the | - |
206 | user to interact with both the application's main window and with | - |
207 | the dialog. | - |
208 | | - |
209 | Modeless dialogs are displayed using show(), which returns control | - |
210 | to the caller immediately. | - |
211 | | - |
212 | If you invoke the \l{QWidget::show()}{show()} function after hiding | - |
213 | a dialog, the dialog will be displayed in its original position. This is | - |
214 | because the window manager decides the position for windows that | - |
215 | have not been explicitly placed by the programmer. To preserve the | - |
216 | position of a dialog that has been moved by the user, save its position | - |
217 | in your \l{QWidget::closeEvent()}{closeEvent()} handler and then | - |
218 | move the dialog to that position, before showing it again. | - |
219 | | - |
220 | \target default | - |
221 | \section1 Default Button | - |
222 | | - |
223 | A dialog's \e default button is the button that's pressed when the | - |
224 | user presses Enter (Return). This button is used to signify that | - |
225 | the user accepts the dialog's settings and wants to close the | - |
226 | dialog. Use QPushButton::setDefault(), QPushButton::isDefault() | - |
227 | and QPushButton::autoDefault() to set and control the dialog's | - |
228 | default button. | - |
229 | | - |
230 | \target escapekey | - |
231 | \section1 Escape Key | - |
232 | | - |
233 | If the user presses the Esc key in a dialog, QDialog::reject() | - |
234 | will be called. This will cause the window to close: The \l{QCloseEvent}{close event} cannot be \l{QCloseEvent::ignore()}{ignored}. | - |
235 | | - |
236 | \section1 Extensibility | - |
237 | | - |
238 | Extensibility is the ability to show the dialog in two ways: a | - |
239 | partial dialog that shows the most commonly used options, and a | - |
240 | full dialog that shows all the options. Typically an extensible | - |
241 | dialog will initially appear as a partial dialog, but with a | - |
242 | \uicontrol More toggle button. If the user presses the \uicontrol More button down, | - |
243 | the dialog is expanded. The \l{Extension Example} shows how to achieve | - |
244 | extensible dialogs using Qt. | - |
245 | | - |
246 | \target return | - |
247 | \section1 Return Value (Modal Dialogs) | - |
248 | | - |
249 | Modal dialogs are often used in situations where a return value is | - |
250 | required, e.g. to indicate whether the user pressed \uicontrol OK or | - |
251 | \uicontrol Cancel. A dialog can be closed by calling the accept() or the | - |
252 | reject() slots, and exec() will return \c Accepted or \c Rejected | - |
253 | as appropriate. The exec() call returns the result of the dialog. | - |
254 | The result is also available from result() if the dialog has not | - |
255 | been destroyed. | - |
256 | | - |
257 | In order to modify your dialog's close behavior, you can reimplement | - |
258 | the functions accept(), reject() or done(). The | - |
259 | \l{QWidget::closeEvent()}{closeEvent()} function should only be | - |
260 | reimplemented to preserve the dialog's position or to override the | - |
261 | standard close or reject behavior. | - |
262 | | - |
263 | \target examples | - |
264 | \section1 Code Examples | - |
265 | | - |
266 | A modal dialog: | - |
267 | | - |
268 | \snippet dialogs/dialogs.cpp 1 | - |
269 | | - |
270 | A modeless dialog: | - |
271 | | - |
272 | \snippet dialogs/dialogs.cpp 0 | - |
273 | | - |
274 | \sa QDialogButtonBox, QTabWidget, QWidget, QProgressDialog, | - |
275 | {fowler}{GUI Design Handbook: Dialogs, Standard}, {Extension Example}, | - |
276 | {Standard Dialogs Example} | - |
277 | */ | - |
278 | | - |
279 | /*! \enum QDialog::DialogCode | - |
280 | | - |
281 | The value returned by a modal dialog. | - |
282 | | - |
283 | \value Accepted | - |
284 | \value Rejected | - |
285 | */ | - |
286 | | - |
287 | /*! | - |
288 | \property QDialog::sizeGripEnabled | - |
289 | \brief whether the size grip is enabled | - |
290 | | - |
291 | A QSizeGrip is placed in the bottom-right corner of the dialog when this | - |
292 | property is enabled. By default, the size grip is disabled. | - |
293 | */ | - |
294 | | - |
295 | | - |
296 | /*! | - |
297 | Constructs a dialog with parent \a parent. | - |
298 | | - |
299 | A dialog is always a top-level widget, but if it has a parent, its | - |
300 | default location is centered on top of the parent. It will also | - |
301 | share the parent's taskbar entry. | - |
302 | | - |
303 | The widget flags \a f are passed on to the QWidget constructor. | - |
304 | If, for example, you don't want a What's This button in the title bar | - |
305 | of the dialog, pass Qt::WindowTitleHint | Qt::WindowSystemMenuHint in \a f. | - |
306 | | - |
307 | \sa QWidget::setWindowFlags() | - |
308 | */ | - |
309 | | - |
310 | QDialog::QDialog(QWidget *parent, Qt::WindowFlags f) | - |
311 | : QWidget(*new QDialogPrivate, parent, | - |
312 | f | ((f & Qt::WindowType_Mask) == 0 ? Qt::Dialog : Qt::WindowType(0))) | - |
313 | { | - |
314 | } | - |
315 | | - |
316 | /*! | - |
317 | \overload | - |
318 | \internal | - |
319 | */ | - |
320 | QDialog::QDialog(QDialogPrivate &dd, QWidget *parent, Qt::WindowFlags f) | - |
321 | : QWidget(dd, parent, f | ((f & Qt::WindowType_Mask) == 0 ? Qt::Dialog : Qt::WindowType(0))) | - |
322 | { | - |
323 | } | - |
324 | | - |
325 | /*! | - |
326 | Destroys the QDialog, deleting all its children. | - |
327 | */ | - |
328 | | - |
329 | QDialog::~QDialog() | - |
330 | { | - |
331 | QT_TRY { | - |
332 | // Need to hide() here, as our (to-be) overridden hide() | - |
333 | // will not be called in ~QWidget. | - |
334 | hide(); | - |
335 | } QT_CATCH(...) { | - |
336 | // we're in the destructor - just swallow the exception | - |
337 | } | - |
338 | } | - |
339 | | - |
340 | /*! | - |
341 | \internal | - |
342 | This function is called by the push button \a pushButton when it | - |
343 | becomes the default button. If \a pushButton is 0, the dialogs | - |
344 | default default button becomes the default button. This is what a | - |
345 | push button calls when it loses focus. | - |
346 | */ | - |
347 | void QDialogPrivate::setDefault(QPushButton *pushButton) | - |
348 | { | - |
349 | Q_Q(QDialog); | - |
350 | bool hasMain = false; | - |
351 | QList<QPushButton*> list = q->findChildren<QPushButton*>(); | - |
352 | for (int i=0; i<list.size(); ++i) { | - |
353 | QPushButton *pb = list.at(i); | - |
354 | if (pb->window() == q) { | - |
355 | if (pb == mainDef) | - |
356 | hasMain = true; | - |
357 | if (pb != pushButton) | - |
358 | pb->setDefault(false); | - |
359 | } | - |
360 | } | - |
361 | if (!pushButton && hasMain) | - |
362 | mainDef->setDefault(true); | - |
363 | if (!hasMain) | - |
364 | mainDef = pushButton; | - |
365 | } | - |
366 | | - |
367 | /*! | - |
368 | \internal | - |
369 | This function sets the default default push button to \a pushButton. | - |
370 | This function is called by QPushButton::setDefault(). | - |
371 | */ | - |
372 | void QDialogPrivate::setMainDefault(QPushButton *pushButton) | - |
373 | { | - |
374 | mainDef = 0; | - |
375 | setDefault(pushButton); | - |
376 | } | - |
377 | | - |
378 | /*! | - |
379 | \internal | - |
380 | Hides the default button indicator. Called when non auto-default | - |
381 | push button get focus. | - |
382 | */ | - |
383 | void QDialogPrivate::hideDefault() | - |
384 | { | - |
385 | Q_Q(QDialog); | - |
386 | QList<QPushButton*> list = q->findChildren<QPushButton*>(); | - |
387 | for (int i=0; i<list.size(); ++i) { | - |
388 | list.at(i)->setDefault(false); | - |
389 | } | - |
390 | } | - |
391 | | - |
392 | void QDialogPrivate::resetModalitySetByOpen() | - |
393 | { | - |
394 | Q_Q(QDialog); | - |
395 | if (resetModalityTo != -1 && !q->testAttribute(Qt::WA_SetWindowModality)) { | - |
396 | // open() changed the window modality and the user didn't touch it afterwards; restore it | - |
397 | q->setWindowModality(Qt::WindowModality(resetModalityTo)); | - |
398 | q->setAttribute(Qt::WA_SetWindowModality, wasModalitySet); | - |
399 | #ifdef Q_OS_MAC | - |
400 | Q_ASSERT(resetModalityTo != Qt::WindowModal); | - |
401 | q->setParent(q->parentWidget(), Qt::Dialog); | - |
402 | #endif | - |
403 | } | - |
404 | resetModalityTo = -1; | - |
405 | } | - |
406 | | - |
407 | #if defined(Q_OS_WINCE) | - |
408 | #ifdef Q_OS_WINCE_WM | - |
409 | void QDialogPrivate::_q_doneAction() | - |
410 | { | - |
411 | //Done... | - |
412 | QApplication::postEvent(q_func(), new QEvent(QEvent::OkRequest)); | - |
413 | } | - |
414 | #endif | - |
415 | | - |
416 | /*! | - |
417 | \reimp | - |
418 | */ | - |
419 | bool QDialog::event(QEvent *e) | - |
420 | { | - |
421 | bool result = QWidget::event(e); | - |
422 | #ifdef Q_OS_WINCE | - |
423 | if (e->type() == QEvent::OkRequest) { | - |
424 | accept(); | - |
425 | result = true; | - |
426 | } | - |
427 | #endif | - |
428 | return result; | - |
429 | } | - |
430 | #endif | - |
431 | | - |
432 | /*! | - |
433 | In general returns the modal dialog's result code, \c Accepted or | - |
434 | \c Rejected. | - |
435 | | - |
436 | \note When called on a QMessageBox instance, the returned value is a | - |
437 | value of the \l QMessageBox::StandardButton enum. | - |
438 | | - |
439 | Do not call this function if the dialog was constructed with the | - |
440 | Qt::WA_DeleteOnClose attribute. | - |
441 | */ | - |
442 | int QDialog::result() const | - |
443 | { | - |
444 | Q_D(const QDialog); | - |
445 | return d->rescode; | - |
446 | } | - |
447 | | - |
448 | /*! | - |
449 | \fn void QDialog::setResult(int i) | - |
450 | | - |
451 | Sets the modal dialog's result code to \a i. | - |
452 | | - |
453 | \note We recommend that you use one of the values defined by | - |
454 | QDialog::DialogCode. | - |
455 | */ | - |
456 | void QDialog::setResult(int r) | - |
457 | { | - |
458 | Q_D(QDialog); | - |
459 | d->rescode = r; | - |
460 | } | - |
461 | | - |
462 | /*! | - |
463 | \since 4.5 | - |
464 | | - |
465 | Shows the dialog as a \l{QDialog#Modal Dialogs}{window modal dialog}, | - |
466 | returning immediately. | - |
467 | | - |
468 | \sa exec(), show(), result(), setWindowModality() | - |
469 | */ | - |
470 | void QDialog::open() | - |
471 | { | - |
472 | Q_D(QDialog); | - |
473 | | - |
474 | Qt::WindowModality modality = windowModality(); | - |
475 | if (modality != Qt::WindowModal) { | - |
476 | d->resetModalityTo = modality; | - |
477 | d->wasModalitySet = testAttribute(Qt::WA_SetWindowModality); | - |
478 | setWindowModality(Qt::WindowModal); | - |
479 | setAttribute(Qt::WA_SetWindowModality, false); | - |
480 | #ifdef Q_OS_MAC | - |
481 | setParent(parentWidget(), Qt::Sheet); | - |
482 | #endif | - |
483 | } | - |
484 | | - |
485 | setResult(0); | - |
486 | show(); | - |
487 | } | - |
488 | | - |
489 | /*! | - |
490 | Shows the dialog as a \l{QDialog#Modal Dialogs}{modal dialog}, | - |
491 | blocking until the user closes it. The function returns a \l | - |
492 | DialogCode result. | - |
493 | | - |
494 | If the dialog is \l{Qt::ApplicationModal}{application modal}, users cannot | - |
495 | interact with any other window in the same application until they close | - |
496 | the dialog. If the dialog is \l{Qt::ApplicationModal}{window modal}, only | - |
497 | interaction with the parent window is blocked while the dialog is open. | - |
498 | By default, the dialog is application modal. | - |
499 | | - |
500 | \sa open(), show(), result(), setWindowModality() | - |
501 | */ | - |
502 | | - |
503 | int QDialog::exec() | - |
504 | { | - |
505 | Q_D(QDialog); | - |
506 | | - |
507 | if (d->eventLoop) { | - |
508 | qWarning("QDialog::exec: Recursive call detected"); | - |
509 | return -1; | - |
510 | } | - |
511 | | - |
512 | bool deleteOnClose = testAttribute(Qt::WA_DeleteOnClose); | - |
513 | setAttribute(Qt::WA_DeleteOnClose, false); | - |
514 | | - |
515 | d->resetModalitySetByOpen(); | - |
516 | | - |
517 | bool wasShowModal = testAttribute(Qt::WA_ShowModal); | - |
518 | setAttribute(Qt::WA_ShowModal, true); | - |
519 | setResult(0); | - |
520 | | - |
521 | show(); | - |
522 | | - |
523 | QPointer<QDialog> guard = this; | - |
524 | if (d->nativeDialogInUse) { | - |
525 | d->platformHelper()->exec(); | - |
526 | } else { | - |
527 | QEventLoop eventLoop; | - |
528 | d->eventLoop = &eventLoop; | - |
529 | (void) eventLoop.exec(QEventLoop::DialogExec); | - |
530 | } | - |
531 | if (guard.isNull()) | - |
532 | return QDialog::Rejected; | - |
533 | d->eventLoop = 0; | - |
534 | | - |
535 | setAttribute(Qt::WA_ShowModal, wasShowModal); | - |
536 | | - |
537 | int res = result(); | - |
538 | if (d->nativeDialogInUse) | - |
539 | d->helperDone(static_cast<QDialog::DialogCode>(res), d->platformHelper()); | - |
540 | if (deleteOnClose) | - |
541 | delete this; | - |
542 | return res; | - |
543 | } | - |
544 | | - |
545 | /*! | - |
546 | Closes the dialog and sets its result code to \a r. If this dialog | - |
547 | is shown with exec(), done() causes the local event loop to finish, | - |
548 | and exec() to return \a r. | - |
549 | | - |
550 | As with QWidget::close(), done() deletes the dialog if the | - |
551 | Qt::WA_DeleteOnClose flag is set. If the dialog is the application's | - |
552 | main widget, the application terminates. If the dialog is the | - |
553 | last window closed, the QApplication::lastWindowClosed() signal is | - |
554 | emitted. | - |
555 | | - |
556 | \sa accept(), reject(), QApplication::activeWindow(), QApplication::quit() | - |
557 | */ | - |
558 | | - |
559 | void QDialog::done(int r) | - |
560 | { | - |
561 | Q_D(QDialog); | - |
562 | hide(); | - |
563 | setResult(r); | - |
564 | | - |
565 | d->close_helper(QWidgetPrivate::CloseNoEvent); | - |
566 | d->resetModalitySetByOpen(); | - |
567 | | - |
568 | emit finished(r); | - |
569 | if (r == Accepted) | - |
570 | emit accepted(); | - |
571 | else if (r == Rejected) | - |
572 | emit rejected(); | - |
573 | } | - |
574 | | - |
575 | /*! | - |
576 | Hides the modal dialog and sets the result code to \c Accepted. | - |
577 | | - |
578 | \sa reject(), done() | - |
579 | */ | - |
580 | | - |
581 | void QDialog::accept() | - |
582 | { | - |
583 | done(Accepted); | - |
584 | } | - |
585 | | - |
586 | /*! | - |
587 | Hides the modal dialog and sets the result code to \c Rejected. | - |
588 | | - |
589 | \sa accept(), done() | - |
590 | */ | - |
591 | | - |
592 | void QDialog::reject() | - |
593 | { | - |
594 | done(Rejected); | - |
595 | } | - |
596 | | - |
597 | /*! \reimp */ | - |
598 | bool QDialog::eventFilter(QObject *o, QEvent *e) | - |
599 | { | - |
600 | return QWidget::eventFilter(o, e); | - |
601 | } | - |
602 | | - |
603 | /***************************************************************************** | - |
604 | Event handlers | - |
605 | *****************************************************************************/ | - |
606 | | - |
607 | #ifndef QT_NO_CONTEXTMENU | - |
608 | /*! \reimp */ | - |
609 | void QDialog::contextMenuEvent(QContextMenuEvent *e) | - |
610 | { | - |
611 | #if defined(QT_NO_WHATSTHIS) || defined(QT_NO_MENU) | - |
612 | Q_UNUSED(e); | - |
613 | #else | - |
614 | QWidget *w = childAt(e->pos()); | - |
615 | if (!w) { | - |
616 | w = rect().contains(e->pos()) ? this : 0; | - |
617 | if (!w) | - |
618 | return; | - |
619 | } | - |
620 | while (w && w->whatsThis().size() == 0 && !w->testAttribute(Qt::WA_CustomWhatsThis)) | - |
621 | w = w->isWindow() ? 0 : w->parentWidget(); | - |
622 | if (w) { | - |
623 | QPointer<QMenu> p = new QMenu(this); | - |
624 | QAction *wt = p.data()->addAction(tr("What's This?")); | - |
625 | if (p.data()->exec(e->globalPos()) == wt) { | - |
626 | QHelpEvent e(QEvent::WhatsThis, w->rect().center(), | - |
627 | w->mapToGlobal(w->rect().center())); | - |
628 | QApplication::sendEvent(w, &e); | - |
629 | } | - |
630 | delete p.data(); | - |
631 | } | - |
632 | #endif | - |
633 | } | - |
634 | #endif // QT_NO_CONTEXTMENU | - |
635 | | - |
636 | /*! \reimp */ | - |
637 | void QDialog::keyPressEvent(QKeyEvent *e) | - |
638 | { | - |
639 | // Calls reject() if Escape is pressed. Simulates a button | - |
640 | // click for the default button if Enter is pressed. Move focus | - |
641 | // for the arrow keys. Ignore the rest. | - |
642 | #ifdef Q_OS_MAC | - |
643 | if(e->modifiers() == Qt::ControlModifier && e->key() == Qt::Key_Period) { | - |
644 | reject(); | - |
645 | } else | - |
646 | #endif | - |
647 | if (!e->modifiers() || (e->modifiers() & Qt::KeypadModifier && e->key() == Qt::Key_Enter)) { | - |
648 | switch (e->key()) { | - |
649 | case Qt::Key_Enter: | - |
650 | case Qt::Key_Return: { | - |
651 | QList<QPushButton*> list = findChildren<QPushButton*>(); | - |
652 | for (int i=0; i<list.size(); ++i) { | - |
653 | QPushButton *pb = list.at(i); | - |
654 | if (pb->isDefault() && pb->isVisible()) { | - |
655 | if (pb->isEnabled()) | - |
656 | pb->click(); | - |
657 | return; | - |
658 | } | - |
659 | } | - |
660 | } | - |
661 | break; | - |
662 | case Qt::Key_Escape: | - |
663 | reject(); | - |
664 | break; | - |
665 | default: | - |
666 | e->ignore(); | - |
667 | return; | - |
668 | } | - |
669 | } else { | - |
670 | e->ignore(); | - |
671 | } | - |
672 | } | - |
673 | | - |
674 | /*! \reimp */ | - |
675 | void QDialog::closeEvent(QCloseEvent *e) | - |
676 | { | - |
677 | #ifndef QT_NO_WHATSTHIS | - |
678 | if (isModal() && QWhatsThis::inWhatsThisMode()) | - |
679 | QWhatsThis::leaveWhatsThisMode(); | - |
680 | #endif | - |
681 | if (isVisible()) { | - |
682 | QPointer<QObject> that = this; | - |
683 | reject(); | - |
684 | if (that && isVisible()) | - |
685 | e->ignore(); | - |
686 | } else { | - |
687 | e->accept(); | - |
688 | } | - |
689 | } | - |
690 | | - |
691 | /***************************************************************************** | - |
692 | Geometry management. | - |
693 | *****************************************************************************/ | - |
694 | | - |
695 | /*! \reimp | - |
696 | */ | - |
697 | | - |
698 | void QDialog::setVisible(bool visible) | - |
699 | { | - |
700 | Q_D(QDialog); | - |
701 | if (visible) { | - |
702 | if (testAttribute(Qt::WA_WState_ExplicitShowHide) && !testAttribute(Qt::WA_WState_Hidden)) | - |
703 | return; | - |
704 | | - |
705 | if (!testAttribute(Qt::WA_Moved)) { | - |
706 | Qt::WindowStates state = windowState(); | - |
707 | adjustPosition(parentWidget()); | - |
708 | setAttribute(Qt::WA_Moved, false); // not really an explicit position | - |
709 | if (state != windowState()) | - |
710 | setWindowState(state); | - |
711 | } | - |
712 | QWidget::setVisible(visible); | - |
713 | showExtension(d->doShowExtension); | - |
714 | QWidget *fw = window()->focusWidget(); | - |
715 | if (!fw) | - |
716 | fw = this; | - |
717 | | - |
718 | /* | - |
719 | The following block is to handle a special case, and does not | - |
720 | really follow propper logic in concern of autoDefault and TAB | - |
721 | order. However, it's here to ease usage for the users. If a | - |
722 | dialog has a default QPushButton, and first widget in the TAB | - |
723 | order also is a QPushButton, then we give focus to the main | - |
724 | default QPushButton. This simplifies code for the developers, | - |
725 | and actually catches most cases... If not, then they simply | - |
726 | have to use [widget*]->setFocus() themselves... | - |
727 | */ | - |
728 | if (d->mainDef && fw->focusPolicy() == Qt::NoFocus) { | - |
729 | QWidget *first = fw; | - |
730 | while ((first = first->nextInFocusChain()) != fw && first->focusPolicy() == Qt::NoFocus) | - |
731 | ; | - |
732 | if (first != d->mainDef && qobject_cast<QPushButton*>(first)) | - |
733 | d->mainDef->setFocus(); | - |
734 | } | - |
735 | if (!d->mainDef && isWindow()) { | - |
736 | QWidget *w = fw; | - |
737 | while ((w = w->nextInFocusChain()) != fw) { | - |
738 | QPushButton *pb = qobject_cast<QPushButton *>(w); | - |
739 | if (pb && pb->autoDefault() && pb->focusPolicy() != Qt::NoFocus) { | - |
740 | pb->setDefault(true); | - |
741 | break; | - |
742 | } | - |
743 | } | - |
744 | } | - |
745 | if (fw && !fw->hasFocus()) { | - |
746 | QFocusEvent e(QEvent::FocusIn, Qt::TabFocusReason); | - |
747 | QApplication::sendEvent(fw, &e); | - |
748 | } | - |
749 | | - |
750 | #ifndef QT_NO_ACCESSIBILITY | - |
751 | QAccessibleEvent event(this, QAccessible::DialogStart); | - |
752 | QAccessible::updateAccessibility(&event); | - |
753 | #endif | - |
754 | | - |
755 | } else { | - |
756 | if (testAttribute(Qt::WA_WState_ExplicitShowHide) && testAttribute(Qt::WA_WState_Hidden)) | - |
757 | return; | - |
758 | | - |
759 | #ifndef QT_NO_ACCESSIBILITY | - |
760 | if (isVisible()) { | - |
761 | QAccessibleEvent event(this, QAccessible::DialogEnd); | - |
762 | QAccessible::updateAccessibility(&event); | - |
763 | } | - |
764 | #endif | - |
765 | | - |
766 | // Reimplemented to exit a modal event loop when the dialog is hidden. | - |
767 | QWidget::setVisible(visible); | - |
768 | if (d->eventLoop) | - |
769 | d->eventLoop->exit(); | - |
770 | } | - |
771 | if (d->mainDef && isActiveWindow() | - |
772 | && d->styleHint(QPlatformDialogHelper::SnapToDefaultButton).toBool()) | - |
773 | QCursor::setPos(d->mainDef->mapToGlobal(d->mainDef->rect().center())); | - |
774 | } | - |
775 | | - |
776 | /*!\reimp */ | - |
777 | void QDialog::showEvent(QShowEvent *event) | - |
778 | { | - |
779 | if (!event->spontaneous() && !testAttribute(Qt::WA_Moved)) { | - |
780 | Qt::WindowStates state = windowState(); | - |
781 | adjustPosition(parentWidget()); | - |
782 | setAttribute(Qt::WA_Moved, false); // not really an explicit position | - |
783 | if (state != windowState()) | - |
784 | setWindowState(state); | - |
785 | } | - |
786 | } | - |
787 | | - |
788 | /*! \internal */ | - |
789 | void QDialog::adjustPosition(QWidget* w) | - |
790 | { | - |
791 | | - |
792 | if (const QPlatformTheme *theme = QGuiApplicationPrivate::platformTheme()) partially evaluated: const QPlatformTheme *theme = QGuiApplicationPrivate::platformTheme() yes Evaluation Count:458 | no Evaluation Count:0 |
| 0-458 |
793 | if (theme->themeHint(QPlatformTheme::WindowAutoPlacement).toBool()) partially evaluated: theme->themeHint(QPlatformTheme::WindowAutoPlacement).toBool() no Evaluation Count:0 | yes Evaluation Count:458 |
| 0-458 |
794 | return; | 0 |
795 | QPoint p(0, 0); executed (the execution status of this line is deduced): QPoint p(0, 0); | - |
796 | int extraw = 0, extrah = 0, scrn = 0; executed (the execution status of this line is deduced): int extraw = 0, extrah = 0, scrn = 0; | - |
797 | if (w) evaluated: w yes Evaluation Count:78 | yes Evaluation Count:380 |
| 78-380 |
798 | w = w->window(); executed: w = w->window(); Execution Count:78 | 78 |
799 | QRect desk; executed (the execution status of this line is deduced): QRect desk; | - |
800 | if (w) { evaluated: w yes Evaluation Count:78 | yes Evaluation Count:380 |
| 78-380 |
801 | scrn = QApplication::desktop()->screenNumber(w); executed (the execution status of this line is deduced): scrn = QApplication::desktop()->screenNumber(w); | - |
802 | } else if (QApplication::desktop()->isVirtualDesktop()) { executed: } Execution Count:78 partially evaluated: QApplication::desktop()->isVirtualDesktop() no Evaluation Count:0 | yes Evaluation Count:380 |
| 0-380 |
803 | scrn = QApplication::desktop()->screenNumber(QCursor::pos()); never executed (the execution status of this line is deduced): scrn = QApplication::desktop()->screenNumber(QCursor::pos()); | - |
804 | } else { | 0 |
805 | scrn = QApplication::desktop()->screenNumber(this); executed (the execution status of this line is deduced): scrn = QApplication::desktop()->screenNumber(this); | - |
806 | } executed: } Execution Count:380 | 380 |
807 | desk = QApplication::desktop()->availableGeometry(scrn); executed (the execution status of this line is deduced): desk = QApplication::desktop()->availableGeometry(scrn); | - |
808 | | - |
809 | QWidgetList list = QApplication::topLevelWidgets(); executed (the execution status of this line is deduced): QWidgetList list = QApplication::topLevelWidgets(); | - |
810 | for (int i = 0; (extraw == 0 || extrah == 0) && i < list.size(); ++i) { evaluated: extraw == 0 yes Evaluation Count:1133 | yes Evaluation Count:60 |
partially evaluated: extrah == 0 no Evaluation Count:0 | yes Evaluation Count:60 |
evaluated: i < list.size() yes Evaluation Count:735 | yes Evaluation Count:398 |
| 0-1133 |
811 | QWidget * current = list.at(i); executed (the execution status of this line is deduced): QWidget * current = list.at(i); | - |
812 | if (current->isVisible()) { evaluated: current->isVisible() yes Evaluation Count:292 | yes Evaluation Count:443 |
| 292-443 |
813 | int framew = current->geometry().x() - current->x(); executed (the execution status of this line is deduced): int framew = current->geometry().x() - current->x(); | - |
814 | int frameh = current->geometry().y() - current->y(); executed (the execution status of this line is deduced): int frameh = current->geometry().y() - current->y(); | - |
815 | | - |
816 | extraw = qMax(extraw, framew); executed (the execution status of this line is deduced): extraw = qMax(extraw, framew); | - |
817 | extrah = qMax(extrah, frameh); executed (the execution status of this line is deduced): extrah = qMax(extrah, frameh); | - |
818 | } executed: } Execution Count:292 | 292 |
819 | } executed: } Execution Count:735 | 735 |
820 | | - |
821 | // sanity check for decoration frames. With embedding, we | - |
822 | // might get extraordinary values | - |
823 | if (extraw == 0 || extrah == 0 || extraw >= 10 || extrah >= 40) { evaluated: extraw == 0 yes Evaluation Count:398 | yes Evaluation Count:60 |
partially evaluated: extrah == 0 no Evaluation Count:0 | yes Evaluation Count:60 |
partially evaluated: extraw >= 10 no Evaluation Count:0 | yes Evaluation Count:60 |
partially evaluated: extrah >= 40 no Evaluation Count:0 | yes Evaluation Count:60 |
| 0-398 |
824 | extrah = 40; executed (the execution status of this line is deduced): extrah = 40; | - |
825 | extraw = 10; executed (the execution status of this line is deduced): extraw = 10; | - |
826 | } executed: } Execution Count:398 | 398 |
827 | | - |
828 | | - |
829 | if (w) { evaluated: w yes Evaluation Count:78 | yes Evaluation Count:380 |
| 78-380 |
830 | // Use mapToGlobal rather than geometry() in case w might | - |
| // be embedded in another application | |
| / Use pos() if the widget is embedded into a native window | |
831 | QPoint pp; executed (the execution status of this line is deduced): QPoint pp; | - |
832 | if (w->windowHandle() && w->windowHandle()->property("_q_embedded_native_parent_handle").value<WId>()) evaluated: w->windowHandle() yes Evaluation Count:46 | yes Evaluation Count:32 |
partially evaluated: w->windowHandle()->property("_q_embedded_native_parent_handle").value<WId>() no Evaluation Count:0 | yes Evaluation Count:46 |
| 0-46 |
833 | pp = w->pos(); never executed: pp = w->pos(); | 0 |
834 | else | - |
835 | pp = w->mapToGlobal(QPoint(0,0)); executed: pp = w->mapToGlobal(QPoint(0,0)); Execution Count:78 | 78 |
836 | p = QPoint(pp.x() + w->width()/2, executed (the execution status of this line is deduced): p = QPoint(pp.x() + w->width()/2, | - |
837 | pp.y() + w->height()/ 2); executed (the execution status of this line is deduced): pp.y() + w->height()/ 2); | - |
838 | } else { executed: } Execution Count:78 | 78 |
839 | // p = middle of the desktop | - |
840 | p = QPoint(desk.x() + desk.width()/2, desk.y() + desk.height()/2); executed (the execution status of this line is deduced): p = QPoint(desk.x() + desk.width()/2, desk.y() + desk.height()/2); | - |
841 | } executed: } Execution Count:380 | 380 |
842 | | - |
843 | // p = origin of this | - |
844 | p = QPoint(p.x()-width()/2 - extraw, executed (the execution status of this line is deduced): p = QPoint(p.x()-width()/2 - extraw, | - |
845 | p.y()-height()/2 - extrah); executed (the execution status of this line is deduced): p.y()-height()/2 - extrah); | - |
846 | | - |
847 | | - |
848 | if (p.x() + extraw + width() > desk.x() + desk.width()) evaluated: p.x() + extraw + width() > desk.x() + desk.width() yes Evaluation Count:12 | yes Evaluation Count:446 |
| 12-446 |
849 | p.setX(desk.x() + desk.width() - width() - extraw); executed: p.setX(desk.x() + desk.width() - width() - extraw); Execution Count:12 | 12 |
850 | if (p.x() < desk.x()) evaluated: p.x() < desk.x() yes Evaluation Count:12 | yes Evaluation Count:446 |
| 12-446 |
851 | p.setX(desk.x()); executed: p.setX(desk.x()); Execution Count:12 | 12 |
852 | | - |
853 | if (p.y() + extrah + height() > desk.y() + desk.height()) evaluated: p.y() + extrah + height() > desk.y() + desk.height() yes Evaluation Count:12 | yes Evaluation Count:446 |
| 12-446 |
854 | p.setY(desk.y() + desk.height() - height() - extrah); executed: p.setY(desk.y() + desk.height() - height() - extrah); Execution Count:12 | 12 |
855 | if (p.y() < desk.y()) evaluated: p.y() < desk.y() yes Evaluation Count:12 | yes Evaluation Count:446 |
| 12-446 |
856 | p.setY(desk.y()); executed: p.setY(desk.y()); Execution Count:12 | 12 |
857 | | - |
858 | move(p); executed (the execution status of this line is deduced): move(p); | - |
859 | } executed: } Execution Count:458 | 458 |
860 | | - |
861 | /*! | - |
862 | \obsolete | - |
863 | | - |
864 | If \a orientation is Qt::Horizontal, the extension will be displayed | - |
865 | to the right of the dialog's main area. If \a orientation is | - |
866 | Qt::Vertical, the extension will be displayed below the dialog's main | - |
867 | area. | - |
868 | | - |
869 | Instead of using this functionality, we recommend that you simply call | - |
870 | show() or hide() on the part of the dialog that you want to use as an | - |
871 | extension. See the \l{Extension Example} for details. | - |
872 | | - |
873 | \sa setExtension() | - |
874 | */ | - |
875 | void QDialog::setOrientation(Qt::Orientation orientation) | - |
876 | { | - |
877 | Q_D(QDialog); | - |
878 | d->orientation = orientation; | - |
879 | } | - |
880 | | - |
881 | /*! | - |
882 | \obsolete | - |
883 | | - |
884 | Returns the dialog's extension orientation. | - |
885 | | - |
886 | Instead of using this functionality, we recommend that you simply call | - |
887 | show() or hide() on the part of the dialog that you want to use as an | - |
888 | extension. See the \l{Extension Example} for details. | - |
889 | | - |
890 | \sa extension() | - |
891 | */ | - |
892 | Qt::Orientation QDialog::orientation() const | - |
893 | { | - |
894 | Q_D(const QDialog); | - |
895 | return d->orientation; | - |
896 | } | - |
897 | | - |
898 | /*! | - |
899 | \obsolete | - |
900 | | - |
901 | Sets the widget, \a extension, to be the dialog's extension, | - |
902 | deleting any previous extension. The dialog takes ownership of the | - |
903 | extension. Note that if 0 is passed any existing extension will be | - |
904 | deleted. This function must only be called while the dialog is hidden. | - |
905 | | - |
906 | Instead of using this functionality, we recommend that you simply call | - |
907 | show() or hide() on the part of the dialog that you want to use as an | - |
908 | extension. See the \l{Extension Example} for details. | - |
909 | | - |
910 | \sa showExtension(), setOrientation() | - |
911 | */ | - |
912 | void QDialog::setExtension(QWidget* extension) | - |
913 | { | - |
914 | Q_D(QDialog); | - |
915 | delete d->extension; | - |
916 | d->extension = extension; | - |
917 | | - |
918 | if (!extension) | - |
919 | return; | - |
920 | | - |
921 | if (extension->parentWidget() != this) | - |
922 | extension->setParent(this); | - |
923 | extension->hide(); | - |
924 | } | - |
925 | | - |
926 | /*! | - |
927 | \obsolete | - |
928 | | - |
929 | Returns the dialog's extension or 0 if no extension has been | - |
930 | defined. | - |
931 | | - |
932 | Instead of using this functionality, we recommend that you simply call | - |
933 | show() or hide() on the part of the dialog that you want to use as an | - |
934 | extension. See the \l{Extension Example} for details. | - |
935 | | - |
936 | \sa showExtension(), setOrientation() | - |
937 | */ | - |
938 | QWidget* QDialog::extension() const | - |
939 | { | - |
940 | Q_D(const QDialog); | - |
941 | return d->extension; | - |
942 | } | - |
943 | | - |
944 | | - |
945 | /*! | - |
946 | \obsolete | - |
947 | | - |
948 | If \a showIt is true, the dialog's extension is shown; otherwise the | - |
949 | extension is hidden. | - |
950 | | - |
951 | Instead of using this functionality, we recommend that you simply call | - |
952 | show() or hide() on the part of the dialog that you want to use as an | - |
953 | extension. See the \l{Extension Example} for details. | - |
954 | | - |
955 | \sa show(), setExtension(), setOrientation() | - |
956 | */ | - |
957 | void QDialog::showExtension(bool showIt) | - |
958 | { | - |
959 | Q_D(QDialog); | - |
960 | d->doShowExtension = showIt; | - |
961 | if (!d->extension) | - |
962 | return; | - |
963 | if (!testAttribute(Qt::WA_WState_Visible)) | - |
964 | return; | - |
965 | if (d->extension->isVisible() == showIt) | - |
966 | return; | - |
967 | | - |
968 | if (showIt) { | - |
969 | d->size = size(); | - |
970 | d->min = minimumSize(); | - |
971 | d->max = maximumSize(); | - |
972 | if (layout()) | - |
973 | layout()->setEnabled(false); | - |
974 | QSize s(d->extension->sizeHint() | - |
975 | .expandedTo(d->extension->minimumSize()) | - |
976 | .boundedTo(d->extension->maximumSize())); | - |
977 | if (d->orientation == Qt::Horizontal) { | - |
978 | int h = qMax(height(), s.height()); | - |
979 | d->extension->setGeometry(width(), 0, s.width(), h); | - |
980 | setFixedSize(width() + s.width(), h); | - |
981 | } else { | - |
982 | int w = qMax(width(), s.width()); | - |
983 | d->extension->setGeometry(0, height(), w, s.height()); | - |
984 | setFixedSize(w, height() + s.height()); | - |
985 | } | - |
986 | d->extension->show(); | - |
987 | #ifndef QT_NO_SIZEGRIP | - |
988 | const bool sizeGripEnabled = isSizeGripEnabled(); | - |
989 | setSizeGripEnabled(false); | - |
990 | d->sizeGripEnabled = sizeGripEnabled; | - |
991 | #endif | - |
992 | } else { | - |
993 | d->extension->hide(); | - |
994 | // workaround for CDE window manager that won't shrink with (-1,-1) | - |
995 | setMinimumSize(d->min.expandedTo(QSize(1, 1))); | - |
996 | setMaximumSize(d->max); | - |
997 | resize(d->size); | - |
998 | if (layout()) | - |
999 | layout()->setEnabled(true); | - |
1000 | #ifndef QT_NO_SIZEGRIP | - |
1001 | setSizeGripEnabled(d->sizeGripEnabled); | - |
1002 | #endif | - |
1003 | } | - |
1004 | } | - |
1005 | | - |
1006 | | - |
1007 | /*! \reimp */ | - |
1008 | QSize QDialog::sizeHint() const | - |
1009 | { | - |
1010 | Q_D(const QDialog); | - |
1011 | if (d->extension) { | - |
1012 | if (d->orientation == Qt::Horizontal) | - |
1013 | return QSize(QWidget::sizeHint().width(), | - |
1014 | qMax(QWidget::sizeHint().height(),d->extension->sizeHint().height())); | - |
1015 | else | - |
1016 | return QSize(qMax(QWidget::sizeHint().width(), d->extension->sizeHint().width()), | - |
1017 | QWidget::sizeHint().height()); | - |
1018 | } | - |
1019 | return QWidget::sizeHint(); | - |
1020 | } | - |
1021 | | - |
1022 | | - |
1023 | /*! \reimp */ | - |
1024 | QSize QDialog::minimumSizeHint() const | - |
1025 | { | - |
1026 | Q_D(const QDialog); | - |
1027 | if (d->extension) { | - |
1028 | if (d->orientation == Qt::Horizontal) | - |
1029 | return QSize(QWidget::minimumSizeHint().width(), | - |
1030 | qMax(QWidget::minimumSizeHint().height(), d->extension->minimumSizeHint().height())); | - |
1031 | else | - |
1032 | return QSize(qMax(QWidget::minimumSizeHint().width(), d->extension->minimumSizeHint().width()), | - |
1033 | QWidget::minimumSizeHint().height()); | - |
1034 | } | - |
1035 | | - |
1036 | return QWidget::minimumSizeHint(); | - |
1037 | } | - |
1038 | | - |
1039 | /*! | - |
1040 | \property QDialog::modal | - |
1041 | \brief whether show() should pop up the dialog as modal or modeless | - |
1042 | | - |
1043 | By default, this property is false and show() pops up the dialog | - |
1044 | as modeless. Setting his property to true is equivalent to setting | - |
1045 | QWidget::windowModality to Qt::ApplicationModal. | - |
1046 | | - |
1047 | exec() ignores the value of this property and always pops up the | - |
1048 | dialog as modal. | - |
1049 | | - |
1050 | \sa QWidget::windowModality, show(), exec() | - |
1051 | */ | - |
1052 | | - |
1053 | void QDialog::setModal(bool modal) | - |
1054 | { | - |
1055 | setAttribute(Qt::WA_ShowModal, modal); | - |
1056 | } | - |
1057 | | - |
1058 | | - |
1059 | bool QDialog::isSizeGripEnabled() const | - |
1060 | { | - |
1061 | #ifndef QT_NO_SIZEGRIP | - |
1062 | Q_D(const QDialog); | - |
1063 | return !!d->resizer; | - |
1064 | #else | - |
1065 | return false; | - |
1066 | #endif | - |
1067 | } | - |
1068 | | - |
1069 | | - |
1070 | void QDialog::setSizeGripEnabled(bool enabled) | - |
1071 | { | - |
1072 | #ifdef QT_NO_SIZEGRIP | - |
1073 | Q_UNUSED(enabled); | - |
1074 | #else | - |
1075 | Q_D(QDialog); | - |
1076 | #ifndef QT_NO_SIZEGRIP | - |
1077 | d->sizeGripEnabled = enabled; | - |
1078 | if (enabled && d->doShowExtension) | - |
1079 | return; | - |
1080 | #endif | - |
1081 | if (!enabled != !d->resizer) { | - |
1082 | if (enabled) { | - |
1083 | d->resizer = new QSizeGrip(this); | - |
1084 | // adjustSize() processes all events, which is suboptimal | - |
1085 | d->resizer->resize(d->resizer->sizeHint()); | - |
1086 | if (isRightToLeft()) | - |
1087 | d->resizer->move(rect().bottomLeft() -d->resizer->rect().bottomLeft()); | - |
1088 | else | - |
1089 | d->resizer->move(rect().bottomRight() -d->resizer->rect().bottomRight()); | - |
1090 | d->resizer->raise(); | - |
1091 | d->resizer->show(); | - |
1092 | } else { | - |
1093 | delete d->resizer; | - |
1094 | d->resizer = 0; | - |
1095 | } | - |
1096 | } | - |
1097 | #endif //QT_NO_SIZEGRIP | - |
1098 | } | - |
1099 | | - |
1100 | | - |
1101 | | - |
1102 | /*! \reimp */ | - |
1103 | void QDialog::resizeEvent(QResizeEvent *) | - |
1104 | { | - |
1105 | #ifndef QT_NO_SIZEGRIP | - |
1106 | Q_D(QDialog); | - |
1107 | if (d->resizer) { | - |
1108 | if (isRightToLeft()) | - |
1109 | d->resizer->move(rect().bottomLeft() -d->resizer->rect().bottomLeft()); | - |
1110 | else | - |
1111 | d->resizer->move(rect().bottomRight() -d->resizer->rect().bottomRight()); | - |
1112 | d->resizer->raise(); | - |
1113 | } | - |
1114 | #endif | - |
1115 | } | - |
1116 | | - |
1117 | /*! \fn void QDialog::finished(int result) | - |
1118 | \since 4.1 | - |
1119 | | - |
1120 | This signal is emitted when the dialog's \a result code has been | - |
1121 | set, either by the user or by calling done(), accept(), or | - |
1122 | reject(). | - |
1123 | | - |
1124 | Note that this signal is \e not emitted when hiding the dialog | - |
1125 | with hide() or setVisible(false). This includes deleting the | - |
1126 | dialog while it is visible. | - |
1127 | | - |
1128 | \sa accepted(), rejected() | - |
1129 | */ | - |
1130 | | - |
1131 | /*! \fn void QDialog::accepted() | - |
1132 | \since 4.1 | - |
1133 | | - |
1134 | This signal is emitted when the dialog has been accepted either by | - |
1135 | the user or by calling accept() or done() with the | - |
1136 | QDialog::Accepted argument. | - |
1137 | | - |
1138 | Note that this signal is \e not emitted when hiding the dialog | - |
1139 | with hide() or setVisible(false). This includes deleting the | - |
1140 | dialog while it is visible. | - |
1141 | | - |
1142 | \sa finished(), rejected() | - |
1143 | */ | - |
1144 | | - |
1145 | /*! \fn void QDialog::rejected() | - |
1146 | \since 4.1 | - |
1147 | | - |
1148 | This signal is emitted when the dialog has been rejected either by | - |
1149 | the user or by calling reject() or done() with the | - |
1150 | QDialog::Rejected argument. | - |
1151 | | - |
1152 | Note that this signal is \e not emitted when hiding the dialog | - |
1153 | with hide() or setVisible(false). This includes deleting the | - |
1154 | dialog while it is visible. | - |
1155 | | - |
1156 | \sa finished(), accepted() | - |
1157 | */ | - |
1158 | | - |
1159 | QT_END_NAMESPACE | - |
1160 | #include "moc_qdialog.cpp" | - |
1161 | | - |
| | |