QLegend Class

QLegend クラスは、チャートの凡例を表示します。詳細...

Header: #include <QLegend>
In QML: Legend
Inherits: QGraphicsWidget

パブリックな型

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)

アクセス関数: Notifier signal: このプロパティは、凡例の背景色(ブラシ色)を保持します:

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)

アクセス関数:Notifierシグナル

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 に対するノーティファイア・シグナル。

QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const

凡例内のマーカーのリストを返す。マーカーを返すseries を指定することで、リストをフィルタリングすることができます。

QPen QLegend::pen() const

凡例が使用するペンを返します。

setPen()も参照

[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)

このシグナルは、凡例内のマーカーの逆順の使用がreverseMarkers に変更されたときに発行される。

注: プロパティreverseMarkers に対するノーティファイアシグナル。

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)

interactivetrue で凡例が切り離されているとき、凡例はウィンドウと同様にマウスで移動したり大きさを変えたりすることができます。

凡例は、チャートの端からドラッグすることで自動的にその端にくっつく。くっついている凡例をダブルクリックすると、凡例が切り離される。これはデフォルトでは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)

showtrue の場合、ラベルそのものが非表示で表示されている場合、凡例ラベルにマウスを置くとツールチップが表示されます。これはデフォルトではfalse です。

注: プロパティshowToolTips に対するセッター関数。

showToolTips()も参照してください

bool QLegend::showToolTips() const

凡例ラベルがエライデされたとき、ツールチップを表示するかどうかを返します。

メモ: プロパティ showToolTips のゲッター関数。

setShowToolTips()も参照

[signal] void QLegend::showToolTipsChanged(bool showToolTips)

このシグナルは、ツールチップの可視性がshowToolTips に変更されたときに発行される。

注: プロパティshowToolTips の Notifier シグナル。

©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。