PieSlice QML Type
パイシリーズの1つのスライスを表します。詳細...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QPieSlice |
プロパティ
- 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
スライスの値。
注: 負の値は正の値に変換される。
シグナル・ドキュメント
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.