QTextObjectInterface Class

详细说明

文本对象描述了文本文档中一个或多个元素的结构；例如，从 HTML 导入的图像就是通过文本对象实现的。在渲染文档时，文本对象知道如何布局和绘制其元素。

Qt 允许通过将自定义object type 注册到QTextCharFormat 来将自定义文本对象插入文档。该类型还必须实现QTextObjectInterface，并与文档的QAbstractTextDocumentLayout 保持registered 。在渲染QTextDocument 时遇到该对象类型时，将调用该接口的intrinsicSize()和drawObject()函数。

以下列表说明了将自定义文本对象插入文档所需的步骤：

• 选择一个objectType 。objectType 是一个整数，其值大于或等于QTextFormat::UserObject 。
• 创建一个QTextCharFormat 对象，并使用setObjectType()函数将对象类型设置为所选类型。
• 实现 QTextObjectInterface 类。
• 调用QAbstractTextDocumentLayout::registerHandler() 并传入您的 QTextObjectInterface 子类的实例，以注册您的对象类型。
• 将带有上述所选对象类型的QTextCharFormat 的QChar::ObjectReplacementCharacter 插入到文档中。如前所述，每当遇到替换字符时，系统就会以QTextFormat 作为参数调用 QTextObjectInterface 的intrinsicSize() 和drawObject() 函数。

实现文本对象的类需要同时继承QObject 和 QTextObjectInterface。QObject 必须是第一个被继承的类。例如：

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

文本对象的数据通常通过QTextCharFormat::setProperty() 存储在QTextCharFormat 中，然后使用QTextCharFormat::property() 进行检索。