Imagine Style

Der Imagine Style basiert auf konfigurierbaren Bild-Assets. Mehr...

Angehängte Eigenschaften

• path: Zeichenkette

Detaillierte Beschreibung

Der Imagine-Stil basiert auf Bild-Assets. Der Stil wird mit einem Standardsatz von Bildern geliefert, aber die Bilder können leicht geändert werden, indem ein Verzeichnis mit Bildern unter Verwendung einer vordefinierten Namenskonvention angegeben wird.

Der Imagine-Stil mit den Standardbildern

Um eine Anwendung mit dem Imagine-Stil auszuführen, siehe Verwenden von Stilen in Qt Quick Controls.

Dateinamen

Die Bilddateien werden nach der folgenden Konvention benannt:

<control>-<element>-<states>

Die Abschnitte <control> und <element> sind obligatorisch, während der Abschnitt <states> optional ist. Wenn zum Beispiel eine einzige Datei mit dem Namen "button-background.9.png" für Button bereitgestellt wird, wird sie für jeden Zustand verwendet, den Button unterstützt. Es liegt im Ermessen des Entwicklers, für welche Zustände er Bilder zur Verfügung stellt. Es wird jedoch empfohlen, nach Möglichkeit Bilder für die häufigsten Zustände der Steuerelemente bereitzustellen, z. B. für disabled, pressed usw. Dadurch wird sichergestellt, dass sich interaktive Steuerelemente visuell so verhalten, wie der Endbenutzer es erwartet.

Element-Referenz

In der folgenden Tabelle ist aufgeführt, welche Elemente für jedes Steuerelement unterstützt werden, zusammen mit den möglichen Zuständen für dieses Element und der erwarteten Dateierweiterung. Ein Element ist ein Bild, das einen bestimmten visuellen Teil des Steuerelements darstellt. Das Element "background" von Button stellt beispielsweise das Element background dar.

Asset-Beispiele

In der folgenden Tabelle sind Beispiele von Assets (aus den Standard-Assets im Imagine-Stil) für alle Steuerelemente aufgeführt. Die Liste erhebt keinen Anspruch auf Vollständigkeit, da nicht alle Elemente Assets benötigen, aber sie kann als Leitfaden für die Erstellung eigener Assets dienen.

Die Vorlage, aus der diese Elemente exportiert wurden, ist als Sketch-Projekt verfügbar.

¹ Ein 1x1-Bild mit einer Farbe, das so gestreckt wird, dass es das Steuerelement ausfüllt.

9-Felder-Bilder

Der Imagine-Stil verwendet 9-Patch-Bilder, um den Designern die Kontrolle darüber zu geben, wie ein bestimmtes Element auf eine Größenänderung reagiert. Hier ist ein Beispiel für ein 9-Felder-Bild, das ein Button's background darstellt, zusammen mit einer vergrößerten Version (um die 9-Felder-Linien besser erkennen zu können):

Der Inhalt des Bildes ist 44 Pixel breit und 32 Pixel hoch. Jedes 9-Felder-Bild benötigt an jeder Seite eine ein Pixel dicke Linie (zusammenfassend als "9-Felder-Linien" bezeichnet), so dass die tatsächliche Größe des Bildes 46 Pixel breit und 34 Pixel hoch ist. Beachten Sie, dass die 9-Patch-Linien unabhängig von der Ziel-DPI des Bildes ein Pixel dick sein müssen. Zum Beispiel müssen die 9-Patch-Linien für button-background.9.png und button-background@2x.9.png beide ein Pixel dick sein.

Die 9-Patch-Linien müssen schwarz sein, und die übrigen Bereiche müssen transparent oder weiß sein:

Dehnbare Bereiche

Die 9-Patch-Linien am oberen und linken Rand bestimmen, welche Teile des Bildes bei einer Größenänderung gedehnt werden.

Unten sehen Sie Beispiele für die Änderung der Größe des 9-Felder-Bildes auf das Eineinhalbfache seiner ursprünglichen Größe in verschiedenen Dimensionen:

Beachten Sie, dass die abgerundeten Ecken ihre ursprüngliche Größe beibehalten, da sie sich außerhalb des Bereichs der Linien befinden.

Aufgefüllte Bereiche

Die 9-Patch-Linien am rechten und unteren Rand bestimmen, wie viel Platz für das Steuerelement contentItem zur Verfügung steht, was bedeutet, dass es auch als Steuerung der padding betrachtet werden kann. Ein Diagramm zur Veranschaulichung der Auffüllung finden Sie unter Control Layout.

Nachfolgend finden Sie weitere Beispiele für die Größenänderung des 9-Felder-Bildes, wobei dieses Mal gezeigt wird, wie die 9-Felder-Linien zum Auffüllen funktionieren.

Die contentItem kann innerhalb der schattierten Bereiche so viel Platz einnehmen, wie sie benötigt. Wenn die Auffüllungslinien weggelassen werden, nimmt contentItem so viel Platz ein, wie es braucht, ohne die dehnbaren Bereiche zu überschreiten.

Eingeschobene Bereiche

In manchen Fällen ist es notwendig, dass ein Steuerelement z. B. einen Schlagschatten hat. Wenn wir jedoch der obigen Schaltfläche einen Schlagschatten hinzufügen würden, würde sich dies auf ihre Größe auswirken, was sowohl für das Layout als auch für die Begrenzung der Maus-/Toucheingabe Probleme mit sich bringt.

Einfügebereiche berücksichtigen dies, indem sie dem Steuerelement mitteilen, dass ein bestimmter Bereich des 9-Felder-Bildes außerhalb des Steuerelements liegen soll:

In der Abbildung unten stellt die gestrichelte Linie den anklickbaren Bereich der Schaltfläche sowie den Platz dar, den sie in einem Layout einnehmen wird. Der Schatten ist durch den gestreiften Bereich dahinter gekennzeichnet:

Exportieren von 9-Patch-Bildern

Verschiedene Vektor- und Bitmap-Editoren können verwendet werden, um 9-Patch-Bilder zu erstellen, die für die Verwendung mit dem Imagine-Stil geeignet sind. In den folgenden Abschnitten wird der Exportvorgang für jeden Editor kurz erläutert, und im letzten Abschnitt wird erklärt, wie Sie sicherstellen, dass die exportierten Bilder 9-Patch-konform sind.

Affinity Designer

Siehe die Dokumentation zu den Export-Einstellungen von Affinity.

Adobe Illustrator

Siehe die Dokumentation des Asset-Export-Panels von Adobe.

Adobe Photoshop

Siehe die Dokumentation Generieren von Bild-Assets aus Ebenen von Adobe.

Inkscape

Die Inkscape 9-Patch Export Extension kann verwendet werden, um Assets mit Inkscape zu exportieren.

Skizze

Siehe Sketch's Exporting Dokumentation.

Qt Quick Controls bietet auch ein Plugin für Sketch, das die Dicke der 9-Patch-Linien nach dem Exportieren der Assets automatisch korrigiert. Um diese Datei zu installieren, doppelklicken Sie auf sie. Sobald Sketch bestätigt hat, dass das 9-Patch-Export-Plugin installiert wurde, verarbeitet das Plugin die Bilder automatisch, wenn sie exportiert werden.

Reparieren von 9-Patch-Linien

Beim Export von 9-Patch-Bildern in verschiedenen DPI-Varianten (@2x, @3x, etc.) werden die 9-Patch-Linien in der Regel zusammen mit dem Bild hochskaliert. Es gibt mehrere Möglichkeiten, dies zu beheben, aber die vielleicht einfachste Methode ist die Verwendung des ImageMagick-Werkzeugs mogrify. Das Werkzeug verfügt über die Funktion -shave, mit der Sie das Bild zuschneiden können, um die Dicke der 9-Felder-Linien zu verringern:

mogrify -shave 1x1 -path path/to/images *@2x.9.png
mogrify -shave 2x2 -path path/to/images *@3x.9.png
mogrify -shave 3x3 -path path/to/images *@4x.9.png

Bilder mit normalen DPI-Werten (ohne das Präfix @Nx ) sind davon nicht betroffen, so dass der Befehl nur bei Bildern ausgeführt werden muss, die für Bildschirme mit hohen DPI-Werten bestimmt sind.

Animierte Bilder

Die Formate WebP und GIF für animierte Bilder werden vom Imagine-Stil unterstützt.

Anpassung

Pfad

Der Imagine-Stil ermöglicht die Anpassung des Pfads, der für die Auswahl von Bild-Assets verwendet wird. Der Pfad kann für jedes beliebige Fenster oder Element angegeben werden und wird automatisch auf die untergeordneten Elemente übertragen, genau wie bei fonts. Im folgenden Beispiel werden das Fenster und alle drei Optionsfelder mit dunklen Bildelementen angezeigt (Dateien, die sich in "qrc:/themes/dark" befinden).

import QtQuick 2.12
import QtQuick.Controls 2.12
import QtQuick.Controls.Imagine 2.12

ApplicationWindow {
    visible: true

    Imagine.path: "qrc:/themes/dark"

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium"); checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

Neben der Angabe des Pfades in QML ist es auch möglich, ihn über eine Umgebungsvariable oder in einer Konfigurationsdatei anzugeben. In QML angegebene Attribute haben Vorrang vor allen anderen Methoden.

Konfigurationsdatei

[Imagine]
Path=:/imagine-assets

[Imagine]
Path=imagine-assets

Weitere Informationen zur Konfigurationsdatei finden Sie unter Qt Quick Controls Konfigurationsdatei.

Umgebungsvariablen

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Eine vollständige Liste der unterstützten Umgebungsvariablen finden Sie unter Unterstützte Umgebungsvariablen in Qt Quick Controls.

Palette

Der Stil Imagine unterstützt die Anpassung der Palette über die Eigenschaft palette und die Datei qtquickcontrols2.conf. Wie bei anderen Stilen ist die genaue palette roles, die der Imagine-Stil verwendet, stilabhängig. Da jedoch der größte Teil des visuellen Erscheinungsbildes von Steuerelementen (z. B. Hintergründe) über Bild-Assets verwaltet wird, haben nur die Rollen, die typischerweise für Text verwendet werden, einen Einfluss.

Schriftart

Benutzerdefinierte Schriftarten können über die Eigenschaft font und die Konfigurationsdatei festgelegt werden.

Abhängigkeit

Der Imagine-Stil muss separat importiert werden, um Zugriff auf die Attribute zu erhalten, die für den Imagine-Stil spezifisch sind. Es ist zu beachten, dass unabhängig von den Verweisen auf den Imagine-Stil derselbe Anwendungscode mit jedem anderen Stil ausgeführt werden kann. Imagine-spezifische Attribute wirken sich nur aus, wenn die Anwendung mit dem Imagine-Stil ausgeführt wird.

Wenn der Imagine-Stil in eine QML-Datei importiert wird, die immer geladen wird, muss der Imagine-Stil mit der Anwendung bereitgestellt werden, damit die Anwendung unabhängig davon ausgeführt werden kann, mit welchem Stil die Anwendung ausgeführt wird. Durch die Verwendung von Datei-Selektoren können stil-spezifische Anpassungen vorgenommen werden, ohne eine feste Abhängigkeit von einem Stil zu schaffen.

Siehe auch Styling Qt Quick Controls

Dokumentation der angehängten Eigenschaft

Diese angehängte Eigenschaft enthält den Pfad zu den Bild-Assets...

Button {
    Imagine.path: "qrc:/themes/dark"
}

Verwandte Informationen

• Styling Qt Quick Controls
• Beispiel Automobil