QPieSlice Class
QPieSlice クラスは、パイ・シリーズ内の 1 つのスライスを表します。詳細...
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
| enum | LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal } |
プロパティ
|
|
パブリック関数
| QPieSlice(QObject *parent = nullptr) | |
| QPieSlice(QString label, qreal value, QObject *parent = nullptr) | |
| virtual | ~QPieSlice() |
| qreal | angleSpan() const |
| QColor | borderColor() |
| int | borderWidth() |
| QBrush | brush() const |
| QColor | color() |
| qreal | explodeDistanceFactor() const |
| bool | isExploded() const |
| bool | isLabelVisible() const |
| QString | label() const |
| qreal | labelArmLengthFactor() const |
| QBrush | labelBrush() const |
| QColor | labelColor() |
| QFont | labelFont() const |
| QPieSlice::LabelPosition | labelPosition() |
| QPen | pen() const |
| qreal | percentage() const |
| QPieSeries * | series() const |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(int width) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setExplodeDistanceFactor(qreal factor) |
| void | setExploded(bool exploded = true) |
| void | setLabel(QString label) |
| void | setLabelArmLengthFactor(qreal factor) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setLabelFont(const QFont &font) |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
| void | setLabelVisible(bool visible = true) |
| void | setPen(const QPen &pen) |
| void | setValue(qreal value) |
| qreal | startAngle() const |
| qreal | value() const |
シグナル
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | brushChanged() |
| void | clicked() |
| void | colorChanged() |
| void | doubleClicked() |
| void | hovered(bool state) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelVisibleChanged() |
| void | penChanged() |
| void | percentageChanged() |
| void | pressed() |
| void | released() |
| void | startAngleChanged() |
| void | valueChanged() |
詳細な説明
円グラフのスライスには、値とラベルがあります。スライスが円グラフシリーズに追加されると、QPieSeries オブジェクトは、シリーズ内の全スライスの合計に対するそのスライスの割合を計算し、チャート上のスライスの実際のサイズを決定します。
デフォルトでは、ラベルは非表示になっています。表示されている場合、ラベルはスライスの外側に配置され、アームでスライスと接続されるか、スライスの弧の接線または法線と平行になるように、スライスの内側に水平方向に中央揃えで配置されます。
デフォルトでは、スライスの外観はテーマによって設定されますが、スライスのプロパティを指定することでテーマを上書きすることができます。ただし、スライスをカスタマイズした後にテーマを変更すると、すべてのカスタマイズ設定が失われます。
円グラフでのユーザー操作を可能にするため、ユーザーが円グラフのスライスをクリックしたり、マウスをスライス上にホバーさせたりすると、いくつかの基本的なシグナルが発信されます。
「QPieSeries」も参照してください 。
メンバ型のドキュメント
enum QPieSlice::LabelPosition
この列挙型は、スライスラベルの位置を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QPieSlice::LabelOutside | 0 | ラベルは、アームを介して接続されたスライスの外側に配置されます。これがデフォルト値です。 |
QPieSlice::LabelInsideHorizontal | 1 | ラベルはスライス内で中央に配置され、水平方向に配置されます。 |
QPieSlice::LabelInsideTangential | 2 | ラベルはスライス内で中央に配置され、スライスの弧の接線と平行になるように回転されます。 |
QPieSlice::LabelInsideNormal | 3 | ラベルはスライス内で中央に配置され、スライスの弧の法線と平行になるように回転されます。 |
プロパティのドキュメント
[read-only] angleSpan : qreal
このプロパティには、スライスの角度（度）が格納されます。円全体は360度で、0度は12時の位置に相当します。スライスがシリーズに追加されると、自動的に更新されます。
アクセス関数：
| qreal | angleSpan() const |
通知シグナル:
| void | angleSpanChanged() |
borderColor : QColor
このプロパティは、スライスの境界線を描画するために使用される色を保持します。これは、スライスの描画スタイルを変更するための便利なプロパティです。
アクセス関数：
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
通知シグナル:
| void | borderColorChanged() |
関連項目： pen およびborderWidth 。
borderWidth : int
このプロパティは、スライスの境界線の幅を指定します。これは、スライスのペン設定を変更するための便利なプロパティです。
アクセス関数：
| int | borderWidth() |
| void | setBorderWidth(int width) |
通知シグナル:
| void | borderWidthChanged() |
関連項目： pen およびborderColor 。
brush : QBrush
このプロパティには、スライスの塗りつぶしに使用されるブラシが格納されます。
アクセス関数：
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
通知シグナル:
| void | brushChanged() |
color : QColor
このプロパティは、スライスの塗りつぶし（ブラシ）色を保持します。これは、スライスのブラシを変更するための便利なプロパティです。
アクセス関数：
| QColor | color() |
| void | setColor(QColor color) |
通知シグナル:
| void | colorChanged() |
関連項目： brush 。
explodeDistanceFactor : qreal
スライスが円からどの程度離れた位置に展開されるかを決定します。
- 1.0 は、その距離が半径と同じであることを意味します。
- 0.5 の場合、距離は半径の半分になります。
デフォルトでは、距離は 0.15 です。
アクセス関数：
| qreal | explodeDistanceFactor() const |
| void | setExplodeDistanceFactor(qreal factor) |
関連項目： exploded 。
exploded : bool
このプロパティは、スライスがパイから切り離されているかどうかを示します。
アクセス関数：
| bool | isExploded() const |
| void | setExploded(bool exploded = true) |
「explodeDistanceFactor」も参照してください 。
label : QString
このプロパティには、スライスのラベルが格納されます。
注： 文字列は HTML形式で記述可能です。
アクセス関数：
| QString | label() const |
| void | setLabel(QString label) |
通知シグナル:
| void | labelChanged() |
関連項目： labelVisible 、labelBrush 、labelFont 、およびlabelArmLengthFactor 。
labelArmLengthFactor : qreal
このプロパティは、ラベルアームの長さを保持します。この係数は、円グラフの半径に対する相対値です。例えば：
- 1.0 は、長さが半径と同じであることを意味します。
- 0.5 は、長さが半径の半分であることを意味します。
デフォルトでは、アームの長さは 0.15 です
アクセス関数：
| qreal | labelArmLengthFactor() const |
| void | setLabelArmLengthFactor(qreal factor) |
関連項目： label 、labelVisible 、labelBrush 、およびlabelFont 。
labelBrush : QBrush
このプロパティには、スライスのラベルおよびラベルアームの描画に使用されるブラシが格納されます。
アクセス関数:
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
通知シグナル:
| void | labelBrushChanged() |
関連項目: label 、labelVisible 、labelFont 、およびlabelArmLengthFactor 。
labelColor : QColor
このプロパティには、スライスのラベルを描画するために使用される色が格納されます。これは、スライスのラベル用ブラシを変更するための便利なプロパティです。
アクセス関数：
| QColor | labelColor() |
| void | setLabelColor(QColor color) |
通知シグナル:
| void | labelColorChanged() |
関連項目: labelBrush 。
labelFont : QFont
このプロパティには、ラベルのテキストを描画するために使用されるフォントが格納されます。
アクセス関数：
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
通知シグナル:
| void | labelFontChanged() |
関連項目： label 、labelVisible 、およびlabelArmLengthFactor 。
labelPosition : LabelPosition
このプロパティは、スライスラベルの位置を指定します。
アクセス関数：
| QPieSlice::LabelPosition | labelPosition() |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
関連項目： label およびlabelVisible 。
labelVisible : bool
このプロパティは、スライスラベルの表示/非表示を設定します。デフォルトでは、ラベルは非表示になっています。
アクセス関数：
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
通知シグナル:
| void | labelVisibleChanged() |
関連項目： label 、labelBrush 、labelFont 、およびlabelArmLengthFactor 。
pen : QPen
このプロパティには、スライスの境界線を描画するために使用されるペンが格納されます。
アクセス関数：
| QPen | pen() const |
| void | setPen(const QPen &pen) |
通知シグナル:
| void | penChanged() |
[read-only] percentage : qreal
このプロパティは、シリーズ内のすべてのスライスの合計に対する、そのスライスの割合を表します。実際の値は 0.0 から 1.0 の範囲です。スライスがシリーズに追加されると自動的に更新されます。
アクセス関数：
| qreal | percentage() const |
通知シグナル:
| void | percentageChanged() |
関連項目： value およびQPieSeries::sum 。
[read-only] startAngle : qreal
このプロパティは、このスライスが属するシリーズにおける開始角度を保持します。円グラフ全体は360度で、0度は12時の位置に相当します。スライスがシリーズに追加されると自動的に更新されます。
アクセス関数：
| qreal | startAngle() const |
通知シグナル:
| void | startAngleChanged() |
value : qreal
このプロパティには、スライスの値が格納されます。
注： 負の値は 正の値に変換されます。
アクセス関数：
| qreal | value() const |
| void | setValue(qreal value) |
通知シグナル：
| void | valueChanged() |
関連項目： percentage() およびQPieSeries::sum()。
メンバ関数のドキュメント
[explicit] QPieSlice::QPieSlice(QObject *parent = nullptr)
親のparent を持つ空のスライスを生成します。
QPieSeries::append() およびQPieSeries::insert()も参照してください 。
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)
指定されたvalue 、label 、およびparent を使用して、空のスライスを構築します。
QPieSeries::append() およびQPieSeries::insert()も参照してください 。
[virtual noexcept] QPieSlice::~QPieSlice()
スライスを削除します。スライスがシリーズに追加されている場合は、削除しないでください。
[signal] void QPieSlice::angleSpanChanged()
このシグナルは、スライスの角度範囲が変更されたときに発せられます。
注： プロパティ `angleSpan` に対する通知 信号です。
「angleSpan」も参照してください 。
[signal] void QPieSlice::borderColorChanged()
このシグナルは、スライスの境界線の色が変化したときに発せられます。
注： プロパティ `borderColor` に対する通知 シグナルです。
関連項目： pen およびborderColor 。
[signal] void QPieSlice::borderWidthChanged()
このシグナルは、スライスの境界幅が変化した際に発生します。
注： プロパティ `borderWidth` に対する通知 シグナルです。
「 pen 」および「borderWidth 」も参照してください 。
[signal] void QPieSlice::brushChanged()
このシグナルは、スライスの塗りつぶしに使用されるブラシが変更されたときに発せられます。
注： プロパティ `brush`の通知 シグナルです。
「brush」も参照してください 。
[signal] void QPieSlice::clicked()
この信号は、スライスがクリックされたときに発せられます。
QPieSeries::clicked()も参照してください 。
[signal] void QPieSlice::colorChanged()
このシグナルは、スライスの色が変化したときに発せられます。
注： プロパティ `color` に対する通知 シグナルです。
「brush」も参照してください 。
[signal] void QPieSlice::doubleClicked()
このシグナルは、ユーザーがスライスをダブルクリックしたときに発生します。
QPieSeries::doubleClicked()も参照してください 。
[signal] void QPieSlice::hovered(bool state)
このシグナルは、マウスがスライスの上にホバーされたときに発せられます。マウスがスライスの上を移動すると、state はtrue となり、マウスが再びスライスから離れると、false となります。
QPieSeries::hovered()も参照してください 。
[signal] void QPieSlice::labelBrushChanged()
このシグナルは、スライスのラベルブラシが変更されたときに発火します。
注： プロパティ `labelBrush` に対する通知 シグナルです。
「labelBrush」も参照してください 。
[signal] void QPieSlice::labelChanged()
このシグナルは、スライスのラベルが変更されたときに発せられます。
注： プロパティ `label` に対する通知 シグナルです。
「label」も参照してください 。
[signal] void QPieSlice::labelColorChanged()
このシグナルは、スライスのラベルの色が変更されたときに発信されます。
注： プロパティ `labelColor` に対する通知 シグナルです。
「labelColor」も参照してください 。
[signal] void QPieSlice::labelFontChanged()
このシグナルは、スライスのラベルフォントが変更されたときに発せられます。
注： プロパティ `labelFont`の通知 シグナルです。
「labelFont」も参照してください 。
[signal] void QPieSlice::labelVisibleChanged()
このシグナルは、スライスラベルの可視性が変更されたときに発火します。
注： プロパティ `labelVisible` に対する通知 シグナルです。
「labelVisible」も参照してください 。
[signal] void QPieSlice::penChanged()
スライスの境界線を描画するために使用されるペンが変更されたときに、このシグナルが発信されます。
注： プロパティ `pen` に対する通知 シグナルです。
「pen」も参照してください 。
[signal] void QPieSlice::percentageChanged()
このシグナルは、スライスの割合が変化したときに発行されます。
注： プロパティ `percentage`の通知 シグナルです。
「percentage」も参照してください 。
[signal] void QPieSlice::pressed()
このシグナルは、ユーザーがスライスをクリックしてマウスボタンを押し続けたときに発生します。
QPieSeries::pressed()も参照してください 。
[signal] void QPieSlice::released()
このシグナルは、ユーザーがスライス上でマウスのボタンを離したときに発火します。
QPieSeries::released()も参照してください 。
QPieSeries *QPieSlice::series() const
このスライスが属する系列を返します。
QPieSeries::append()も参照してください 。
[signal] void QPieSlice::startAngleChanged()
このシグナルは、スライスの開始角度が変更されたときに発信されます。
注： プロパティ `startAngle` に対する通知 信号です。
「startAngle」も参照してください 。
[signal] void QPieSlice::valueChanged()
このシグナルは、スライス値が変化したときに発生します。
注： プロパティ `value` に対する通知 シグナルです。
「value」も参照してください 。
© 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.
