FontLoader QML Type
Erlaubt das Laden von Schriftarten per URL. Mehr...
Import Statement: | import QtQuick |
Eigenschaften
Ausführliche Beschreibung
Der FontLoader-Typ wird zum Laden von Schriftarten per URL verwendet.
Die status zeigt an, wann die Schriftart geladen wurde, was für Schriftarten, die aus entfernten Quellen geladen wurden, nützlich ist.
Ein Beispiel:
import QtQuick 2.0 Column { FontLoader { id: webFont; source: "http://www.mysite.com/myfont.ttf" } Text { text: "Fancy font"; font: webFont.font } }
Siehe auch Qt Quick Beispiele - Text-Schriftarten.
Eigenschaft Dokumentation
font : font |
Diese Eigenschaft enthält eine Standardabfrage für die geladene Schriftart.
Sie können diese Eigenschaft verwenden, um die Schriftart auszuwählen, wenn andere Eigenschaften als nur der Name der Schriftfamilie benötigt werden, um eine eindeutige Zuordnung zu ermöglichen. Sie können die Schriftart entweder über einzelne Eigenschaften angeben:
Item { width: 200; height: 50 FontLoader { id: webFont source: "http://www.mysite.com/myfont.ttf" } Text { text: "Fancy font" font.family: webFont.font.family font.weight: webFont.font.weight font.styleName: webFont.font.styleName font.pixelSize: 24 } }
Oder Sie können direkt die vollständige Schriftartabfrage festlegen:
Item { width: 200; height: 50 FontLoader { id: webFont source: "http://www.mysite.com/myfont.ttf" } Text { text: "Fancy font" font: webFont.font } }
In diesem Fall wird die Standard-Schriftartabfrage ohne Änderungen verwendet (so wird z.B. die Schriftgröße die Systemvorgabe sein).
Diese Eigenschaft wurde in Qt 6.0 eingeführt.
name : string |
Diese Eigenschaft enthält den Namen der Schriftfamilie. Sie wird automatisch gesetzt, wenn eine Schriftart mit der Eigenschaft source geladen wird.
Sie ist äquivalent zur Eigenschaft family der Eigenschaft FontLoader's font.
Verwenden Sie dies, um die font.family
Eigenschaft eines Text
Elements zu setzen.
Beispiel:
Item { width: 200; height: 50 FontLoader { id: webFont source: "http://www.mysite.com/myfont.ttf" } Text { text: "Fancy font" font.family: webFont.name } }
source : url |
Die URL der zu ladenden Schriftart.
status : enumeration |
Diese Eigenschaft enthält den Status des Ladens der Schriftart. Sie kann eine der folgenden sein:
Konstante | Beschreibung |
---|---|
FontLoader.Null | Es wurde keine Schriftart festgelegt |
FontLoader.Ready | die Schriftart wurde bereits geladen |
FontLoader.Loading | die Schriftart wird gerade geladen |
FontLoader.Error | beim Laden der Schriftart ist ein Fehler aufgetreten |
Verwenden Sie diesen Status, um eine Aktualisierung vorzunehmen oder auf irgendeine Weise auf die Statusänderung zu reagieren. Zum Beispiel könnten Sie:
- Eine Statusänderung auslösen:
State { name: 'loaded'; when: loader.status == FontLoader.Ready }
- Implementieren Sie einen
onStatusChanged
Signalhandler:FontLoader { id: loader onStatusChanged: if (loader.status == FontLoader.Ready) console.log('Loaded') }
- Bindung an den Statuswert:
Text { text: loader.status == FontLoader.Ready ? 'Loaded' : 'Not loaded' }
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.