Главная · Все классы · Все функции · Обзоры

Описание класса QGraphicsSvgItem
[модуль QtSvg]

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

 #include <QGraphicsSvgItem>

Этот класс не является частью Выпуска GUI Framework Qt.

Унаследован от QGraphicsObject.

Класс был добавлен в Qt 4.2.

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

Свойства

• elementId : QString
• maximumCacheSize : QSize

• 11 свойств, унаследованных от QGraphicsObject
• 1 свойство, унаследованное от QObject

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

Переопределённые открытые функции

• 2 открытые функции, унаследованные от QGraphicsObject
• 29 открытых функций, унаследованных от QObject
• 177 открытых функций, унаследованных от QGraphicsItem

Дополнительные унаследованные члены

• 1 открытый слот, унаследованный от QObject
• 9 сигналов, унаследованных от QGraphicsObject
• 1 сигнал, унаследованный от QObject
• 5 статических открытых членов, унаследованных от QObject
• 2 статических открытых члена, унаследованных от QGraphicsItem
• 7 защищенных функций, унаследованных от QObject
• 23 защищённые функции, унаследованные от QGraphicsItem

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

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

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

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

QGraphicsSvgItem предоставляет способ отрисовки только частей файлов SVG с помощью setElementId. Если вызван метод setElementId(), то только элемент SVG (и его потомки) с указанным id будет отрисован. Это предоставляет простой способ выборочной отрисовки больших файлов 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"));

Размер элемента может быть установлен с помощью метода setSize() или с помощью прямого управления матрицей преобразования элементов.

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

Смотрите также QSvgWidget, Модуль QtSvg, QGraphicsItem и QGraphicsView.

Описание свойств

elementId : QString

Это свойство содержит идентификатор (ID) элемента.

Это свойство было введено в Qt 4.6.

Функции доступа:

maximumCacheSize : QSize

Это свойство содержит максимальный размер кэша в координатах устройства для данного элемента.

Это свойство было введено в Qt 4.6.

Функции доступа:

Описание функций-членов

QGraphicsSvgItem::QGraphicsSvgItem ( QGraphicsItem * parent = 0 )

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

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

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

QRectF QGraphicsSvgItem::boundingRect () const   [virtual]

Переопределено из QGraphicsItem::boundingRect().

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

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

Переопределено из QGraphicsItem::paint().

QSvgRenderer * QGraphicsSvgItem::renderer () const

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

void QGraphicsSvgItem::setSharedRenderer ( QSvgRenderer * renderer )

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

int QGraphicsSvgItem::type () const   [virtual]

Переопределено из QGraphicsItem::type().