kdeui Library API Documentation

KFontRequester Class Reference

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

#include <kfontrequester.h>

Inheritance diagram for KFontRequester:

Inheritance graph
[legend]
Collaboration diagram for KFontRequester:

Collaboration graph
[legend]
List of all members.

Signals

void fontSelected (const QFont &font)

Public Member Functions

 KFontRequester (QWidget *parent=0L, const char *name=0L, bool onlyFixed=false)
QFont font () const
bool isFixedOnly () const
QString sampleText () const
QString title () const
QLabellabel () const
QPushButtonbutton () const
virtual void setFont (const QFont &font, bool onlyFixed=false)
virtual void setSampleText (const QString &text)
virtual void setTitle (const QString &title)

Protected Slots

virtual void buttonClicked ()

Protected Member Functions

void displaySampleText ()
void setToolTip ()

Protected Attributes

bool m_onlyFixed
QString m_sampleText
QString m_title
QLabelm_sampleLabel
QPushButtonm_button
QFont m_selFont

Properties

QString title
QString sampleText
QFont font

Detailed Description

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

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

KDE Font Requester

Author:
Nadeem Hasan <nhasan@kde.org>

Definition at line 44 of file kfontrequester.h.


Constructor & Destructor Documentation

KFontRequester::KFontRequester QWidget parent = 0L,
const char *  name = 0L,
bool  onlyFixed = false
 

Constructs a font requester widget.

Parameters:
parent The parent widget.
name The widget name.
onlyFixed Only display fonts which have fixed-width character sizes.

Definition at line 31 of file kfontrequester.cpp.

References buttonClicked(), displaySampleText(), QWidget::layout(), m_button, m_sampleLabel, QWidget::setFocusProxy(), setToolTip(), and KDialog::spacingHint().


Member Function Documentation

QFont KFontRequester::font  )  const [inline]
 

Returns:
The currently selected font in the requester.

Definition at line 68 of file kfontrequester.h.

bool KFontRequester::isFixedOnly  )  const [inline]
 

Returns:
Returns true if only fixed fonts are displayed.

Definition at line 73 of file kfontrequester.h.

QString KFontRequester::sampleText  )  const [inline]
 

Returns:
The current text in the sample text input area.

Definition at line 78 of file kfontrequester.h.

QString KFontRequester::title  )  const [inline]
 

Returns:
The current title of the widget.

Definition at line 83 of file kfontrequester.h.

QLabel* KFontRequester::label  )  const [inline]
 

Returns:
Pointer to the label used for preview.

Definition at line 88 of file kfontrequester.h.

QPushButton* KFontRequester::button  )  const [inline]
 

Returns:
Pointer to the pushbutton in the widget.

Definition at line 93 of file kfontrequester.h.

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

Sets the currently selected font in the requester.

Parameters:
font The font to select.
onlyFixed Display only fixed-width fonts in the font dialog if true, or vice-versa.

Reimplemented from QWidget.

Definition at line 52 of file kfontrequester.cpp.

References displaySampleText(), m_onlyFixed, and m_selFont.

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

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::null will restore the default.

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

Definition at line 61 of file kfontrequester.cpp.

References displaySampleText(), and m_sampleText.

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

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

Parameters:
title The title to be set.

Definition at line 67 of file kfontrequester.cpp.

References m_title, and setToolTip().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.4.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Sep 15 10:30:06 2005 by doxygen 1.4.4 written by Dimitri van Heesch, © 1997-2003