Gradient QML Type

Definiert eine Farbverlaufsfüllung. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• orientation : enumeration
• stops : list<GradientStop>

Detaillierte Beschreibung

Ein Farbverlauf wird durch zwei oder mehr Farben definiert, die nahtlos ineinander übergehen sollen.

Die Farben werden als eine Reihe von GradientStop untergeordneten Elementen angegeben, von denen jedes eine Position auf dem Farbverlauf von 0,0 bis 1,0 und eine Farbe definiert. Die Position jedes GradientStop wird durch Festlegen der Eigenschaft position definiert; die Farbe wird durch die Eigenschaft color festgelegt.

Ein Farbverlauf ohne Farbverlaufsstopps wird als einfarbige weiße Füllung wiedergegeben.

Beachten Sie, dass dieses Element keine visuelle Darstellung eines Farbverlaufs ist. Um einen Farbverlauf anzuzeigen, verwenden Sie ein visuelles Element (wie Rectangle), das die Verwendung von Farbverläufen unterstützt.

Beispiel für die Verwendung

Das folgende Beispiel deklariert ein Element Rectangle mit einem Farbverlauf, der mit Rot beginnt, bei einem Drittel der Höhe des Rechtecks in Gelb übergeht und mit Grün endet:

Rectangle {
    width: 100; height: 100
    gradient: Gradient {
        GradientStop { position: 0.0; color: "red" }
        GradientStop { position: 0.33; color: "yellow" }
        GradientStop { position: 1.0; color: "green" }
    }
}

Leistung und Beschränkungen

Die Berechnung von Farbverläufen kann im Vergleich zur Verwendung von einfarbigen Füllungen oder Bildern sehr rechenintensiv sein. Erwägen Sie die Verwendung von Farbverläufen für statische Elemente in einer Benutzeroberfläche.

Seit Qt 5.12 können vertikale und horizontale lineare Farbverläufe auf Elemente angewendet werden. Wenn Sie schräge Verläufe benötigen, kann eine Kombination aus Rotation und Beschneidung auf die entsprechenden Elemente angewendet werden. Alternativ dazu können Sie QtQuick.Shapes::LinearGradient oder QtGraphicalEffects::LinearGradient verwenden. Alle diese Ansätze können zusätzliche Leistungsanforderungen für Ihre Anwendung mit sich bringen.

Die Verwendung von Animationen mit Farbverlaufsstopps führt möglicherweise nicht zum gewünschten Ergebnis. Eine alternative Möglichkeit, Farbverläufe zu animieren, ist die Verwendung von vorgenerierten Bildern oder SVG-Zeichnungen, die Farbverläufe enthalten.

Siehe auch GradientStop.

Eigenschaft Dokumentation