1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: Describe updating fonts with substitutes

Browse Source 
Fixes: QTBUG-82577
Change-Id: I40662240da69c0d93d0386172c10f375fbb5fefc
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
This commit is contained in:
Leena Miettinen 2020-03-26 12:34:55 +01:00
parent e03a3882be
commit 37bd3fbccd
1 changed files with 10 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
src/gui/text/qfont.cpp
View File

@ -420,7 +420,9 @@ QFontEngineData::~QFontEngineData()
be removed with removeSubstitutions(). Use substitute() to retrieve be removed with removeSubstitutions(). Use substitute() to retrieve
a family's first substitute, or the family name itself if it has 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 no substitutes. Use substitutes() to retrieve a list of a family's
substitutes (which may be empty). substitutes (which may be empty). After substituting a font, you must
trigger the updating of the font by destroying and re-creating all
QFont objects.
Every QFont has a key() which you can use, for example, as the key 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 in a cache or dictionary. If you want to store a user's font
@ -1864,6 +1866,9 @@ QStringList QFont::substitutes(const QString &familyName)
Inserts \a substituteName into the substitution Inserts \a substituteName into the substitution
table for the family \a familyName. table for the family \a familyName.
After substituting a font, trigger the updating of the font by destroying
and re-creating all QFont objects.
\sa insertSubstitutions(), removeSubstitutions(), substitutions(), substitute(), substitutes() \sa insertSubstitutions(), removeSubstitutions(), substitutions(), substitute(), substitutes()
*/ */
void QFont::insertSubstitution(const QString &familyName, void QFont::insertSubstitution(const QString &familyName,
@ -1882,6 +1887,10 @@ void QFont::insertSubstitution(const QString &familyName,
Inserts the list of families \a substituteNames into the Inserts the list of families \a substituteNames into the
substitution list for \a familyName. substitution list for \a familyName.
After substituting a font, trigger the updating of the font by destroying
and re-creating all QFont objects.
\sa insertSubstitution(), removeSubstitutions(), substitutions(), substitute() \sa insertSubstitution(), removeSubstitutions(), substitutions(), substitute()
*/ */
void QFont::insertSubstitutions(const QString &familyName, void QFont::insertSubstitutions(const QString &familyName,