QFontDialog Class

Documentación de las funciones miembro

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

Construye un diálogo de fuente estándar.

Utilice setCurrentFont() para establecer los atributos iniciales de la fuente.

El parámetro parent se pasa al constructor QDialog.

Véase también getFont().

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

Construye un diálogo de fuente estándar con el parent dado y la fuente initial especificada.

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

Reimplementa: QWidget::changeEvent(QEvent *event).

QFont QFontDialog::currentFont() const

Devuelve la fuente actual.

Véase también setCurrentFont() y selectedFont().

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

Esta señal se emite cuando se cambia la fuente actual. El nuevo tipo de letra se especifica en font.

La señal se emite mientras el usuario está seleccionando un tipo de letra. En última instancia, la fuente elegida puede diferir de la fuente actualmente seleccionada.

Véase también currentFont, fontSelected(), y selectedFont().

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

Reimplementa: QDialog::done(int r).

Cierra el diálogo y establece su código de resultado a result. Si este diálogo se muestra con exec(), done() hace que el bucle de eventos local termine, y exec() devuelva result.

Véase también QDialog::done().

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

Esta señal se emite cuando se ha seleccionado una fuente. La fuente seleccionada se especifica en font.

La señal sólo se emite cuando un usuario ha elegido la fuente final que se utilizará. No se emite mientras el usuario está cambiando la fuente actual en el diálogo de fuentes.

Véase también selectedFont(), currentFontChanged(), y currentFont.

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

Ejecuta un diálogo modal de fuentes y devuelve una fuente.

Si el usuario hace clic en OK, se devuelve la fuente seleccionada. Si el usuario hace clic en Cancel, se devuelve la fuente initial.

El diálogo se construye con el parámetro parent y las opciones especificadas en options. title se muestra como el título de la ventana del diálogo y initial es la fuente seleccionada inicialmente. Si el parámetro ok no es nulo, el valor al que hace referencia se establece en true si el usuario hace clic en OK, y en false si el usuario hace clic en Cancel.

Ejemplos:

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

El cuadro de diálogo también puede utilizarse para establecer directamente la fuente de un widget:

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

En este ejemplo, si el usuario hace clic en Aceptar se utilizará la fuente que haya elegido, y si hace clic en Cancelar se utilizará la fuente original.

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

Ejecuta un diálogo modal de fuentes y devuelve una fuente.

Si el usuario hace clic en OK, se devuelve la fuente seleccionada. Si el usuario hace clic en Cancel, se devuelve la fuente Qt predeterminada.

El diálogo se construye con el parámetro parent. Si el parámetro ok no es nulo, el valor al que hace referencia se establece en true si el usuario hace clic en OK, y en false si el usuario hace clic en Cancel.

Ejemplo:

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)

Abre el diálogo y conecta su señal fontSelected() a la ranura especificada por receiver y member.

La señal se desconectará de la ranura cuando se cierre el diálogo.

QFont QFontDialog::selectedFont() const

Devuelve la fuente que el usuario seleccionó al pulsar el botón OK o equivalente.

void QFontDialog::setCurrentFont(const QFont &font)

Establece la fuente resaltada en QFontDialog a la dada font.

Véase también currentFont() y selectedFont().

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

Establece el option dado para que esté habilitado si on es verdadero; de lo contrario, borra el option dado.

Véase también options y testOption().

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

Reimplementa: QDialog::setVisible(bool visible).

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

Devuelve true si el option dado está habilitado; en caso contrario, devuelve false.

Véase también options y setOption().