QSvgRenderer Class

メンバ関数のドキュメント

QSvgRenderer::QSvgRenderer(QObject *parent = nullptr)

指定されたparent を使用して、新しいレンダラーを作成します。

QSvgRenderer::QSvgRenderer(QXmlStreamReader *contents, QObject *parent = nullptr)

指定されたparent を使用して新しいレンダラーを構築し、contents で指定されたストリームリーダーを使用してSVGデータを読み込みます。

QSvgRenderer::QSvgRenderer(const QByteArray &contents, QObject *parent = nullptr)

指定されたparent を使用して新しいレンダラーを構築し、contents で指定されたバイト配列からSVGデータを読み込みます。

QSvgRenderer::QSvgRenderer(const QString &filename, QObject *parent = nullptr)

指定されたparent を使用して新しいレンダラーを生成し、指定されたfilename のSVGファイルの内容を読み込みます。

[virtual noexcept] QSvgRenderer::~QSvgRenderer()

レンダラーを破棄します。

bool QSvgRenderer::animated() const

現在のドキュメントにアニメーション要素が含まれている場合は true を返し、そうでない場合は false を返します。

framesPerSecond()も参照してください 。

QRectF QSvgRenderer::boundsOnElement(const QString &id) const

指定されたid を用いて、項目の境界矩形を返します。親要素の変換行列は、この要素の境界に影響を与えません。

transformForElement()も参照してください 。

QSize QSvgRenderer::defaultSize() const

ドキュメント内容のデフォルトのサイズを返します。

bool QSvgRenderer::elementExists(const QString &id) const

指定されたid を持つ要素が、現在解析中のSVGファイル内に存在し、かつレンダリング可能な要素である場合にtrueを返します。

注：このメソッドは、レンダリング可能な要素に対してのみ true を返します。つまり、fill や stroke スタイルプロパティの一部とみなされる要素（例：radialGradients）は、たとえ「id」属性が指定されていても、このメソッドでは検出されません。

bool QSvgRenderer::isValid() const

有効な現在のドキュメントが存在する場合、true を返します。そうでない場合は false を返します。

[slot] bool QSvgRenderer::load(QXmlStreamReader *contents)

contents に指定された SVG を読み込み、コンテンツの解析に成功した場合は true を返し、そうでない場合は false を返します。

リーダーは、現在の位置から使用されます。contents がnull の場合、動作は未定義となります。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QXmlStreamReader *contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QByteArray &contents)

指定されたSVG形式のcontents を読み込み、コンテンツの解析に成功した場合はtrueを返し、失敗した場合はfalseを返します。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QByteArray &contents) { receiver->load(contents); });

[slot] bool QSvgRenderer::load(const QString &filename)

filename で指定された SVG ファイルを読み込み、コンテンツの解析に成功した場合は true を返し、失敗した場合は false を返します。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::load));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](const QString &filename) { receiver->load(filename); });

[slot] void QSvgRenderer::render(QPainter *painter)

指定されたpainter を使用して、現在のドキュメント、またはアニメーション付きドキュメントの現在のフレームをレンダリングします。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter) { receiver->render(painter); });

[slot] void QSvgRenderer::render(QPainter *painter, const QRectF &bounds)

指定されたペインター内の指定されたbounds に対して、指定されたpainter を使用して、現在のドキュメント、またはアニメーション付きドキュメントの現在のフレームを描画します。bounds が空でない場合、SVGで指定されたアスペクト比は無視され、出力は に収まるように拡大縮小されます。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QRectF &bounds) { receiver->render(painter, bounds); });

[slot] void QSvgRenderer::render(QPainter *painter, const QString &elementId, const QRectF &bounds = QRectF())

指定された要素を、指定されたpainter を用いて、指定されたbounds 上でelementId で描画します。バウンディング矩形が指定されていない場合、SVG要素はペイントデバイス全体にマッピングされます。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        svgRenderer, qOverload(&QSvgRenderer::render));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        svgRenderer, [receiver = svgRenderer](QPainter *painter, const QString &elementId, const QRectF &bounds) { receiver->render(painter, elementId, bounds); });

[signal] void QSvgRenderer::repaintNeeded()

このシグナルは、ドキュメントのレンダリングを更新する必要があるたびに発せられます。通常、アニメーションを目的として使用されます。

[static, since 6.8] void QSvgRenderer::setDefaultOptions(QtSvg::Options flags)

レンダラーの作成時に使用されるオプションフラグを `flags` に設定します。デフォルトでは、フラグは設定されません。

実行時には、環境変数 `QT_SVG_DEFAULT_OPTIONS` によってこの設定を上書きできます。

この関数は Qt 6.8 で導入されました。

QTransform QSvgRenderer::transformForElement(const QString &id) const

指定されたid を持つ要素の変換行列を返します。この行列は、その要素の親要素の変換行列の積となります。要素自体の変換は含まれません。

論理座標系における要素のバウンディング矩形を求めるには、boundsOnElement() から返される矩形にこの行列を適用します。

boundsOnElement()も参照してください 。

QRect QSvgRenderer::viewBox() const

viewBoxF().toRect() を返します。

setViewBox() およびviewBoxF()も参照してください 。