QPieSlice Class
QPieSlice クラスは、パイシリーズのスライスを表します。詳細...
| Header: | #include <QPieSlice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | PieSlice |
| Inherits: | QObject |
- 継承メンバを含む全メンバ一覧
- QPieSlice はQt Graphs C++ Classes for 2D に含まれます。
パブリックタイプ
| enum class | LabelPosition { Outside, InsideHorizontal, InsideTangential, InsideNormal } |
プロパティ
|
|
パブリック関数
| QPieSlice(QObject *parent = nullptr) | |
| QPieSlice(const QString &label, qreal value, QObject *parent = nullptr) | |
| virtual | ~QPieSlice() override |
| qreal | angleSpan() const |
| QColor | borderColor() const |
| qreal | borderWidth() const |
| QColor | color() const |
| qreal | explodeDistanceFactor() const |
| bool | isExploded() const |
| bool | isLabelVisible() const |
| QString | label() const |
| qreal | labelArmLengthFactor() const |
| QColor | labelColor() const |
| QFont | labelFont() const |
| QPieSlice::LabelPosition | labelPosition() |
| qreal | percentage() const |
| QPieSeries * | series() const |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(qreal borderWidth) |
| void | setColor(QColor color) |
| void | setExplodeDistanceFactor(qreal factor) |
| void | setExploded(bool exploded) |
| void | setLabel(const QString &label) |
| void | setLabelArmLengthFactor(qreal factor) |
| void | setLabelColor(QColor color) |
| void | setLabelFont(const QFont &font) |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
| void | setLabelVisible(bool visible = true) |
| void | setValue(qreal value) |
| qreal | startAngle() const |
| qreal | value() const |
シグナル
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | colorChanged() |
| void | explodeDistanceFactorChanged() |
| void | explodedChanged() |
| void | labelArmLengthFactorChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelPositionChanged() |
| void | labelVisibleChanged() |
| void | percentageChanged() |
| void | startAngleChanged() |
| void | valueChanged() |
詳細説明
パイスライスには値とラベルがあります。スライスがパイシリーズに追加されると、QPieSeries オブジェクトは、シリーズ内のすべてのスライスの合計と比較したスライスのパーセンテージを計算し、グラフ内のスライスの実際のサイズを決定します。
デフォルトでは、ラベルは非表示です。ラベルが表示されている場合、ラベルはスライスの外側に配置され、アームでスライスに接続されるか、スライスの内側に水平またはスライスの円弧の接線または法線と平行に配置されます。
デフォルトでは、スライスの外観はテーマによって設定されますが、スライスのプロパティを指定することでテーマを上書きすることができます。ただし、スライスをカスタマイズした後にテーマを変更すると、すべてのカスタマイズが失われます。
ユーザーが円グラフとインタラクションできるように、ユーザーが円グラフのスライスをクリックしたり、マウスカーソルを重ねたりすると、いくつかの基本的なシグナルが発せられます。
QPieSeriesも参照してください 。
メンバ型ドキュメント
enum class QPieSlice::LabelPosition
この列挙型はスライスラベルの位置を記述する。
| 定数 | 値 | 説明 |
|---|---|---|
QPieSlice::LabelPosition::Outside | 0 | ラベルはアームで接続されたスライスの外側に位置する。これはデフォルト値です。 |
QPieSlice::LabelPosition::InsideHorizontal | 1 | ラベルはスライス内の中央にあり、水平に配置される。 |
QPieSlice::LabelPosition::InsideTangential | 2 | ラベルはスライス内の中央にあり、スライスの円弧の接線と平行になるように回転する。 |
QPieSlice::LabelPosition::InsideNormal | 3 | ラベルはスライス内の中央に配置され、スライスの円弧の法線と平行になるように回転される。 |
プロパティの説明
[read-only] angleSpan : const qreal
このプロパティは、スライスのスパンを度単位で保持します。完全なパイは360度で、0度は12時の方向である。スライスがシリーズに追加されると自動的に更新される。
アクセス関数
| qreal | angleSpan() const |
通知シグナル
| void | angleSpanChanged() |
borderColor : QColor
このプロパティは、スライスの境界線の描画に使用される色を保持する。スライスを変更するための便利なプロパティです。
アクセス関数：
| QColor | borderColor() const |
| void | setBorderColor(QColor color) |
ノーティファイアシグナル：
| void | borderColorChanged() |
borderWidthも参照してください 。
borderWidth : qreal
このプロパティは、スライスの境界線の幅を保持します。これは、スライスのボーダーの幅を変更するための便利なプロパティです。
アクセス関数：
| qreal | borderWidth() const |
| void | setBorderWidth(qreal borderWidth) |
ノーティファイアシグナル：
| void | borderWidthChanged() |
borderColorも参照して ください。
color : QColor
このプロパティはスライスの塗りつぶし色を保持します。スライスの塗りつぶし色を変更するための便利なプロパティです。
アクセス関数：
| QColor | color() const |
| void | setColor(QColor color) |
通知シグナル：
| void | colorChanged() |
explodeDistanceFactor : qreal
スライスがパイからどのくらい離れて爆発するかを決定します。
- 1.0は距離が半径と同じであることを意味します。
- 0.5は半径の半分の距離です。
デフォルトでは、距離は0.15です。
アクセス関数
| qreal | explodeDistanceFactor() const |
| void | setExplodeDistanceFactor(qreal factor) |
通知シグナル：
| void | explodeDistanceFactorChanged() |
explodedも参照 。
exploded : bool
このプロパティは、スライスがパイから分離されているかどうかを保持します。
アクセス関数：
| bool | isExploded() const |
| void | setExploded(bool exploded) |
ノーティファイアシグナル：
| void | explodedChanged() |
label : QString
このプロパティはスライスのラベルを保持します。
注意: 文字列はHTML形式にすることができます。
アクセス関数
| QString | label() const |
| void | setLabel(const QString &label) |
Notifier シグナル：
| void | labelChanged() |
labelVisible 、labelFont 、labelArmLengthFactorも参照 。
labelArmLengthFactor : qreal
このプロパティは、ラベルアームの長さを保持します。係数はパイの半径に対する相対値です。例えば
- 1.0は長さが半径と同じであることを意味する。
- 0.5は、長さが半径の半分であることを意味します。
デフォルトでは、アームの長さは0.15です。
アクセス機能
| qreal | labelArmLengthFactor() const |
| void | setLabelArmLengthFactor(qreal factor) |
通知シグナル：
| void | labelArmLengthFactorChanged() |
label 、labelVisible 、labelFontも参照 。
labelColor : QColor
このプロパティは、スライスラベルの描画に使用される色を保持します。
アクセス関数：
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
ノーティファイアシグナル：
| void | labelColorChanged() |
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) |
ノーティファイアシグナル：
| void | labelPositionChanged() |
label およびlabelVisible も参照 。
labelVisible : bool
このプロパティは、スライス ラベルの可視性を保持します。デフォルトでは、ラベルは表示されません。
アクセス関数：
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
Notifier シグナル：
| void | labelVisibleChanged() |
label 、labelFont 、labelArmLengthFactorも参照して ください。
[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(const QString &label, qreal value, QObject *parent = nullptr)
指定されたvalue 、label 、parent で空のスライスを構築します。
QPieSeries::append() およびQPieSeries::insert() も参照して ください。
[override virtual noexcept] QPieSlice::~QPieSlice()
スライスを削除します。スライスがシリーズに追加されている場合は削除してはなりません。
QPieSeries *QPieSlice::series() const
このスライスが属するシリーズを返します。
QPieSeries::append()も参照してください 。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
