QTextObjectInterface Class

详细说明

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

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

下面列出了在文档中插入自定义文本对象的必要步骤：

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

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

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

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