org.kde.koala

Class KFontDialog

public class KFontDialog extends KDialogBase

The KFontDialog provides a dialog for interactive font selection. It is basically a thin wrapper around the KFontChooser widget, which can also be used standalone. In most cases, the simplest use of this class is the static method KFontDialog.getFont(), which pops up the dialog, allows the user to select a font, and returns when the dialog is closed. Example:
      QFont myFont;
      int result = KFontDialog.getFont( myFont );
      if ( result == KFontDialog.Accepted )
            ...
 
\image html kfontdialog.png "KDE Font Dialog" See KFontDialogSignals for signals emitted by KFontDialog

Version: $Id: KFontDialog.java 473384 2005-10-23 14:17:09Z rdale $

Author: Preston Brown , Bernd Wuebben

UNKNOWN: A font selection dialog.

Constructor Summary
protected KFontDialog(Class dummy)
KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist, boolean makeFrame, boolean diff, int sizeIsRelativeState)
Constructs a font selection dialog.
KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist, boolean makeFrame, boolean diff)
KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist, boolean makeFrame)
KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist)
KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal)
KFontDialog(QWidget parent, String name, boolean onlyFixed)
KFontDialog(QWidget parent, String name)
KFontDialog(QWidget parent)
KFontDialog()
Method Summary
StringclassName()
voiddispose()
Delete the wrapped C++ instance ahead of finalize()
protected voidfinalize()
Deletes the wrapped C++ instance
QFontfont()
static intgetFont(QFont theFont, boolean onlyFixed, QWidget parent, boolean makeFrame, int sizeIsRelativeState)
Creates a modal font dialog, lets the user choose a font, and returns when the dialog is closed.
static intgetFont(QFont theFont, boolean onlyFixed, QWidget parent, boolean makeFrame)
static intgetFont(QFont theFont, boolean onlyFixed, QWidget parent)
static intgetFont(QFont theFont, boolean onlyFixed)
static intgetFont(QFont theFont)
static intgetFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed, QWidget parent, boolean makeFrame, int sizeIsRelativeState)
When you are not only interested in the font selected, but also in the example string typed in, you can call this method.
static intgetFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed, QWidget parent, boolean makeFrame)
static intgetFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed, QWidget parent)
static intgetFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed)
static intgetFontAndText(QFont theFont, StringBuffer theString)
static intgetFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed, QWidget parent, boolean makeFrame, int sizeIsRelativeState)
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.
static intgetFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed, QWidget parent, boolean makeFrame)
static intgetFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed, QWidget parent)
static intgetFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed)
static intgetFontDiff(QFont theFont, int[] diffFlags)
booleanisDisposed()
Has the wrapped C++ instance been deleted?
QMetaObjectmetaObject()
voidsetFont(QFont font, boolean onlyFixed)
Sets the currently selected font in the dialog.
voidsetFont(QFont font)
voidsetSizeIsRelative(int relative)
Sets the state of the checkbox indicating whether the font size is to be interpreted as relative size.
intsizeIsRelative()

Constructor Detail

KFontDialog

protected KFontDialog(Class dummy)

KFontDialog

public KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist, boolean makeFrame, boolean diff, int sizeIsRelativeState)
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().

UNKNOWN: Constructs a font selection dialog.

KFontDialog

public KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist, boolean makeFrame, boolean diff)

KFontDialog

public KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist, boolean makeFrame)

KFontDialog

public KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal, String[] fontlist)

KFontDialog

public KFontDialog(QWidget parent, String name, boolean onlyFixed, boolean modal)

KFontDialog

public KFontDialog(QWidget parent, String name, boolean onlyFixed)

KFontDialog

public KFontDialog(QWidget parent, String name)

KFontDialog

public KFontDialog(QWidget parent)

KFontDialog

public KFontDialog()

Method Detail

className

public String className()

dispose

public void dispose()
Delete the wrapped C++ instance ahead of finalize()

finalize

protected void finalize()
Deletes the wrapped C++ instance

font

public QFont font()

Returns: The currently selected font in the dialog.

UNKNOWN:

getFont

public static int getFont(QFont theFont, boolean onlyFixed, QWidget parent, boolean makeFrame, int sizeIsRelativeState)
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: QDialog.result().

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

getFont

public static int getFont(QFont theFont, boolean onlyFixed, QWidget parent, boolean makeFrame)

getFont

public static int getFont(QFont theFont, boolean onlyFixed, QWidget parent)

getFont

public static int getFont(QFont theFont, boolean onlyFixed)

getFont

public static int getFont(QFont theFont)

getFontAndText

public static int getFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed, QWidget parent, boolean makeFrame, int sizeIsRelativeState)
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.

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

getFontAndText

public static int getFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed, QWidget parent, boolean makeFrame)

getFontAndText

public static int getFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed, QWidget parent)

getFontAndText

public static int getFontAndText(QFont theFont, StringBuffer theString, boolean onlyFixed)

getFontAndText

public static int getFontAndText(QFont theFont, StringBuffer theString)

getFontDiff

public static int getFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed, QWidget parent, boolean makeFrame, int sizeIsRelativeState)
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 & KFontChooser.FontDiffFamily )
		            [...]
		        if ( diffFlags & KFontChooser.FontDiffStyle )
		            [...]
		        if ( diffFlags & KFontChooser.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: QDialog.result().

UNKNOWN: 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.

getFontDiff

public static int getFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed, QWidget parent, boolean makeFrame)

getFontDiff

public static int getFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed, QWidget parent)

getFontDiff

public static int getFontDiff(QFont theFont, int[] diffFlags, boolean onlyFixed)

getFontDiff

public static int getFontDiff(QFont theFont, int[] diffFlags)

isDisposed

public boolean isDisposed()
Has the wrapped C++ instance been deleted?

metaObject

public QMetaObject metaObject()

setFont

public void setFont(QFont font, boolean onlyFixed)
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

UNKNOWN: Sets the currently selected font in the dialog.

setFont

public void setFont(QFont font)

setSizeIsRelative

public void setSizeIsRelative(int relative)
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.

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

sizeIsRelative

public int sizeIsRelative()

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

UNKNOWN: