QTextObjectInterface Class

상세 설명

텍스트 객체는 텍스트 문서에 있는 하나 이상의 요소 구조를 설명합니다. 예를 들어 HTML에서 가져온 이미지는 텍스트 객체를 사용하여 구현됩니다. 텍스트 객체는 문서가 렌더링될 때 그 요소를 배치하고 그리는 방법을 알고 있습니다.

Qt는 QTextCharFormat 에 사용자 정의 object type 를 등록하여 사용자 정의 텍스트 객체를 문서에 삽입할 수 있습니다. 이 유형에 대해 QTextObjectInterface도 구현되어야 하며 문서의 QAbstractTextDocumentLayout 과 함께 registered 여야 합니다. QTextDocument 을 렌더링하는 동안 객체 유형이 발생하면 인터페이스의 intrinsicSize() 및 drawObject() 함수가 호출됩니다.

다음 목록은 문서에 사용자 정의 텍스트 객체를 삽입하는 데 필요한 단계를 설명합니다:

• objectType 을 선택합니다. objectType 은 QTextFormat::UserObject 보다 크거나 같은 값의 정수입니다.
• QTextCharFormat 객체를 만들고 setObjectType() 함수를 사용하여 객체 유형을 선택한 유형으로 설정합니다.
• QTextObjectInterface 클래스를 구현합니다.
• QTextObjectInterface 서브클래스의 인스턴스로 QAbstractTextDocumentLayout::registerHandler()를 호출하여 객체 유형을 등록합니다.
• 선택한 객체 유형의 QChar::ObjectReplacementCharacter 을 앞서 언급한 QTextCharFormat 과 함께 문서에 삽입합니다. 앞서 언급했듯이, 대체 문자가 발생할 때마다 QTextFormat 을 매개변수로 하여 QTextObjectInterface intrinsicSize() 및 drawObject()의 함수가 호출됩니다.

텍스트 객체를 구현하는 클래스는 QObject 와 QTextObjectInterface 를 모두 상속해야 합니다. QObject 이 가장 먼저 상속되는 클래스여야 합니다. 예를 들어:

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

텍스트 객체의 데이터는 일반적으로 QTextCharFormat::setProperty()을 사용하여 QTextCharFormat 에 저장한 다음 QTextCharFormat::property()로 검색합니다.