Класс QTextObjectInterface

Класс QTextObjectInterface позволяет рисовать пользовательские объекты текста в документах QTextDocument. Подробнее...

Этот класс был представлен в Qt 4.5.

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

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

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

Объект текста описывает структуру одного или нескольких элементов в документе текста; например, изображения, импортированные из HTML, реализуются с помощью объектов текста. Объект текста знает, как выкладывать и отрисовывать свои элементы при рендеринге документа.

Qt позволяет вставлять пользовательские объекты текста в документ, регистрируя пользовательский тип объекта object type с QTextCharFormat. Для этого типа также должен быть реализован класс QTextObjectInterface и зарегистрирован в QAbstractTextDocumentLayout документа. При встрече типа объекта во время рендеринга QTextDocument вызываются функции intrinsicSize() и drawObject() интерфейса.

В следующем списке описаны необходимые шаги для вставки пользовательского объекта текста в документ:

• Выберите objectType. objectType — это целое число со значением, большим или равным QTextFormat::UserObject.
• Создайте объект QTextCharFormat и установите тип объекта на выбранный тип, используя функцию setObjectType().
• Реализуйте класс QTextObjectInterface.
• Вызовите QAbstractTextDocumentLayout::registerHandler() с экземпляром вашего подкласса QTextObjectInterface для регистрации вашего типа объекта.
• Вставьте QChar::ObjectReplacementCharacter с указанным выше QTextCharFormat выбранного типа объекта в документ. Как указано, функции QTextObjectInterface intrinsicSize() и drawObject() будут вызываться с QTextFormat в качестве параметра всякий раз, когда встречается символ замены.

Класс, реализующий объект текста, должен наследоваться как от QObject, так и от QTextObjectInterface. QObject должен быть первым наследовавшимся классом. Например:

class SvgTextObject : public QObject, public QTextObjectInterface
{
    Q_OBJECT
    Q_INTERFACES(QTextObjectInterface)

Данные объекта текста обычно хранятся в QTextCharFormat с помощью QTextCharFormat::setProperty(), а затем извлекаются с помощью QTextCharFormat::property().

Предупреждение: Операции копирования и вставки игнорируют пользовательские объекты текста.

См. также Пример объекта текста, QTextCharFormat и QTextLayout.

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

[virtual] QTextObjectInterface::~QTextObjectInterface()

Удаляет этот QTextObjectInterface.

[pure virtual] void QTextObjectInterface::drawObject(QPainter *painter, const QRectF &rect, QTextDocument *doc, int posInDocument, const QTextFormat &format)

Отрисовывает этот объект текста с помощью указанного painter.

Размер прямоугольника rect для отрисовки — это размер, ранее рассчитанный функцией intrinsicSize(). Положение прямоугольника относительно painter.

Вы также получаете документ (doc) и позицию (posInDocument) format в этом документе.

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

[pure virtual] QSizeF QTextObjectInterface::intrinsicSize(QTextDocument *doc, int posInDocument, const QTextFormat &format)

Функция intrinsicSize() возвращает размер объекта текста, представленного format в данном документе (doc) в заданной позиции (posInDocument).

Рассчитанный размер будет использован для последующих вызовов drawObject() для данного format.

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