QTextObjectInterface Class

詳細説明

テキストオブジェクトは、テキストドキュメント内の1つ以上の要素の構造を記述します。例えば、HTMLから取り込まれた画像はテキストオブジェクトを使って実装されます。例えば、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 （）を使って取り出されます。