QPieSlice Class
QPieSlice クラスは、パイシリーズのスライスを表します。詳細...
パブリック・タイプ
| 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 : 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) |
Notifier シグナル：
| 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も参照して ください。
©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
