QDialog Class

Detaillierte Beschreibung

Ein Dialogfenster ist ein Fenster der obersten Ebene, das hauptsächlich für kurzfristige Aufgaben und kurze Kommunikation mit dem Benutzer verwendet wird. QDialogs können modal oder modeless sein. QDialogs können ein return value zur Verfügung stellen, und sie können default buttons haben. QDialogs können auch ein QSizeGrip in ihrer unteren rechten Ecke haben, indem sie setSizeGripEnabled() verwenden.

Beachten Sie, dass QDialog (und jedes andere Widget mit dem Typ Qt::Dialog) das übergeordnete Widget etwas anders als andere Klassen in Qt verwendet. Ein Dialog ist immer ein Widget der obersten Ebene, aber wenn es ein übergeordnetes Widget hat, ist seine Standardposition über dem übergeordneten Widget zentriert (wenn es nicht selbst die oberste Ebene ist). Es wird auch den Taskleisteneintrag des Elternteils teilen.

Verwenden Sie die Überladung der Funktion QWidget::setParent(), um die Eigentümerschaft eines QDialog-Widgets zu ändern. Diese Funktion erlaubt es Ihnen, die Fensterflags des reparierten Widgets explizit zu setzen; die Verwendung der überladenen Funktion löscht die Fensterflags, die die Fenstersystemeigenschaften für das Widget spezifizieren (insbesondere wird das Qt::Dialog Flag zurückgesetzt).

Modale Dialoge

Ein modaler Dialog ist ein Dialog, der die Eingabe in andere sichtbare Fenster in derselben Anwendung blockiert. Dialoge, die dazu dienen, einen Dateinamen vom Benutzer anzufordern oder Anwendungseinstellungen vorzunehmen, sind normalerweise modal. Dialoge können application modal (die Standardeinstellung) oder window modal sein.

Wenn ein modales Dialogfeld geöffnet wird, muss der Benutzer die Interaktion mit dem Dialogfeld beenden und es schließen, bevor er auf ein anderes Fenster in der Anwendung zugreifen kann. Modale Fensterdialoge blockieren nur den Zugriff auf das mit dem Dialog verknüpfte Fenster, so dass der Benutzer weiterhin andere Fenster in einer Anwendung verwenden kann.

Die häufigste Art, ein modales Dialogfeld anzuzeigen, ist der Aufruf der Funktion open(). Alternativ können Sie auch setModal(true) oder setWindowModality() und dann show() aufrufen. In beiden Fällen wird die Kontrolle sofort an den Aufrufer zurückgegeben, sobald das Dialogfeld angezeigt wird. Sie müssen eine Verbindung mit dem Signal finished() herstellen, um zu erfahren, wann das Dialogfeld geschlossen wird und wie sein return value lautet. Alternativ können Sie auch eine Verbindung zu den Signalen accepted() und rejected() herstellen.

Wenn Sie ein benutzerdefiniertes Dialogfeld implementieren, um das Dialogfeld zu schließen und einen entsprechenden Wert zurückzugeben, verbinden Sie eine Standardschaltfläche, z. B. eine OK-Schaltfläche, mit dem Slot accept() und eine Abbrechen-Schaltfläche mit dem Slot reject(). Alternativ können Sie den Slot done() auch mit Accepted oder Rejected aufrufen.

Wenn Sie das modale Dialogfeld anzeigen, um einen langwierigen Vorgang auszuführen, empfiehlt es sich, den Vorgang in einem Worker-Thread im Hintergrund auszuführen, damit er den GUI-Thread nicht beeinträchtigt.

Modellfreie Dialoge

Ein modellloser Dialog ist ein Dialog, der unabhängig von anderen Fenstern in derselben Anwendung funktioniert. Dialoge zum Suchen und Ersetzen in Textverarbeitungsprogrammen sind oft modelllos, damit der Benutzer sowohl mit dem Hauptfenster der Anwendung als auch mit dem Dialog interagieren kann.

Modeless-Dialoge werden mit show() angezeigt, das die Kontrolle sofort an den Aufrufer zurückgibt.

Wenn Sie die Funktion show() aufrufen, nachdem Sie einen Dialog ausgeblendet haben, wird der Dialog an seiner ursprünglichen Position angezeigt. Dies liegt daran, dass der Fenstermanager die Position für Fenster bestimmt, die nicht explizit vom Programmierer platziert wurden. Um die Position eines vom Benutzer verschobenen Dialogs beizubehalten, speichern Sie seine Position in Ihrem closeEvent()-Handler und verschieben Sie den Dialog dann an diese Position, bevor Sie ihn wieder einblenden.

Standard-Schaltfläche

Die Standardschaltfläche eines Dialogs ist die Schaltfläche, die gedrückt wird, wenn der Benutzer die Eingabetaste (Return) drückt. Diese Schaltfläche wird verwendet, um zu signalisieren, dass der Benutzer die Einstellungen des Dialogs akzeptiert und den Dialog schließen möchte. Verwenden Sie QPushButton::setDefault(), QPushButton::isDefault() und QPushButton::autoDefault(), um die Standardschaltfläche des Dialogs festzulegen und zu steuern.

Escape-Taste

Wenn der Benutzer in einem Dialog die Esc-Taste drückt, wird QDialog::reject() aufgerufen. Dies führt zum Schließen des Fensters: Die close event kann nicht ignored sein.

Erweiterbarkeit

Unter Erweiterbarkeit versteht man die Möglichkeit, das Dialogfeld auf zwei Arten darzustellen: als partielles Dialogfeld, das die am häufigsten verwendeten Optionen anzeigt, und als vollständiges Dialogfeld, das alle Optionen anzeigt. In der Regel wird ein erweiterbarer Dialog zunächst als Teildialog angezeigt, jedoch mit einer Umschalttaste More. Wenn der Benutzer die Schaltfläche More drückt, wird das Dialogfeld erweitert.

Rückgabewert (Modale Dialoge)

Modale Dialoge werden oft in Situationen verwendet, in denen ein Rückgabewert erforderlich ist, z. B. um anzuzeigen, ob der Benutzer OK oder Cancel gedrückt hat. Ein Dialog kann durch den Aufruf der Slots accept() oder reject() geschlossen werden, und exec() gibt Accepted oder Rejected zurück, je nachdem. Der Aufruf exec() gibt das Ergebnis des Dialogs zurück. Das Ergebnis ist auch von result() verfügbar, wenn der Dialog nicht zerstört wurde.

Um das Schließverhalten Ihres Dialogs zu ändern, können Sie die Funktionen accept(), reject() oder done() neu implementieren. Die Funktion closeEvent() sollte nur neu implementiert werden, um die Position des Dialogs beizubehalten oder um das standardmäßige Schließ- oder Ablehnungsverhalten außer Kraft zu setzen.

Code-Beispiele

Ein modaler Dialog:

void EditorWindow::countWords()
{
    WordCountDialog dialog(this);
    dialog.setWordCount(document().wordCount());
    dialog.exec();
}

Ein modellloser Dialog:

void EditorWindow::find()
{
    if (!findDialog) {
        findDialog = new FindDialog(this);
        connect(findDialog, &FindDialog::findNext,
                this, &EditorWindow::findNext);
    }

    findDialog->show();
    findDialog->raise();
    findDialog->activateWindow();
}

Ein Dialog mit einer Erweiterung:

    mainLayout->setSizeConstraint(QLayout::SetFixedSize);

    findButton = new QPushButton(tr("&Find"));
    moreButton = new QPushButton(tr("&More..."));
    moreButton->setCheckable(true);

    extension = new ExtendedControls;
    mainLayout->addWidget(extension);
    extension->hide();

    connect(moreButton, &QAbstractButton::toggled, extension, &QWidget::setVisible);

Wenn Sie die Eigenschaft sizeConstraint des Dialoglayouts auf SetFixedSize setzen, kann die Größe des Dialogs vom Benutzer nicht geändert werden und wird automatisch verkleinert, wenn die Erweiterung ausgeblendet wird.