QLegend Class
QLegend クラスは、チャートの凡例を表示します。詳細...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
| Status: | Deprecated |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
| enum | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, …, MarkerShapeFromSeries } |
プロパティ
|
|
パブリック関数
| virtual | ~QLegend() |
| Qt::Alignment | alignment() const |
| void | attachToChart() |
| QColor | borderColor() |
| QBrush | brush() const |
| QColor | color() |
| void | detachFromChart() |
| QFont | font() const |
| bool | isAttachedToChart() |
| bool | isBackgroundVisible() const |
(since 6.2) bool | isInteractive() const |
| QBrush | labelBrush() const |
| QColor | labelColor() const |
| QLegend::MarkerShape | markerShape() const |
| QList<QLegendMarker *> | markers(QAbstractSeries *series = nullptr) const |
| QPen | pen() const |
| bool | reverseMarkers() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setBackgroundVisible(bool visible = true) |
| void | setBorderColor(QColor color) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setFont(const QFont &font) |
(since 6.2) void | setInteractive(bool interactive) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setMarkerShape(QLegend::MarkerShape shape) |
| void | setPen(const QPen &pen) |
| void | setReverseMarkers(bool reverseMarkers = true) |
| void | setShowToolTips(bool show) |
| bool | showToolTips() const |
シグナル
(since 6.2) void | attachedToChartChanged(bool attached) |
| void | backgroundVisibleChanged(bool visible) |
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | fontChanged(QFont font) |
| void | labelColorChanged(QColor color) |
| void | markerShapeChanged(QLegend::MarkerShape shape) |
| void | reverseMarkersChanged(bool reverseMarkers) |
| void | showToolTipsChanged(bool showToolTips) |
詳細な説明
凡例は、チャートの凡例を表示するグラフィックオブジェクトです。凡例の状態は、系列が変更された際にQChart によって更新されます。デフォルトでは、凡例はチャートに紐付けられていますが、チャートのレイアウトから独立させるために切り離すことも可能です。凡例オブジェクトは作成または削除することはできませんが、QChart クラスを介して参照することは可能です。

QChartも参照してください 。
メンバ型のドキュメント
enum QLegend::MarkerShape
この列挙型は、凡例マーカー項目をレンダリングする際に使用される形状を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QLegend::MarkerShapeDefault | 0 | QLegend によって決定されるデフォルトの形状がマーカーに使用されます。この値は、個々の QLegendMarker アイテムでのみサポートされています。 |
QLegend::MarkerShapeRectangle | 1 | 長方形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決定されます。 |
QLegend::MarkerShapeCircle | 2 | 円形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。 |
QLegend::MarkerShapeRotatedRectangle | 4 | 回転した長方形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決定されます。 |
QLegend::MarkerShapeTriangle | 5 | 三角形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。 |
QLegend::MarkerShapeStar | 6 | 星形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。 |
QLegend::MarkerShapePentagon | 7 | 五角形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。 |
QLegend::MarkerShapeFromSeries | 3 | マーカーの形状は系列によって決まります。散布図系列の場合、凡例マーカーは散布点の形状をしており、そのサイズも点と同じになります。線またはスプライン系列の場合、凡例マーカーは線の小さな区間のような形状になります。 その他の系列タイプでは、長方形のマーカーが表示されます。系列に「lightMarker 」が指定されている場合、「lightMarker 」が表示され、そのサイズは系列のマーカーサイズに基づいて決定されます。 |
「markerShape」も参照してください 。
プロパティのドキュメント
alignment : Qt::Alignment
凡例がグラフに対してどのように配置されるか。
Qt::AlignTop 、Qt::AlignBottom 、Qt::AlignLeft 、Qt::AlignRight のいずれかが指定可能です。複数のフラグを設定した場合、結果は未定義となります。
アクセス関数:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
このプロパティは、凡例の背景が表示されるかどうかを指定します。
アクセス関数:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
通知シグナル:
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
このプロパティは、凡例の色を指定します。
アクセス関数:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
通知シグナル:
| void | borderColorChanged(QColor color) |
color : QColor
このプロパティは、凡例の背景(ブラシ)色を指定します。
凡例の色を変更すると、凡例のブラシのスタイルはQt::SolidPattern に設定されます。
アクセス関数:
| QColor | color() |
| void | setColor(QColor color) |
通知シグナル:
| void | colorChanged(QColor color) |
font : QFont
このプロパティは、凡例で使用されるマーカーのフォントを指定します。
アクセス関数:
| QFont | font() const |
| void | setFont(const QFont &font) |
通知シグナル:
| void | fontChanged(QFont font) |
labelColor : QColor
このプロパティは、ラベルの描画に使用されるブラシの色を保持します。
アクセス関数:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
通知シグナル:
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
凡例マーカーのデフォルトの形状。デフォルト値はMarkerShapeRectangle です。
アクセス関数:
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
通知シグナル:
| void | markerShapeChanged(QLegend::MarkerShape shape) |
reverseMarkers : bool
このプロパティは、凡例内のマーカーの表示順序が逆順になるかどうかを指定します。
このプロパティのデフォルト値は「false 」です。
アクセス関数:
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
通知シグナル:
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
このプロパティは、テキストが切り詰められた場合にツールチップを表示するかどうかを指定します。
このプロパティのデフォルト値はfalse です。
アクセス関数:
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
通知シグナル:
| void | showToolTipsChanged(bool showToolTips) |
メンバ関数のドキュメント
[virtual noexcept] QLegend::~QLegend()
凡例オブジェクトを破棄します。凡例は常に QChart が所有しているため、アプリケーションはこの関数を呼び出してはなりません。
void QLegend::attachToChart()
凡例をグラフに追加します。グラフによって、凡例のレイアウトが調整される場合があります。
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
このシグナルは、凡例がチャートにattached されたとき、またはチャートから されたときに発火します。
この関数は Qt 6.2 で導入されました。
[signal] void QLegend::backgroundVisibleChanged(bool visible)
このシグナルは、凡例の背景の可視性が「visible 」に変化したときに発せられます。
注: プロパティ `backgroundVisible` に関する通知 シグナルです。
[signal] void QLegend::borderColorChanged(QColor color)
このシグナルは、凡例の背景の境界線の色が「color 」に変わったときに発火します。
注: プロパティ `borderColor` に対する通知 シグナルです。
QBrush QLegend::brush() const
凡例で使用されているブラシを返します。
setBrush()も参照してください 。
[signal] void QLegend::colorChanged(QColor color)
このシグナルは、凡例の背景色がcolor に変わったときに発火します。
注: プロパティ `color` に対する通知 シグナルです。
void QLegend::detachFromChart()
チャートから凡例を切り離します。これにより、チャートは凡例のレイアウトを調整しなくなります。
[signal] void QLegend::fontChanged(QFont font)
このシグナルは、凡例のマーカーのフォントが「font 」に変更されたときに発生します。
注: プロパティ `font` に関する通知 シグナルです。
bool QLegend::isAttachedToChart()
凡例がチャートに紐付けられている場合、true を返します。
bool QLegend::isBackgroundVisible() const
凡例の背景の表示状態を返します。
注: プロパティ `backgroundVisible`のゲッター 関数です。
[since 6.2] bool QLegend::isInteractive() const
レジェンドが切り離された状態で、マウスを使用してドラッグやサイズ変更が可能かどうかを返します。
この関数は Qt 6.2 で導入されました。
QLegend::setInteractive()も参照してください 。
QBrush QLegend::labelBrush() const
ラベルの描画に使用されたブラシを返します。
setLabelBrush()も参照してください 。
[signal] void QLegend::labelColorChanged(QColor color)
このシグナルは、凡例ラベルの描画に使用されるブラシの色が「color 」に変わったときに発火します。
注: プロパティ `labelColor` に対する通知 シグナルです。
[signal] void QLegend::markerShapeChanged(QLegend::MarkerShape shape)
このシグナルは、凡例マーカーの形状が「shape 」に変更されたときに発せられます。
注: プロパティ `markerShape` に関する通知 シグナルです。
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
凡例に含まれるマーカーのリストを返します。このリストは、マーカーを返す対象となるseries を指定することで、フィルタリングすることができます。
QPen QLegend::pen() const
凡例で使用されているペンを返します。
setPen()も参照してください 。
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
このシグナルは、凡例内のマーカーの順序を「reverseMarkers 」に変更したときに発生します。
注: プロパティ「reverseMarkers 」に関するNotifier シグナルです。
void QLegend::setBackgroundVisible(bool visible = true)
凡例の背景の可視性を「visible 」に設定します。
注: プロパティ `backgroundVisible`のセッター 関数です。
isBackgroundVisible()も参照してください 。
void QLegend::setBrush(const QBrush &brush)
凡例の背景を描画するために使用されるbrush を設定します。
brush()も参照してください 。
[since 6.2] void QLegend::setInteractive(bool interactive)
interactive がtrue に設定されており、凡例が切り離されている場合、その凡例はウィンドウと同様に、マウスを使って移動やサイズ変更を行うことができます。
凡例をチャートの端からドラッグして外すと、自動的にその端に固定されます。固定された凡例をダブルクリックすると、固定が解除されます。デフォルトでは、false が設定されています。
この関数は Qt 6.2 で導入されました。
QLegend::isInteractive()も参照してください 。
void QLegend::setLabelBrush(const QBrush &brush)
凡例ラベルの描画に使用するブラシを「brush 」に設定します。
labelBrush()も参照してください 。
void QLegend::setPen(const QPen &pen)
凡例の枠線を描画するために使用されるpen を設定します。
pen()も参照してください 。
void QLegend::setShowToolTips(bool show)
show がtrue に設定されている場合、凡例ラベル自体が省略表示されているとき、マウスをその上にホバーさせるとツールチップが表示されます。デフォルトでは、これはfalse です。
注: プロパティ `showToolTips`のセッター 関数です。
showToolTips()も参照してください 。
bool QLegend::showToolTips() const
凡例ラベルが省略された場合に、ツールチップが表示されるかどうかを返します。
注: プロパティ `showToolTips`のゲッター 関数です。
関連項目: setShowToolTips()。
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
このシグナルは、ツールチップの表示状態が「showToolTips 」に変更されたときに発火します。
注: プロパティ `showToolTips` に対する通知 シグナルです。
© 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.