QDialog Class

Ausführliche Beschreibung

Ein Dialogfenster ist ein Fenster der obersten Ebene, das hauptsächlich für kurzfristige Aufgaben und kurze Interaktionen mit dem Benutzer verwendet wird. QDialogs können modal oder modelos sein. QDialogs können einen „ return value “ bereitstellen und über „ default buttons “ verfügen. QDialogs können außerdem in ihrer rechten unteren Ecke einen „ QSizeGrip “ anzeigen, der mit „ setSizeGripEnabled()“ aufgerufen wird.

Beachten Sie, dass QDialog (und jedes andere Widget vom Typ „ Qt::Dialog “) das übergeordnete Widget etwas anders verwendet als andere Klassen in Qt. Ein Dialog ist immer ein Widget der obersten Ebene, aber wenn er ein übergeordnetes Widget hat, wird er standardmäßig zentriert über dem Widget der obersten Ebene des übergeordneten Widgets platziert (sofern er nicht selbst ein Widget der obersten Ebene ist). Außerdem nutzt es den Taskleisten-Eintrag des übergeordneten Widgets mit.

Verwenden Sie die Überladung der Funktion ` QWidget::setParent()` (), um die Eigentümerschaft eines `QDialog`-Widgets zu ändern. Mit dieser Funktion können Sie die Fensterflags des Widgets, dessen übergeordnetes Widget geändert wird, explizit festlegen; durch die Verwendung der überladenen Funktion werden die Fensterflags gelöscht, die die Fenstersystem-Eigenschaften für das Widget festlegen (insbesondere wird das Flag ` Qt::Dialog ` zurückgesetzt).

Modale Dialoge

Ein modaler Dialog ist ein Dialog, der die Eingabe in andere sichtbare Fenster derselben Anwendung blockiert. Dialoge, die dazu dienen, einen Dateinamen vom Benutzer abzufragen oder Anwendungseinstellungen festzulegen, sind in der Regel modal. Dialoge können „ application modal “ (Standard) oder „ window modal “ sein.

Wenn ein modaler Anwendungsdialog geöffnet wird, muss der Benutzer die Interaktion mit dem Dialog abschließen und diesen schließen, bevor er auf andere Fenster der Anwendung zugreifen kann. Modale Fensterdialoge blockieren nur den Zugriff auf das mit dem Dialog verknüpfte Fenster, sodass der Benutzer andere Fenster der Anwendung weiterhin nutzen kann.

Die gängigste Methode zum Anzeigen eines modalen Dialogs ist der Aufruf der Funktion „ open()“. Alternativ können Sie „ setModal(true)“ oder „ setWindowModality()“ aufrufen und anschließend „ show()“. In beiden Fällen wird die Steuerung sofort an den Aufrufer zurückgegeben, sobald der Dialog angezeigt wird. Sie müssen eine Verbindung zum Signal „ finished()“ herstellen, um zu erfahren, wann der Dialog geschlossen wird und welchen Wert „ return value “ annimmt. Alternativ können Sie eine Verbindung zu den Signalen „ accepted()“ und „ rejected()“ herstellen.

Um bei der Implementierung eines benutzerdefinierten Dialogs diesen zu schließen und einen entsprechenden Wert zurückzugeben, verbinden Sie eine Standardschaltfläche – beispielsweise eine „OK“-Schaltfläche – mit dem Slot „ accept()“ und eine „Abbrechen“-Schaltfläche mit dem Slot „ reject()“. Alternativ können Sie den Slot „ done()“ mit „ Accepted “ oder „ Rejected “ aufrufen.

Wenn Sie den modalen Dialog anzeigen, um einen lang andauernden Vorgang auszuführen, wird empfohlen, diesen Vorgang in einem Hintergrund-Worker-Thread auszuführen, damit der GUI-Thread nicht beeinträchtigt wird.

Moduslose Dialoge

Ein modelloser Dialog ist ein Dialog, der unabhängig von anderen Fenstern derselben Anwendung arbeitet. Such- und Ersetzungsdialoge in Textverarbeitungsprogrammen sind oft modellos, damit der Benutzer sowohl mit dem Hauptfenster der Anwendung als auch mit dem Dialog interagieren kann.

Modeless-Dialogfelder werden mit der Funktion ` show()` angezeigt, die die Kontrolle sofort an den Aufrufer zurückgibt.

Wenn Sie die Funktion ` show()` aufrufen, nachdem Sie ein Dialogfeld ausgeblendet haben, wird das Dialogfeld an seiner ursprünglichen Position angezeigt. Dies liegt daran, dass der Fenstermanager die Position für Fenster festlegt, die nicht explizit vom Programmierer platziert wurden. Um die Position eines vom Benutzer verschobenen Dialogfelds beizubehalten, speichern Sie dessen Position in Ihrem ` closeEvent()`-Handler und verschieben Sie das Dialogfeld dann an diese Position, bevor Sie es erneut anzeigen.

Standardschaltfläche

Die Standardschaltfläche eines Dialogfelds ist die Schaltfläche, die gedrückt wird, wenn der Benutzer die Eingabetaste (Return) drückt. Diese Schaltfläche dient dazu, anzuzeigen, dass der Benutzer die Einstellungen des Dialogfelds akzeptiert und das Dialogfeld schließen möchte. Verwenden Sie die Funktionen „ QPushButton::setDefault()“, „ QPushButton::isDefault()“ und „ QPushButton::autoDefault()“, um die Standardschaltfläche des Dialogfelds festzulegen und zu steuern.

Esc-Taste

Wenn der Benutzer in einem Dialogfeld die Esc-Taste drückt, wird ` QDialog::reject()` aufgerufen. Dadurch wird das Fenster geschlossen: Die ` close event ` darf nicht ` ignored` sein.

Erweiterbarkeit

Erweiterbarkeit bezeichnet die Möglichkeit, den Dialog auf zwei Arten anzuzeigen: als Teildialog, der die am häufigsten verwendeten Optionen anzeigt, und als Vollbilddialog, der alle Optionen anzeigt. In der Regel wird ein erweiterbarer Dialog zunächst als Teildialog angezeigt, jedoch mit einer Umschaltfläche „ More “. Wenn der Benutzer die Schaltfläche „ More “ betätigt, wird der Dialog erweitert.

Rückgabewert (modale Dialoge)

Modale Dialoge werden häufig in Situationen verwendet, in denen ein Rückgabewert erforderlich ist, z. B. um anzugeben, ob der Benutzer auf „ OK “ oder „ Cancel “ geklickt hat. Ein Dialog kann durch Aufruf der Slots „ accept()“ oder „ reject()“ geschlossen werden, und „ exec()“ gibt je nach Fall „ Accepted “ oder „ Rejected “ zurück. Der Aufruf von ` exec()` gibt das Ergebnis des Dialogs zurück. Das Ergebnis ist auch über ` result()` abrufbar, sofern der Dialog nicht zerstört wurde.

Um das Schließverhalten Ihres Dialogs anzupassen, 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 das Standardverhalten beim Schließen oder Ablehnen zu überschreiben.

Code-Beispiele

Ein modaler Dialog:

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

Ein nicht-modaler 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);

Indem Sie die Eigenschaft „ sizeConstraint “ des Layouts des Dialogfelds auf „ SetFixedSize “ setzen, kann das Dialogfeld vom Benutzer nicht in der Größe verändert werden und wird automatisch verkleinert, wenn die Erweiterung ausgeblendet wird.