QFontDialog Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen Standard-Schriftart-Dialog.

Verwenden Sie setCurrentFont(), um die anfänglichen Schriftattribute zu setzen.

Der Parameter parent wird an den Konstruktor QDialog übergeben.

Siehe auch getFont().

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

Konstruiert einen Standard-Schriftart-Dialog mit der angegebenen parent und der angegebenen initial Schriftart.

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

Reimplements: 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 ausgegeben, 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 sich die gewählte Schriftart von der aktuell ausgewählten Schriftart unterscheiden.

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

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

Reimplements: QDialog::done(int r).

Schließt den Dialog und setzt seinen Ergebniscode auf result. Wenn dieser Dialog mit exec() angezeigt wird, beendet done() die lokale Ereignisschleife, und exec() gibt result zurück.

Siehe auch QDialog::done().

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

Dieses Signal wird ausgegeben, wenn eine Schriftart ausgewählt wurde. Die ausgewählte Schriftart wird in font angegeben.

Das Signal wird nur ausgegeben, wenn ein Benutzer die endgültige Schriftart ausgewählt hat. Es wird nicht ausgegeben, wenn der Benutzer die aktuelle Schriftart im Schriftartdialog ä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())

Führt einen modalen Schriftartendialog aus und gibt eine Schriftart zurück.

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

Der Dialog wird mit der angegebenen parent und den in options angegebenen Optionen erstellt. title wird als Fenstertitel des Dialogs angezeigt und initial ist die ursprünglich ausgewählte Schriftart. Wenn der Parameter ok nicht null ist, wird der Wert, auf den er sich bezieht, auf true gesetzt, wenn der Benutzer OK anklickt, und auf false, wenn der Benutzer Cancel anklickt.

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.
}

Das Dialogfeld kann auch verwendet werden, um die Schriftart eines Widgets direkt einzustellen:

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

Klickt der Benutzer in diesem Beispiel auf OK, wird die von ihm gewählte Schriftart verwendet, klickt er auf Abbrechen, wird die ursprüngliche Schriftart verwendet.

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

Dies ist eine überladene Funktion.

Führt einen modalen Schriftartendialog aus und gibt eine Schriftart zurück.

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

Der Dialog wird mit dem angegebenen parent aufgebaut. Wenn der Parameter ok nicht null ist, wird der Wert, auf den er sich bezieht, auf true gesetzt, wenn der Benutzer auf OK klickt, und 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 sein Signal fontSelected() mit dem durch receiver und member angegebenen Steckplatz.

Das Signal wird vom Slot getrennt, wenn 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 in QFontDialog hervorgehobene Schriftart auf die angegebene font.

Siehe auch currentFont() und selectedFont().

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

Setzt das angegebene option auf aktiv, wenn on wahr ist; andernfalls wird das angegebene option gelöscht.

Siehe auch options und testOption().

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

Reimplements: QDialog::setVisible(bool visible).

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

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

Siehe auch options und setOption().