이 페이지에서

QLegendMarker Class

QLegendMarker 클래스는 범례 내의 마커에 접근하는 데 사용할 수 있는 추상 객체입니다. 더 보기...

Header: #include <QLegendMarker>
Inherits: QObject
Inherited By:

QAreaLegendMarker, QBarLegendMarker, QBoxPlotLegendMarker, QCandlestickLegendMarker, QPieLegendMarker, and QXYLegendMarker

Status: Deprecated

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

공개 유형

enum LegendMarkerType { LegendMarkerTypeArea, LegendMarkerTypeBar, LegendMarkerTypePie, LegendMarkerTypeXY, LegendMarkerTypeBoxPlot, LegendMarkerTypeCandlestick }

속성

공개 함수

virtual ~QLegendMarker()
QBrush brush() const
QFont font() const
bool isVisible() const
QString label() const
QBrush labelBrush() const
QPen pen() const
virtual QAbstractSeries *series() = 0
void setBrush(const QBrush &brush)
void setFont(const QFont &font)
void setLabel(const QString &label)
void setLabelBrush(const QBrush &brush)
void setPen(const QPen &pen)
void setShape(QLegend::MarkerShape shape)
void setVisible(bool visible)
QLegend::MarkerShape shape() const
virtual QLegendMarker::LegendMarkerType type() = 0

신호

void brushChanged()
void clicked()
void fontChanged()
void hovered(bool status)
void labelBrushChanged()
void labelChanged()
void penChanged()
void shapeChanged()
void visibleChanged()

상세 설명

범례 마커는 아이콘과 레이블로 구성됩니다. 아이콘 색상은 시리즈를 그리는 데 사용된 색상과 일치하며, 레이블에는 시리즈의 이름(파이 차트의 경우 슬라이스 레이블, 막대 차트의 경우 막대 세트 레이블)이 표시됩니다. 범례 마커는 항상 하나의 시리즈, 슬라이스 또는 막대 세트와 관련되어 있습니다.

색상별로 구분된 5개의 막대 그룹 이름을 하단에 설명으로 표시한 백분율 막대 그래프

QLegend도 참조하십시오 .

멤버 유형 설명서

enum QLegendMarker::LegendMarkerType

범례 마커 객체의 유형입니다.

상수값설명
QLegendMarker::LegendMarkerTypeArea0영역 계열에 대한 범례 마커입니다.
QLegendMarker::LegendMarkerTypeBar1막대 세트에 대한 범례 마커.
QLegendMarker::LegendMarkerTypePie2원형 차트 조각에 대한 범례 마커.
QLegendMarker::LegendMarkerTypeXY3선, 스플라인 또는 산점도 시리즈용 범례 마커.
QLegendMarker::LegendMarkerTypeBoxPlot4박스 플롯 시리즈용 범례 마커.
QLegendMarker::LegendMarkerTypeCandlestick5캔들스틱 시리즈용 범례 마커.

속성 설명서

brush : QBrush

이 속성은 아이콘을 채우는 데 사용되는 브러시를 저장합니다.

액세스 함수:

QBrush brush() const
void setBrush(const QBrush &brush)

Notifier 신호:

void brushChanged()

font : QFont

이 속성은 레이블의 글꼴을 지정합니다.

액세스 함수:

QFont font() const
void setFont(const QFont &font)

알림 신호:

void fontChanged()

label : QString

이 속성은 범례 마커의 범례에 표시되는 텍스트를 저장합니다.

액세스 함수:

QString label() const
void setLabel(const QString &label)

알림 신호:

void labelChanged()

labelBrush : QBrush

이 속성은 레이블의 브러시를 저장합니다.

액세스 함수:

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Notifier 신호:

pen : QPen

이 속성은 아이콘의 윤곽선을 그리는 데 사용되는 펜을 나타냅니다.

액세스 함수:

QPen pen() const
void setPen(const QPen &pen)

Notifier 신호:

void penChanged()

shape : QLegend::MarkerShape

범례 마커의 모양입니다. 기본값은 ` QLegend::MarkerShapeDefault`이며, 이는 모양이 ` QLegend::markerShape ` 속성에 의해 결정됨을 나타냅니다.

액세스 함수:

QLegend::MarkerShape shape() const
void setShape(QLegend::MarkerShape shape)

알림 신호:

void shapeChanged()

visible : bool

이 속성은 범례 마커의 표시 여부를 결정합니다.

이 표시 여부는 범례 마커의 레이블과 아이콘 모두에 영향을 미칩니다.

액세스 함수:

bool isVisible() const
void setVisible(bool visible)

알림 신호:

멤버 함수 설명서

[virtual noexcept] QLegendMarker::~QLegendMarker()

범례 표시기를 제거합니다.

QBrush QLegendMarker::brush() const

아이콘을 채우는 데 사용된 브러시를 반환합니다.

참고: brush 속성에 대한게터 함수입니다.

setBrush()도 참조하십시오 .

[signal] void QLegendMarker::brushChanged()

이 신호는 범례 마커의 브러시가 변경되었을 때 발생합니다.

참고: 속성 ` brush`에 대한알림 신호입니다.

[signal] void QLegendMarker::clicked()

이 신호는 범례 마커를 클릭하면 발생합니다.

QFont QLegendMarker::font() const

레이블의 글꼴을 반환합니다.

참고: font 속성에 대한게터 함수입니다.

setFont()도 참조하십시오 .

[signal] void QLegendMarker::fontChanged()

이 신호는 범례 마커의 (레이블) 글꼴이 변경되었을 때 발생합니다.

참고: 속성 ` font`에 대한알림 신호입니다.

[signal] void QLegendMarker::hovered(bool status)

이 신호는 마우스를 범례 마커 위에 올렸을 때 발생합니다. 마우스가 마커 위로 이동하면 status 가 true 로 바뀌고, 마우스가 다시 마커에서 멀어지면 false 로 바뀝니다.

bool QLegendMarker::isVisible() const

마커의 표시 여부를 반환합니다.

참고: ` visible` 속성에 대한게터 함수입니다.

QString QLegendMarker::label() const

마커의 레이블을 반환합니다.

참고: label 속성에 대한게터 함수입니다.

setLabel()도 참조하십시오 .

QBrush QLegendMarker::labelBrush() const

레이블을 그리는 데 사용되는 브러시를 반환합니다.

참고: labelBrush 속성에 대한게터 함수입니다.

참조: ` setLabelBrush()` 함수.

[signal] void QLegendMarker::labelBrushChanged()

이 신호는 범례 마커의 레이블 브러시가 변경되었을 때 발생합니다.

참고: 속성 ` labelBrush`에 대한알림 신호입니다.

[signal] void QLegendMarker::labelChanged()

이 신호는 범례 마커의 레이블이 변경되었을 때 발생합니다.

참고: 속성 ` label`에 대한알림 신호입니다.

QPen QLegendMarker::pen() const

아이콘의 윤곽선을 그리는 데 사용된 펜을 반환합니다.

참고: pen 속성에 대한게터 함수입니다.

setPen()도 참조하십시오 .

[signal] void QLegendMarker::penChanged()

이 신호는 범례 마커의 펜이 변경되었을 때 발생합니다.

참고: 속성 pen 에 대한알림 신호입니다.

[pure virtual] QAbstractSeries *QLegendMarker::series()

이 범례 마커와 연관된 시리즈에 대한 포인터를 반환합니다. 범례 마커는 항상 시리즈와 연관되어 있습니다.

void QLegendMarker::setBrush(const QBrush &brush)

아이콘을 채우는 데 사용되는 브러시를 ‘ brush ’로 설정합니다.

참고: 시리즈의 색상을변경하면 아이콘의 색상도 함께 변경됩니다.

참고: brush 속성에 대한세터 함수입니다.

brush()도 참조하십시오 .

void QLegendMarker::setFont(const QFont &font)

레이블의 글꼴을 ‘ font ’로 설정합니다.

참고: font 속성에 대한세터 함수입니다.

font()도 참조하십시오 .

void QLegendMarker::setLabel(const QString &label)

마커의 레이블을 ‘ label ’로 설정합니다.

참고: 시리즈의 이름을변경하면 해당 마커의 레이블도 함께 변경됩니다.

참고: label 속성에 대한세터 함수입니다.

label()도 참조하십시오 .

void QLegendMarker::setLabelBrush(const QBrush &brush)

라벨을 그릴 때 사용할 브러시를 ` brush`로 설정합니다.

참고: labelBrush 속성에 대한세터 함수입니다.

labelBrush()도 참조하십시오 .

void QLegendMarker::setPen(const QPen &pen)

아이콘의 윤곽선을 그리는 데 사용되는 ‘ pen ’를 ‘ pen ’로 설정합니다.

참고: pen 속성에 대한세터 함수입니다.

pen()도 참조하십시오 .

void QLegendMarker::setVisible(bool visible)

마커의 표시 여부를 ` visible`로 설정합니다.

참고: visible 속성에 대한세터 함수입니다.

isVisible()도 참조하십시오 .

[pure virtual] QLegendMarker::LegendMarkerType QLegendMarker::type()

관련된 시리즈, 파이 차트 조각 또는 막대 차트 세트의 범례 마커 유형을 반환합니다.

LegendMarkerType도 참조하십시오 .

[signal] void QLegendMarker::visibleChanged()

이 신호는 범례 마커의 표시 상태가 변경되었을 때 발생합니다.

참고: 속성 ` visible`에 대한알림 신호입니다.

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