#include <tdefontdialog.h>

Inheritance diagram for TDEFontDialog:

Signals
void	fontSelected (const TQFont &font)

Signals inherited from KDialogBase
void	helpClicked ()

void	defaultClicked ()

void	user3Clicked ()

void	user2Clicked ()

void	user1Clicked ()

void	applyClicked ()

void	tryClicked ()

void	okClicked ()

void	yesClicked ()

void	noClicked ()

void	cancelClicked ()

void	closeClicked ()

void	apply ()

void	backgroundChanged ()

void	hidden ()

void	finished ()

void	aboutToShowDetails ()

void	aboutToShowPage (TQWidget *page)

Signals inherited from KDialog
void	layoutHintChanged ()

Public Member Functions
	TDEFontDialog (TQWidget parent=0L, const char name=0, bool onlyFixed=false, bool modal=false, const TQStringList &fontlist=TQStringList(), bool makeFrame=true, bool diff=false, TQButton::ToggleState *sizeIsRelativeState=0L)

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

TQFont	font () const

void	setSizeIsRelative (TQButton::ToggleState relative)

TQButton::ToggleState	sizeIsRelative () const

Public Member Functions inherited from KDialogBase
	KDialogBase (TQWidget parent=0, const char name=0, bool modal=true, const TQString &caption=TQString::null, int buttonMask=Ok\|Apply\|Cancel, ButtonCode defaultButton=Ok, bool separator=false, const KGuiItem &user1=KGuiItem(), const KGuiItem &user2=KGuiItem(), const KGuiItem &user3=KGuiItem())

	KDialogBase (int dialogFace, const TQString &caption, int buttonMask, ButtonCode defaultButton, TQWidget parent=0, const char name=0, bool modal=true, bool separator=false, const KGuiItem &user1=KGuiItem(), const KGuiItem &user2=KGuiItem(), const KGuiItem &user3=KGuiItem())

	KDialogBase (KDialogBase::DialogType dialogFace, WFlags f, TQWidget parent=0, const char name=0, bool modal=true, const TQString &caption=TQString::null, int buttonMask=Ok\|Apply\|Cancel, ButtonCode defaultButton=Ok, bool separator=false, const KGuiItem &user1=KGuiItem(), const KGuiItem &user2=KGuiItem(), const KGuiItem &user3=KGuiItem())

	KDialogBase (const TQString &caption, int buttonMask=Yes\|No\|Cancel, ButtonCode defaultButton=Yes, ButtonCode escapeButton=Cancel, TQWidget parent=0, const char name=0, bool modal=true, bool separator=false, const KGuiItem &yes=KStdGuiItem::yes(), const KGuiItem &no=KStdGuiItem::no(), const KGuiItem &cancel=KStdGuiItem::cancel())

	~KDialogBase ()

void	setButtonBoxOrientation (int orientation)

void	setEscapeButton (ButtonCode id)

virtual void	adjustSize ()

virtual TQSize	sizeHint () const

virtual TQSize	minimumSizeHint () const

TQFrame *	plainPage ()

TQFrame *	addPage (const TQString &itemName, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQFrame *	addPage (const TQStringList &items, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQVBox *	addVBoxPage (const TQString &itemName, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQVBox *	addVBoxPage (const TQStringList &items, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQHBox *	addHBoxPage (const TQString &itemName, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQHBox *	addHBoxPage (const TQStringList &items, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQGrid *	addGridPage (int n, Orientation dir, const TQString &itemName, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

TQGrid *	addGridPage (int n, Orientation dir, const TQStringList &items, const TQString &header=TQString::null, const TQPixmap &pixmap=TQPixmap())

void	setFolderIcon (const TQStringList &path, const TQPixmap &pixmap)

TQFrame *	makeMainWidget ()

TQVBox *	makeVBoxMainWidget ()

TQHBox *	makeHBoxMainWidget ()

TQGrid *	makeGridMainWidget (int n, Orientation dir)

void	enableButtonSeparator (bool state)

void	showButton (ButtonCode id, bool state)

void	showButtonOK (bool state)

void	showButtonApply (bool state)

void	showButtonCancel (bool state)

bool	showPage (int index)

int	activePageIndex () const

int	pageIndex (TQWidget *widget) const

void	setMainWidget (TQWidget *widget)

TQWidget *	mainWidget ()

void	disableResize ()

void	setInitialSize (const TQSize &s, bool noResize=false)

void	incInitialSize (const TQSize &s, bool noResize=false)

TQSize	configDialogSize (const TQString &groupName) const

TQSize	configDialogSize (TDEConfig &config, const TQString &groupName) const

void	saveDialogSize (const TQString &groupName, bool global=false)

void	saveDialogSize (TDEConfig &config, const TQString &groupName, bool global=false) const

void	setButtonOK (const KGuiItem &item=KStdGuiItem::ok())

void	setButtonOKText (const TQString &text=TQString::null, const TQString &tooltip=TQString::null, const TQString &quickhelp=TQString::null) TDE_DEPRECATED

void	setButtonApply (const KGuiItem &item=KStdGuiItem::apply())

void	setButtonApplyText (const TQString &text=TQString::null, const TQString &tooltip=TQString::null, const TQString &quickhelp=TQString::null) TDE_DEPRECATED

void	setButtonCancel (const KGuiItem &item=KStdGuiItem::cancel())

void	setButtonCancelText (const TQString &text=TQString::null, const TQString &tooltip=TQString::null, const TQString &quickhelp=TQString::null) TDE_DEPRECATED

void	setButtonText (ButtonCode id, const TQString &text)

void	setButtonTip (ButtonCode id, const TQString &text)

void	setButtonWhatsThis (ButtonCode id, const TQString &text)

void	setButtonGuiItem (ButtonCode id, const KGuiItem &item)

void	setTreeListAutoResize (bool state)

void	setShowIconsInTreeList (bool state)

void	setRootIsDecorated (bool state)

void	unfoldTreeList (bool persist=false)

void	addWidgetBelowList (TQWidget *widget)

void	addButtonBelowList (const TQString &text, TQObject recv, const char slot)

void	addButtonBelowList (const KGuiItem &guiitem, TQObject recv, const char slot)

void	setIconListAllVisible (bool state)

void	showTile (bool state)

void	getBorderWidths (int &ulx, int &uly, int &lrx, int &lry) const TDE_DEPRECATED

TQRect	getContentsRect () const TDE_DEPRECATED

TQSize	calculateSize (int w, int h) const

TQString	helpLinkText () const

TQPushButton *	actionButton (ButtonCode id)

Public Member Functions inherited from KDialog
	KDialog (TQWidget parent=0, const char name=0, bool modal=false, WFlags f=0)

Static Public Member Functions
static int	getFont (TQFont &theFont, bool onlyFixed=false, TQWidget parent=0L, bool makeFrame=true, TQButton::ToggleState sizeIsRelativeState=0L)

static int	getFontDiff (TQFont &theFont, int &diffFlags, bool onlyFixed=false, TQWidget parent=0L, bool makeFrame=true, TQButton::ToggleState sizeIsRelativeState=0L)

static int	getFontAndText (TQFont &theFont, TQString &theString, bool onlyFixed=false, TQWidget parent=0L, bool makeFrame=true, TQButton::ToggleState sizeIsRelativeState=0L)

Static Public Member Functions inherited from KDialogBase
static bool	haveBackgroundTile ()

static const TQPixmap *	backgroundTile ()

static const TQPixmap *	getBackgroundTile () TDE_DEPRECATED

static void	setBackgroundTile (const TQPixmap *pix)

Static Public Member Functions inherited from KDialog
static int	marginHint ()

static int	spacingHint ()

static void	resizeLayout (TQWidget *widget, int margin, int spacing)

static void	resizeLayout (TQLayoutItem *lay, int margin, int spacing)

static void	centerOnScreen (TQWidget *widget, int screen=-1)

static bool	avoidArea (TQWidget *widget, const TQRect &area, int screen=-1)

Protected Member Functions
virtual void	virtual_hook (int id, void *data)

Protected Member Functions inherited from KDialogBase
virtual void	keyPressEvent (TQKeyEvent *e)

virtual void	hideEvent (TQHideEvent *)

virtual void	closeEvent (TQCloseEvent *e)

virtual void	virtual_hook (int id, void *data)

virtual void	keyPressEvent (TQKeyEvent *)

virtual void	virtual_hook (int id, void *data)

Protected Attributes
TDEFontChooser *	chooser

Additional Inherited Members
Public Types inherited from KDialogBase
enum	ButtonCode { Help = 0x00000001 , Default = 0x00000002 , Ok = 0x00000004 , Apply = 0x00000008 , Try = 0x00000010 , Cancel = 0x00000020 , Close = 0x00000040 , User1 = 0x00000080 , User2 = 0x00000100 , User3 = 0x00000200 , No = 0x00000080 , Yes = 0x00000100 , Details = 0x00000400 , Filler = 0x40000000 , Stretch = 0x80000000 , NoDefault }

enum	ActionButtonStyle { ActionStyle0 =0 , ActionStyle1 , ActionStyle2 , ActionStyle3 , ActionStyle4 , ActionStyleMAX }

enum	DialogType { TreeList = KJanusWidget::TreeList , Tabbed = KJanusWidget::Tabbed , Plain = KJanusWidget::Plain , Swallow = KJanusWidget::Swallow , IconList = KJanusWidget::IconList }

Public Slots inherited from KDialogBase
void	enableButton (ButtonCode id, bool state)

void	enableButtonOK (bool state)

void	enableButtonApply (bool state)

void	enableButtonCancel (bool state)

void	enableLinkedHelp (bool state)

void	delayedDestruct ()

void	setHelpLinkText (const TQString &text)

void	setHelp (const TQString &anchor, const TQString &appname=TQString::null)

void	helpClickedSlot (const TQString &)

void	setDetails (bool showDetails)

void	setDetailsWidget (TQWidget *detailsWidget)

void	updateBackground ()

void	cancel ()

Public Slots inherited from KDialog
virtual void	polish ()

virtual void	setCaption (const TQString &caption)

virtual void	setPlainCaption (const TQString &caption)

Protected Slots inherited from KDialogBase
virtual void	slotHelp ()

virtual void	slotDefault ()

virtual void	slotDetails ()

virtual void	slotUser3 ()

virtual void	slotUser2 ()

virtual void	slotUser1 ()

virtual void	slotOk ()

virtual void	slotApply ()

virtual void	slotTry ()

virtual void	slotYes ()

virtual void	slotNo ()

virtual void	slotCancel ()

virtual void	slotClose ()

virtual void	applyPressed ()

void	updateGeometry ()

void	slotDelayedDestruct ()

Detailed Description

A font selection dialog.

The TDEFontDialog provides a dialog for interactive font selection. It is basically a thin wrapper around the TDEFontChooser widget, which can also be used standalone. In most cases, the simplest use of this class is the static method TDEFontDialog::getFont(), which pops up the dialog, allows the user to select a font, and returns when the dialog is closed.

Example:

TQFont myFont;
int result = TDEFontDialog::getFont( myFont );
if ( result == TDEFontDialog::Accepted )
      ...

KDE Font Dialog

Author: Preston Brown pbrow.nosp@m.n@kd.nosp@m.e.org, Bernd Wuebben wuebb.nosp@m.en@k.nosp@m.de.or.nosp@m.g

Version: $Id$

Definition at line 349 of file tdefontdialog.h.

Constructor & Destructor Documentation

◆ TDEFontDialog()

TDEFontDialog::TDEFontDialog	(	TQWidget *	parent = `0L`,
		const char *	name = `0`,
		bool	onlyFixed = `false`,
		bool	modal = `false`,
		const TQStringList &	fontlist = `TQStringList()`,
		bool	makeFrame = `true`,
		bool	diff = `false`,
		TQButton::ToggleState *	sizeIsRelativeState = `0L`
	)

Constructs a font selection dialog.

Parameters

parent	The parent widget of the dialog, if any.
name	The name of the dialog.
modal	Specifies whether the dialog is modal or not.
onlyFixed	only display fonts which have fixed-width character sizes.
fontlist	a list of fonts to display, in XLFD format. If no list is formatted, the internal KDE font list is used. If that has not been created, X is queried, and all fonts available on the system are displayed.
makeFrame	Draws a frame with titles around the contents.
diff	Display the difference version dialog. See getFontDiff().
sizeIsRelativeState	If not zero the widget will show a checkbox where the user may choose whether the font size is to be interpreted as relative size. Initial state of this checkbox will be set according to *sizeIsRelativeState, user choice may be retrieved by calling sizeIsRelative().

Definition at line 766 of file tdefontdialog.cpp.

Member Function Documentation

◆ font()

TQFont TDEFontDialog::font ( ) const

inline

Returns: The currently selected font in the dialog.

Definition at line 394 of file tdefontdialog.h.

◆ fontSelected

void TDEFontDialog::fontSelected ( const TQFont & font )

signal

Emitted whenever the currently selected font changes.

Connect to this to monitor the font as it is selected if you are not running modal.

◆ getFont()

int TDEFontDialog::getFont	(	TQFont &	theFont,
		bool	onlyFixed = `false`,
		TQWidget *	parent = `0L`,
		bool	makeFrame = `true`,
		TQButton::ToggleState *	sizeIsRelativeState = `0L`
	)

static

Creates a modal font dialog, lets the user choose a font, and returns when the dialog is closed.

Parameters

theFont	a reference to the font to write the chosen font into.
onlyFixed	if true, only select from fixed-width fonts.
parent	Parent widget of the dialog. Specifying a widget different from 0 (Null) improves centering (looks better).
makeFrame	Draws a frame with titles around the contents.
sizeIsRelativeState	If not zero the widget will show a checkbox where the user may choose whether the font size is to be interpreted as relative size. Initial state of this checkbox will be set according to *sizeIsRelativeState and user choice will be returned therein.

Returns: TQDialog::result().

Definition at line 798 of file tdefontdialog.cpp.

◆ getFontAndText()

int TDEFontDialog::getFontAndText	(	TQFont &	theFont,
		TQString &	theString,
		bool	onlyFixed = `false`,
		TQWidget *	parent = `0L`,
		bool	makeFrame = `true`,
		TQButton::ToggleState *	sizeIsRelativeState = `0L`
	)

static

When you are not only interested in the font selected, but also in the example string typed in, you can call this method.

Parameters

theFont	a reference to the font to write the chosen font into.
theString	a reference to the example text that was typed.
onlyFixed	if true, only select from fixed-width fonts.
parent	Parent widget of the dialog. Specifying a widget different from 0 (Null) improves centering (looks better).
makeFrame	Draws a frame with titles around the contents.
sizeIsRelativeState	If not zero the widget will show a checkbox where the user may choose whether the font size is to be interpreted as relative size. Initial state of this checkbox will be set according to *sizeIsRelativeState and user choice will be returned therein.

Returns: The result of the dialog.

Definition at line 817 of file tdefontdialog.cpp.

◆ getFontDiff()

int TDEFontDialog::getFontDiff	(	TQFont &	theFont,
		int &	diffFlags,
		bool	onlyFixed = `false`,
		TQWidget *	parent = `0L`,
		bool	makeFrame = `true`,
		TQButton::ToggleState *	sizeIsRelativeState = `0L`
	)

static

Creates a modal font difference dialog, lets the user choose a selection of changes that should be made to a set of fonts, and returns when the dialog is closed.

Useful for choosing slight adjustments to the font set when the user would otherwise have to manually edit a number of fonts.

Parameters

theFont	a reference to the font to write the chosen font into.
diffFlags	a reference to the int into which the chosen difference selection bitmask should be written. Check the returned bitmask like: if ( diffFlags & TDEFontChooser::FontDiffFamily ) [...] if ( diffFlags & TDEFontChooser::FontDiffStyle ) [...] if ( diffFlags & TDEFontChooser::FontDiffSize ) [...]
onlyFixed	if true, only select from fixed-width fonts.
parent	Parent widget of the dialog. Specifying a widget different from 0 (Null) improves centering (looks better).
makeFrame	Draws a frame with titles around the contents.
sizeIsRelativeState	If not zero the widget will show a checkbox where the user may choose whether the font size is to be interpreted as relative size. Initial state of this checkbox will be set according to *sizeIsRelativeState and user choice will be returned therein.

Returns: TQDialog::result().

Definition at line 779 of file tdefontdialog.cpp.

◆ setFont()

void TDEFontDialog::setFont	(	const TQFont &	font,
		bool	onlyFixed = `false`
	)

inline

Sets the currently selected font in the dialog.

Parameters

font	The font to select.
onlyFixed	readjust the font list to display only fixed width fonts if true, or vice-versa

Definition at line 388 of file tdefontdialog.h.

◆ setSizeIsRelative()

void TDEFontDialog::setSizeIsRelative ( TQButton::ToggleState relative )

inline

Sets the state of the checkbox indicating whether the font size is to be interpreted as relative size.

NOTE: If parameter sizeIsRelative was not set in the constructor of the dialog this setting will be ignored.

Definition at line 402 of file tdefontdialog.h.

◆ sizeIsRelative()

TQButton::ToggleState TDEFontDialog::sizeIsRelative ( ) const

inline

Returns: Whether the font size is to be interpreted as relative size (default: false)

Definition at line 409 of file tdefontdialog.h.

◆ virtual_hook()

void TDEFontDialog::virtual_hook	(	int	id,
		void *	data
	)

protectedvirtual

Reimplemented from KDialogBase.

Definition at line 840 of file tdefontdialog.cpp.

Member Data Documentation

◆ chooser

TDEFontChooser* TDEFontDialog::chooser

protected

Definition at line 504 of file tdefontdialog.h.

The documentation for this class was generated from the following files:

tdeui

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TDEFontDialog()

Member Function Documentation

◆ font()

◆ fontSelected

◆ getFont()

◆ getFontAndText()

◆ getFontDiff()

◆ setFont()

◆ setSizeIsRelative()

◆ sizeIsRelative()

◆ virtual_hook()

Member Data Documentation

◆ chooser

tdeui

tdeui