QDialog Class Reference

A modal dialog.

        QFileDialog *dlg = new QFileDialog( workingDirectory,
                QString::null, 0, 0, TRUE );
        dlg->setCaption( QFileDialog::tr( "Open" ) );
        dlg->setMode( QFileDialog::ExistingFile );
        QString result;
        if ( dlg->exec() == QDialog::Accepted ) {
            result = dlg->selectedFile();
            workingDirectory = dlg->url();
        }
        delete dlg;
        return result;

A modeless dialog. After the show() call, control returns to the main event loop.

    int main( int argc, char **argv )
    {
        QApplication a( argc, argv );

        int scale = 10;

        LifeDialog *life = new LifeDialog( scale );
        a.setMainWidget( life );
        life->setCaption("Qt Example - Life");
        life->show();

        return a.exec();
    }

See also QTabDialog, QWidget, QProgressDialog, GUI Design Handbook: Dialogs, Standard, Abstract Widget Classes, and Dialog Classes.

Member Type Documentation

QDialog::DialogCode

The value returned by a modal dialog.

• QDialog::Accepted
• QDialog::Rejected

Member Function Documentation

explicit QDialog::QDialog ( QWidget * parent = 0, const char * name = 0, bool modal = FALSE, WFlags f = 0 )

A dialog is always a top-level widget, but if it has a parent, its default location is centered on top of the parent. It will also share the parent's taskbar entry.

The widget flags f are passed on to the QWidget constructor. If, for example, you don't want a What's This button in the titlebar of the dialog, pass WStyle_Customize | WStyle_NormalBorder | WStyle_Title | WStyle_SysMenu in f.

Warning: In Qt 3.2, the modal flag is obsolete. There is now a setModal() function that can be used for obtaining a modal behavior when calling show(). This is rarely needed, because modal dialogs are usually invoked using exec(), which ignores the modal flag.

See also QWidget::setWFlags() and Qt::WidgetFlags.

QDialog::~QDialog ()

void QDialog::accept () [virtual protected slot]

See also reject() and done().

Examples: chart/setdataform.cpp and distributor/distributor.ui.h.

void QDialog::done ( int r ) [virtual protected slot]

As with QWidget::close(), done() deletes the dialog if the WDestructiveClose flag is set. If the dialog is the application's main widget, the application terminates. If the dialog is the last window closed, the QApplication::lastWindowClosed() signal is emitted.

See also accept(), reject(), QApplication::mainWidget(), and QApplication::quit().

Example: movies/main.cpp.

int QDialog::exec () [slot]

Users cannot interact with any other window in the same application until they close the dialog.

See also show() and result().

Examples: chart/chartform.cpp, dialog/mainwindow.cpp, extension/mainform.ui.h, network/ftpclient/ftpmainwindow.ui.h, network/networkprotocol/view.cpp, qdir/qdir.cpp, and wizard/main.cpp.

QWidget * QDialog::extension () const

See also setExtension().

Example: extension/mainform.ui.h.

bool QDialog::isModal () const

Returns TRUE if show() should pop up the dialog as modal or modeless; otherwise returns FALSE. See the "modal" property for details.

bool QDialog::isSizeGripEnabled () const

Returns TRUE if the size grip is enabled; otherwise returns FALSE. See the "sizeGripEnabled" property for details.

Orientation QDialog::orientation () const

See also setOrientation().

void QDialog::reject () [virtual protected slot]

See also accept() and done().

int QDialog::result () const

Returns the modal dialog's result code, Accepted or Rejected.

Do not call this function if the dialog was constructed with the WDestructiveClose flag.

void QDialog::setExtension ( QWidget * extension )

This function must only be called while the dialog is hidden.

See also showExtension(), setOrientation(), and extension().

void QDialog::setModal ( bool modal )

Sets whether show() should pop up the dialog as modal or modeless to modal. See the "modal" property for details.

void QDialog::setOrientation ( Orientation orientation )

See also orientation() and setExtension().

void QDialog::setResult ( int i ) [protected]

Sets the modal dialog's result code to i.

void QDialog::setSizeGripEnabled ( bool )

Sets whether the size grip is enabled. See the "sizeGripEnabled" property for details.

void QDialog::show () [virtual]

The dialog will be modal or modeless according to the value of the modal property.

See also exec() and modal.

Examples: extension/main.cpp, movies/main.cpp, network/archivesearch/main.cpp, showimg/showimg.cpp, sql/overview/form1/main.cpp, and tabdialog/main.cpp.

Reimplemented from QWidget.

void QDialog::showExtension ( bool showIt ) [protected slot]

This slot is usually connected to the QButton::toggled() signal of a QPushButton.

A dialog with a visible extension is not resizeable.

See also show(), setExtension(), and setOrientation().

Property Documentation

bool modal

This property holds whether show() should pop up the dialog as modal or modeless.

By default, this property is false and show() pops up the dialog as modeless.

exec() ignores the value of this property and always pops up the dialog as modal.

See also show() and exec().

Set this property's value with setModal() and get this property's value with isModal().

bool sizeGripEnabled

This property holds whether the size grip is enabled.

A QSizeGrip is placed in the bottom right corner of the dialog when this property is enabled. By default, the size grip is disabled.

Set this property's value with setSizeGripEnabled() and get this property's value with isSizeGripEnabled().

This file is part of the Qt toolkit. Copyright © 1995-2003 Trolltech. All Rights Reserved.