Qt 4.8
Public Types | Public Functions | Static Public Functions | Private Functions | Properties | Friends | List of all members
QFont Class Reference

The QFont class specifies a font used for drawing text. More...

#include <qfont.h>

Public Types

enum  Capitalization {
  MixedCase, AllUppercase, AllLowercase, SmallCaps,
  Capitalize
}
 Rendering option for text this font applies to. More...
 
enum  HintingPreference { PreferDefaultHinting = 0, PreferNoHinting = 1, PreferVerticalHinting = 2, PreferFullHinting = 3 }
 This enum describes the different levels of hinting that can be applied to glyphs to improve legibility on displays where it might be warranted by the density of pixels. More...
 
enum  ResolveProperties {
  FamilyResolved = 0x0001, SizeResolved = 0x0002, StyleHintResolved = 0x0004, StyleStrategyResolved = 0x0008,
  WeightResolved = 0x0010, StyleResolved = 0x0020, UnderlineResolved = 0x0040, OverlineResolved = 0x0080,
  StrikeOutResolved = 0x0100, FixedPitchResolved = 0x0200, StretchResolved = 0x0400, KerningResolved = 0x0800,
  CapitalizationResolved = 0x1000, LetterSpacingResolved = 0x2000, WordSpacingResolved = 0x4000, HintingPreferenceResolved = 0x8000,
  StyleNameResolved = 0x10000, AllPropertiesResolved = 0x1ffff
}
 This enum describes the properties of a QFont that can be set on a font individually and then considered resolved. More...
 
enum  SpacingType { PercentageSpacing, AbsoluteSpacing }
 
enum  Stretch {
  UltraCondensed = 50, ExtraCondensed = 62, Condensed = 75, SemiCondensed = 87,
  Unstretched = 100, SemiExpanded = 112, Expanded = 125, ExtraExpanded = 150,
  UltraExpanded = 200
}
 Predefined stretch values that follow the CSS naming convention. More...
 
enum  Style { StyleNormal, StyleItalic, StyleOblique }
 This enum describes the different styles of glyphs that are used to display text. More...
 
enum  StyleHint {
  Helvetica, SansSerif = Helvetica, Times, Serif = Times,
  Courier, TypeWriter = Courier, OldEnglish, Decorative = OldEnglish,
  System, AnyStyle, Cursive, Monospace,
  Fantasy
}
 Style hints are used by the font matching algorithm to find an appropriate default family if a selected font family is not available. More...
 
enum  StyleStrategy {
  PreferDefault = 0x0001, PreferBitmap = 0x0002, PreferDevice = 0x0004, PreferOutline = 0x0008,
  ForceOutline = 0x0010, PreferMatch = 0x0020, PreferQuality = 0x0040, PreferAntialias = 0x0080,
  NoAntialias = 0x0100, OpenGLCompatible = 0x0200, ForceIntegerMetrics = 0x0400, NoFontMerging = 0x8000
}
 The style strategy tells the font matching algorithm what type of fonts should be used to find an appropriate default family. More...
 
enum  Weight {
  Light = 25, Normal = 50, DemiBold = 63, Bold = 75,
  Black = 87
}
 Qt uses a weighting scale from 0 to 99 similar to, but not the same as, the scales used in Windows or CSS. More...
 

Public Functions

bool bold () const
 Returns true if weight() is a value greater than QFont::Normal ; otherwise returns false. More...
 
Capitalization capitalization () const
 Returns the current capitalization type of the font. More...
 
QString defaultFamily () const
 Returns the family name that corresponds to the current style hint. More...
 
bool exactMatch () const
 Returns true if a window system font exactly matching the settings of this font is available. More...
 
QString family () const
 Returns the requested font family name, i.e. More...
 
bool fixedPitch () const
 Returns true if fixed pitch has been set; otherwise returns false. More...
 
FT_Face freetypeFace () const
 Returns the handle to the primary FreeType face of the font. More...
 
bool fromString (const QString &)
 Sets this font to match the description descrip. More...
 
HFONT handle () const
 Returns the window system handle to the font, for low-level access. More...
 
HintingPreference hintingPreference () const
 Returns the currently preferred hinting level for glyphs rendered with this font. More...
 
bool isCopyOf (const QFont &) const
 Returns true if this font and f are copies of each other, i.e. More...
 
bool italic () const
 Returns true if the style() of the font is not QFont::StyleNormal. More...
 
bool kerning () const
 Returns true if kerning should be used when drawing text with this font. More...
 
QString key () const
 Returns the font's key, a textual representation of a font. More...
 
QString lastResortFamily () const
 Returns the "last resort" font family name. More...
 
QString lastResortFont () const
 Returns a "last resort" font name for the font matching algorithm. More...
 
qreal letterSpacing () const
 Returns the letter spacing for the font. More...
 
SpacingType letterSpacingType () const
 Returns the spacing type used for letter spacing. More...
 
quint32 macFontID () const
 Returns an ATSUFontID. More...
 
 operator QVariant () const
 Returns the font as a QVariant. More...
 
bool operator!= (const QFont &) const
 Returns true if this font is different from f; otherwise returns false. More...
 
bool operator< (const QFont &) const
 Provides an arbitrary comparison of this font and font f. More...
 
QFontoperator= (const QFont &)
 Assigns font to this font and returns a reference to it. More...
 
bool operator== (const QFont &) const
 Returns true if this font is equal to f; otherwise returns false. More...
 
bool overline () const
 Returns true if overline has been set; otherwise returns false. More...
 
int pixelSize () const
 Returns the pixel size of the font if it was set with setPixelSize(). More...
 
int pointSize () const
 Returns the point size of the font. More...
 
qreal pointSizeF () const
 Returns the point size of the font. More...
 
 QFont ()
 Constructs a font object that uses the application's default font. More...
 
 QFont (const QString &family, int pointSize=-1, int weight=-1, bool italic=false)
 Constructs a font object with the specified family, pointSize, weight and italic settings. More...
 
 QFont (const QFont &, QPaintDevice *pd)
 Constructs a font from font for use on the paint device pd. More...
 
 QFont (const QFont &)
 Constructs a font that is a copy of font. More...
 
bool rawMode () const
 Returns true if raw mode is used for font name matching; otherwise returns false. More...
 
QString rawName () const
 Returns the name of the font within the underlying window system. More...
 
QFont resolve (const QFont &) const
 Returns a new QFont that has attributes copied from other that have not been previously set on this font. More...
 
uint resolve () const
 
void resolve (uint mask)
 
void setBold (bool)
 If enable is true sets the font's weight to QFont::Bold ; otherwise sets the weight to QFont::Normal. More...
 
void setCapitalization (Capitalization)
 Sets the capitalization of the text in this font to caps. More...
 
void setFamily (const QString &)
 Sets the family name of the font. More...
 
void setFixedPitch (bool)
 If enable is true, sets fixed pitch on; otherwise sets fixed pitch off. More...
 
void setHintingPreference (HintingPreference hintingPreference)
 Set the preference for the hinting level of the glyphs to hintingPreference. More...
 
void setItalic (bool b)
 Sets the style() of the font to QFont::StyleItalic if enable is true; otherwise the style is set to QFont::StyleNormal. More...
 
void setKerning (bool)
 Enables kerning for this font if enable is true; otherwise disables it. More...
 
void setLetterSpacing (SpacingType type, qreal spacing)
 Sets the letter spacing for the font to spacing and the type of spacing to type. More...
 
void setOverline (bool)
 If enable is true, sets overline on; otherwise sets overline off. More...
 
void setPixelSize (int)
 Sets the font size to pixelSize pixels. More...
 
void setPointSize (int)
 Sets the point size to pointSize. More...
 
void setPointSizeF (qreal)
 Sets the point size to pointSize. More...
 
void setRawMode (bool)
 If enable is true, turns raw mode on; otherwise turns raw mode off. More...
 
void setRawName (const QString &)
 Sets a font by its system specific name. More...
 
void setStretch (int)
 Sets the stretch factor for the font. More...
 
void setStrikeOut (bool)
 If enable is true, sets strikeout on; otherwise sets strikeout off. More...
 
void setStyle (Style style)
 Sets the style of the font to style. More...
 
void setStyleHint (StyleHint, StyleStrategy=PreferDefault)
 Sets the style hint and strategy to hint and strategy, respectively. More...
 
void setStyleName (const QString &)
 Sets the style name of the font to the given styleName. More...
 
void setStyleStrategy (StyleStrategy s)
 Sets the style strategy for the font to s. More...
 
void setUnderline (bool)
 If enable is true, sets underline on; otherwise sets underline off. More...
 
void setWeight (int)
 Sets the weight the font to weight, which should be a value from the QFont::Weight enumeration. More...
 
void setWordSpacing (qreal spacing)
 Sets the word spacing for the font to spacing. More...
 
int stretch () const
 Returns the stretch factor for the font. More...
 
bool strikeOut () const
 Returns true if strikeout has been set; otherwise returns false. More...
 
Style style () const
 Returns the style of the font. More...
 
StyleHint styleHint () const
 Returns the StyleHint. More...
 
QString styleName () const
 Returns the requested font style name, it will be used to match the font with irregular styles (that can't be normalized in other style properties). More...
 
StyleStrategy styleStrategy () const
 Returns the StyleStrategy. More...
 
QString toString () const
 Returns a description of the font. More...
 
bool underline () const
 Returns true if underline has been set; otherwise returns false. More...
 
int weight () const
 Returns the weight of the font which is one of the enumerated values from QFont::Weight. More...
 
qreal wordSpacing () const
 Returns the word spacing for the font. More...
 
 ~QFont ()
 Destroys the font object and frees all allocated resources. More...
 

Static Public Functions

static void cleanup ()
 Internal function that cleans up the font system. More...
 
static void initialize ()
 Internal function that initializes the font system. More...
 
static void insertSubstitution (const QString &, const QString &)
 Inserts substituteName into the substitution table for the family familyName. More...
 
static void insertSubstitutions (const QString &, const QStringList &)
 Inserts the list of families substituteNames into the substitution list for familyName. More...
 
static void removeSubstitution (const QString &)
 Removes all the substitutions for familyName. More...
 
static QString substitute (const QString &)
 Returns the first family name to be used whenever familyName is specified. More...
 
static QStringList substitutes (const QString &)
 Returns a list of family names to be used whenever familyName is specified. More...
 
static QStringList substitutions ()
 Returns a sorted list of substituted family names. More...
 

Private Functions

void detach ()
 Detaches the font object from common font data. More...
 
void macSetFont (QPaintDevice *)
 
 QFont (QFontPrivate *)
 

Properties

QExplicitlySharedDataPointer< QFontPrivated
 
uint resolve_mask
 

Friends

Q_GUI_EXPORT QDataStreamoperator<< (QDataStream &, const QFont &)
 Writes the font font to the data stream s. More...
 
Q_GUI_EXPORT QDataStreamoperator>> (QDataStream &, QFont &)
 Reads the font font from the data stream s. More...
 
class Q3TextFormatCollection
 
class QAlphaPaintEngine
 
class QApplication
 
class QCommandLinkButtonPrivate
 
class QFontDialogPrivate
 
class QFontEngine
 
class QFontInfo
 
class QFontMetrics
 
class QFontMetricsF
 
class QFontPrivate
 
class QGLContext
 
class QPaintBufferEngine
 
class QPainter
 
class QPainterPath
 
class QPainterPrivate
 
class QPainterReplayer
 
class QPicturePaintEngine
 
class QPSPrintEngineFont
 
struct QScriptLine
 
class QStackTextEngine
 
class QTextEngine
 
class QTextItemInt
 
class QTextLayout
 
class QTextLine
 
class QWidget
 
class QWidgetPrivate
 
class QWin32PaintEngine
 

Detailed Description

The QFont class specifies a font used for drawing text.

Note
This class or function is reentrant.

When you create a QFont object you specify various attributes that you want the font to have. Qt will use the font with the specified attributes, or if no matching font exists, Qt will use the closest matching installed font. The attributes of the font that is actually used are retrievable from a QFontInfo object. If the window system provides an exact match exactMatch() returns true. Use QFontMetrics to get measurements, e.g. the pixel length of a string using QFontMetrics::width().

Note that a QApplication instance must exist before a QFont can be used. You can set the application's default font with QApplication::setFont().

If a chosen font does not include all the characters that need to be displayed, QFont will try to find the characters in the nearest equivalent fonts. When a QPainter draws a character from a font the QFont will report whether or not it has the character; if it does not, QPainter will draw an unfilled square.

Create QFonts like this:

QFont serifFont("Times", 10, QFont::Bold);
QFont sansFont("Helvetica [Cronyx]", 12);

The attributes set in the constructor can also be set later, e.g. setFamily(), setPointSize(), setPointSizeFloat(), setWeight() and setItalic(). The remaining attributes must be set after contstruction, e.g. setBold(), setUnderline(), setOverline(), setStrikeOut() and setFixedPitch(). QFontInfo objects should be created after the font's attributes have been set. A QFontInfo object will not change, even if you change the font's attributes. The corresponding "get" functions, e.g. family(), pointSize(), etc., return the values that were set, even though the values used may differ. The actual values are available from a QFontInfo object.

If the requested font family is unavailable you can influence the font matching algorithm by choosing a particular QFont::StyleHint and QFont::StyleStrategy with setStyleHint(). The default family (corresponding to the current style hint) is returned by defaultFamily().

The font-matching algorithm has a lastResortFamily() and lastResortFont() in cases where a suitable match cannot be found. You can provide substitutions for font family names using insertSubstitution() and insertSubstitutions(). Substitutions can be removed with removeSubstitution(). Use substitute() to retrieve a family's first substitute, or the family name itself if it has no substitutes. Use substitutes() to retrieve a list of a family's substitutes (which may be empty).

Every QFont has a key() which you can use, for example, as the key in a cache or dictionary. If you want to store a user's font preferences you could use QSettings, writing the font information with toString() and reading it back with fromString(). The operator<<() and operator>>() functions are also available, but they work on a data stream.

It is possible to set the height of characters shown on the screen to a specified number of pixels with setPixelSize(); however using setPointSize() has a similar effect and provides device independence.

In X11 you can set a font using its system specific name with setRawName().

Loading fonts can be expensive, especially on X11. QFont contains extensive optimizations to make the copying of QFont objects fast, and to cache the results of the slow window system functions it depends upon.

The font matching algorithm works as follows:

  1. The specified font family is searched for.
  2. If not found, the styleHint() is used to select a replacement family.
  3. Each replacement font family is searched for.
  4. If none of these are found or there was no styleHint(), "helvetica" will be searched for.
  5. If "helvetica" isn't found Qt will try the lastResortFamily().
  6. If the lastResortFamily() isn't found Qt will try the lastResortFont() which will always return a name of some kind.

Note that the actual font matching algorithm varies from platform to platform.

In Windows a request for the "Courier" font is automatically changed to "Courier New", an improved version of Courier that allows for smooth scaling. The older "Courier" bitmap font can be selected by setting the PreferBitmap style strategy (see setStyleStrategy()).

Once a font is found, the remaining attributes are matched in order of priority:

  1. fixedPitch()
  2. pointSize() (see below)
  3. weight()
  4. style()

If you have a font which matches on family, even if none of the other attributes match, this font will be chosen in preference to a font which doesn't match on family but which does match on the other attributes. This is because font family is the dominant search criteria.

The point size is defined to match if it is within 20% of the requested point size. When several fonts match and are only distinguished by point size, the font with the closest point size to the one requested will be chosen.

The actual family, font size, weight and other font attributes used for drawing text will depend on what's available for the chosen family under the window system. A QFontInfo object can be used to determine the actual values used for drawing the text.

Examples:

QFont f("Helvetica");

If you had both an Adobe and a Cronyx Helvetica, you might get either.

QFont f("Helvetica [Cronyx]");

You can specify the foundry you want in the family name. The font f in the above example will be set to "Helvetica [Cronyx]".

To determine the attributes of the font actually used in the window system, use a QFontInfo object, e.g.

QString family = info.family();

To find out font metrics use a QFontMetrics object, e.g.

QFontMetrics fm(f1);
int textWidthInPixels = fm.width("How many pixels wide is this text?");
int textHeightInPixels = fm.height();

For more general information on fonts, see the http://nwalsh.com/comp.fonts/FAQ/ . Information on encodings can be found from http://czyborra.com/ Roman Czyborra's page.

See also
QFontComboBox, QFontMetrics, QFontInfo, QFontDatabase, {Character Map Example}

Definition at line 64 of file qfont.h.

Enumerations

◆ Capitalization

Rendering option for text this font applies to.

Since
4.4
  • MixedCase This is the normal text rendering option where no capitalization change is applied.
  • AllUppercase This alters the text to be rendered in all uppercase type.
  • AllLowercase This alters the text to be rendered in all lowercase type.
  • SmallCaps This alters the text to be rendered in small-caps type.
  • Capitalize This alters the text to be rendered with the first character of each word as an uppercase character.
Enumerator
MixedCase 
AllUppercase 
AllLowercase 
SmallCaps 
Capitalize 

Definition at line 129 of file qfont.h.

◆ HintingPreference

This enum describes the different levels of hinting that can be applied to glyphs to improve legibility on displays where it might be warranted by the density of pixels.

Since
4.8
  • PreferDefaultHinting Use the default hinting level for the target platform.
  • PreferNoHinting If possible, render text without hinting the outlines of the glyphs. The text layout will be typographically accurate and scalable, using the same metrics as are used e.g. when printing.
  • PreferVerticalHinting If possible, render text with no horizontal hinting, but align glyphs to the pixel grid in the vertical direction. The text will appear crisper on displays where the density is too low to give an accurate rendering of the glyphs. But since the horizontal metrics of the glyphs are unhinted, the text's layout will be scalable to higher density devices (such as printers) without impacting details such as line breaks.
  • PreferFullHinting If possible, render text with hinting in both horizontal and vertical directions. The text will be altered to optimize legibility on the target device, but since the metrics will depend on the target size of the text, the positions of glyphs, line breaks, and other typographical detail will not scale, meaning that a text layout may look different on devices with different pixel densities.

Please note that this enum only describes a preference, as the full range of hinting levels are not supported on all of Qt's supported platforms. The following table details the effect of a given hinting preference on a selected set of target platforms.

PreferDefaultHinting PreferNoHinting PreferVerticalHinting PreferFullHinting
Windows Vista (w/o Platform Update) and earlier Full hinting Full hinting Full hinting Full hinting
Windows 7 and Windows Vista (w/Platform Update) and DirectWrite enabled in Qt Full hinting Vertical hinting Vertical hinting Full hinting
FreeType Operating System setting No hinting Vertical hinting (light) Full hinting
Cocoa on Mac OS X No hinting No hinting No hinting No hinting
Note
Please be aware that altering the hinting preference on Windows is available through the DirectWrite font engine. This is available on Windows Vista after installing the platform update, and on Windows 7. In order to use this extension, configure Qt using -directwrite. The target application will then depend on the availability of DirectWrite on the target system.
Enumerator
PreferDefaultHinting 
PreferNoHinting 
PreferVerticalHinting 
PreferFullHinting 

Definition at line 96 of file qfont.h.

◆ ResolveProperties

This enum describes the properties of a QFont that can be set on a font individually and then considered resolved.

Warning
This function is not part of the public interface.
  • FamilyResolved
  • SizeResolved
  • StyleHintResolved
  • StyleStrategyResolved
  • WeightResolved
  • StyleResolved
  • UnderlineResolved
  • OverlineResolved
  • StrikeOutResolved
  • FixedPitchResolved
  • StretchResolved
  • KerningResolved
  • CapitalizationResolved
  • LetterSpacingResolved
  • WordSpacingResolved
  • CompletelyResolved
Enumerator
FamilyResolved 
SizeResolved 
StyleHintResolved 
StyleStrategyResolved 
WeightResolved 
StyleResolved 
UnderlineResolved 
OverlineResolved 
StrikeOutResolved 
FixedPitchResolved 
StretchResolved 
KerningResolved 
CapitalizationResolved 
LetterSpacingResolved 
WordSpacingResolved 
HintingPreferenceResolved 
StyleNameResolved 
AllPropertiesResolved 

Definition at line 142 of file qfont.h.

142  {
143  FamilyResolved = 0x0001,
144  SizeResolved = 0x0002,
145  StyleHintResolved = 0x0004,
146  StyleStrategyResolved = 0x0008,
147  WeightResolved = 0x0010,
148  StyleResolved = 0x0020,
149  UnderlineResolved = 0x0040,
150  OverlineResolved = 0x0080,
151  StrikeOutResolved = 0x0100,
152  FixedPitchResolved = 0x0200,
153  StretchResolved = 0x0400,
154  KerningResolved = 0x0800,
155  CapitalizationResolved = 0x1000,
156  LetterSpacingResolved = 0x2000,
157  WordSpacingResolved = 0x4000,
158  HintingPreferenceResolved = 0x8000,
159  StyleNameResolved = 0x10000,
160  AllPropertiesResolved = 0x1ffff
161  };

◆ SpacingType

Since
4.4
  • PercentageSpacing A value of 100 will keep the spacing unchanged; a value of 200 will enlarge the spacing after a character by the width of the character itself.
  • AbsoluteSpacing A positive value increases the letter spacing by the corresponding pixels; a negative value decreases the spacing.
Enumerator
PercentageSpacing 
AbsoluteSpacing 

Definition at line 137 of file qfont.h.

◆ Stretch

Predefined stretch values that follow the CSS naming convention.

The higher the value, the more stretched the text is.

  • UltraCondensed 50
  • ExtraCondensed 62
  • Condensed 75
  • SemiCondensed 87
  • Unstretched 100
  • SemiExpanded 112
  • Expanded 125
  • ExtraExpanded 150
  • UltraExpanded 200
See also
setStretch() stretch()
Enumerator
UltraCondensed 
ExtraCondensed 
Condensed 
SemiCondensed 
Unstretched 
SemiExpanded 
Expanded 
ExtraExpanded 
UltraExpanded 

Definition at line 117 of file qfont.h.

117  {
118  UltraCondensed = 50,
119  ExtraCondensed = 62,
120  Condensed = 75,
121  SemiCondensed = 87,
122  Unstretched = 100,
123  SemiExpanded = 112,
124  Expanded = 125,
125  ExtraExpanded = 150,
126  UltraExpanded = 200
127  };

◆ Style

This enum describes the different styles of glyphs that are used to display text.

  • StyleNormal Normal glyphs used in unstyled text.
  • StyleItalic Italic glyphs that are specifically designed for the purpose of representing italicized text.
  • StyleOblique Glyphs with an italic appearance that are typically based on the unstyled glyphs, but are not fine-tuned for the purpose of representing italicized text.
See also
Weight
Enumerator
StyleNormal 
StyleItalic 
StyleOblique 

Definition at line 111 of file qfont.h.

◆ StyleHint

Style hints are used by the font matching algorithm to find an appropriate default family if a selected font family is not available.

  • AnyStyle leaves the font matching algorithm to choose the family. This is the default.
  • SansSerif the font matcher prefer sans serif fonts.
  • Helvetica is a synonym for SansSerif.
  • Serif the font matcher prefers serif fonts.
  • Times is a synonym for Serif.
  • TypeWriter the font matcher prefers fixed pitch fonts.
  • Courier a synonym for TypeWriter.
  • OldEnglish the font matcher prefers decorative fonts.
  • Decorative is a synonym for OldEnglish.
  • Monospace the font matcher prefers fonts that map to the CSS generic font-family 'monospace'.
  • Fantasy the font matcher prefers fonts that map to the CSS generic font-family 'fantasy'.
  • Cursive the font matcher prefers fonts that map to the CSS generic font-family 'cursive'.
  • System the font matcher prefers system fonts.
Enumerator
Helvetica 
SansSerif 
Times 
Serif 
Courier 
TypeWriter 
OldEnglish 
Decorative 
System 
AnyStyle 
Cursive 
Monospace 
Fantasy 

Definition at line 69 of file qfont.h.

◆ StyleStrategy

The style strategy tells the font matching algorithm what type of fonts should be used to find an appropriate default family.

The following strategies are available:

  • PreferDefault the default style strategy. It does not prefer any type of font.
  • PreferBitmap prefers bitmap fonts (as opposed to outline fonts).
  • PreferDevice prefers device fonts.
  • PreferOutline prefers outline fonts (as opposed to bitmap fonts).
  • ForceOutline forces the use of outline fonts.
  • NoAntialias don't antialias the fonts.
  • PreferAntialias antialias if possible.
  • OpenGLCompatible forces the use of OpenGL compatible fonts.
  • NoFontMerging If the font selected for a certain writing system does not contain a character requested to draw, then Qt automatically chooses a similar looking font that contains the character. The NoFontMerging flag disables this feature. Please note that enabling this flag will not prevent Qt from automatically picking a suitable font when the selected font does not support the writing system of the text.

Any of these may be OR-ed with one of these flags:

  • PreferMatch prefer an exact match. The font matcher will try to use the exact font size that has been specified.
  • PreferQuality prefer the best quality font. The font matcher will use the nearest standard point size that the font supports.
  • ForceIntegerMetrics forces the use of integer values in font engines that support fractional font metrics.
Enumerator
PreferDefault 
PreferBitmap 
PreferDevice 
PreferOutline 
ForceOutline 
PreferMatch 
PreferQuality 
PreferAntialias 
NoAntialias 
OpenGLCompatible 
ForceIntegerMetrics 
NoFontMerging 

Definition at line 81 of file qfont.h.

81  {
82  PreferDefault = 0x0001,
83  PreferBitmap = 0x0002,
84  PreferDevice = 0x0004,
85  PreferOutline = 0x0008,
86  ForceOutline = 0x0010,
87  PreferMatch = 0x0020,
88  PreferQuality = 0x0040,
89  PreferAntialias = 0x0080,
90  NoAntialias = 0x0100,
91  OpenGLCompatible = 0x0200,
92  ForceIntegerMetrics = 0x0400,
93  NoFontMerging = 0x8000
94  };

◆ Weight

Qt uses a weighting scale from 0 to 99 similar to, but not the same as, the scales used in Windows or CSS.

A weight of 0 is ultralight, whilst 99 will be an extremely black.

This enum contains the predefined font weights:

  • Light 25
  • Normal 50
  • DemiBold 63
  • Bold 75
  • Black 87
Enumerator
Light 
Normal 
DemiBold 
Bold 
Black 

Definition at line 103 of file qfont.h.

103  {
104  Light = 25,
105  Normal = 50,
106  DemiBold = 63,
107  Bold = 75,
108  Black = 87
109  };

Constructors and Destructors

◆ QFont() [1/5]

QFont::QFont ( )

Constructs a font object that uses the application's default font.

See also
QApplication::setFont(), QApplication::font()

Definition at line 823 of file qfont.cpp.

825 {
826 }
static QFont font()
Returns the default application font.
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ QFont() [2/5]

QFont::QFont ( const QString family,
int  pointSize = -1,
int  weight = -1,
bool  italic = false 
)

Constructs a font object with the specified family, pointSize, weight and italic settings.

If pointSize is zero or negative, the point size of the font is set to a system-dependent default value. Generally, this is 12 points, except on Symbian where it is 7 points.

The family name may optionally also include a foundry name, e.g. "Helvetica [Cronyx]". If the family is available from more than one foundry and the foundry isn't specified, an arbitrary foundry is chosen. If the family isn't available a family will be set using the font matching algorithm.

See also
Weight, setFamily(), setPointSize(), setWeight(), setItalic(), setStyleHint() QApplication::font()

Definition at line 846 of file qfont.cpp.

848 {
849  if (pointSize <= 0) {
850 #ifdef Q_OS_SYMBIAN
851  pointSize = 7;
852 #else
853  pointSize = 12;
854 #endif
855  } else {
857  }
858 
859  if (weight < 0) {
860  weight = Normal;
861  } else {
863  }
864 
865  if (italic)
867 
868  d->request.family = family;
870  d->request.pixelSize = -1;
871  d->request.weight = weight;
873 }
double qreal
Definition: qglobal.h:1193
qreal pointSize
Definition: qfont_p.h:89
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
uint weight
Definition: qfont_p.h:95
friend class QFontPrivate
Definition: qfont.h:310
qreal pixelSize
Definition: qfont_p.h:90
QString family() const
Returns the requested font family name, i.e.
Definition: qfont.cpp:906
uint style
Definition: qfont_p.h:97
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
int weight() const
Returns the weight of the font which is one of the enumerated values from QFont::Weight.
Definition: qfont.cpp:1248
bool italic() const
Returns true if the style() of the font is not QFont::StyleNormal.
Definition: qfont.h:355
int pointSize() const
Returns the point size of the font.
Definition: qfont.cpp:981
QString family
Definition: qfont_p.h:82

◆ QFont() [3/5]

QFont::QFont ( const QFont font,
QPaintDevice pd 
)

Constructs a font from font for use on the paint device pd.

Definition at line 765 of file qfont.cpp.

766  : resolve_mask(font.resolve_mask)
767 {
768  Q_ASSERT(pd != 0);
769  int dpi = pd->logicalDpiY();
770 #ifdef Q_WS_X11
771  const QX11Info *info = qt_x11Info(pd);
772  int screen = info ? info->screen() : 0;
773 #else
774  const int screen = 0;
775 #endif
776  if (font.d->dpi != dpi || font.d->screen != screen ) {
777  d = new QFontPrivate(*font.d);
778  d->dpi = dpi;
779  d->screen = screen;
780  } else {
781  d = font.d.data();
782  }
783 #ifdef Q_WS_WIN
784  if (pd->devType() == QInternal::Printer && pd->getDC())
785  d->hdc = pd->getDC();
786 #endif
787 }
static mach_timebase_info_data_t info
int logicalDpiY() const
Definition: qpaintdevice.h:96
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
virtual int devType() const
Definition: qpaintdevice.h:167
const QX11Info * qt_x11Info(const QPaintDevice *pd)
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
uint resolve_mask
Definition: qfont.h:344
friend class QFontPrivate
Definition: qfont.h:310
virtual HDC getDC() const
The QX11Info class provides information about the X display configuration.
Definition: qx11info_x11.h:63
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
int screen
Definition: qfont_p.h:181
int screen() const
Returns the number of the screen currently in use.

◆ QFont() [4/5]

QFont::QFont ( const QFont font)

Constructs a font that is a copy of font.

Definition at line 878 of file qfont.cpp.

879  : d(font.d.data()), resolve_mask(font.resolve_mask)
880 {
881 }
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ ~QFont()

QFont::~QFont ( )

Destroys the font object and frees all allocated resources.

Definition at line 886 of file qfont.cpp.

887 {
888 }

◆ QFont() [5/5]

QFont::QFont ( QFontPrivate data)
private
Warning
This function is not part of the public interface.

Definition at line 792 of file qfont.cpp.

794 {
795 }
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

Functions

◆ bold()

bool QFont::bold ( ) const
inline

Returns true if weight() is a value greater than QFont::Normal ; otherwise returns false.

See also
weight(), setBold(), QFontInfo::bold()

Definition at line 348 of file qfont.h.

Referenced by getFontSet(), QDeclarativeFontValueType::setFamily(), and QMenuPrivate::QMacMenuPrivate::syncAction().

349 { return weight() > Normal; }
int weight() const
Returns the weight of the font which is one of the enumerated values from QFont::Weight.
Definition: qfont.cpp:1248

◆ capitalization()

QFont::Capitalization QFont::capitalization ( ) const

Returns the current capitalization type of the font.

Since
4.4
See also
setCapitalization()

Definition at line 1819 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), QTextHtmlParserNode::applyCssDeclarations(), setCapitalization(), QTextCharFormat::setFont(), and QDeclarativeFontValueType::setPixelSize().

1820 {
1821  return static_cast<QFont::Capitalization> (d->capital);
1822 }
Capitalization
Rendering option for text this font applies to.
Definition: qfont.h:129
uint capital
Definition: qfont_p.h:192
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ cleanup()

void QFont::cleanup ( )
static

Internal function that cleans up the font system.

Warning
This function is not part of the public interface.

Definition at line 93 of file qfont_mac.cpp.

Referenced by pointSize(), qt_cleanup(), and qt_x11_set_fallback_font_family().

94 {
96 }
static void cleanup()
Definition: qfont.cpp:2927

◆ defaultFamily()

QString QFont::defaultFamily ( ) const

Returns the family name that corresponds to the current style hint.

See also
StyleHint styleHint() setStyleHint()

Definition at line 134 of file qfont_mac.cpp.

Referenced by freetypeFace(), getFcPattern(), loadFromDatabase(), loadWin(), pointSize(), qt_x11_set_fallback_font_family(), and registerFont().

135 {
136  switch(d->request.styleHint) {
137  case QFont::Times:
138  return QString::fromLatin1("Times New Roman");
139  case QFont::Courier:
140  return QString::fromLatin1("Courier New");
141  case QFont::Monospace:
142  return QString::fromLatin1("Courier");
143  case QFont::Decorative:
144  return QString::fromLatin1("Bookman Old Style");
145  case QFont::Cursive:
146  return QString::fromLatin1("Apple Chancery");
147  case QFont::Fantasy:
148  return QString::fromLatin1("Papyrus");
149  case QFont::Helvetica:
150  case QFont::System:
151  default:
152  return QString::fromLatin1("Helvetica");
153  }
154 }
QFontDef request
Definition: qfont_p.h:178
static QString fromLatin1(const char *, int size=-1)
Returns a QString initialized with the first size characters of the Latin-1 string str...
Definition: qstring.cpp:4188
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint styleHint
Definition: qfont_p.h:93

◆ detach()

void QFont::detach ( )
private

Detaches the font object from common font data.

Warning
This function is not part of the public interface.

Definition at line 803 of file qfont.cpp.

Referenced by QCommandLinkButtonPrivate::descriptionFont(), qt_x11_set_fallback_font_family(), resolve(), setCapitalization(), setFamily(), setFixedPitch(), setHintingPreference(), setKerning(), setLetterSpacing(), setOverline(), setPixelSize(), setPointSize(), setPointSizeF(), setRawMode(), setStretch(), setStrikeOut(), setStyle(), setStyleHint(), setStyleName(), setStyleStrategy(), setUnderline(), setWeight(), setWordSpacing(), and QCommandLinkButtonPrivate::titleFont().

804 {
805  if (d->ref == 1) {
806  if (d->engineData)
807  d->engineData->ref.deref();
808  d->engineData = 0;
809  if (d->scFont && d->scFont != d.data())
810  d->scFont->ref.deref();
811  d->scFont = 0;
812  return;
813  }
814 
815  d.detach();
816 }
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
bool deref()
Atomically decrements the value of this QAtomicInt.
QAtomicInt ref
Definition: qfont_p.h:152
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
If the shared data object&#39;s reference count is greater than 1, this function creates a deep copy of t...
Definition: qshareddata.h:148
QAtomicInt ref
Definition: qfont_p.h:177
QFontPrivate * scFont
Definition: qfont_p.h:198
QFontEngineData * engineData
Definition: qfont_p.h:179

◆ exactMatch()

bool QFont::exactMatch ( ) const

Returns true if a window system font exactly matching the settings of this font is available.

See also
QFontInfo

Definition at line 1857 of file qfont.cpp.

Referenced by qt_set_x11_resources().

1858 {
1860  Q_ASSERT(engine != 0);
1861  return (d->rawMode
1862  ? engine->type() != QFontEngine::Box
1863  : d->request.exactMatch(engine->fontDef));
1864 }
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
virtual Type type() const =0
uint rawMode
Definition: qfont_p.h:187
QFontDef request
Definition: qfont_p.h:178
QFontEngine * engineForScript(int script) const
Definition: qfont.cpp:294
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
bool exactMatch(const QFontDef &other) const
Definition: qfont.cpp:102
QFontDef fontDef

◆ family()

QString QFont::family ( ) const

◆ fixedPitch()

bool QFont::fixedPitch ( ) const

Returns true if fixed pitch has been set; otherwise returns false.

See also
setFixedPitch(), QFontInfo::fixedPitch()

Definition at line 1391 of file qfont.cpp.

Referenced by QTextFormatPrivate::recalcFont(), QTextCharFormat::setFont(), and toString().

1392 {
1393  return d->request.fixedPitch;
1394 }
uint fixedPitch
Definition: qfont_p.h:96
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ freetypeFace()

FT_Face QFont::freetypeFace ( ) const

Returns the handle to the primary FreeType face of the font.

If font merging is not disabled a QFont can contain several physical fonts.

Returns 0 if the font does not contain a FreeType face.

Note
This function is only available on platforms that provide the FreeType library; i.e., X11 and some Embedded Linux platforms.

Definition at line 82 of file qfont_qws.cpp.

Referenced by qt_x11_set_fallback_font_family().

83 {
84 #ifndef QT_NO_FREETYPE
86  if (engine->type() == QFontEngine::Multi)
87  engine = static_cast<QFontEngineMulti *>(engine)->engine(0);
88  if (engine->type() == QFontEngine::Freetype) {
89  const QFontEngineFT *ft = static_cast<const QFontEngineFT *>(engine);
90  return ft->non_locked_face();
91  }
92 #endif
93  return 0;
94 }
virtual Type type() const =0
QFontEngine * engineForScript(int script) const
Definition: qfont.cpp:294
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
FT_Face non_locked_face() const

◆ fromString()

bool QFont::fromString ( const QString descrip)

Sets this font to match the description descrip.

The description is a comma-separated list of the font attributes, as returned by toString().

See also
toString()

Definition at line 2367 of file qfont.cpp.

Referenced by convert(), QApplicationPrivate::qt_mac_apply_settings(), and QApplicationPrivate::x11_apply_settings().

2368 {
2369  QStringList l(descrip.split(QLatin1Char(',')));
2370 
2371  int count = l.count();
2372  if (!count || (count > 2 && count < 9) || count > 11) {
2373  qWarning("QFont::fromString: Invalid description '%s'",
2374  descrip.isEmpty() ? "(empty)" : descrip.toLatin1().data());
2375  return false;
2376  }
2377 
2378  setFamily(l[0]);
2379  if (count > 1 && l[1].toDouble() > 0.0)
2380  setPointSizeF(l[1].toDouble());
2381  if (count == 9) {
2382  setStyleHint((StyleHint) l[2].toInt());
2383  setWeight(qMax(qMin(99, l[3].toInt()), 0));
2384  setItalic(l[4].toInt());
2385  setUnderline(l[5].toInt());
2386  setStrikeOut(l[6].toInt());
2387  setFixedPitch(l[7].toInt());
2388  setRawMode(l[8].toInt());
2389  } else if (count == 10) {
2390  if (l[2].toInt() > 0)
2391  setPixelSize(l[2].toInt());
2392  setStyleHint((StyleHint) l[3].toInt());
2393  setWeight(qMax(qMin(99, l[4].toInt()), 0));
2394  setStyle((QFont::Style)l[5].toInt());
2395  setUnderline(l[6].toInt());
2396  setStrikeOut(l[7].toInt());
2397  setFixedPitch(l[8].toInt());
2398  setRawMode(l[9].toInt());
2399  }
2400  if (count >= 9 && !d->request.fixedPitch) // assume 'false' fixedPitch equals default
2401  d->request.ignorePitch = true;
2402 
2403  return true;
2404 }
uint fixedPitch
Definition: qfont_p.h:96
Q_DECL_CONSTEXPR const T & qMin(const T &a, const T &b)
Definition: qglobal.h:1215
char * data()
Returns a pointer to the data stored in the byte array.
Definition: qbytearray.h:429
void setUnderline(bool)
If enable is true, sets underline on; otherwise sets underline off.
Definition: qfont.cpp:1331
void setRawMode(bool)
If enable is true, turns raw mode on; otherwise turns raw mode off.
Definition: qfont.cpp:1842
void setItalic(bool b)
Sets the style() of the font to QFont::StyleItalic if enable is true; otherwise the style is set to Q...
Definition: qfont.h:360
Q_DECL_CONSTEXPR const T & qMax(const T &a, const T &b)
Definition: qglobal.h:1217
void setFamily(const QString &)
Sets the family name of the font.
Definition: qfont.cpp:924
bool isEmpty() const
Returns true if the string has no characters; otherwise returns false.
Definition: qstring.h:704
void setStrikeOut(bool)
If enable is true, sets strikeout on; otherwise sets strikeout off.
Definition: qfont.cpp:1378
QFontDef request
Definition: qfont_p.h:178
The QStringList class provides a list of strings.
Definition: qstringlist.h:66
static int toInt(const QByteArray &str)
Definition: generator.cpp:167
Q_CORE_EXPORT void qWarning(const char *,...)
QByteArray toLatin1() const Q_REQUIRED_RESULT
Returns a Latin-1 representation of the string as a QByteArray.
Definition: qstring.cpp:3993
uint ignorePitch
Definition: qfont_p.h:100
void setStyleHint(StyleHint, StyleStrategy=PreferDefault)
Sets the style hint and strategy to hint and strategy, respectively.
Definition: qfont.cpp:1554
Style
This enum describes the different styles of glyphs that are used to display text. ...
Definition: qfont.h:111
StyleHint
Style hints are used by the font matching algorithm to find an appropriate default family if a select...
Definition: qfont.h:69
void setFixedPitch(bool)
If enable is true, sets fixed pitch on; otherwise sets fixed pitch off.
Definition: qfont.cpp:1402
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void setWeight(int)
Sets the weight the font to weight, which should be a value from the QFont::Weight enumeration...
Definition: qfont.cpp:1278
QFactoryLoader * l
void setPointSizeF(qreal)
Sets the point size to pointSize.
Definition: qfont.cpp:1121
static qreal toDouble(const QChar *&str)
QStringList split(const QString &sep, SplitBehavior behavior=KeepEmptyParts, Qt::CaseSensitivity cs=Qt::CaseSensitive) const Q_REQUIRED_RESULT
Splits the string into substrings wherever sep occurs, and returns the list of those strings...
Definition: qstring.cpp:6526
void setPixelSize(int)
Sets the font size to pixelSize pixels.
Definition: qfont.cpp:1156
The QLatin1Char class provides an 8-bit ASCII/Latin-1 character.
Definition: qchar.h:55
void setStyle(Style style)
Sets the style of the font to style.
Definition: qfont.cpp:1234

◆ handle()

Qt::HANDLE QFont::handle ( ) const

Returns the window system handle to the font, for low-level access.

Using this function is not portable.

Definition at line 121 of file qfont_mac.cpp.

Referenced by QGLContext::choosePixelFormat(), macFontID(), pointSize(), qgl_use_font(), qt_x11_set_fallback_font_family(), and QWinInputContext::update().

122 {
123 #ifdef QT_MAC_USE_COCOA
125  if (fe && fe->type() == QFontEngine::Multi)
126  return (Qt::HANDLE)static_cast<QCoreTextFontEngineMulti*>(fe)->macFontID();
127 #endif
128  return 0;
129 }
virtual Type type() const =0
void * HANDLE
Definition: qnamespace.h:1671
QFontEngine * engineForScript(int script) const
Definition: qfont.cpp:294
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
quint32 macFontID() const
Returns an ATSUFontID.
Definition: qfont_mac.cpp:101

◆ hintingPreference()

QFont::HintingPreference QFont::hintingPreference ( ) const

Returns the currently preferred hinting level for glyphs rendered with this font.

Since
4.8

Definition at line 1088 of file qfont.cpp.

Referenced by QRawFont::fromFont(), and setHintingPreference().

1089 {
1091 }
HintingPreference
This enum describes the different levels of hinting that can be applied to glyphs to improve legibili...
Definition: qfont.h:96
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint hintingPreference
Definition: qfont_p.h:101

◆ initialize()

void QFont::initialize ( )
static

Internal function that initializes the font system.

Warning
This function is not part of the public interface.

The font cache and font dict do not alloc the keys. The key is a QString which is shared between QFontPrivate and QXFontName.

Definition at line 131 of file qfont_mac.cpp.

Referenced by init_display(), pointSize(), qt_init(), and qt_x11_set_fallback_font_family().

132 { }

◆ insertSubstitution()

void QFont::insertSubstitution ( const QString familyName,
const QString substituteName 
)
static

Inserts substituteName into the substitution table for the family familyName.

See also
insertSubstitutions() removeSubstitution() substitutions() substitute() substitutes()

Definition at line 2155 of file qfont.cpp.

2157 {
2158  initFontSubst();
2159 
2160  QFontSubst *fontSubst = globalFontSubst();
2161  Q_ASSERT(fontSubst != 0);
2162  QStringList &list = (*fontSubst)[familyName.toLower()];
2163  QString s = substituteName.toLower();
2164  if (!list.contains(s))
2165  list.append(s);
2166 }
The QString class provides a Unicode character string.
Definition: qstring.h:83
The QHash class is a template class that provides a hash-table-based dictionary.
Definition: qdatastream.h:66
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
void append(const T &t)
Inserts value at the end of the list.
Definition: qlist.h:507
The QStringList class provides a list of strings.
Definition: qstringlist.h:66
QBool contains(const QString &str, Qt::CaseSensitivity cs=Qt::CaseSensitive) const
Returns true if the list contains the string str; otherwise returns false.
Definition: qstringlist.h:172
static void initFontSubst()
Definition: qfont.cpp:2068
QString toLower() const Q_REQUIRED_RESULT
Returns a lowercase copy of the string.
Definition: qstring.cpp:5389

◆ insertSubstitutions()

void QFont::insertSubstitutions ( const QString familyName,
const QStringList substituteNames 
)
static

Inserts the list of families substituteNames into the substitution list for familyName.

See also
insertSubstitution(), removeSubstitution(), substitutions(), substitute()

Definition at line 2175 of file qfont.cpp.

Referenced by QApplicationPrivate::qt_mac_apply_settings(), and QApplicationPrivate::x11_apply_settings().

2177 {
2178  initFontSubst();
2179 
2180  QFontSubst *fontSubst = globalFontSubst();
2181  Q_ASSERT(fontSubst != 0);
2182  QStringList &list = (*fontSubst)[familyName.toLower()];
2183  QStringList::ConstIterator it = substituteNames.constBegin();
2184  while (it != substituteNames.constEnd()) {
2185  QString s = (*it).toLower();
2186  if (!list.contains(s))
2187  list.append(s);
2188  it++;
2189  }
2190 }
#define it(className, varName)
const_iterator constBegin() const
Returns a const STL-style iterator pointing to the first item in the list.
Definition: qlist.h:269
The QString class provides a Unicode character string.
Definition: qstring.h:83
The QHash class is a template class that provides a hash-table-based dictionary.
Definition: qdatastream.h:66
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
void append(const T &t)
Inserts value at the end of the list.
Definition: qlist.h:507
The QStringList class provides a list of strings.
Definition: qstringlist.h:66
QBool contains(const QString &str, Qt::CaseSensitivity cs=Qt::CaseSensitive) const
Returns true if the list contains the string str; otherwise returns false.
Definition: qstringlist.h:172
static void initFontSubst()
Definition: qfont.cpp:2068
const_iterator ConstIterator
Qt-style synonym for QList::const_iterator.
Definition: qlist.h:279
QString toLower() const Q_REQUIRED_RESULT
Returns a lowercase copy of the string.
Definition: qstring.cpp:5389
const_iterator constEnd() const
Returns a const STL-style iterator pointing to the imaginary item after the last item in the list...
Definition: qlist.h:272

◆ isCopyOf()

bool QFont::isCopyOf ( const QFont f) const

Returns true if this font and f are copies of each other, i.e.

one of them was created as a copy of the other and neither has been modified since. This is much stricter than equality.

See also
operator=() operator==()

Definition at line 1963 of file qfont.cpp.

Referenced by QWidgetPrivate::naturalWidgetFont(), and QApplication::setFont().

1964 {
1965  return d == f.d;
1966 }
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ italic()

bool QFont::italic ( ) const
inline

Returns true if the style() of the font is not QFont::StyleNormal.

See also
setItalic() style()

Definition at line 355 of file qfont.h.

Referenced by getFontSet(), QFontToIFont(), QTextCharFormat::setFont(), QDeclarativeFontValueType::setWeight(), and QMenuPrivate::QMacMenuPrivate::syncAction().

356 {
357  return (style() != StyleNormal);
358 }
Style style() const
Returns the style of the font.
Definition: qfont.cpp:1223

◆ kerning()

bool QFont::kerning ( ) const

Returns true if kerning should be used when drawing text with this font.

See also
setKerning()

Definition at line 1416 of file qfont.cpp.

Referenced by draw_text_item_win(), and QTextCharFormat::setFont().

1417 {
1418  return d->kerning;
1419 }
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint kerning
Definition: qfont_p.h:191

◆ key()

QString QFont::key ( ) const

Returns the font's key, a textual representation of a font.

It is typically used as the key for a cache or dictionary of fonts.

See also
QMap

Definition at line 2332 of file qfont.cpp.

2333 {
2334  return toString();
2335 }
QString toString() const
Returns a description of the font.
Definition: qfont.cpp:2344

◆ lastResortFamily()

QString QFont::lastResortFamily ( ) const

Returns the "last resort" font family name.

The current implementation tries a wide variety of common fonts, returning the first one it finds. Is is possible that no family is found in which case an empty string is returned.

See also
lastResortFont()

Definition at line 156 of file qfont_mac.cpp.

Referenced by freetypeFace(), pointSize(), qt_x11_set_fallback_font_family(), and QFontDialogPrivate::updateFamilies().

157 {
158  return QString::fromLatin1("Helvetica");
159 }
static QString fromLatin1(const char *, int size=-1)
Returns a QString initialized with the first size characters of the Latin-1 string str...
Definition: qstring.cpp:4188

◆ lastResortFont()

QString QFont::lastResortFont ( ) const

Returns a "last resort" font name for the font matching algorithm.

This is used if the last resort family is not available. It will always return a name, if necessary returning something like "fixed" or "system".

The current implementation tries a wide variety of common fonts, returning the first one it finds. The implementation may change at any time, but this function will always return a string containing something.

It is theoretically possible that there really isn't a lastResortFont() in which case Qt will abort with an error message. We have not been able to identify a case where this happens. Please report it as a bug if it does, preferably with a list of the fonts you have installed.

See also
lastResortFamily() rawName()

Definition at line 161 of file qfont_mac.cpp.

Referenced by fontExists(), freetypeFace(), and pointSize().

162 {
163  return QString::fromLatin1("Geneva");
164 }
static QString fromLatin1(const char *, int size=-1)
Returns a QString initialized with the first size characters of the Latin-1 string str...
Definition: qstring.cpp:4188

◆ letterSpacing()

qreal QFont::letterSpacing ( ) const

Returns the letter spacing for the font.

Since
4.4
See also
setLetterSpacing(), letterSpacingType(), setWordSpacing()

Definition at line 1677 of file qfont.cpp.

Referenced by QDeclarativeFontValueType::setCapitalization(), and QTextCharFormat::setFont().

1678 {
1679  return d->letterSpacing.toReal();
1680 }
QFixed letterSpacing
Definition: qfont_p.h:195
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
qreal toReal() const
Definition: qfixed_p.h:77

◆ letterSpacingType()

QFont::SpacingType QFont::letterSpacingType ( ) const

Returns the spacing type used for letter spacing.

Since
4.4
See also
letterSpacing(), setLetterSpacing(), setWordSpacing()

Definition at line 1721 of file qfont.cpp.

Referenced by QTextCharFormat::setFont().

1722 {
1724 }
bool letterSpacingIsAbsolute
Definition: qfont_p.h:193
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ macFontID()

quint32 QFont::macFontID ( ) const

Returns an ATSUFontID.

Definition at line 101 of file qfont_mac.cpp.

Referenced by handle(), and QMenuPrivate::QMacMenuPrivate::syncAction().

102 {
103 #ifdef QT_MAC_USE_COCOA
104  return 0;
105 #elif 1
107  if (fe && fe->type() == QFontEngine::Multi)
108  return static_cast<QFontEngineMacMulti*>(fe)->macFontID();
109 #else
110  Str255 name;
111  if(FMGetFontFamilyName((FMFontFamily)((UInt32)handle()), name) == noErr) {
112  short fnum;
113  GetFNum(name, &fnum);
114  return fnum;
115  }
116 #endif
117  return 0;
118 }
HFONT handle() const
Returns the window system handle to the font, for low-level access.
Definition: qfont_mac.cpp:121
virtual Type type() const =0
const char * name
QFontEngine * engineForScript(int script) const
Definition: qfont.cpp:294
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ macSetFont()

void QFont::macSetFont ( QPaintDevice )
private

◆ operator QVariant()

QFont::operator QVariant ( ) const

Returns the font as a QVariant.

Definition at line 1951 of file qfont.cpp.

1952 {
1953  return QVariant(QVariant::Font, this);
1954 }
The QVariant class acts like a union for the most common Qt data types.
Definition: qvariant.h:92

◆ operator!=()

bool QFont::operator!= ( const QFont f) const

Returns true if this font is different from f; otherwise returns false.

Two QFonts are considered to be different if their font attributes are different. If rawMode() is enabled for both fonts, only the family fields are compared.

See also
operator==()

Definition at line 1943 of file qfont.cpp.

1944 {
1945  return !(operator==(f));
1946 }
bool operator==(const QFont &) const
Returns true if this font is equal to f; otherwise returns false.
Definition: qfont.cpp:1876

◆ operator<()

bool QFont::operator< ( const QFont f) const

Provides an arbitrary comparison of this font and font f.

All that is guaranteed is that the operator returns false if both fonts are equal and that (f1 < f2) == !(f2 < f1) if the fonts are not equal.

This function is useful in some circumstances, for example if you want to use QFont objects as keys in a QMap.

See also
operator==() operator!=() isCopyOf()

Definition at line 1904 of file qfont.cpp.

1905 {
1906  if (f.d == d) return false;
1907  // the < operator for fontdefs ignores point sizes.
1908  QFontDef &r1 = f.d->request;
1909  QFontDef &r2 = d->request;
1910  if (r1.pointSize != r2.pointSize) return r1.pointSize < r2.pointSize;
1911  if (r1.pixelSize != r2.pixelSize) return r1.pixelSize < r2.pixelSize;
1912  if (r1.weight != r2.weight) return r1.weight < r2.weight;
1913  if (r1.style != r2.style) return r1.style < r2.style;
1914  if (r1.stretch != r2.stretch) return r1.stretch < r2.stretch;
1915  if (r1.styleHint != r2.styleHint) return r1.styleHint < r2.styleHint;
1916  if (r1.styleStrategy != r2.styleStrategy) return r1.styleStrategy < r2.styleStrategy;
1917  if (r1.family != r2.family) return r1.family < r2.family;
1918 #ifdef Q_WS_X11
1919  if (r1.addStyle != r2.addStyle) return r1.addStyle < r2.addStyle;
1920 #endif // Q_WS_X11
1921  if (f.d->capital != d->capital) return f.d->capital < d->capital;
1922 
1924  if (f.d->letterSpacing != d->letterSpacing) return f.d->letterSpacing < d->letterSpacing;
1925  if (f.d->wordSpacing != d->wordSpacing) return f.d->wordSpacing < d->wordSpacing;
1926 
1927  int f1attrs = (f.d->underline << 3) + (f.d->overline << 2) + (f.d->strikeOut<<1) + f.d->kerning;
1928  int f2attrs = (d->underline << 3) + (d->overline << 2) + (d->strikeOut<<1) + d->kerning;
1929  return f1attrs < f2attrs;
1930 }
bool letterSpacingIsAbsolute
Definition: qfont_p.h:193
qreal pointSize
Definition: qfont_p.h:89
QFixed wordSpacing
Definition: qfont_p.h:196
uint overline
Definition: qfont_p.h:189
uint underline
Definition: qfont_p.h:188
QFontDef request
Definition: qfont_p.h:178
uint capital
Definition: qfont_p.h:192
uint weight
Definition: qfont_p.h:95
QFixed letterSpacing
Definition: qfont_p.h:195
qreal pixelSize
Definition: qfont_p.h:90
uint style
Definition: qfont_p.h:97
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint stretch
Definition: qfont_p.h:98
uint kerning
Definition: qfont_p.h:191
QString addStyle
Definition: qfont_p.h:86
QString family
Definition: qfont_p.h:82
uint styleHint
Definition: qfont_p.h:93
uint styleStrategy
Definition: qfont_p.h:92
uint strikeOut
Definition: qfont_p.h:190

◆ operator=()

QFont & QFont::operator= ( const QFont font)

Assigns font to this font and returns a reference to it.

Definition at line 893 of file qfont.cpp.

894 {
895  d = font.d.data();
896  resolve_mask = font.resolve_mask;
897  return *this;
898 }
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ operator==()

bool QFont::operator== ( const QFont f) const

Returns true if this font is equal to f; otherwise returns false.

Two QFonts are considered equal if their font attributes are equal. If rawMode() is enabled for both fonts, only the family fields are compared.

See also
operator!=() isCopyOf()

Definition at line 1876 of file qfont.cpp.

Referenced by operator!=().

1877 {
1878  return (f.d == d
1879  || (f.d->request == d->request
1880  && f.d->request.pointSize == d->request.pointSize
1881  && f.d->underline == d->underline
1882  && f.d->overline == d->overline
1883  && f.d->strikeOut == d->strikeOut
1884  && f.d->kerning == d->kerning
1885  && f.d->capital == d->capital
1887  && f.d->letterSpacing == d->letterSpacing
1888  && f.d->wordSpacing == d->wordSpacing
1889  ));
1890 }
bool letterSpacingIsAbsolute
Definition: qfont_p.h:193
qreal pointSize
Definition: qfont_p.h:89
QFixed wordSpacing
Definition: qfont_p.h:196
uint overline
Definition: qfont_p.h:189
uint underline
Definition: qfont_p.h:188
QFontDef request
Definition: qfont_p.h:178
uint capital
Definition: qfont_p.h:192
QFixed letterSpacing
Definition: qfont_p.h:195
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint kerning
Definition: qfont_p.h:191
uint strikeOut
Definition: qfont_p.h:190

◆ overline()

bool QFont::overline ( ) const

Returns true if overline has been set; otherwise returns false.

See also
setOverline()

Definition at line 1344 of file qfont.cpp.

Referenced by QTextHtmlParserNode::applyCssDeclarations(), QTextLine::glyphs(), qt_draw_decoration_for_glyphs(), QTextCharFormat::setFont(), and QDeclarativeFontValueType::setUnderline().

1345 {
1346  return d->overline;
1347 }
uint overline
Definition: qfont_p.h:189
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ pixelSize()

int QFont::pixelSize ( ) const

◆ pointSize()

int QFont::pointSize ( ) const

◆ pointSizeF()

qreal QFont::pointSizeF ( ) const

Returns the point size of the font.

Returns -1 if the font size was specified in pixels.

See also
pointSize() setPointSizeF() pixelSize() QFontInfo::pointSize() QFontInfo::pixelSize()

Definition at line 1142 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), QSvgText::draw(), QPagePreview::paintEvent(), QTextFormatPrivate::resolveFont(), QTextCharFormat::setFont(), QDeclarativeFontValueType::setPointSize(), QDeclarativeFontValueType::setStrikeout(), QFontPrivate::smallCapsFontPrivate(), and toString().

1143 {
1144  return d->request.pointSize;
1145 }
qreal pointSize
Definition: qfont_p.h:89
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ rawMode()

bool QFont::rawMode ( ) const

Returns true if raw mode is used for font name matching; otherwise returns false.

See also
setRawMode() rawName()

Definition at line 1974 of file qfont.cpp.

Referenced by qt_set_x11_resources(), and toString().

1975 {
1976  return d->rawMode;
1977 }
uint rawMode
Definition: qfont_p.h:187
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ rawName()

QString QFont::rawName ( ) const

Returns the name of the font within the underlying window system.

On X11, this function will return an empty string if Qt is built with FontConfig support; otherwise the XLFD (X Logical Font Description) is returned.

Using the return value of this function is usually not portable.

See also
setRawName()

Definition at line 83 of file qfont_mac.cpp.

Referenced by freetypeFace(), pointSize(), and qt_x11_set_fallback_font_family().

84 {
85  return family();
86 }
QString family() const
Returns the requested font family name, i.e.
Definition: qfont.cpp:906

◆ removeSubstitution()

void QFont::removeSubstitution ( const QString familyName)
static

Removes all the substitutions for familyName.

See also
insertSubstitutions(), insertSubstitution(), substitutions(), substitute()

Definition at line 2218 of file qfont.cpp.

2219 { // ### function name should be removeSubstitutions() or
2220  // ### removeSubstitutionList()
2221  initFontSubst();
2222 
2223  QFontSubst *fontSubst = globalFontSubst();
2224  Q_ASSERT(fontSubst != 0);
2225  fontSubst->remove(familyName.toLower());
2226 }
int remove(const Key &key)
Removes all the items that have the key from the hash.
Definition: qhash.h:784
The QHash class is a template class that provides a hash-table-based dictionary.
Definition: qdatastream.h:66
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
static void initFontSubst()
Definition: qfont.cpp:2068
QString toLower() const Q_REQUIRED_RESULT
Returns a lowercase copy of the string.
Definition: qstring.cpp:5389

◆ resolve() [1/3]

QFont QFont::resolve ( const QFont other) const

Returns a new QFont that has attributes copied from other that have not been previously set on this font.

Definition at line 1983 of file qfont.cpp.

Referenced by QTextHtmlParserNode::applyCssDeclarations(), QCommandLinkButtonPrivate::descriptionFont(), QStyleSheetStyle::drawComplexControl(), QStyleSheetStyle::drawControl(), QTextEngine::font(), QTextEngine::fontEngine(), QMenu::initStyleOption(), QGraphicsWidgetPrivate::naturalWidgetFont(), QWidgetPrivate::naturalWidgetFont(), QGraphicsWidgetPrivate::resolveFont(), QTextFormatPrivate::resolveFont(), QGraphicsScenePrivate::resolveFont(), QWidgetPrivate::resolveFont(), QGraphicsWidget::setFont(), QPainter::setFont(), QGraphicsScene::setFont(), QWidget::setFont(), QGraphicsWidgetPrivate::setFont_helper(), QGraphicsScenePrivate::setFont_helper(), QWidgetPrivate::setFont_helper(), QGraphicsWidget::setStyle(), QMenuPrivate::QMacMenuPrivate::syncAction(), QCommandLinkButtonPrivate::titleFont(), QGraphicsWidgetPrivate::updateFont(), QGraphicsScenePrivate::updateFont(), QWidgetPrivate::updateFont(), and QStyleSheetStyle::updateStyleSheetFont().

1984 {
1985  if (*this == other
1986  && (resolve_mask == other.resolve_mask || resolve_mask == 0)
1987  && d->dpi == other.d->dpi) {
1988  QFont o = other;
1990  return o;
1991  }
1992 
1993  QFont font(*this);
1994  font.detach();
1995  font.d->resolve(resolve_mask, other.d.data());
1996 
1997  return font;
1998 }
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
uint resolve_mask
Definition: qfont.h:344
The QFont class specifies a font used for drawing text.
Definition: qfont.h:64
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ resolve() [2/3]

uint QFont::resolve ( ) const
inline
Warning
This function is not part of the public interface.

Definition at line 287 of file qfont.h.

287 { return resolve_mask; }
uint resolve_mask
Definition: qfont.h:344

◆ resolve() [3/3]

void QFont::resolve ( uint  mask)
inline
Warning
This function is not part of the public interface.

Definition at line 288 of file qfont.h.

288 { resolve_mask = mask; }
uint resolve_mask
Definition: qfont.h:344

◆ setBold()

void QFont::setBold ( bool  enable)
inline

If enable is true sets the font's weight to QFont::Bold ; otherwise sets the weight to QFont::Normal.

For finer boldness control use setWeight().

See also
bold(), setWeight()

Definition at line 352 of file qfont.h.

Referenced by QMessageBox::changeEvent(), QmlJSDebugger::LiveSelectionTool::createContextMenu(), QCalendarWidgetPrivate::createNavigationBar(), QScriptDebuggerLocalsModel::data(), QPPDOptionsModel::data(), QWindowsCEStyle::drawComplexControl(), QPlastiqueStyle::drawComplexControl(), QWindowsMobileStyle::drawComplexControl(), QCleanlooksStyle::drawComplexControl(), QGtkStyle::drawComplexControl(), QWindowsCEStyle::drawControl(), QWindowsVistaStyle::drawControl(), QCommonStyle::drawControl(), QPlastiqueStyle::drawControl(), QWindowsMobileStyle::drawControl(), QCleanlooksStyle::drawControl(), QWindowsXPStyle::drawControl(), QWindowsStyle::drawControl(), QGtkStyle::drawControl(), IFontToQFont(), QMessageBoxPrivate::init(), QBalloonTip::QBalloonTip(), qt_set_windows_font_resources(), QWizardHeader::QWizardHeader(), QWizardPrivate::recreateLayout(), QDeclarativeFontValueType::setBold(), QCleanlooksStyle::sizeFromContents(), QWindowsStyle::sizeFromContents(), QCleanlooksStyle::subControlRect(), QGtkStyle::subControlRect(), and QCommandLinkButtonPrivate::titleFont().

353 { setWeight(enable ? Bold : Normal); }
void setWeight(int)
Sets the weight the font to weight, which should be a value from the QFont::Weight enumeration...
Definition: qfont.cpp:1278

◆ setCapitalization()

void QFont::setCapitalization ( Capitalization  caps)

Sets the capitalization of the text in this font to caps.

Since
4.4

A font's capitalization makes the text appear in the selected capitalization mode.

See also
capitalization()

Definition at line 1798 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), QTextFormatPrivate::recalcFont(), QDeclarativeFontValueType::setCapitalization(), setFontVariantFromValue(), and setTextTransformFromValue().

1799 {
1801  capitalization() == caps)
1802  return;
1803 
1804  detach();
1805 
1806  d->capital = caps;
1808 }
Capitalization capitalization() const
Returns the current capitalization type of the font.
Definition: qfont.cpp:1819
uint resolve_mask
Definition: qfont.h:344
uint capital
Definition: qfont_p.h:192
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setFamily()

void QFont::setFamily ( const QString family)

Sets the family name of the font.

The name is case insensitive and may include a foundry name.

The family name may optionally also include a foundry name, e.g. "Helvetica [Cronyx]". If the family is available from more than one foundry and the foundry isn't specified, an arbitrary foundry is chosen. If the family isn't available a family will be set using the font matching algorithm.

See also
family(), setStyleHint(), QFontInfo

Definition at line 924 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), fromString(), QGtkStylePrivate::getThemeFont(), QFontFamilyDelegate::paint(), pointSize(), QWindowsVistaStyle::polish(), qt_init(), qt_set_x11_resources(), qt_x11_set_fallback_font_family(), QTextFormatPrivate::recalcFont(), QDeclarativeFontValueType::setFamily(), setFontFamilyFromValues(), setRawName(), and QWindowsVistaStyle::unpolish().

925 {
926  detach();
927 
928  d->request.family = family;
929 #if defined(Q_WS_X11)
930  d->request.addStyle.clear();
931 #endif // Q_WS_X11
932 
934 }
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
void clear()
Clears the contents of the string and makes it empty.
Definition: qstring.h:723
QString family() const
Returns the requested font family name, i.e.
Definition: qfont.cpp:906
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
QString addStyle
Definition: qfont_p.h:86
QString family
Definition: qfont_p.h:82

◆ setFixedPitch()

void QFont::setFixedPitch ( bool  enable)

If enable is true, sets fixed pitch on; otherwise sets fixed pitch off.

See also
fixedPitch(), QFontInfo

Definition at line 1402 of file qfont.cpp.

Referenced by fromString(), and QTextFormatPrivate::recalcFont().

1403 {
1404  detach();
1405 
1406  d->request.fixedPitch = enable;
1407  d->request.ignorePitch = false;
1409 }
uint fixedPitch
Definition: qfont_p.h:96
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
uint ignorePitch
Definition: qfont_p.h:100
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setHintingPreference()

void QFont::setHintingPreference ( HintingPreference  hintingPreference)

Set the preference for the hinting level of the glyphs to hintingPreference.

Since
4.8

This is a hint to the underlying font rendering system to use a certain level of hinting, and has varying support across platforms. See the table in the documentation for QFont::HintingPreference for more details.

The default hinting preference is QFont::PreferDefaultHinting.

Definition at line 1071 of file qfont.cpp.

Referenced by QTextFormatPrivate::recalcFont().

1072 {
1073  detach();
1074 
1076 
1078 }
HintingPreference hintingPreference() const
Returns the currently preferred hinting level for glyphs rendered with this font. ...
Definition: qfont.cpp:1088
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
uint hintingPreference
Definition: qfont_p.h:101

◆ setItalic()

void QFont::setItalic ( bool  enable)
inline

Sets the style() of the font to QFont::StyleItalic if enable is true; otherwise the style is set to QFont::StyleNormal.

See also
italic() QFontInfo

Definition at line 360 of file qfont.h.

Referenced by fromString(), qt_LOGFONTtoQFont(), qt_set_x11_resources(), QTextFormatPrivate::recalcFont(), and QDeclarativeFontValueType::setItalic().

360  {
362 }
void setStyle(Style style)
Sets the style of the font to style.
Definition: qfont.cpp:1234

◆ setKerning()

void QFont::setKerning ( bool  enable)

Enables kerning for this font if enable is true; otherwise disables it.

By default, kerning is enabled.

When kerning is enabled, glyph metrics do not add up anymore, even for Latin text. In other words, the assumption that width('a') + width('b') is equal to width("ab") is not neccesairly true.

See also
kerning(), QFontMetrics

Definition at line 1432 of file qfont.cpp.

Referenced by QTextFormatPrivate::recalcFont().

1433 {
1434  detach();
1435  d->kerning = enable;
1437 }
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
uint kerning
Definition: qfont_p.h:191

◆ setLetterSpacing()

void QFont::setLetterSpacing ( SpacingType  type,
qreal  spacing 
)

Sets the letter spacing for the font to spacing and the type of spacing to type.

Since
4.4

Letter spacing changes the default spacing between individual letters in the font. The spacing between the letters can be made smaller as well as larger.

See also
letterSpacing(), letterSpacingType(), setWordSpacing()

Definition at line 1696 of file qfont.cpp.

Referenced by QTextFormatPrivate::recalcFont(), and QDeclarativeFontValueType::setLetterSpacing().

1697 {
1698  const QFixed newSpacing = QFixed::fromReal(spacing);
1699  const bool absoluteSpacing = type == AbsoluteSpacing;
1701  d->letterSpacingIsAbsolute == absoluteSpacing &&
1702  d->letterSpacing == newSpacing)
1703  return;
1704 
1705  detach();
1706 
1707  d->letterSpacing = newSpacing;
1708  d->letterSpacingIsAbsolute = absoluteSpacing;
1710 }
int type
Definition: qmetatype.cpp:239
bool letterSpacingIsAbsolute
Definition: qfont_p.h:193
static QFixed fromReal(qreal r)
Definition: qfixed_p.h:70
uint resolve_mask
Definition: qfont.h:344
QFixed letterSpacing
Definition: qfont_p.h:195
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setOverline()

void QFont::setOverline ( bool  enable)

If enable is true, sets overline on; otherwise sets overline off.

See also
overline(), QFontInfo

Definition at line 1354 of file qfont.cpp.

Referenced by QPicturePaintEngine::drawTextItem(), qt_LOGFONTtoQFont(), QTextFormatPrivate::recalcFont(), QDeclarativeFontValueType::setOverline(), and setTextDecorationFromValues().

1355 {
1356  detach();
1357 
1358  d->overline = enable;
1360 }
uint overline
Definition: qfont_p.h:189
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setPixelSize()

void QFont::setPixelSize ( int  pixelSize)

Sets the font size to pixelSize pixels.

Using this function makes the font device dependent. Use setPointSize() or setPointSizeF() to set the size of the font in a device independent manner.

See also
pixelSize()

Definition at line 1156 of file qfont.cpp.

Referenced by QSvgText::draw(), QTextEngine::font(), QTextEngine::fontEngine(), fromString(), pixelSize(), QUIKitScreen::QUIKitScreen(), QTextFormatPrivate::recalcFont(), QTextFormatPrivate::resolveFont(), setFontSizeFromValue(), QDeclarativeFontValueType::setPixelSize(), and QFontPrivate::smallCapsFontPrivate().

1157 {
1158  if (pixelSize <= 0) {
1159  qWarning("QFont::setPixelSize: Pixel size <= 0 (%d)", pixelSize);
1160  return;
1161  }
1162 
1163  detach();
1164 
1166  d->request.pointSize = -1;
1167 
1169 }
qreal pointSize
Definition: qfont_p.h:89
int pixelSize() const
Returns the pixel size of the font if it was set with setPixelSize().
Definition: qfont.cpp:1178
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
Q_CORE_EXPORT void qWarning(const char *,...)
qreal pixelSize
Definition: qfont_p.h:90
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setPointSize()

void QFont::setPointSize ( int  pointSize)

Sets the point size to pointSize.

The point size must be greater than zero.

See also
pointSize() setPointSizeF()

Definition at line 1099 of file qfont.cpp.

Referenced by QDragManager::drag(), QPlastiqueStyle::drawControl(), QWindowsMobileStyle::drawControl(), QApplication::font(), QTextEngine::font(), QTextEngine::fontEngine(), QFontFamilyDelegate::paint(), QBalloonTip::QBalloonTip(), qt_set_windows_font_resources(), qt_set_x11_resources(), QWizardPrivate::recreateLayout(), QFontFamilyDelegate::sizeHint(), and QTextEdit::zoomIn().

1100 {
1101  if (pointSize <= 0) {
1102  qWarning("QFont::setPointSize: Point size <= 0 (%d), must be greater than 0", pointSize);
1103  return;
1104  }
1105 
1106  detach();
1107 
1109  d->request.pixelSize = -1;
1110 
1112 }
double qreal
Definition: qglobal.h:1193
qreal pointSize
Definition: qfont_p.h:89
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
Q_CORE_EXPORT void qWarning(const char *,...)
qreal pixelSize
Definition: qfont_p.h:90
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
int pointSize() const
Returns the point size of the font.
Definition: qfont.cpp:981

◆ setPointSizeF()

void QFont::setPointSizeF ( qreal  pointSize)

Sets the point size to pointSize.

The point size must be greater than zero. The requested precision may not be achieved on all platforms.

See also
pointSizeF() setPointSize() setPixelSize()

Definition at line 1121 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), QCommandLinkButtonPrivate::descriptionFont(), QCleanlooksStyle::drawControl(), QMacStyle::drawControl(), fromString(), QGtkStylePrivate::getThemeFont(), QPagePreview::paintEvent(), qt_LOGFONTtoQFont(), QTextFormatPrivate::recalcFont(), QTextFormatPrivate::resolveFont(), setFontSizeFromValue(), QDeclarativeFontValueType::setPointSize(), QFontPrivate::smallCapsFontPrivate(), and QCommandLinkButtonPrivate::titleFont().

1122 {
1123  if (pointSize <= 0) {
1124  qWarning("QFont::setPointSizeF: Point size <= 0 (%f), must be greater than 0", pointSize);
1125  return;
1126  }
1127 
1128  detach();
1129 
1131  d->request.pixelSize = -1;
1132 
1134 }
qreal pointSize
Definition: qfont_p.h:89
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
Q_CORE_EXPORT void qWarning(const char *,...)
qreal pixelSize
Definition: qfont_p.h:90
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
int pointSize() const
Returns the point size of the font.
Definition: qfont.cpp:981

◆ setRawMode()

void QFont::setRawMode ( bool  enable)

If enable is true, turns raw mode on; otherwise turns raw mode off.

This function only has an effect under X11.

If raw mode is enabled, Qt will search for an X font with a complete font name matching the family name, ignoring all other values set for the QFont. If the font name matches several fonts, Qt will use the first font returned by X. QFontInfo cannot be used to fetch information about a QFont using raw mode (it will return the values set in the QFont for all parameters, including the family name).

Warning
Do not use raw mode unless you really, really need it! In most (if not all) cases, setRawName() is a much better choice.
See also
rawMode(), setRawName()

Definition at line 1842 of file qfont.cpp.

Referenced by fromString(), qt_set_x11_resources(), and qt_x11_set_fallback_font_family().

1843 {
1844  detach();
1845 
1846  if ((bool) d->rawMode == enable) return;
1847 
1848  d->rawMode = enable;
1849 }
uint rawMode
Definition: qfont_p.h:187
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setRawName()

void QFont::setRawName ( const QString name)

Sets a font by its system specific name.

The function is particularly useful under X, where system font settings (for example X resources) are usually available in XLFD (X Logical Font Description) form only. You can pass an XLFD as name to this function.

A font set with setRawName() is still a full-featured QFont. It can be queried (for example with italic()) or modified (for example with setItalic()) and is therefore also suitable for rendering rich text.

If Qt's internal font database cannot resolve the raw name, the font becomes a raw font with name as its family.

Note that the present implementation does not handle wildcards in XLFDs well, and that font aliases (file fonts.alias in the font directory on X11) are not supported.

See also
rawName(), setRawMode(), setFamily()

Definition at line 88 of file qfont_mac.cpp.

Referenced by freetypeFace(), pointSize(), qt_set_x11_resources(), and qt_x11_set_fallback_font_family().

89 {
90  setFamily(name);
91 }
void setFamily(const QString &)
Sets the family name of the font.
Definition: qfont.cpp:924

◆ setStretch()

void QFont::setStretch ( int  factor)

Sets the stretch factor for the font.

The stretch factor changes the width of all characters in the font by factor percent. For example, setting factor to 150 results in all characters in the font being 1.5 times (ie. 150%) wider. The default stretch factor is 100. The minimum stretch factor is 1, and the maximum stretch factor is 4000.

The stretch factor is only applied to outline fonts. The stretch factor is ignored for bitmap fonts.

NOTE: QFont cannot stretch XLFD fonts. When loading XLFD fonts on X11, the stretch factor is matched against a predefined set of values for the SETWIDTH_NAME field of the XLFD.

See also
stretch() QFont::Stretch

Definition at line 1641 of file qfont.cpp.

1642 {
1643  if (factor < 1 || factor > 4000) {
1644  qWarning("QFont::setStretch: Parameter '%d' out of range", factor);
1645  return;
1646  }
1647 
1649  d->request.stretch == (uint)factor)
1650  return;
1651 
1652  detach();
1653 
1654  d->request.stretch = (uint)factor;
1656 }
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
Q_CORE_EXPORT void qWarning(const char *,...)
unsigned int uint
Definition: qglobal.h:996
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
uint stretch
Definition: qfont_p.h:98

◆ setStrikeOut()

void QFont::setStrikeOut ( bool  enable)

If enable is true, sets strikeout on; otherwise sets strikeout off.

See also
strikeOut(), QFontInfo

Definition at line 1378 of file qfont.cpp.

Referenced by QFontDialogPrivate::_q_updateSample(), QPicturePaintEngine::drawTextItem(), fromString(), IFontToQFont(), qfontForCocoaFont(), qt_LOGFONTtoQFont(), qt_set_x11_resources(), QTextFormatPrivate::recalcFont(), QDeclarativeFontValueType::setStrikeout(), and setTextDecorationFromValues().

1379 {
1380  detach();
1381 
1382  d->strikeOut = enable;
1384 }
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
uint strikeOut
Definition: qfont_p.h:190

◆ setStyle()

void QFont::setStyle ( Style  style)

Sets the style of the font to style.

See also
italic(), QFontInfo

Definition at line 1234 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), QFontDatabase::font(), fromString(), QGtkStylePrivate::getThemeFont(), parseShorthandFontProperty(), and setFontStyleFromValue().

1235 {
1236  detach();
1237 
1238  d->request.style = style;
1240 }
Style style() const
Returns the style of the font.
Definition: qfont.cpp:1223
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
uint style
Definition: qfont_p.h:97
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setStyleHint()

void QFont::setStyleHint ( StyleHint  hint,
StyleStrategy  strategy = PreferDefault 
)

Sets the style hint and strategy to hint and strategy, respectively.

If these aren't set explicitly the style hint will default to AnyStyle and the style strategy to PreferDefault.

Qt does not support style hints on X11 since this information is not provided by the window system.

See also
StyleHint, styleHint(), StyleStrategy, styleStrategy(), QFontInfo

Definition at line 1554 of file qfont.cpp.

Referenced by fromString(), qt_set_x11_resources(), and QTextFormatPrivate::recalcFont().

1555 {
1556  detach();
1557 
1559  (StyleHint) d->request.styleHint == hint &&
1560  (StyleStrategy) d->request.styleStrategy == strategy)
1561  return;
1562 
1563  d->request.styleHint = hint;
1564  d->request.styleStrategy = strategy;
1567 
1568 #if defined(Q_WS_X11)
1569  d->request.addStyle.clear();
1570 #endif // Q_WS_X11
1571 }
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
StyleHint
Style hints are used by the font matching algorithm to find an appropriate default family if a select...
Definition: qfont.h:69
void clear()
Clears the contents of the string and makes it empty.
Definition: qstring.h:723
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
StyleStrategy
The style strategy tells the font matching algorithm what type of fonts should be used to find an app...
Definition: qfont.h:81
QString addStyle
Definition: qfont_p.h:86
uint styleHint
Definition: qfont_p.h:93
uint styleStrategy
Definition: qfont_p.h:92

◆ setStyleName()

void QFont::setStyleName ( const QString styleName)

Sets the style name of the font to the given styleName.

Since
4.8

When set, other style properties like style() and weight() will be ignored for font matching.

See also
styleName()

Definition at line 967 of file qfont.cpp.

Referenced by QFontDatabase::font().

968 {
969  detach();
970 
973 }
QString styleName() const
Returns the requested font style name, it will be used to match the font with irregular styles (that ...
Definition: qfont.cpp:950
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
QString styleName
Definition: qfont_p.h:83
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setStyleStrategy()

void QFont::setStyleStrategy ( StyleStrategy  s)

Sets the style strategy for the font to s.

See also
QFont::StyleStrategy

Definition at line 1578 of file qfont.cpp.

Referenced by qgl_use_font(), and QTextFormatPrivate::recalcFont().

1579 {
1580  detach();
1581 
1584  return;
1585 
1586  d->request.styleStrategy = s;
1588 }
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
StyleStrategy
The style strategy tells the font matching algorithm what type of fonts should be used to find an app...
Definition: qfont.h:81
uint styleStrategy
Definition: qfont_p.h:92

◆ setUnderline()

void QFont::setUnderline ( bool  enable)

If enable is true, sets underline on; otherwise sets underline off.

See also
underline(), QFontInfo

Definition at line 1331 of file qfont.cpp.

Referenced by QFontDialogPrivate::_q_updateSample(), QPicturePaintEngine::drawTextItem(), QPaintBufferEngine::drawTextItem(), fromString(), IFontToQFont(), QPainterReplayer::process(), qfontForCocoaFont(), qt_LOGFONTtoQFont(), qt_set_x11_resources(), QTextFormatPrivate::recalcFont(), setTextDecorationFromValues(), and QDeclarativeFontValueType::setUnderline().

1332 {
1333  detach();
1334 
1335  d->underline = enable;
1337 }
uint underline
Definition: qfont_p.h:188
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ setWeight()

void QFont::setWeight ( int  weight)

Sets the weight the font to weight, which should be a value from the QFont::Weight enumeration.

See also
weight(), QFontInfo

Definition at line 1278 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), fromString(), QGtkStylePrivate::getThemeFont(), parseShorthandFontProperty(), qt_LOGFONTtoQFont(), qt_set_x11_resources(), QTextFormatPrivate::recalcFont(), setFontWeightFromValue(), and QDeclarativeFontValueType::setWeight().

1279 {
1280  Q_ASSERT_X(weight >= 0 && weight <= 99, "QFont::setWeight", "Weight must be between 0 and 99");
1281 
1282  detach();
1283 
1284  d->request.weight = weight;
1286 }
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
uint weight
Definition: qfont_p.h:95
#define Q_ASSERT_X(cond, where, what)
Definition: qglobal.h:1837
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803
int weight() const
Returns the weight of the font which is one of the enumerated values from QFont::Weight.
Definition: qfont.cpp:1248

◆ setWordSpacing()

void QFont::setWordSpacing ( qreal  spacing)

Sets the word spacing for the font to spacing.

Since
4.4

Word spacing changes the default spacing between individual words. A positive value increases the word spacing by a corresponding amount of pixels, while a negative value decreases the inter-word spacing accordingly.

Word spacing will not apply to writing systems, where indiviaul words are not separated by white space.

See also
wordSpacing(), setLetterSpacing()

Definition at line 1757 of file qfont.cpp.

Referenced by QTextFormatPrivate::recalcFont(), and QDeclarativeFontValueType::setWordSpacing().

1758 {
1759  const QFixed newSpacing = QFixed::fromReal(spacing);
1761  d->wordSpacing == newSpacing)
1762  return;
1763 
1764  detach();
1765 
1766  d->wordSpacing = newSpacing;
1768 }
static QFixed fromReal(qreal r)
Definition: qfixed_p.h:70
QFixed wordSpacing
Definition: qfont_p.h:196
uint resolve_mask
Definition: qfont.h:344
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
void detach()
Detaches the font object from common font data.
Definition: qfont.cpp:803

◆ stretch()

int QFont::stretch ( ) const

Returns the stretch factor for the font.

See also
setStretch()

Definition at line 1618 of file qfont.cpp.

1619 {
1620  return d->request.stretch;
1621 }
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint stretch
Definition: qfont_p.h:98

◆ strikeOut()

bool QFont::strikeOut ( ) const

Returns true if strikeout has been set; otherwise returns false.

See also
setStrikeOut()

Definition at line 1367 of file qfont.cpp.

Referenced by QTextHtmlParserNode::applyCssDeclarations(), QTextLine::glyphs(), qfontForCocoaFont(), QFontToIFont(), qt_draw_decoration_for_glyphs(), QFontDialog::setCurrentFont(), QTextCharFormat::setFont(), QDeclarativeFontValueType::setOverline(), and toString().

1368 {
1369  return d->strikeOut;
1370 }
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint strikeOut
Definition: qfont_p.h:190

◆ style()

QFont::Style QFont::style ( ) const

Returns the style of the font.

See also
setStyle()

Definition at line 1223 of file qfont.cpp.

Referenced by QSvgFontStyle::apply(), QTextHtmlParserNode::applyCssDeclarations(), QAccessibleTextWidget::attributes(), QFontDialogPrivate::setFont(), setStyle(), QFontDatabase::styleString(), and toString().

1224 {
1225  return (QFont::Style)d->request.style;
1226 }
QFontDef request
Definition: qfont_p.h:178
Style
This enum describes the different styles of glyphs that are used to display text. ...
Definition: qfont.h:111
uint style
Definition: qfont_p.h:97
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ styleHint()

QFont::StyleHint QFont::styleHint ( ) const

Returns the StyleHint.

The style hint affects the font matching algorithm. See QFont::StyleHint for the list of available hints.

See also
setStyleHint(), QFont::StyleStrategy QFontInfo::styleHint()

Definition at line 1460 of file qfont.cpp.

Referenced by QTextCharFormat::setFont(), and toString().

1461 {
1462  return (StyleHint) d->request.styleHint;
1463 }
QFontDef request
Definition: qfont_p.h:178
StyleHint
Style hints are used by the font matching algorithm to find an appropriate default family if a select...
Definition: qfont.h:69
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
uint styleHint
Definition: qfont_p.h:93

◆ styleName()

QString QFont::styleName ( ) const

Returns the requested font style name, it will be used to match the font with irregular styles (that can't be normalized in other style properties).

Since
4.8

It depends on system font support, thus only works for Mac OS X and X11 so far. On Windows irregular styles will be added as separate font families so there is no need for this.

See also
setFamily() setStyle()

Definition at line 950 of file qfont.cpp.

Referenced by setStyleName(), and QFontDatabase::styleString().

951 {
952  return d->request.styleName;
953 }
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
QString styleName
Definition: qfont_p.h:83

◆ styleStrategy()

QFont::StyleStrategy QFont::styleStrategy ( ) const

Returns the StyleStrategy.

The style strategy affects the font matching algorithm. See QFont::StyleStrategy for the list of available strategies.

See also
setStyleHint() QFont::StyleHint

Definition at line 1447 of file qfont.cpp.

Referenced by QTextFormatPrivate::recalcFont(), and QTextCharFormat::setFont().

1448 {
1450 }
QFontDef request
Definition: qfont_p.h:178
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
StyleStrategy
The style strategy tells the font matching algorithm what type of fonts should be used to find an app...
Definition: qfont.h:81
uint styleStrategy
Definition: qfont_p.h:92

◆ substitute()

QString QFont::substitute ( const QString familyName)
static

Returns the first family name to be used whenever familyName is specified.

The lookup is case insensitive.

If there is no substitution for familyName, familyName is returned.

To obtain a list of substitutions use substitutes().

See also
setFamily() insertSubstitutions() insertSubstitution() removeSubstitution()

Definition at line 2116 of file qfont.cpp.

2117 {
2118  initFontSubst();
2119 
2120  QFontSubst *fontSubst = globalFontSubst();
2121  Q_ASSERT(fontSubst != 0);
2122  QFontSubst::ConstIterator it = fontSubst->constFind(familyName.toLower());
2123  if (it != fontSubst->constEnd() && !(*it).isEmpty())
2124  return (*it).first();
2125 
2126  return familyName;
2127 }
The QHash::const_iterator class provides an STL-style const iterator for QHash and QMultiHash...
Definition: qhash.h:395
#define it(className, varName)
The QHash class is a template class that provides a hash-table-based dictionary.
Definition: qdatastream.h:66
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
const_iterator constFind(const Key &key) const
Returns an iterator pointing to the item with the key in the hash.
Definition: qhash.h:859
const_iterator constEnd() const
Returns a const STL-style iterator pointing to the imaginary item after the last item in the hash...
Definition: qhash.h:469
static void initFontSubst()
Definition: qfont.cpp:2068
QString toLower() const Q_REQUIRED_RESULT
Returns a lowercase copy of the string.
Definition: qstring.cpp:5389

◆ substitutes()

QStringList QFont::substitutes ( const QString familyName)
static

Returns a list of family names to be used whenever familyName is specified.

The lookup is case insensitive.

If there is no substitution for familyName, an empty list is returned.

See also
substitute() insertSubstitutions() insertSubstitution() removeSubstitution()

Definition at line 2139 of file qfont.cpp.

Referenced by familyList(), and registerFont().

2140 {
2141  initFontSubst();
2142 
2143  QFontSubst *fontSubst = globalFontSubst();
2144  Q_ASSERT(fontSubst != 0);
2145  return fontSubst->value(familyName.toLower(), QStringList());
2146 }
The QHash class is a template class that provides a hash-table-based dictionary.
Definition: qdatastream.h:66
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
const T value(const Key &key) const
Returns the value associated with the key.
Definition: qhash.h:606
The QStringList class provides a list of strings.
Definition: qstringlist.h:66
static void initFontSubst()
Definition: qfont.cpp:2068
QString toLower() const Q_REQUIRED_RESULT
Returns a lowercase copy of the string.
Definition: qstring.cpp:5389

◆ substitutions()

QStringList QFont::substitutions ( )
static

Returns a sorted list of substituted family names.

See also
insertSubstitution(), removeSubstitution(), substitute()

Definition at line 2234 of file qfont.cpp.

2235 {
2236  initFontSubst();
2237 
2238  QFontSubst *fontSubst = globalFontSubst();
2239  Q_ASSERT(fontSubst != 0);
2240  QStringList ret;
2241  QFontSubst::ConstIterator it = fontSubst->constBegin();
2242 
2243  while (it != fontSubst->constEnd()) {
2244  ret.append(it.key());
2245  ++it;
2246  }
2247 
2248  ret.sort();
2249  return ret;
2250 }
The QHash::const_iterator class provides an STL-style const iterator for QHash and QMultiHash...
Definition: qhash.h:395
#define it(className, varName)
The QHash class is a template class that provides a hash-table-based dictionary.
Definition: qdatastream.h:66
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
const Key & key() const
Returns the current item&#39;s key.
Definition: qhash.h:419
void append(const T &t)
Inserts value at the end of the list.
Definition: qlist.h:507
void sort()
Sorts the list of strings in ascending order (case sensitively).
Definition: qstringlist.h:152
The QStringList class provides a list of strings.
Definition: qstringlist.h:66
const_iterator constBegin() const
Returns a const STL-style iterator pointing to the first item in the hash.
Definition: qhash.h:466
const_iterator constEnd() const
Returns a const STL-style iterator pointing to the imaginary item after the last item in the hash...
Definition: qhash.h:469
static void initFontSubst()
Definition: qfont.cpp:2068

◆ toString()

QString QFont::toString ( ) const

Returns a description of the font.

The description is a comma-separated list of the attributes, perfectly suited for use in QSettings.

See also
fromString()

Definition at line 2344 of file qfont.cpp.

Referenced by key(), and operator<<().

2345 {
2346  const QChar comma(QLatin1Char(','));
2347  return family() + comma +
2348  QString::number( pointSizeF()) + comma +
2349  QString::number( pixelSize()) + comma +
2350  QString::number((int) styleHint()) + comma +
2351  QString::number( weight()) + comma +
2352  QString::number((int) style()) + comma +
2353  QString::number((int) underline()) + comma +
2354  QString::number((int) strikeOut()) + comma +
2355  QString::number((int)fixedPitch()) + comma +
2356  QString::number((int) rawMode());
2357 }
static QString number(int, int base=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: qstring.cpp:6448
bool underline() const
Returns true if underline has been set; otherwise returns false.
Definition: qfont.cpp:1320
int pixelSize() const
Returns the pixel size of the font if it was set with setPixelSize().
Definition: qfont.cpp:1178
Style style() const
Returns the style of the font.
Definition: qfont.cpp:1223
The QChar class provides a 16-bit Unicode character.
Definition: qchar.h:72
qreal pointSizeF() const
Returns the point size of the font.
Definition: qfont.cpp:1142
bool fixedPitch() const
Returns true if fixed pitch has been set; otherwise returns false.
Definition: qfont.cpp:1391
QString family() const
Returns the requested font family name, i.e.
Definition: qfont.cpp:906
int weight() const
Returns the weight of the font which is one of the enumerated values from QFont::Weight.
Definition: qfont.cpp:1248
bool rawMode() const
Returns true if raw mode is used for font name matching; otherwise returns false. ...
Definition: qfont.cpp:1974
bool strikeOut() const
Returns true if strikeout has been set; otherwise returns false.
Definition: qfont.cpp:1367
StyleHint styleHint() const
Returns the StyleHint.
Definition: qfont.cpp:1460
The QLatin1Char class provides an 8-bit ASCII/Latin-1 character.
Definition: qchar.h:55

◆ underline()

bool QFont::underline ( ) const

◆ weight()

int QFont::weight ( ) const

Returns the weight of the font which is one of the enumerated values from QFont::Weight.

See also
setWeight(), Weight, QFontInfo

Definition at line 1248 of file qfont.cpp.

Referenced by QTextHtmlParserNode::applyCssDeclarations(), QFont(), QFontToIFont(), QDeclarativeFontValueType::setBold(), QFontDialogPrivate::setFont(), QTextCharFormat::setFont(), setWeight(), QFontDatabase::styleString(), and toString().

1249 {
1250  return d->request.weight;
1251 }
QFontDef request
Definition: qfont_p.h:178
uint weight
Definition: qfont_p.h:95
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343

◆ wordSpacing()

qreal QFont::wordSpacing ( ) const

Returns the word spacing for the font.

Since
4.4
See also
setWordSpacing(), setLetterSpacing()

Definition at line 1735 of file qfont.cpp.

Referenced by QTextCharFormat::setFont(), and QDeclarativeFontValueType::setLetterSpacing().

1736 {
1737  return d->wordSpacing.toReal();
1738 }
QFixed wordSpacing
Definition: qfont_p.h:196
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
qreal toReal() const
Definition: qfixed_p.h:77

Friends and Related Functions

◆ operator<<

QDataStream & operator<< ( QDataStream s,
const QFont font 
)
friend

Writes the font font to the data stream s.

(toString() writes to a text stream.)

See also
Format of the QDataStream operators

Definition at line 2439 of file qfont.cpp.

2440 {
2441  if (s.version() == 1) {
2442  s << font.d->request.family.toLatin1();
2443  } else {
2444  s << font.d->request.family;
2445  }
2446 
2447  if (s.version() >= QDataStream::Qt_4_0) {
2448  // 4.0
2449  double pointSize = font.d->request.pointSize;
2451  s << pointSize;
2452  s << pixelSize;
2453  } else if (s.version() <= 3) {
2454  qint16 pointSize = (qint16) (font.d->request.pointSize * 10);
2455  if (pointSize < 0) {
2456 #ifdef Q_WS_X11
2457  pointSize = (qint16)(font.d->request.pixelSize*720/QX11Info::appDpiY());
2458 #else
2459  pointSize = (qint16)QFontInfo(font).pointSize() * 10;
2460 #endif
2461  }
2462  s << pointSize;
2463  } else {
2464  s << (qint16) (font.d->request.pointSize * 10);
2465  s << (qint16) font.d->request.pixelSize;
2466  }
2467 
2468  s << (quint8) font.d->request.styleHint;
2469  if (s.version() >= QDataStream::Qt_3_1)
2470  s << (quint8) font.d->request.styleStrategy;
2471  s << (quint8) 0
2472  << (quint8) font.d->request.weight
2473  << get_font_bits(s.version(), font.d.data());
2474  if (s.version() >= QDataStream::Qt_4_3)
2475  s << (quint16)font.d->request.stretch;
2476  if (s.version() >= QDataStream::Qt_4_4)
2477  s << get_extended_font_bits(font.d.data());
2478  if (s.version() >= QDataStream::Qt_4_5) {
2479  s << font.d->letterSpacing.value();
2480  s << font.d->wordSpacing.value();
2481  }
2482  return s;
2483 }
int qint32
Definition: qglobal.h:937
int value() const
Definition: qfixed_p.h:73
qreal pointSize
Definition: qfont_p.h:89
int pixelSize() const
Returns the pixel size of the font if it was set with setPixelSize().
Definition: qfont.cpp:1178
unsigned char quint8
Definition: qglobal.h:934
QFixed wordSpacing
Definition: qfont_p.h:196
friend class QFontInfo
Definition: qfont.h:314
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
QFontDef request
Definition: qfont_p.h:178
static quint8 get_font_bits(int version, const QFontPrivate *f)
Definition: qfont.cpp:2257
short qint16
Definition: qglobal.h:935
unsigned short quint16
Definition: qglobal.h:936
uint weight
Definition: qfont_p.h:95
QByteArray toLatin1() const Q_REQUIRED_RESULT
Returns a Latin-1 representation of the string as a QByteArray.
Definition: qstring.cpp:3993
QFixed letterSpacing
Definition: qfont_p.h:195
qreal pixelSize
Definition: qfont_p.h:90
int version() const
Returns the version number of the data serialization format.
Definition: qdatastream.h:212
static quint8 get_extended_font_bits(const QFontPrivate *f)
Definition: qfont.cpp:2284
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
if(void) toggleToolbarShown
uint stretch
Definition: qfont_p.h:98
int pointSize() const
Returns the point size of the font.
Definition: qfont.cpp:981
QString family
Definition: qfont_p.h:82
uint styleHint
Definition: qfont_p.h:93
uint styleStrategy
Definition: qfont_p.h:92
static int appDpiY(int screen=-1)
Returns the vertical resolution of the given screen in terms of the number of dots per inch...

◆ operator>>

QDataStream & operator>> ( QDataStream s,
QFont font 
)
friend

Reads the font font from the data stream s.

(fromString() reads from a text stream.)

See also
Format of the QDataStream operators

Definition at line 2497 of file qfont.cpp.

2498 {
2499  font.d = new QFontPrivate;
2501 
2503 
2504  if (s.version() == 1) {
2505  QByteArray fam;
2506  s >> fam;
2507  font.d->request.family = QString::fromLatin1(fam);
2508  } else {
2509  s >> font.d->request.family;
2510  }
2511 
2512  if (s.version() >= QDataStream::Qt_4_0) {
2513  // 4.0
2514  double pointSize;
2515  qint32 pixelSize;
2516  s >> pointSize;
2517  s >> pixelSize;
2518  font.d->request.pointSize = qreal(pointSize);
2519  font.d->request.pixelSize = pixelSize;
2520  } else {
2521  qint16 pointSize, pixelSize = -1;
2522  s >> pointSize;
2523  if (s.version() >= 4)
2524  s >> pixelSize;
2525  font.d->request.pointSize = qreal(pointSize / 10.);
2526  font.d->request.pixelSize = pixelSize;
2527  }
2528  s >> styleHint;
2529  if (s.version() >= QDataStream::Qt_3_1)
2530  s >> styleStrategy;
2531 
2532  s >> charSet;
2533  s >> weight;
2534  s >> bits;
2535 
2536  font.d->request.styleHint = styleHint;
2538  font.d->request.weight = weight;
2539 
2540  set_font_bits(s.version(), bits, font.d.data());
2541 
2542  if (s.version() >= QDataStream::Qt_4_3) {
2543  quint16 stretch;
2544  s >> stretch;
2545  font.d->request.stretch = stretch;
2546  }
2547 
2548  if (s.version() >= QDataStream::Qt_4_4) {
2549  quint8 extendedBits;
2550  s >> extendedBits;
2551  set_extended_font_bits(extendedBits, font.d.data());
2552  }
2553  if (s.version() >= QDataStream::Qt_4_5) {
2554  int value;
2555  s >> value;
2556  font.d->letterSpacing.setValue(value);
2557  s >> value;
2558  font.d->wordSpacing.setValue(value);
2559  }
2560 
2561  return s;
2562 }
double qreal
Definition: qglobal.h:1193
int qint32
Definition: qglobal.h:937
qreal pointSize
Definition: qfont_p.h:89
int pixelSize() const
Returns the pixel size of the font if it was set with setPixelSize().
Definition: qfont.cpp:1178
The QByteArray class provides an array of bytes.
Definition: qbytearray.h:135
unsigned char quint8
Definition: qglobal.h:934
QFixed wordSpacing
Definition: qfont_p.h:196
T * data() const
Returns a pointer to the shared data object.
Definition: qshareddata.h:145
void setValue(int value)
Definition: qfixed_p.h:74
uint resolve_mask
Definition: qfont.h:344
QFontDef request
Definition: qfont_p.h:178
short qint16
Definition: qglobal.h:935
unsigned short quint16
Definition: qglobal.h:936
uint weight
Definition: qfont_p.h:95
static void set_font_bits(int version, quint8 bits, QFontPrivate *f)
Definition: qfont.cpp:2301
QFixed letterSpacing
Definition: qfont_p.h:195
friend class QFontPrivate
Definition: qfont.h:310
qreal pixelSize
Definition: qfont_p.h:90
int version() const
Returns the version number of the data serialization format.
Definition: qdatastream.h:212
static QString fromLatin1(const char *, int size=-1)
Returns a QString initialized with the first size characters of the Latin-1 string str...
Definition: qstring.cpp:4188
QExplicitlySharedDataPointer< QFontPrivate > d
Definition: qfont.h:343
int weight() const
Returns the weight of the font which is one of the enumerated values from QFont::Weight.
Definition: qfont.cpp:1248
uint stretch
Definition: qfont_p.h:98
int pointSize() const
Returns the point size of the font.
Definition: qfont.cpp:981
StyleStrategy styleStrategy() const
Returns the StyleStrategy.
Definition: qfont.cpp:1447
QString family
Definition: qfont_p.h:82
StyleHint styleHint() const
Returns the StyleHint.
Definition: qfont.cpp:1460
uint styleHint
Definition: qfont_p.h:93
uint styleStrategy
Definition: qfont_p.h:92
int stretch() const
Returns the stretch factor for the font.
Definition: qfont.cpp:1618
static void set_extended_font_bits(quint8 bits, QFontPrivate *f)
Definition: qfont.cpp:2317

◆ Q3TextFormatCollection

friend class Q3TextFormatCollection
friend

Definition at line 321 of file qfont.h.

◆ QAlphaPaintEngine

friend class QAlphaPaintEngine
friend

Definition at line 329 of file qfont.h.

◆ QApplication

friend class QApplication
friend

Definition at line 318 of file qfont.h.

◆ QCommandLinkButtonPrivate

Definition at line 335 of file qfont.h.

◆ QFontDialogPrivate

friend class QFontDialogPrivate
friend

Definition at line 311 of file qfont.h.

◆ QFontEngine

friend class QFontEngine
friend

Definition at line 336 of file qfont.h.

◆ QFontInfo

friend class QFontInfo
friend

Definition at line 314 of file qfont.h.

◆ QFontMetrics

friend class QFontMetrics
friend

Definition at line 312 of file qfont.h.

◆ QFontMetricsF

friend class QFontMetricsF
friend

Definition at line 313 of file qfont.h.

◆ QFontPrivate

friend class QFontPrivate
friend

Definition at line 310 of file qfont.h.

Referenced by QFont().

◆ QGLContext

friend class QGLContext
friend

Definition at line 327 of file qfont.h.

◆ QPaintBufferEngine

friend class QPaintBufferEngine
friend

Definition at line 334 of file qfont.h.

◆ QPainter

friend class QPainter
friend

Definition at line 315 of file qfont.h.

◆ QPainterPath

friend class QPainterPath
friend

Definition at line 330 of file qfont.h.

◆ QPainterPrivate

friend class QPainterPrivate
friend

Definition at line 316 of file qfont.h.

◆ QPainterReplayer

friend class QPainterReplayer
friend

Definition at line 333 of file qfont.h.

◆ QPicturePaintEngine

friend class QPicturePaintEngine
friend

Definition at line 332 of file qfont.h.

◆ QPSPrintEngineFont

friend class QPSPrintEngineFont
friend

Definition at line 317 of file qfont.h.

◆ QScriptLine

friend struct QScriptLine
friend

Definition at line 326 of file qfont.h.

◆ QStackTextEngine

friend class QStackTextEngine
friend

Definition at line 324 of file qfont.h.

◆ QTextEngine

friend class QTextEngine
friend

Definition at line 323 of file qfont.h.

◆ QTextItemInt

friend class QTextItemInt
friend

Definition at line 331 of file qfont.h.

◆ QTextLayout

friend class QTextLayout
friend

Definition at line 322 of file qfont.h.

◆ QTextLine

friend class QTextLine
friend

Definition at line 325 of file qfont.h.

◆ QWidget

friend class QWidget
friend

Definition at line 319 of file qfont.h.

◆ QWidgetPrivate

friend class QWidgetPrivate
friend

Definition at line 320 of file qfont.h.

◆ QWin32PaintEngine

friend class QWin32PaintEngine
friend

Definition at line 328 of file qfont.h.

Properties

◆ d

◆ resolve_mask

uint QFont::resolve_mask
private

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