Back to Qt.io
Contact Us Blog Download Qt

QPieSlice Class

QPieSlice クラスは、パイシリーズのスライスを表します。詳細...

Header: #include <QPieSlice>
In QML: PieSlice
Inherits: QObject

パブリック・タイプ

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::LabelOutside0ラベルはアームで接続されたスライスの外側に位置する。これはデフォルト値です。
QPieSlice::LabelInsideHorizontal1ラベルはスライス内の中央にあり、水平に配置される。
QPieSlice::LabelInsideTangential2ラベルはスライス内の中央にあり、スライスの円弧の接線と平行になるように回転する。
QPieSlice::LabelInsideNormal3ラベルはスライス内の中央に配置され、スライスの円弧の法線と平行になるように回転される。

プロパティのドキュメント

[read-only] angleSpan : const 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)

アクセス関数： Notifierシグナル：

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 : const qreal

このプロパティは、シリーズ内の全スライスの合計に対するスライスのパーセンテージを保持する。実際の値の範囲は0.0から1.0です。スライスがシリーズに追加されると自動的に更新される。

アクセス関数：

qreal percentage() const

通知シグナル：

void percentageChanged()

value およびQPieSeries::sumも参照 。

[read-only] startAngle : const 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も参照してください 。

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