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 [read-only, since 6.0]

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 [read-only]

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 [read-only]

Diese Eigenschaft enthält den Status des Ladens der Schriftart. Sie kann eine der folgenden sein:

KonstanteBeschreibung
FontLoader.NullEs wurde keine Schriftart festgelegt
FontLoader.Readydie Schriftart wurde bereits geladen
FontLoader.Loadingdie Schriftart wird gerade geladen
FontLoader.Errorbeim 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.