Back to Qt.io
Contact Us Blog Download Qt

PieSlice QML Type

パイシリーズの1つのスライスを表します。詳細...

Import Statement: import QtGraphs
In C++: QPieSlice

プロパティ

信号

詳細説明

パイスライスは値とラベルを持つ。スライスがパイシリーズに追加されると、PieSeries タイプは、シリーズ内のすべてのスライスの合計と比較したスライスのパーセンテージを計算し、グラフ内のスライスの実際のサイズを決定します。

デフォルトでは、ラベルは非表示です。ラベルが表示されている場合、ラベルはスライスの外側に配置され、アームでスライスに接続されるか、スライスの内側に水平またはスライスの円弧の接線または法線と平行に配置されます。

デフォルトでは、スライスの外観はテーマによって設定されますが、スライスのプロパティを指定することでテーマを上書きすることができます。ただし、スライスをカスタマイズした後にテーマを変更すると、カスタマイズした内容はすべて失われます。

PieSlice タイプはPieSeries タイプの子として使用してください。例えば

PieSeries {
    PieSlice {
        label: "example"
        value: 1
    }
}

また、PieSeries.append() メソッドを使用して、パイシリーズにスライスを追加することもできます。

その場合、PieSeries.at() またはPieSeries.find() を使用して、個々の PieSlice インスタンスのプロパティにアクセスできます。

PieSeriesも参照してください 。

プロパティの説明

angleSpan : real [read-only]

スライスの角度を表します。完全なパイは360度で、0度は12時の方向です。スライスがシリーズに追加されると自動的に更新されます。


borderColor : color

スライスの境界線の描画に使用する色。

borderWidthも参照してください 。


borderWidth : qreal

スライス境界線の幅。これは、スライスの境界線の幅を変更するための便利なプロパティです。

borderColorも参照 。


color : color

スライスの塗りつぶし色。


explodeDistanceFactor : real

スライスがパイからどの程度離れているかを指定します。

  • 1.0は距離が半径と同じであることを意味します。
  • 0.5 は距離が半径の半分であることを意味します。

デフォルトでは、距離は 0.15 です。

explodedも参照してください 。


exploded : bool

スライスをパイから切り離すかどうか。

explodeDistanceFactorも参照して ください。


label : string

スライスのラベル。

注意: 文字列は HTML 形式にすることができます。


labelArmLengthFactor : real

ラベルのアームの長さ。係数はパイの半径に対する相対値です。例えば

  • 1.0 は半径と同じ長さを意味します。
  • 0.5 は長さが半径の半分であることを意味します。

デフォルトでは、アームの長さは0.15です。

labelVisibleも参照してください 。


labelColor : color

スライスラベルの描画に使用する色。


labelFont : font

スライス・ラベルに使用するフォント。

詳細はfont を参照。

labelVisible およびlabelPosition も参照 。


labelPosition : enumeration

スライスラベルの位置を記述します。

定数説明
PieSlice.LabelPosition.Outsideラベルは、アームで接続されたスライスの外側に位置します。これはデフォルト値です。
PieSlice.LabelPosition.InsideHorizontalラベルはスライス内の中央にあり、水平に配置されます。
PieSlice.LabelPosition.InsideTangentialラベルはスライス内の中央にあり、スライスの円弧の接線と平行になるように回転する。
PieSlice.LabelPosition.InsideNormalラベルはスライス内の中央に置かれ、スライスの弧の法線と平行になるように回転される。

labelVisibleも参照 。


labelVisible : bool

スライスラベルの可視性。デフ ォル ト では、 ラ ベルは表示 さ れません。


percentage : real [read-only]

シリーズ内の全スライスの合計に対するスライスのパーセンテージ。実際の値は0.0から1.0まで。スライスがシリーズに追加されると自動的に更新される。


startAngle : real [read-only]

このスライスが属するシリーズの開始角度。完全なパイは360度で、0度は午前12時を指す。スライスがシリーズに追加されると自動的に更新されます。


value : real

スライスの値。

注意： 負の値は正の値に変換されます。


シグナル・ドキュメント

angleSpanChanged()

このシグナルは、スライスの角度が変化したときに発信されます。

注： 対応するハンドラはonAngleSpanChanged 。

angleSpanも参照してください 。


borderColorChanged()

このシグナルはスライスのボーダーの色が変化したときに発せられます。

注意 : 対応するハンドラはonBorderColorChanged です。

borderColorも参照して ください。


borderWidthChanged()

このシグナルはスライスのボーダーの幅が変更されたときに発せられます。

注 : 対応するハンドラはonBorderWidthChanged です。

borderWidthも参照して ください。


colorChanged()

このシグナルはスライスの色が変わったときに発せられます。

注： 対応するハンドラはonColorChanged です。


explodeDistanceFactorChanged()

このシグナルは爆発距離係数が変化したときに発せられます。

注 : 対応するハンドラはonExplodeDistanceFactorChanged です。

explodeDistanceFactorも参照してください 。


explodedChanged()

このシグナルはexplodeプロパティが変更されたときに発せられます。

注 : 対応するハンドラはonExplodedChanged です。

explodedも参照して ください。


labelArmLengthFactorChanged()

このシグナルは、ラベルの腕の長さ係数が変化したときに発せられます。

注意 ：対応するハンドラはonLabelArmLengthFactorChanged です。

labelArmLengthFactorも参照して ください。


labelChanged()

このシグナルはスライスラベルが変更されたときに発せられます。

注 ：対応するハンドラはonLabelChanged 。

labelも参照して ください。


labelColorChanged()

このシグナルはスライスラベルの色が変わったときに発せられます。

注意 : 対応するハンドラはonLabelColorChanged です。

labelColorも参照して ください。


labelFontChanged()

このシグナルはスライスのラベルのフォントが変更されたときに発せられます。

注 : 対応するハンドラはonLabelFontChanged です。

labelFontも参照して ください。


labelFontChanged()

このシグナルはラベルのフォントが変更されたときに発せられます。

注 : 対応するハンドラはonLabelFontChanged です。

labelFontも参照して ください。


labelPositionChanged()

このシグナルはラベルの位置が変更されたときに発せられます。

注意 : 対応するハンドラはonLabelPositionChanged です。

labelPositionも参照して ください。


labelVisibleChanged()

このシグナルは、スライスラベルの可視性が変化したときに発せられます。

注 : 対応するハンドラはonLabelVisibleChanged です。

labelVisibleも参照して ください。


percentageChanged()

このシグナルはスライスのパーセンテージが変更されたときに発行されます。

注 : 対応するハンドラはonPercentageChanged です。

percentageも参照 。


startAngleChanged()

このシグナルはスライスの開始角度が変更されたときに発せられます。

注 ：対応するハンドラはonStartAngleChanged 。

startAngleも参照して ください。


valueChanged()

このシグナルはスライス値が変更されたときに発せられます。

注 ：対応するハンドラはonValueChanged 。

valueも参照して ください。


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