QSvgWidget Class
QSvgWidgetクラスは、Scalable Vector Graphics (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 図面はディスプレイのプロパティを用いてレンダリングされる。QImage や QGLWidget のような他の描画デバイスに描画するために使用できるため、QSvgRenderer クラスで描画処理をより制御できる。ウィジェットが使用するレンダラーはrenderer() 関数で取得できます。
各QSvgWidgetはSVGファイルのファイル名で構築することもできるし、レンダリングする特定のファイルなしで構築し、後で提供することもできる。load() 関数は SVG ファイルを読み込むための2つの異なる方法を提供する: SVG ファイルのファイル名か、SVG ファイルのシリアライズされた XML 表現を含むQByteArray のどちらかを受け付ける。
デフォルトでは、ウィジェットは表示する描画のサイズを反映するサイズヒントを提供する。データが読み込まれていない場合、ウィジェットはデフォルトの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)
指定された SVGfile の内容を読み込み、ウィジェットを更新する。
[since 6.7] QtSvg::Options QSvgWidget::options() const
ウィジェットのレンダラーのオプションを返します。
この関数は Qt 6.7 で導入されました。
setOptionsも参照してください 。
[override virtual protected] void QSvgWidget::paintEvent(QPaintEvent *event)
再実装：QWidget::paintEvent(QPaintEvent *event)。
QSvgRenderer *QSvgWidget::renderer() const
ウィジェットのコンテンツを表示するために使用されるレンダラーを返します。
[since 6.7] void QSvgWidget::setOptions(QtSvg::Options options)
ウィジェットのレンダラオプションをoptions に設定する。
このプロパティは、SVG ファイルの解析とレンダリングの様々な機能を有効または無効にするために使用できるQtSvg::Option フラグのセットを保持する。何らかの効果を得るためには load 関数を呼び出す前に設定されなければならない。
デフォルトではフラグは設定されていない。
この関数は Qt 6.7 で導入されました。
optionsも参照してください 。
[override virtual] QSize QSvgWidget::sizeHint() const
© 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.
