|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.trolltech.qt.QSignalEmitter
com.trolltech.qt.QtJambiObject
com.trolltech.qt.core.QObject
com.trolltech.qt.gui.QAbstractTextDocumentLayout
public abstract class QAbstractTextDocumentLayout
The QAbstractTextDocumentLayout
class is an abstract base class used to implement custom layouts for QTextDocuments
. The standard layout provided by Qt can handle simple word processing including inline layouts, lists and tables.
Some applications (e.g. a word processor or a DTP application) might need more features than the ones provided by Qt's layout engine, in which case you can subclass QAbstractTextDocumentLayout
to provide your own custom layout behavior for your text documents.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter |
---|
QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9 |
Field Summary | |
---|---|
QSignalEmitter.Signal1 |
documentSizeChanged
This signal is emitted when the size of the document changes. |
QSignalEmitter.Signal1 |
pageCountChanged
This signal is emitted when the number of pages in the layout changes; newPages is the updated page count. |
QSignalEmitter.Signal1 |
update
This signal is emitted when the rectangle rect has been updated. |
QSignalEmitter.Signal1 |
updateBlock
This signal is emitted when the rectangle rect has been updated. |
Constructor Summary | |
---|---|
QAbstractTextDocumentLayout(QTextDocument doc)
Creates a new text document layout for the given document. |
Method Summary | |
---|---|
java.lang.String |
anchorAt(QPointF pos)
Returns the reference of the anchor at the given position, or an empty string if no anchor exists at that point. |
abstract QRectF |
blockBoundingRect(QTextBlock block)
Returns the bounding rectangle of block. |
QTextDocument |
document()
Returns the text document that this layout is operating on. |
protected abstract void |
documentChanged(int from,
int charsRemoved,
int charsAdded)
This function is called whenever the contents of the document change. |
abstract QSizeF |
documentSize()
Returns the total size of the document. |
abstract void |
draw(QPainter painter,
QAbstractTextDocumentLayout_PaintContext context)
Draws the layout on the given painter with the given context. |
protected void |
drawInlineObject(QPainter painter,
QRectF rect,
QTextInlineObject object,
int posInDocument,
QTextFormat format)
Called to draw the inline object object on the given painter within the rectangle specified by rect using the text format specified by format. |
protected QTextCharFormat |
format(int pos)
Returns the character format that is applicable at the given position. |
abstract QRectF |
frameBoundingRect(QTextFrame frame)
Returns the bounding rectacle of frame. |
static QAbstractTextDocumentLayout |
fromNativePointer(QNativePointer nativePointer)
|
QTextObjectInterface |
handlerForObject(int objectType)
Returns a handler for objects of the given objectType. |
abstract int |
hitTest(QPointF point,
Qt.HitTestAccuracy accuracy)
Returns the cursor postion for the given point with the accuracy specified. |
abstract int |
pageCount()
Returns the number of pages required by the layout. |
QPaintDeviceInterface |
paintDevice()
Returns the paint device used to render the document's layout. |
protected void |
positionInlineObject(QTextInlineObject item,
int posInDocument,
QTextFormat format)
Lays out the inline object item using the given text format. |
void |
registerHandler(int objectType,
QObject component)
Registers the given component as a handler for items of the given formatType. |
protected void |
resizeInlineObject(QTextInlineObject item,
int posInDocument,
QTextFormat format)
Sets the size of the inline object item in accordance with the text format. |
void |
setPaintDevice(QPaintDeviceInterface device)
Sets the paint device used for rendering the document's layout to the given device. |
Methods inherited from class com.trolltech.qt.core.QObject |
---|
childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty |
Methods inherited from class com.trolltech.qt.QtJambiObject |
---|
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr |
Methods inherited from class com.trolltech.qt.QSignalEmitter |
---|
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread |
Methods inherited from class java.lang.Object |
---|
clone, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.trolltech.qt.QtJambiInterface |
---|
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership |
Field Detail |
---|
public final QSignalEmitter.Signal1 documentSizeChanged
This information is useful to widgets that display text documents since it enables them to update their scroll bars correctly.
documentSize()
.
public final QSignalEmitter.Signal1 pageCountChanged
Changes to the page count are due to the changes to the layout or the document content itself.
pageCount()
.
public final QSignalEmitter.Signal1 update
public final QSignalEmitter.Signal1 updateBlock
Constructor Detail |
---|
public QAbstractTextDocumentLayout(QTextDocument doc)
Method Detail |
---|
public final java.lang.String anchorAt(QPointF pos)
public final QTextDocument document()
protected final QTextCharFormat format(int pos)
public final QTextObjectInterface handlerForObject(int objectType)
public final QPaintDeviceInterface paintDevice()
setPaintDevice()
.
public final void registerHandler(int objectType, QObject component)
public final void setPaintDevice(QPaintDeviceInterface device)
paintDevice()
.
public abstract QRectF blockBoundingRect(QTextBlock block)
protected abstract void documentChanged(int from, int charsRemoved, int charsAdded)
For example, when inserting the text "Hello" into an empty document, charsRemoved would be 0 and charsAdded would be 5 (the length of the string).
Replacing text is the combination of removal and insertion. For example, if the text "Hello" gets replaced by "Hi", charsRemoved would be 5 and charsAdded would be 2.
public abstract QSizeF documentSize()
documentSizeChanged()
, and QTextDocument::pageSize
.
public abstract void draw(QPainter painter, QAbstractTextDocumentLayout_PaintContext context)
protected void drawInlineObject(QPainter painter, QRectF rect, QTextInlineObject object, int posInDocument, QTextFormat format)
draw()
.
public abstract QRectF frameBoundingRect(QTextFrame frame)
public abstract int hitTest(QPointF point, Qt.HitTestAccuracy accuracy)
public abstract int pageCount()
pageCountChanged()
.
protected void positionInlineObject(QTextInlineObject item, int posInDocument, QTextFormat format)
drawInlineObject()
.
protected void resizeInlineObject(QTextInlineObject item, int posInDocument, QTextFormat format)
public static QAbstractTextDocumentLayout fromNativePointer(QNativePointer nativePointer)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |