Contents

KFontRequester Class

This class provides a widget with a lineedit and a button, which invokes a font dialog (KFontChooserDialog). More...

Header: #include <KFontRequester>
CMake: find_package(KF6 REQUIRED COMPONENTS WidgetsAddons)
target_link_libraries(mytarget PRIVATE KF6::WidgetsAddons)
Inherits: QWidget

Properties

Public Functions

KFontRequester(QWidget *parent = nullptr, bool onlyFixed = false)
QPushButton *button() const
QFont font() const
bool isFixedOnly() const
QLabel *label() const
QString sampleText() const
virtual void setFont(const QFont &font, bool onlyFixed = false)
virtual void setSampleText(const QString &text)
virtual void setTitle(const QString &title)
QString title() const

Signals

void fontSelected(const QFont &font)

Detailed Description

The lineedit provides a preview of the selected font. The preview text can be customized. You can also have the font dialog show only the fixed fonts.

"KFontRequester"

Property Documentation

font : QFont

Access functions:

QFont font() const
virtual void setFont(const QFont &font, bool onlyFixed = false)

Notifier signal:

void fontSelected(const QFont &font)

sampleText : QString

Access functions:

QString sampleText() const
virtual void setSampleText(const QString &text)

title : QString

Access functions:

QString title() const
virtual void setTitle(const QString &title)

Member Function Documentation

[explicit] KFontRequester::KFontRequester(QWidget *parent = nullptr, bool onlyFixed = false)

Constructs a font requester widget.

parent The parent widget.

onlyFixed Only display fonts which have fixed-width character sizes.

QPushButton *KFontRequester::button() const

Returns pointer to the pushbutton in the widget.

QFont KFontRequester::font() const

Returns the currently selected font in the requester.

Note: Getter function for property font.

See also setFont().

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

Emitted when a new font has been selected in the underlying dialog

Note: Notifier signal for property font.

bool KFontRequester::isFixedOnly() const

Returns true if only fixed fonts are displayed.

QLabel *KFontRequester::label() const

Returns pointer to the label used for preview.

QString KFontRequester::sampleText() const

Returns the current text in the sample text input area.

Note: Getter function for property sampleText.

See also setSampleText().

[virtual] void KFontRequester::setFont(const QFont &font, bool onlyFixed = false)

Sets the currently selected font in the requester.

font The font to select.

onlyFixed Display only fixed-width fonts in the font dialog if true, or vice-versa.

Note: Setter function for property font.

See also font().

[virtual] void KFontRequester::setSampleText(const QString &text)

Sets the sample text.

Normally you should not change this text, but it can be better to do this if the default text is too large for the edit area when using the default font of your application. Default text is current font name and size. Setting the text to QString() will restore the default.

text The new sample text. The current will be removed.

Note: Setter function for property sampleText.

See also sampleText().

[virtual] void KFontRequester::setTitle(const QString &title)

Set the title for the widget that will be used in the tooltip and what's this text.

title The title to be set.

Note: Setter function for property title.

See also title().

QString KFontRequester::title() const

Returns the current title of the widget.

Note: Getter function for property title.

See also setTitle().