Класс QGraphicsSvgItem

Класс QGraphicsSvgItem — это QGraphicsItem, который может использоваться для отрисовки содержимого файлов SVG. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Свойства

• elementId : QString
• maximumCacheSize : QSize

Открытые функции

Реализованные открытые функции

Подробное описание

QGraphicsSvgItem предоставляет способ отрисовки файлов SVG на QGraphicsView. QGraphicsSvgItem может быть создан путём передачи SVG файла для отрисовки в его конструктор или путём явного задания общего QSvgRenderer на нём.

Обратите внимание, что задание QSvgRenderer на QGraphicsSvgItem не делает элемент владельцем рендерера, поэтому, если используется метод setSharedRenderer(), необходимо убедиться, что жизненный цикл объекта QSvgRenderer будет по крайней мере таким же длительным, как и QGraphicsSvgItem.

QGraphicsSvgItem предоставляет способ отрисовки только частей файлов SVG через setElementId. Если вызван метод setElementId(), будет отрисован только элемент SVG (и его потомки) с переданным идентификатором. Это обеспечивает удобный способ избирательной отрисовки больших файлов SVG, содержащих ряд отдельных элементов. Например, следующий код отрисовывает только джокеров из файла SVG, содержащего всю колоду карт:

QSvgRenderer *renderer = new QSvgRenderer(QLatin1String("SvgCardDeck.svg"));
QGraphicsSvgItem *black = new QGraphicsSvgItem();
QGraphicsSvgItem *red   = new QGraphicsSvgItem();

black->setSharedRenderer(renderer);
black->setElementId(QLatin1String("black_joker"));

red->setSharedRenderer(renderer);
red->setElementId(QLatin1String("red_joker"));

Размер элемента может быть изменён путём прямого управления матрицей преобразований элемента.

По умолчанию отрисовка SVG кэшируется с помощью режима QGraphicsItem::DeviceCoordinateCache, чтобы ускорить отображение элементов. Кэширование можно отключить, передав QGraphicsItem::NoCache методу QGraphicsItem::setCacheMode().

См. также QSvgWidget, Qt SVG C++ классы, QGraphicsItem и QGraphicsView.

Документация функций-членов

QGraphicsSvgItem::QGraphicsSvgItem(const QString &fileName, QGraphicsItem *parent = nullptr)

Конструирует новый элемент с заданным parent и загружает содержимое файла SVG с заданным fileName.

QGraphicsSvgItem::QGraphicsSvgItem(QGraphicsItem *parent = nullptr)

Конструирует новый элемент SVG с заданным parent.

[override virtual] QRectF QGraphicsSvgItem::boundingRect() const

Переопределяет: QGraphicsItem::boundingRect() const.

Возвращает прямоугольник ограничивающей области этого элемента.

QString QGraphicsSvgItem::elementId() const

Возвращает XML-идентификатор элемента, который в данный момент отрисовывается. Возвращает пустую строку, если отрисовывается весь файл.

Примечание: Функция-член для свойства elementId.

См. также setElementId().

QSize QGraphicsSvgItem::maximumCacheSize() const

Возвращает текущий максимальный размер кэша координат устройства для этого элемента. Если элемент кэшируется с помощью режима QGraphicsItem::DeviceCoordinateCache, кэширование пропущено, если расширение элемента в координатах устройства больше максимального размера.

По умолчанию максимальный размер кэша составляет 1024x768. QPixmapCache::cacheLimit() даёт совокупные границы всего кэша, в то время как maximumCacheSize() относится к максимальному размеру кэша для этого конкретного элемента.

Примечание: Функция-член для свойства maximumCacheSize.

См. также setMaximumCacheSize() и QGraphicsItem::cacheMode().

[override virtual] void QGraphicsSvgItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Переопределяет: QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

QSvgRenderer *QGraphicsSvgItem::renderer() const

Возвращает текущий используемый QSvgRenderer.

void QGraphicsSvgItem::setElementId(const QString &id)

Устанавливает XML-идентификатор элемента в id.

Примечание: Функция-установщик для свойства elementId.

См. также elementId().

void QGraphicsSvgItem::setMaximumCacheSize(const QSize &size)

Устанавливает максимальный размер кэша координат устройства элемента в size. Если элемент кэшируется с помощью режима QGraphicsItem::DeviceCoordinateCache, кэширование пропущено, если расширение элемента в координатах устройства больше size.

Кэш соответствует QPixmap, который используется для кэширования результатов рендеринга. Используйте QPixmapCache::setCacheLimit(), чтобы установить ограничения на весь кэш, и используйте setMaximumCacheSize(), при установке размера кэша для отдельных элементов.

Примечание: Функция-установщик для свойства maximumCacheSize.

См. также maximumCacheSize() и QGraphicsItem::cacheMode().

void QGraphicsSvgItem::setSharedRenderer(QSvgRenderer *renderer)

Устанавливает renderer в качестве общего QSvgRenderer для элемента. Используя этот метод, можно использовать один и тот же QSvgRenderer для нескольких элементов. Это означает, что файл SVG будет проанализирован только один раз. QSvgRenderer, переданный в этот метод, должен существовать до тех пор, пока этот элемент используется.

[override virtual] int QGraphicsSvgItem::type() const

Переопределяет: QGraphicsItem::type() const.