QTextObjectInterface Class

詳細な説明

テキストオブジェクトは、テキストドキュメント内の1つ以上の要素の構造を記述します。たとえば、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() で取得されます。