このページでは

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::MarkerShapeDefault0QLegend によって決定されるデフォルトの形状がマーカーに使用されます。この値は、個々の QLegendMarker アイテムでのみサポートされています。
QLegend::MarkerShapeRectangle1長方形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決定されます。
QLegend::MarkerShapeCircle2円形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。
QLegend::MarkerShapeRotatedRectangle4回転した長方形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決定されます。
QLegend::MarkerShapeTriangle5三角形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。
QLegend::MarkerShapeStar6星形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。
QLegend::MarkerShapePentagon7五角形のマーカーが使用されます。マーカーのサイズはフォントサイズによって決まります。
QLegend::MarkerShapeFromSeries3マーカーの形状は系列によって決まります。散布図系列の場合、凡例マーカーは散布点の形状をしており、そのサイズも点と同じになります。線またはスプライン系列の場合、凡例マーカーは線の小さな区間のような形状になります。 その他の系列タイプでは、長方形のマーカーが表示されます。系列に「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.