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)

지정된 페인터( painter ) 내에서, 지정된 영역( bounds )을 사용하여 현재 문서 또는 애니메이션 문서의 현재 프레임을 렌더링합니다. 영역( 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()도 참조하십시오 .