このページでは

C

ShapePath QML Type

パス と 、 それに関連す る 描線 と 塗 り のプ ロ パテ ィ を記述 し ます。詳細...

Import Statement: import QtQuick.Shapes
Since: Qt Quick Ultralite 1.8
Inherits:

Path

列挙

プロパティ

詳細説明

Shape には、1 つ以上の ShapePath 要素が含まれます。Shapeを出力するためには、少なくとも1つのShapePathが必要です。ShapePath 自体はPath で、ストロークの幅や色、塗りつぶしの色やグラデーション、結合やキャップのスタイルなど、ストロークや塗りつぶしのパラメータを記述する追加のプロパティを持ちます。通常のPath オブジェクトと同様に、ShapePath はPathMove,PathLine,PathCubic,PathQuad,PathArc のようなパス要素のリストと開始位置も含んでいます。

これらのデータセットでプロパティを変更すると、バブルアップされ、シェイプの出力が変更されます。つまり、通常のQMLバインディングやアニメーションタイプ(NumberAnimation )を使って、開始位置や終了位置、制御点、ストロークや塗りつぶしのパラメータを簡単に変更したり、アニメーション化したりすることができます。

次の例では、joinStyleIndexの値によって線の結合スタイルが自動的に変わります:

import QtQuick
import QtQuick.Shapes
Rectangle {
    width: 300
    height: 300
    Shape {
        width: 200
        height: 150
        ShapePath {
            strokeColor: "black"
            strokeWidth: 16
            fillColor: "transparent"
            capStyle: ShapePath.RoundCap
            joinStyle: ShapePath.RoundJoin
            startX: 30
            startY: 30
            PathLine { x: 100; y: 100 }
            PathLine { x: 30; y: 100 }
        }
    }
}

シェイプに関連付けられた結果は以下の通りです:

注: QtQuick.Shapes をインポートするには、Qul::Shapes モジュールをプロジェクトにリンクする必要があります。詳しくは Qt Quick Ultralite Shapes QML Types.

Qt Quick Ultralite shapes ExampleおよびShapeも参照して ください。

列挙ドキュメント

CapStyle

行末のオプションのリストを提供します。

定数説明
ShapePath.FlatCap線の終点を覆わない正方形の線端。
ShapePath.SquareCap終点を覆い、そこから線幅の半分だけはみ出る正方形の線端。
ShapePath.RoundCap丸みを帯びた線端。

FillRule

塗りつぶしルールのオプションのリストを提供します。

定数説明
ShapePath.OddEvenFill奇偶塗り潰し規則。
ShapePath.WindingFill非ゼロ巻き塗りルール

JoinStyle

結合スタイルのオプションのリストを提供します。

定数説明
ShapePath.MiterJoin線の外縁が斜めになるように延長され、この領域が塗りつぶされます。
ShapePath.BevelJoin2つの線の間の三角形の切り欠きが塗りつぶされます。
ShapePath.RoundJoin2本の線の間の円弧が塗りつぶされる。

プロパティの説明

capStyle : CapStyle [default]

このプロパティは、線の端点の描画方法を定義します。


fillColor : color

このプロパティは塗りつぶしの色を保持する。

transparent に設定すると、塗りつぶしは行われない。

デフォルト値はwhite です。


fillGradient : ShapeGradient [since Qt Quick Ultralite 2.7]

このプロパティは、塗りつぶしのグラデーションを定義します。デフ ォル ト ではグ ラ デ ィ エ ン ト は有効であ り ませんので、 こ の値は null です。こ の場合、 塗 り はShapePath.fillColor の値に基づ く 無地を用います。

設定されている場合、ShapePath.fillColor は無視され、ShapeGradient のサブタイプのいずれかを使用して塗りつぶしが行われます。

注: Gradient 基本型はここでは使用できません。LinearGradient サブ型を使用する必要があります。

このプロパティは、Qt Quick Ultralite 2.7で導入されました。


fillRule : FillRule [default]

このプロパティは塗りつぶし規則を保持します。塗りつぶしルールの説明については、QPainterPath::setFillRule() を参照してください。


joinStyle : JoinRule [default]

このプロパティは、2つの接続線間の結合がどのように描画されるかを定義します。


miterLimit : int [default]

joinStyleShapePath.MiterJoin に設定されている場合、このプロパティは、マイター結合が結合点からどの程度まで拡張できるかを指定します。


strokeColor : color

このプロパティは描線色を保持する。

transparent に設定する と 、 描線は行われません。

デフォル ト 値はwhite です。


strokeWidth : real

こ のプ ロパテ ィ は描線幅を保持 し ます。

負の値に設定する と 、 描線は行われません。

デフォルト値は 1 です。


特定の Qt ライセンスの下で利用可能です。
詳細はこちら。