PieSlice QML Type
パイシリーズの1つのスライスを表します。詳細...
| Import Statement: | import QtCharts 2.8 |
| 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 |
スライスの角度を表します。完全なパイは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 |
labelPosition : enumeration |
スライスラベルの位置を記述します。
| 定数 | 説明 |
|---|---|
PieSlice.LabelOutside | ラベルは、アームで接続されたスライスの外側に位置します。これはデフォルト値です。 |
PieSlice.LabelInsideHorizontal | ラベルはスライス内の中央にあり、水平に配置されます。 |
PieSlice.LabelInsideTangential | ラベルはスライス内の中央にあり、スライスの円弧の接線と平行になるように回転する。 |
PieSlice.LabelInsideNormal | ラベルはスライス内の中央に置かれ、スライスの弧の法線と平行になるように回転される。 |
labelVisibleも参照 。
labelVisible : bool |
スライスラベルの可視性。デフ ォル ト では、 ラ ベルは表示 さ れません。
percentage : real |
シリーズ内の全スライスの合計に対するスライスのパーセンテージ。実際の値は0.0から1.0まで。スライスがシリーズに追加されると自動的に更新される。
startAngle : real |
このスライスが属するシリーズの開始角度。完全なパイは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 です。
© 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.
