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 the QProgressDialog documentation for an example of a semi-modal dialog.

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

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

If modal is FALSE (the default), the dialog is modeless and should be displayed with show(). If modal is TRUE and the dialog is displayed with exec(), the dialog is modal, i.e. blocks input to other windows in this application. If modal is TRUE and the dialog is displayed using show(), the dialog is semi-modal.

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.

We recommend that you always pass a non-null parent.

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

QDialog::~QDialog ()

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

See also reject() and done().

Example: chart/setdataform.cpp.

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

If the dialog has the WDestructiveClose flag set, done() also deletes the dialog. If the dialog is the applications's main widget, the application terminates.

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

int QDialog::exec () [slot]

See also show() and result().

Examples: chart/chartform.cpp, i18n/main.cpp, network/networkprotocol/view.cpp, qdir/qdir.cpp, showimg/showimg.cpp and wizard/main.cpp.

QWidget * QDialog::extension () const

See also setExtension().

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. (exec() returns the result code anyway.)

void QDialog::setExtension ( QWidget * extension )

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

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

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 does not have a local event loop so you must call QApplication::processEvents() periodically to give the dialog the opportunity to process its events.

The dialog will be semi-modal if the modal flag was set to TRUE in the constructor.

Warning:

In Qt 2.x, calling show() on a modal dialog enters a local event loop, and works like exec(), but doesn't return the result code exec() returns. Trolltech has always warned that doing this is unwise.

See also exec().

Examples: movies/main.cpp, showimg/showimg.cpp and sql/overview/form1/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.

If the dialog is not visible, or has no extension, nothing happens.

A dialog with a visible extension is not resizeable.

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

Property Documentation

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-2002 Trolltech. All Rights Reserved.