PieSlice QML Type
パイチャートシリーズ内の1つのスライスを表します。詳細...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QPieSlice |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- angleSpan : real
- borderColor : color
- borderWidth : int
- brushFilename : string
- color : color
- explodeDistanceFactor : real
- exploded : bool
- label : string
- labelArmLengthFactor : real
- labelColor : color
- labelFont : font
- labelPosition : enumeration
- labelVisible : bool
- percentage : real
- startAngle : real
- value : real
信号
- clicked()
- doubleClicked()
- hovered(bool state)
- pressed()
- released()
詳細な説明
円グラフのスライスには、値とラベルがあります。スライスが円グラフシリーズに追加されると、PieSeries タイプは、シリーズ内の全スライスの合計に対するそのスライスの割合を計算し、グラフ上のスライスの実際のサイズを決定します。
デフォルトでは、ラベルは非表示になっています。表示されている場合、ラベルはスライスの外側に配置され、アームでスライスと接続されるか、スライスの弧の接線または法線に平行に、水平方向にスライス内部の中央に配置されます。
デフォルトでは、スライスの外観はテーマによって設定されますが、スライスのプロパティを指定することでテーマを上書きできます。ただし、スライスのカスタマイズ後にテーマを変更すると、すべてのカスタマイズ設定が失われます。
PieSlice 型は、PieSeries 型の子として使用する必要があります。例:
あるいは、PieSeries.append() メソッドを使用して、パイシリーズにスライスを追加することもできます。
その場合、PieSeries.at() またはPieSeries.find を使用して、個々の PieSlice インスタンスのプロパティにアクセスできます。
PieSeriesも参照してください 。
プロパティのドキュメント
angleSpan : real [read-only]
スライスの角度範囲(度)。円全体は360度で、0度は12時の位置にあたります。スライスが系列に追加されると、自動的に更新されます。
borderColor : color
スライスの境界線を描く際に使用する色(ペン色)。
borderWidthも参照してください 。
borderWidth : int
スライスの境界線の幅。これは、スライスのペンを変更するための便宜上のプロパティです。
borderColorも参照してください 。
brushFilename : string
スライスのブラシとして使用されるファイルの名前。
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.LabelOutside | ラベルは、アームを介して接続されたスライスの外側に配置されます。これがデフォルト値です。 |
PieSlice.LabelInsideHorizontal | ラベルはスライス内で中央に配置され、水平方向に配置されます。 |
PieSlice.LabelInsideTangential | ラベルはスライス内で中央に配置され、スライスの弧の接線と平行になるように回転されます。 |
PieSlice.LabelInsideNormal | ラベルはスライス内で中央に配置され、スライスの弧の法線と平行になるように回転されます。 |
関連項目: labelVisible 。
labelVisible : bool
スライスのラベルの表示設定。デフォルトでは、ラベルは表示されません。
percentage : real [read-only]
そのスライスが、シリーズ内の全スライスの合計に占める割合です。実際の値は 0.0 から 1.0 の範囲です。スライスがシリーズに追加されると、自動的に更新されます。
startAngle : real [read-only]
このスライスが属するシリーズにおける開始角度です。円全体は360度で、0度は12時の位置にあたります。スライスがシリーズに追加されると、自動的に更新されます。
value : real
スライスの値。
注: 負の値は 正の値に変換されます。
Signal ドキュメント
clicked()
このシグナルは、スライスがクリックされたときに発火します。
対応するシグナルハンドラは `onClicked()` です。
注: 対応するハンドラは onClicked です。
doubleClicked()
このシグナルは、ユーザーがスライスをダブルクリックしたときに発生します。
対応するシグナルハンドラはonDoubleClicked() です。
注: 対応するハンドラは onDoubleClicked です。
hovered(bool state)
このシグナルは、マウスがスライスの上にホバーしたときに発生します。マウスがスライスの上を移動すると、state はtrue となり、マウスが再びスライスから離れると、false となります。
対応するシグナルハンドラはonHovered() です。
注: 対応するハンドラは onHovered です。
pressed()
このシグナルは、ユーザーがスライスをクリックしてマウスボタンを押し続けたときに発生します。
対応するシグナルハンドラはonPressed() です。
注: 対応するハンドラは onPressed です。
released()
このシグナルは、ユーザーがスライス上のマウスボタンを離したときに発生します。
対応するシグナルハンドラは `onReleased()` です。
注: 対応するハンドラは onReleased です。
© 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.