このページでは

PieSlice QML Type

パイシリーズの1つのスライスを表します。詳細...

Import Statement: import QtCharts 2.11
In C++: QPieSlice

プロパティ

信号

詳細説明

円グラフのスライスには値とラベルがあります。スライスが円グラフの系列に追加されると、PieSeries タイプは、系列内のすべてのスライスの合計と比較したスライスのパーセンテージを計算し、チャート内のスライスの実際のサイズを決定します。

デフォルトでは、ラベルは非表示です。ラベルが表示されている場合、ラベルはスライスの外側に配置され、スライスにアームで接続されるか、スライスの内側に水平またはスライスの円弧の接線または法線と平行に配置されます。

デフォルトでは、スライスの外観はテーマによって設定されますが、スライスのプロパティを指定することでテーマを上書きすることができます。ただし、スライスをカスタマイズした後にテーマを変更すると、カスタマイズした内容はすべて失われます。

PieSlice タイプはPieSeries タイプの子として使用してください。例えば

また、PieSeries.append() メソッドを使用して、パイシリーズにスライスを追加することもできます。

その場合、PieSeries.at() またはPieSeries.find を使用して、個々の PieSlice インスタンスのプロパティにアクセスできます。

PieSeriesも参照してください

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

angleSpan : real [read-only]

スライスの角度。完全なパイは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

スライス・ラベルに使われるフォント。

詳 し く はfont を参照。

labelVisible およびlabelPositionも参照のこと

labelPosition : enumeration

スライスラベルの位置を表す。

定数説明
PieSlice.LabelOutsideラベルはアームで接続されたスライスの外側に位置します。これはデフォルト値です。
PieSlice.LabelInsideHorizontalラベルはスライス内の中央にあり、水平に配置されます。
PieSlice.LabelInsideTangentialラベルはスライス内の中央にあり、スライスの円弧の接線と平行になるように回転する。
PieSlice.LabelInsideNormalラベルはスライス内の中央に置かれ、スライスの弧の法線と平行になるように回転される。

labelVisibleも参照のこと

labelVisible : bool

スライス・ラベルの可視性。デフォルトでは、ラベルは表示されません。

percentage : real [read-only]

シリーズ内のすべてのスライスの合計と比較したスライスのパーセンテージ。実際の値の範囲は0.0から1.0。スライスがシリーズに追加されると自動的に更新される。

startAngle : real [read-only]

このスライスが属するシリーズの開始角度。完全なパイは360度で、0度は午前12時を指す。スライスがシリーズに追加されると自動的に更新されます。

value : real

スライスの値。

注: 負の値は正の値に変換される。

シグナル・ドキュメント

clicked()

このシグナルはスライスがクリックされたときに発せられます。

対応するシグナルハンドラはonClicked() です。

注: 対応するハンドラはonClicked です。

doubleClicked()

このシグナルは、ユーザーがスライスをダブルクリックしたときに発せられます。

対応するシグナルハンドラはonDoubleClicked() です。

注: 対応するハンドラはonDoubleClicked です。

hovered(bool state)

このシグナルは、マウスがスライスの上に置かれたときに発せられる。マウスがスライス上に移動するとstatetrue に変わり、再びマウスが離れるとfalse に変わります。

対応するシグナルハンドラはonHovered() です。

注: 対応するハンドラはonHovered です。

pressed()

このシグナルは、ユーザーがスライスをクリックし、マウスボタンを押したままにすると発せられます。

対応するシグナルハンドラはonPressed() です。

注: 対応するハンドラはonPressed です。

released()

このシグナルは、ユーザーがスライス上でマウスを離したときに発せられます。

対応するシグナルハンドラはonReleased() です。

注: 対応するハンドラはonReleased です。

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