QFontDialog Class

Dokumentation der Member-Funktionen

[explicit] QFontDialog::QFontDialog(QWidget *parent = nullptr)

Erstellt einen Standard-Schriftartendialog.

Verwenden Sie ` setCurrentFont()` zum Festlegen der anfänglichen Schriftartattribute.

Der Parameter „ parent “ wird an den Konstruktor „ QDialog “ übergeben.

Siehe auch ` getFont()`.

[explicit] QFontDialog::QFontDialog(const QFont &initial, QWidget *parent = nullptr)

Erzeugt einen Standard-Schriftartendialog mit dem angegebenen „ parent “ und der angegebenen Schriftart „ initial “.

[override virtual protected] void QFontDialog::changeEvent(QEvent *e)

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

QFont QFontDialog::currentFont() const

Gibt die aktuelle Schriftart zurück.

Siehe auch „ setCurrentFont()“ und „ selectedFont()“.

[signal] void QFontDialog::currentFontChanged(const QFont &font)

Dieses Signal wird ausgelöst, wenn die aktuelle Schriftart geändert wird. Die neue Schriftart wird in „ font “ angegeben.

Das Signal wird ausgegeben, während ein Benutzer eine Schriftart auswählt. Letztendlich kann die gewählte Schriftart von der aktuell ausgewählten Schriftart abweichen.

Siehe auch „ currentFont“ , „ fontSelected()“ und „ selectedFont()“.

[override virtual protected] void QFontDialog::done(int result)

Implementiert: ` QDialog::done(int r)`.

Schließt das Dialogfeld und setzt dessen Ergebniscode auf „ result “. Wenn dieses Dialogfeld mit „ exec()“ angezeigt wird, bewirkt „done()“, dass die lokale Ereignisschleife beendet wird, und „ exec()“ gibt „ result “ zurück.

Siehe auch „ QDialog::done()“.

[signal] void QFontDialog::fontSelected(const QFont &font)

Dieses Signal wird ausgelöst, wenn eine Schriftart ausgewählt wurde. Die ausgewählte Schriftart wird in „ font “ angegeben.

Das Signal wird nur ausgesendet, wenn ein Benutzer die endgültig zu verwendende Schriftart ausgewählt hat. Es wird nicht ausgesendet, während der Benutzer die aktuelle Schriftart im Schriftartendialog ändert.

Siehe auch „ selectedFont()“, „ currentFontChanged()“ und „ currentFont “.

[static] QFont QFontDialog::getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())

Ruft einen modalen Schriftartendialog auf und gibt eine Schriftart zurück.

Wenn der Benutzer auf „ OK “ klickt, wird die ausgewählte Schriftart zurückgegeben. Wenn der Benutzer auf „ Cancel “ klickt, wird die Schriftart „ initial “ zurückgegeben.

Der Dialog wird mit dem angegebenen „ parent “ und den in „ options “ festgelegten Optionen erstellt. „ title “ wird als Fenstertitel des Dialogs angezeigt und „ initial “ ist die anfänglich ausgewählte Schriftart. Ist der Parameter „ ok “ nicht null, wird der Wert, auf den er verweist, auf „true“ gesetzt, wenn der Benutzer auf „ OK “ klickt, und auf „false“, wenn der Benutzer auf „ Cancel “ klickt.

Beispiele:

bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Times, 12.
}

Der Dialog kann auch verwendet werden, um die Schriftart eines Widgets direkt festzulegen:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

In diesem Beispiel wird die vom Benutzer gewählte Schriftart verwendet, wenn er auf „OK“ klickt; klickt er hingegen auf „Abbrechen“, wird die ursprüngliche Schriftart verwendet.

[static] QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr)

Ruft einen modalen Schriftartendialog auf und gibt eine Schriftart zurück.

Wenn der Benutzer auf „ OK “ klickt, wird die ausgewählte Schriftart zurückgegeben. Wenn der Benutzer auf „ Cancel “ klickt, wird die Qt-Standardschriftart zurückgegeben.

Der Dialog wird mit dem angegebenen Parameter „ parent “ erstellt. Ist der Parameter „ ok “ nicht null, wird der Wert, auf den er verweist, auf „true“ gesetzt, wenn der Benutzer auf „ OK “ klickt, und auf „false“, wenn der Benutzer auf „ Cancel “ klickt.

Beispiel:

bool ok;
QFont font = QFontDialog::getFont(&ok, this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the default
    // application font, QApplication::font()
}

void QFontDialog::open(QObject *receiver, const char *member)

Öffnet das Dialogfeld und verbindet dessen Signal „ fontSelected()“ mit dem durch „ receiver “ und „ member “ angegebenen Slot.

Das Signal wird vom Slot getrennt, sobald das Dialogfeld geschlossen wird.

QFont QFontDialog::selectedFont() const

Gibt die Schriftart zurück, die der Benutzer durch Klicken auf die Schaltfläche „ OK “ oder eine entsprechende Schaltfläche ausgewählt hat.

void QFontDialog::setCurrentFont(const QFont &font)

Setzt die im Feld „ QFontDialog “ markierte Schriftart auf die angegebene „ font “.

Siehe auch „ currentFont()“ und „ selectedFont()“.

void QFontDialog::setOption(QFontDialog::FontDialogOption option, bool on = true)

Setzt die angegebene Eigenschaft „ option “ auf „enabled“, wenn „ on “ den Wert „true“ hat; andernfalls wird die angegebene Eigenschaft „ option “ zurückgesetzt.

Siehe auch „ options “ und „ testOption()“.

[override virtual] void QFontDialog::setVisible(bool visible)

Implementiert: ` QDialog::setVisible` (bool visible).

bool QFontDialog::testOption(QFontDialog::FontDialogOption option) const

Gibt „ true “ zurück, wenn die angegebene Funktion „ option “ aktiviert ist; andernfalls wird „false“ zurückgegeben.

Siehe auch „ options “ und „ setOption()“.