QSvgWidget Class

QSvgWidgetクラスは、Scalable Vector Graphics (SVG) ファイルの内容を表示するために使用されるウィジェットを提供します。詳細...

Header: #include <QSvgWidget>
CMake: find_package(Qt6 REQUIRED COMPONENTS SvgWidgets)
target_link_libraries(mytarget PRIVATE Qt6::SvgWidgets)
qmake: QT += svgwidgets
Inherits: QWidget

パブリック関数

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

パブリックスロット

void load(const QByteArray &contents)
void load(const QString &file)

再実装された保護された関数

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() を再実装してください。

QSvgRendererQt SVG C++ ClassesQPictureも参照してください

メンバ関数ドキュメント

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

プロパティのアクセス関数を再実装しています:QWidget::sizeHint

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