QSvgWidget Class
QSvgWidget 클래스는 확장 가능한 벡터 그래픽(SVG) 파일의 내용을 표시하는 데 사용되는 위젯을 제공합니다. 더 보기...
| 헤더: | #include <QSvgWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SvgWidgets)target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets) |
| qmake: | QT += svgwidgets |
| 상속합니다: | QWidget |
- 상속된 멤버를 포함한 모든 멤버 목록
- QSvgWidget은 페인팅 클래스의 일부입니다.
공용 함수
| QSvgWidget(QWidget *parent = nullptr) | |
| QSvgWidget(const QString &file, QWidget *parent = nullptr) | |
| virtual | ~QSvgWidget() |
(since 6.7) QtSvg::Options | options() const |
| QSvgRenderer * | renderer() const |
(since 6.7) void | setOptions(QtSvg::Options options) |
재구현된 공용 함수
| virtual QSize | sizeHint() const override |
공용 슬롯
재구현된 보호 함수
| virtual void | paintEvent(QPaintEvent *event) override |
상세 설명
이 클래스는 개발자가 표준 위젯과 함께 SVG 도면을 표시할 수 있도록 하며, QLabel 이 텍스트 및 비트맵 이미지를 표시하는 데 사용되는 것과 거의 동일한 방식으로 사용됩니다.
QSvgWidget은 QWidget 의 서브 클래스이므로 디스플레이의 속성을 사용하여 SVG 드로잉이 렌더링됩니다. QSvgRenderer 클래스를 사용하면 QImage 및 QGLWidget과 같은 다른 페인트 장치에 페인트하는 데 사용할 수 있으므로 렌더링 프로세스에 대한 더 많은 제어를 수행할 수 있습니다. 위젯에 사용되는 렌더러는 renderer() 함수를 사용하여 얻을 수 있습니다.
각 QSvgWidget은 SVG 파일의 파일 이름으로 구성하거나 렌더링할 특정 파일 없이 구성한 후 나중에 제공받을 수 있습니다. load () 함수는 SVG 파일의 파일 이름 또는 SVG 파일의 직렬화된 XML 표현이 포함된 QByteArray 을 받는 두 가지 방법으로 SVG 파일을 로드할 수 있습니다.
기본적으로 위젯은 표시되는 그림의 크기를 반영하는 크기 힌트를 제공합니다. 데이터가 로드되지 않은 경우 위젯은 기본값인 QWidget 크기 힌트를 제공합니다. 이 동작을 사용자 정의해야 하는 경우 이 클래스를 서브클래싱하고 sizeHint()를 다시 구현하세요.
QSvgRenderer, Qt SVG C++ Classes, 및 QPicture 를 참조하세요.
멤버 함수 문서
QSvgWidget::QSvgWidget(QWidget *parent = nullptr)
주어진 parent 으로 새 SVG 디스플레이 위젯을 생성합니다.
QSvgWidget::QSvgWidget(const QString &file, QWidget *parent = nullptr)
주어진 parent 으로 새 SVG 디스플레이 위젯을 만들고 지정된 file 의 콘텐츠를 로드합니다.
[virtual noexcept] QSvgWidget::~QSvgWidget()
위젯을 삭제합니다.
[slot] void QSvgWidget::load(const QByteArray &contents)
지정된 SVG 형식( contents )을 로드하고 위젯을 업데이트합니다.
[slot] void QSvgWidget::load(const QString &file)
지정된 SVG file 의 콘텐츠를 로드하고 위젯을 업데이트합니다.
[since 6.7] QtSvg::Options QSvgWidget::options() const
위젯의 렌더러 옵션을 반환합니다.
이 함수는 Qt 6.7에 도입되었습니다.
setOptions 를참조하십시오 .
[override virtual protected] void QSvgWidget::paintEvent(QPaintEvent *event)
다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).
QSvgRenderer *QSvgWidget::renderer() const
위젯의 콘텐츠를 표시하는 데 사용되는 렌더러를 반환합니다.
[since 6.7] void QSvgWidget::setOptions(QtSvg::Options options)
위젯의 렌더러 옵션을 options 로 설정합니다.
이 속성에는 SVG 파일의 구문 분석 및 렌더링의 다양한 기능을 활성화 또는 비활성화하는 데 사용할 수 있는 QtSvg::Option 플래그 세트가 있습니다. 로드 함수를 호출하기 전에 설정해야 효과를 볼 수 있습니다.
기본적으로 플래그는 설정되어 있지 않습니다.
이 함수는 Qt 6.7에 도입되었습니다.
options 를참조하세요 .
[override virtual] QSize QSvgWidget::sizeHint() const
속성에 대한 액세스 함수를 다시 구현합니다: QWidget::sizeHint.
© 2025 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.
