Auf dieser Seite

RectangularGlow QML Type

Erzeugt ein unscharfes und eingefärbtes Rechteck, das den Eindruck vermittelt, als würde die Quelle leuchten. Mehr...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

Eigenschaften

Ausführliche Beschreibung

Dieser Effekt ist auf eine gute Leistung ausgelegt. Die Form des Glüh-Effekts ist auf ein Rechteck mit einem benutzerdefinierten Eckenradius beschränkt. Für Fälle, in denen benutzerdefinierte Formen erforderlich sind, sollten Sie den Effekt „ Glow “ in Betracht ziehen.

Effekt angewendet

Weißer, rechteckiger Leuchteffekt

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Rectangle {
        id: background
        anchors.fill: parent
        color: "black"
    }

    RectangularGlow {
        id: effect
        anchors.fill: rect
        glowRadius: 10
        spread: 0.2
        color: "white"
        cornerRadius: rect.radius + glowRadius
    }

    Rectangle {
        id: rect
        color: "black"
        anchors.centerIn: parent
        width: Math.round(parent.width / 1.5)
        height: Math.round(parent.height / 2)
        radius: 25
    }
}

Dokumentation der Eigenschaften

cached : bool

Diese Eigenschaft ermöglicht es, die Ausgabepixel des Effekts zwischenzuspeichern, um die Rendering-Leistung zu verbessern.

Jedes Mal, wenn die Eigenschaften der Quelle oder des Effekts geändert werden, müssen die Pixel im Cache aktualisiert werden. Der Speicherverbrauch steigt, da ein zusätzlicher Speicherpuffer zum Speichern der Effekt-Ausgabe benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Eigenschaften der Quelle oder des Effekts animiert werden.

Standardmäßig ist die Eigenschaft auf „ false “ gesetzt.

color : color

Diese Eigenschaft legt den RGBA-Farbwert fest, der für den Leuchteffekt verwendet wird.

Standardmäßig ist die Eigenschaft auf „ "white" “ gesetzt.

Beispiele für die Ausgabe mit unterschiedlichen Farbwerten

Weißes Leuchten

Grünes Leuchten

Blaues Leuchten

color: #ffffff color: #55ff55 Farbe: #5555ff
glowRadius: 20glowRadius: 20glowRadius: 20
spread: 0spread: 0spread: 0
cornerRadius: 25cornerRadius: 25cornerRadius: 25

cornerRadius : real

Diese Eigenschaft definiert den Eckenradius, der zum Zeichnen eines Glüh-Effekts mit abgerundeten Ecken verwendet wird.

Der Wert reicht von 0,0 bis zur Hälfte der effektiven Breite oder Höhe des Glüfeffekts, je nachdem, welcher Wert kleiner ist. Dies lässt sich wie folgt berechnen: min(width, height) / 2.0 + glowRadius

Standardmäßig ist die Eigenschaft an die Eigenschaft „ glowRadius “ gebunden. Das Leuchten verhält sich so, als wäre das Rechteck unscharf, wenn die Eigenschaft „ glowRadius “ angepasst wird.

Ausgabebeispiele mit unterschiedlichen „cornerRadius“-Werten

Glühen mit Eckenradius 0

Glüh-Effekt mit Eckenradius 25

Glühen mit einem Eckenradius von 50

cornerRadius: 0 cornerRadius: 25 cornerRadius: 50
glowRadius: 20glowRadius: 20glowRadius: 20
spread: 0spread: 0spread: 0
color: #ffffffcolor: #ffffffcolor: #ffffff

glowRadius : real

Diese Eigenschaft legt fest, wie viele Pixel außerhalb des Elementbereichs vom Leuchteffekt erfasst werden.

Der Wert reicht von 0,0 (kein Leuchten) bis inf (unendliches Leuchten). Standardmäßig ist die Eigenschaft auf „ 0.0 “ gesetzt.

Ausgabebeispiele mit unterschiedlichen „glowRadius“-Werten

Leuchten mit einem Radius von 10

Leuchten mit einem Radius von 20

Leuchten mit einem Radius von 40

glowRadius: 10 glowRadius: 20 glowRadius: 40
spread: 0spread: 0spread: 0
color: #ffffffcolor: #ffffffcolor: #ffffff
cornerRadius: 25cornerRadius: 25cornerRadius: 25

spread : real

Diese Eigenschaft legt fest, wie stark die Leuchtfarbe in der Nähe der Ränder der Lichtquelle verstärkt wird.

Der Wert reicht von 0,0 (keine Verstärkung) bis 1,0 (maximale Verstärkung). Standardmäßig ist die Eigenschaft auf „ 0.0 “ eingestellt.

Ausgabebeispiele mit unterschiedlichen Ausbreitungswerten

Glühen mit Ausbreitung 0,0

Glühen mit Ausbreitung 0,5

Glow mit Ausbreitung 1,0

spread: 0,0 spread: 0,5 spread: 1,0
glowRadius: 20glowRadius: 20glowRadius: 20
color: #ffffffcolor: #ffffffcolor: #ffffff
cornerRadius: 25cornerRadius: 25cornerRadius: 25

© 2026 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.